标准查询参数

以下查询参数可与 Google Content API for Shopping 中的所有方法和所有资源搭配使用。

适用于所有 Google Content API for Shopping 操作的查询参数如下表所示。

备注（关于 API 密钥和身份验证令牌）：

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

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

参数 含义 备注
access_token 适用于当前用户的 OAuth 2.0 令牌。
alt

响应的数据格式。
  • 有效值：json、xml
  • 默认值：json
callback 回调函数。
  • 用于处理响应的 JavaScript 回调函数的名称。
  • 用于 JavaScript JSON-P 请求。
fields 指定响应中所含字段子集的选择器。
  • 有关详情，请参阅部分响应文档。
  • 用于提高性能。
key API 密钥。（必需*）
  • *必需（除非您提供 OAuth 2.0 令牌）。
  • 您的 API 密钥用于确定您的项目，并且为您提供 API 访问权限、配额和报告。
  • 通过 Google API 控制台获取项目的 API 密钥。
prettyPrint

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