原文地址:http://bbs.seacat.cn/thread-898-1-1.html
Standard Query Parameters 标准化查询参数查询参数,适用于所有Google Mirror API的操作,如下表所示:
说明(API密钥和身份验证令牌):1.每个请求的关键参数都是必需的,除非你提供一个OAuth 2.0令牌的请求。
2.你必须为每个请求发送一个授权令牌用来被标记(身份验证)。OAuth 2.0是首选的授权协议。
3.您可以为任何请求提供一个OAuth 2.0令牌,可以用以下两种方式。
~使用 access_token 查询参数像这样:?access_token={oauth2-token}
~使用HTTP Authorization header像这样:Authorization: Bearer {oauth2-token}
除非特别声明,否则所有参数都是可选的。
参数 | 意义 | 注意 |
access_token | 当前用户OAuth 2.0令牌 | · One possible way to provide an OAuth 2.0 token. |
callback | 回调函数 | · Name of the JavaScript callback function that handles the response. · Used in JavaScript JSON-Prequests. |
fields | Selector specifying a subset of fields to include in the response. | · For more information, see the partial responsedocumentation. · Use for better performance. |
key | API key.(REQUIRED*) | · *Required unless you provide an OAuth 2.0 token. · Your API key identifies your project and provides you with API access, quota, and reports. · Obtain your project's API key from the Google Developers Console. |
prettyPrint | Returns response with indentations and line breaks. | · Returns the response in a human-readable format if true. · Default value: true. · When this is false, it can reduce the response payload size, which might lead to better performance in some environments. |
quotaUser | Alternative touserIp. | · Lets you enforce per-user quotas from a server-side application even in cases when the user's IP address is unknown. This can occur, for example, with applications that run cron jobs on App Engine on a user's behalf. · You can choose any arbitrary string that uniquely identifies a user, but it is limited to 40 characters. · Overrides userIp if both are provided. · Learn more about capping usage. |
userIp | IP address of the end user for whom the API call is being made. | · Lets you enforce per-user quotas when calling the API from a server-side application. · Learn more about capping usage. |