标准查询参数

下表显示了适用于所有AdSense Management API操作的查询参数。

有关API密钥和身份验证令牌的注意事项:

  1. 每个请求均需要key参数,除非您为请求提供OAuth 2.0令牌。
  2. 必须在每次标有(AUTHENTICATED)的请求中发送授权令牌。OAuth 2.0是首选的授权协议。
  3. 您可以通过以下任一方式为请求提供OAuth 2.0令牌:
    • 使用access_token查询参数,例如:?access_token=oauth2-token
    • 使用HTTP Authorization标头,例如:Authorization: Bearer oauth2-token

除非特别注明,所有参数均为可选参数。

参数 含义 备注
access_token 当前用户的OAuth 2.0令牌。
callback 回调函数。
  • 处理该响应的JavaScript回调函数的名称。
  • 用于JavaScript JSON-P请求。
fields 用于指定要在响应中包含的一组字段的选择器。
  • 有关详情,请参阅性能提示文档中的部分响应部分。
  • 用于改善效果。
key API密钥。(必需*)
  • *必需(除非您提供OAuth 2.0令牌)。
  • 您的API密钥用于标识您的项目,并且为您提供API访问权限、配额和报告。
  • Google Developers Console获取您项目的API密钥。
prettyPrint

返回带有缩进和换行符的响应。

  • 如果值为true,将以用户可读的形式返回响应。
  • 默认值:false
  • 如果值为false,可以降低响应的负载量,进而在某些环境中提升效果。
quotaUser 可替代userIp
  • 即使不知道用户的IP地址,您也可以通过服务器端的应用,强制执行每个用户的配额限制。例如,当应用代表用户在App引擎上运行定时任务时,会发生此类情况。
  • 您可以选择任意字符串用作辨别用户的唯一标识符,但字符数不能超过40。
  • 如果同时提供二者,则会覆盖userIp
  • 详细了解上限的用法
userIp 进行API调用时,发出调用的最终用户的IP地址。
  • 当通过服务器端的应用调用API时,使您可以强制执行每个用户的配额限制。
  • 详细了解上限的用法

发送以下问题的反馈:

此网页
AdSense Management API
AdSense Management API