google-app-engine - 是否可以在 API Explorer 中向 Cloud Endpoint 字段添加描述？

Question

我在 Google API 中看到了这一点。Cloud Endpoints 也可以吗？

https://developers.google.com/apis-explorer/#p/adexchangebuyer/v1.2/adexchangebuyer.accounts.get

Answer 1

这是完全可能的。我们有一些关于猴子补丁的 StackOverflow 帖子，这将是另一个很好的例子。

例如：
如何指定我自己的图标，以便它们显示在 Google Endpoints API 发现文档中？

对于这种情况，提供的内容/_ah/spi/BackendService.getApiConfigs包含您的 API 配置，而您在此处需要的“描述”是“参数”。

所以例如在方法中

@endpoints.method(MySchema, MySchema,
                  path='myschema/{strField}', name='myschema.echo')
def MySchemaEcho(self, request):
  return request

该字段strField是路径“参数”，因此在 API 配置中我们会看到

{
  ...
  "methods": {
    "myapi.myschema.echo": {
      ...
      "request": {
        ...
        "parameters": {
          "strField": {
            "required": true,
            "type": "string"
          }
        }
      },
      ...
    }
    ...
  }
}

要在其中获取您的描述，您需要将其添加到下面列出的字典中，strField以便读取

          "strField": {
            "required": true,
            "type": "string",
            "description": "Most important field that ever was."
          }