Display & Video 360 API SDF 上传测试计划

重要提示： 我们已将此小规模测试功能的上传限额从每个广告客户每天 5 个 SDF 提高到 30 个。

此小规模测试可让客户测试新的 Display & Video 360 API Beta 版功能，该功能允许客户使用 Display & Video 360 API 上传结构化数据文件 (SDF)。

此小规模测试允许每个已加入的 Google Cloud 项目每天在每个广告客户下最多上传 30 个 SDF。每个文件最多可包含 10,000 个条目。

如需了解如何使用此小规模测试功能，请参阅我们的上传 SDF 指南。

开始使用

开始使用 Display & Video 360 API 后，请按顺序完成以下步骤，以便使用小规模测试功能。

为您的 Google Cloud 项目注册参与 Beta 版计划

只有已申请并获准参与 Beta 版计划的客户才能使用 Beta 版功能。

警告： 我们目前已停止招募新客户参与此项小规模测试。 我们将拒绝将新应用添加到该测试计划中的请求。

生成 API 密钥

除了标准 Display & Video 360 API 凭据之外，您还必须使用 API 密钥。为您的 Google Cloud 项目生成 API 密钥，以便在客户端配置中使用。

配置客户端

使用 Google API Python 客户端库访问这些小规模测试功能。

以下是安装和配置客户端库以向小规模测试功能发出请求的方法：

Python

1. 安装 google-api-python-client

   pip install --upgrade google-api-python-client
   

2. 导入必要的库。

   from google_auth_oauthlib.flow import InstalledAppFlow
   from googleapiclient import discovery

3. 加载客户端密钥文件并生成授权凭据。

   注意： 首次执行此步骤时，系统会在浏览器中提示您接受授权。接受之前，请务必使用可访问 Display & Video 360 的 Google 账号登录。 您的应用将获得授权，能够代表当前登录的账号访问数据。如需详细了解 Display & Video 360 用户权限，请参阅我们的授权请求指南。

   # Set up a flow object to create the credentials using the
   # client secrets file and OAuth scopes.
   credentials = InstalledAppFlow.from_client_secrets_file(
       path-to-client-secrets-file,
       oauth-scopes).run_local_server()

4. 使用发现服务创建授权服务对象。

   api_key = "API_KEY"
   api_name = "displayvideo"
   api_url = f"https://{api_name}.googleapis.com"
   api_version = "v4"
   api_label = "SDF_UPLOAD_ALPHA"
   
   discovery_url = (
       f"{api_url}/$discovery/rest?key={api_key}&version={api_version}&labels={api_label}"
   )
   
   service = discovery.build(api_name, api_version,
                             discoveryServiceUrl=discovery_url,
                             credentials=credentials)

开始上传 SDF

按照我们的功能指南中的说明开始上传结构化数据文件。