标准查询参数

下表中列出了适用于所有 Google Cloud Billing API 操作的查询参数。

备注(关于 API 密钥和身份验证令牌):

  1. 每个请求均需要 key 参数,除非您在请求中提供了 OAuth 2.0 令牌
  2. 必须为每个需要 OAuth 范围的请求发送授权令牌。OAuth 2.0 是唯一受支持的授权协议。
  3. 您可以通过以下任一方式为任何请求提供 OAuth 2.0 令牌:
    • 使用如下所示的 access_token 查询参数:?access_token=oauth2-token
    • 使用类似于 Authorization: Bearer oauth2-token 的 HTTP Authorization 标头

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

参数 含义 备注
access_token 适用于当前用户的 OAuth 2.0 令牌。
callback 回调函数。
  • 用于处理响应的 JavaScript 回调函数的名称。
  • 用于 JavaScript JSON-P 请求。
key API 密钥。(必需*)
  • *必需参数(除非您提供 OAuth 2.0 令牌)。
  • 您的 API 密钥用于标识您的项目,并且为您提供 API 访问权限、配额和报告。
  • Google Cloud Platform Console 获取您项目的 API 密钥。
prettyPrint

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

  • 如果该参数的值为 true,系统会以人类可读的格式返回响应。
  • 默认值:true
  • 如果该参数的值为 false,则可降低响应的有效负载量,从而在某些环境中提高性能。
quotaUser 可替代 userIp
  • 即使不知道用户的 IP 地址,您也可以通过服务器端的应用强制执行每个用户的配额限制。例如,当应用代表用户在 App Engine 上运行 cron 作业时,会发生此类情况。
  • 您可以选择任意字符串用作辨别用户的唯一标识符,但字符数不能超过 40 个。
  • 如果两者均有提供,则替换 userIp
  • 详细了解如何设置 API 用量上限
userIp 最终用户的 IP 地址,表示此 API 是为哪个用户调用的。
  • 通过服务器端应用调用 API 时,您可以利用该参数强制执行每个用户的配额限制。
  • 详细了解如何设置 API 用量上限

此页内容是否有用?请给出您的反馈和评价:

发送以下问题的反馈:

此网页
Cloud Billing 文档
需要帮助?请访问我们的支持页面