googleads shopping samples

用于购物和制造商中心API的内容API的示例

这些代码样本是通过平台或语言组织的。每个语言目录都包含一个README ，其中包含有关如何运行该特定语言样本的更多信息。在这里，我们涵盖了设置身份验证和所有样本使用的常见配置文件。

有关API的更多信息，请参阅“购物内容和制造商中心API”的内容API文档。

选择您的身份验证方法

在开始之前，请检查内容API的入门部分中的购物文档。您可能需要使用服务帐户来简化身份验证流。这些样本还使用Google应用程序默认凭据支持。

为制造商中心API设置身份验证与内容API相似。只需确保在API控制台中选择制造商中心API即可。如果您想尝试两个API的示例，则可以选择两个API。

设置身份验证和样本配置

1. 创建目录$(HOME)/shopping-samples以存储配置。

   如果您不确定将其位于特定设置中的位置，请运行样本（遵循特定于语言的README ）。与此目录或不存在的必要文件相关的样本中的错误将为预期目录/文件提供完整的路径。

   在此目录中，还创建以下子目录，具体取决于您想尝试的API：

   • 购物内容API的content
   • 制造商中心API的manufacturers

   将下面描述的文件放在您要尝试的API的适当子目录中。

2. 设置您所需的身份验证方法。

   如果您使用的是Google应用程序默认凭据：

   • 按照Google应用程序默认凭据页面上的指示。

   如果您使用的是服务帐户：

   • 在适当的API配置子目录中，将Service帐户创建到File service-account.json时下载的JSON文件。

   如果您使用的是OAuth2客户端ID：

   • 在适当的API配置client-secrets.json中下载您的oauth2客户端凭据。

     注意：示例假设您使用的是使用oauth2客户端ID，该ID可以使用loopback ip地址检索令牌。如果您不是或不确定自己，请访问[oauth2.0 for Mobile＆Desktop Apps]（https://developers.google.com/identity/protocols/oauth2installedappapp）并按照说明创建一个说明新的OAuth2客户端ID将与样本一起使用。

   您可以设置多种身份验证方法来尝试不同的流量，但是请注意，样本将始终使用可以按顺序加载的第一个凭据：

   1. Google应用程序默认凭据
   2. 服务帐户凭据
   3. OAuth2客户凭证

3. 每组样本都使用不同的配置文件。对于用于购物的内容API，以存储库根的示例merchant-info.json以$(HOME)/shopping-samples/content复制。接下来，适当地更改其内容。它包含一个带有以下字段的JSON对象：

   场地	类型	描述
   merchantId	数字	商人中心ID可以运行样本。
   accountSampleUser	细绳	如果非空，则为用户添加/删除Accounts服务的示例中的电子邮件地址。
   accountSampleAdWordsCID	数字	如果非零，则ADWORDS客户ID将在Accounts服务中链接/UNLINK链接/UNLINK。

   对于制造商中心API，以示例manufacturer-info.json示例，并将其复制到$(HOME)/shopping-samples/manufacturers中。接下来，适当地更改其内容。它包含一个带有以下字段的JSON对象：

   场地	类型	描述
   manufacturerId	数字	制造商中心ID可以使用样品。
   websiteUrl	细绳	与制造商中心帐户相关的URL（不拖曳斜线）。

   如果使用OAuth2客户端凭据，则一旦您授权访问，您的令牌详细信息将存储在samples配置目录中的stored-token.json文件中。如果您有任何认证的问题，请删除此文件，并要求您重新授权访问权限。

尝试样品

现在，您已经配置了常见的示例配置文件并设置您的身份验证凭据，现在该构建和运行任何随附的示例了。如前所述，在每个语言子目录中的README中都有特定于语言的说明。玩得开心！

可能的问题

• 在使用内容API购物时，如果您没有在帐户上设置税收设置，则在运行某些样本时可能会出现错误。如果您收到“丢失的税收设置”错误，请在尝试这些样本之前将税收设置设置在商家中心。选择“在美国不收取税款”的设置就足够了。