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-P requests.
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.