设置授权

Search Ads 360 API 要求所有请求指定 OAuth 2.0 访问令牌以进行身份验证。您可以按照任何标准的 OAuth 2.0 身份验证工作流生成令牌，并将其传递给 Search Ads 360 API。我们建议使用下述工作流，因为它适用于完全自动化的转化数据上传和报告下载。

有关下述工作流程的替代方案，请参阅针对安装的应用使用 OAuth 2.0 或针对服务器到服务器的应用使用 OAuth 2.0。如果您使用的是备用工作流，请在请求 OAuth 2.0 授权代码时将以下值指定为 scope 参数：
https://www.googleapis.com/auth/doubleclicksearch
如果您遵循服务器到服务器路由，请将服务帐号添加为 Search Ads 360 用户。

推荐的授权工作流

1. 转到 Google API 控制台，选择您的项目。

   如果您尚未创建 Google API 控制台项目和 OAuth 凭据，请按照为您的客户端创建 Google API 控制台项目和 OAuth 凭据中的说明操作。

   如需查找项目的 OAuth 客户端 ID 和密钥，请执行以下操作：

   1. 打开“凭据”页面。
   2. 在名称列中，点击您的 OAuth 客户端的名称。
   3. 页面中会列出客户端 ID 和密钥。
2. 打开网络浏览器，然后使用有权访问 Search Ads 360 中的数据的 Google 帐号登录 Google。

   这是您的 API 客户端将用于向 Search Ads 360 进行身份验证的 Google 帐号。 如果 Google 帐号持有人已从公司离职，并且您从该帐号中移除了 Search Ads 360 访问权限，则需要重复此授权工作流程并指定其他 Google 帐号。

3. 通过调用 Search Ads 360 实用程序脚本获取刷新令牌，具体操作步骤如下：

   sa360Api.py --login

   该脚本会引导您使用 OAuth 客户端 ID 和密钥获取刷新令牌。刷新令牌仅对您在上一步中登录的 Google 帐号有效。

   在此过程中，脚本会生成一个网址，并指示您在网络浏览器中访问该网址。

4. 当浏览器请求您允许 OAuth 客户端访问 Search Ads 360 数据时，请务必显示您之前登录的 Google 帐号。（如果您登录了多个 Google 帐号，系统可能会向您显示其他帐号。）
   

   在该过程结束时，sa360Api.py 脚本会输出以英文逗号分隔的字符串。第一个值是您提供的客户端 ID，第二个值是您提供的客户端密钥，第三个值是刷新令牌。在以下示例输出中，刷新令牌以粗体文本表示：
   123456789123.apps.googleusercontent.com,ABCDEFGHIJKLMNOPQR_abcdef,1/HIJklM01OPQR23NOP456rst890uvw

5. 将客户端 ID、客户端密钥和刷新令牌存储在您的应用可以访问的后端数据库或其他安全位置。

   如果您打算使用 sa360Api.py 向 Search Ads 360 API 发送 JSON 示例请求，请将整个逗号分隔的字符串保存在方便的位置。每次调用脚本时，您都需要将整个字符串作为参数传递。

6. 向您的应用添加执行以下操作的代码：
   1. 使用客户端 ID、客户端密钥和刷新令牌来获取新的 OAuth 2.0 访问令牌。
   2. 使用新访问令牌向 Search Ads 360 API 发送请求。

   如果您使用的是客户端库，则下一部分设置您的应用介绍了如何将此授权代码添加到您的应用。

   如果您未使用任一客户端库，请参阅针对安装的应用使用 OAuth 2.0，获取获取新访问令牌的建议。