使用 REST API 集成推荐

借助 Google TV Video Discovery REST API,合作伙伴可以从其后端服务器向 Google TV 和 Android TV 设备发送非个性化推荐候选内容。通过从后端发送候选内容,合作伙伴可以在这些设备上保持其目录和直播节目推荐内容的新鲜度,而无需用户打开合作伙伴的应用。

合作伙伴将候选内容发送到推荐 Feed。Google 会为合作伙伴创建每个 Feed,并配置 Feed 的展示国家/地区以及电视设备语言。Feed 可以包含电影、电视节目和直播电视节目。

如果您想从用户设备发布个性化推荐内容,请参阅使用 Engage SDK 在设备上集成推荐内容。

前提条件

在与 REST API 集成之前,请确保您具备以下条件:

  • 用于发出 API 请求的 Google Cloud 项目。
  • 与贵组织关联的 Google Workspace 账号。
  • 您的合作伙伴 ID 和推荐 Feed ID,由您的 Google TV 合作伙伴代表在新手入门过程中提供。如需了解如何使用这些 ID,请参阅推荐 Feed。

获取访问权限

只有注册的 Google TV 媒体合作伙伴才能访问 Google TV Video Discovery REST API。每个调用方都使用 Google Cloud 服务账号进行身份验证,该账号在服务器上正好映射到一个合作伙伴 ID。

如需请求和配置 API 访问权限,请按以下步骤操作:

  1. 创建 Google Workspace 账号。按照 Google Workspace 支持页面上的说明为您的组织设置账号。
  2. 找到您的 Google Workspace 客户 ID。按照查找您的客户 ID 中的步骤查找您的客户 ID(例如 C0123abcd)。
  3. 创建 Google Cloud 项目和服务账号。在 Google Workspace 组织下的 Google Cloud 控制台中,为后端服务器创建一个 Google Cloud 项目和一个服务账号。
  4. 请求合作伙伴新手入门。向您的 Google TV 合作伙伴代表提供您的 Google Workspace 客户 ID、Google Cloud 项目 ID 和服务账号邮箱(或唯一数字 ID),以及您要向其发送候选内容的国家/地区和电视设备语言。您的 Google TV 合作伙伴代表在将您的 Google Workspace 组织、项目和服务账号映射到您的合作伙伴 ID 后会通知您,并向您提供为您的合作伙伴创建的推荐 Feed ID。
  5. 启用 API 并生成凭证。在您的代表确认已授予访问权限后,请在您的 Google Cloud 项目中启用 Google TV Video Discovery API (tvvideodiscovery.googleapis.com),并为您的服务账号生成 OAuth 2.0 凭证。
  6. 对请求进行身份验证。使用以下 OAuth 范围请求 OAuth 2.0 访问令牌,并在每次调用时在 Authorization: Bearer HTTP 标头中传递该令牌:

    https://www.googleapis.com/auth/tvvideodiscovery
    

速率限制

对 replaceCandidates 的请求受以下每个项目的速率限制和每个请求的载荷上限约束:

限制 值
每个 Google Cloud 项目每分钟的请求数 5
每个 Google Cloud 项目每天的请求数 100
每次请求 RecommendationCandidate 项 1-25

对预演 Feed 的请求与对相应商品 Feed 的请求计入同一配额。

推荐 Feed

该 API 会将推荐候选内容整理到推荐 Feed 中。Feed 由采用以下格式的资源名称标识:

partners/{partner}/recommendationsFeeds/{recommendationsFeed}

合作伙伴

{partner} 是 Google 在初始配置期间为您分配的合作伙伴 ID。您用于进行身份验证的服务账号仅映射到一个合作伙伴 ID。指定任何其他合作伙伴的请求都会失败,并显示 403 PERMISSION_DENIED。

Feed ID

{recommendationsFeed} 是 Google 在初始配置期间为您创建的 Feed ID。您无法使用 API 创建 Feed。

每个 Feed 都定位到 Google 在创建 Feed 时配置的受众群体:

  • 国家或地区:展示 Feed 候选内容的国家或地区。
  • 电视设备语言:目标用户在其电视设备上设置的语言。这不是您发送的文本所用的语言。如需提供多种语言的文本,请参阅 LocalizedString。

Google 会决定 Feed 的候选内容在 Google TV 和 Android TV 设备上的显示位置。您以相同的方式向每个 Feed 发送候选内容。

暂存 Feed

每个 Feed 都有一个名为 {recommendationsFeed}-staging 的匹配预演 Feed。预演 Feed 仅提供给许可清单中的测试账号。在将候选职位发送到生产 Feed 之前,请使用此工具验证集成。

预演 Feed 与正式 Feed 使用相同的端点、凭据、请求验证和配额。只有受众群体不同。

替换

Feed 是替换单位。每次 replaceCandidates 调用都会替换之前为该 Feed 存储的所有候选内容,并使所有其他 Feed 保持不变。

替换建议候选对象

使用 partners.recommendationsFeeds.replaceCandidates 方法发送一个 Feed 的完整推荐候选列表。

HTTP 请求

POST https://tvvideodiscovery.googleapis.com/v1/{name=partners/*/recommendationsFeeds/*}:replaceCandidates

网址路径包含要替换其候选对象的 Feed 的资源名称。请求正文包含不属于网址路径的所有字段。

路径参数

参数 说明
name 必需。Feed 的资源名称,格式为 partners/{partner}/recommendationsFeeds/{recommendationsFeed}。{partner} 必须是您的服务账号映射到的合作伙伴 ID。{recommendationsFeed} 必须是 Google 为该合作伙伴创建的 Feed ID,或带有 -staging 后缀的 Feed ID。

ReplaceCandidatesRequest

JSON 请求正文具有以下结构:

字段 类型 是否必需 说明
recommendation_candidates array of RecommendationCandidate 是 包含 1 到 25 个 RecommendationCandidate 项的列表。这些候选内容会替换 Feed 的当前候选内容。

候选架构

recommendation_candidates 中的每个项都是一个 RecommendationCandidate 对象,其中包含一个候选类型载荷、可选推荐原因和可选展示播出时段。

RecommendationCandidate

RecommendationCandidate 对象正好包含一个媒体类型载荷字段、可选的推荐原因和可选的可用性时间间隔。

联合字段 candidate_type

candidate_type 为必填项:请设置以下字段中的一个。这些字段是互斥的,如果候选者未设置任何字段或设置了多个字段,则会被拒绝。JSON 中没有 candidate_type 键;直接在 RecommendationCandidate 对象上设置所选字段。

字段 类型 说明
movie_candidate MovieCandidate 点播电影(请参阅 MovieCandidate)。
tv_show_candidate TvShowCandidate 节目级别的电视节目(请参阅 TvShowCandidate)。
live_tv_program_candidate LiveTvProgramCandidate 预定的直播电视广播或直播活动(请参阅 LiveTvProgramCandidate)。

背景信息和适用范围

这两个字段均为选填字段:

字段 类型 是否必需 说明
recommendation_contexts array of RecommendationContext 否 推荐候选网络的原因,以及每个原因的适用时长(请参阅 RecommendationContext)。
availability_intervals array of Interval 否 可展示候选广告的时间范围(请参阅 Interval)。每个时间范围都从其 start_time(含)开始,到其 end_time(不含)结束。如果未设置,则只要候选内容处于存储状态,就符合条件。如果候选广告的所有时间范围都已过去,则该广告永远不会展示。

MovieCandidate

MovieCandidate 对象代表点播电影:

字段 类型 是否必需 说明
title LocalizedString 是 影片的片名(请参阅 LocalizedString)。每个值包含 1 到 100 个 Unicode 码位,并会按发送时的原样显示。
description LocalizedString 是 电影的简短说明(请参阅 LocalizedString)。每个值包含 1 到 400 个 Unicode 码位。
localized_media_images array of LocalizedMediaImage 是 16:9 封面图片,每种语言一个条目(请参阅 LocalizedMediaImage)。必须至少包含一张图片。提供可用的最大来源;建议使用 1920x1080 像素。
localized_provider_playback_uris array of LocalizedProviderPlaybackUri 是 每个平台和每种语言的深层链接(请参阅 LocalizedProviderPlaybackUri)。至少有一个条目必须列出 PLATFORM_ANDROID_TV。
release_date Date 是 电影的上映日期(请参阅 Date)。
external_entity_ids array of ExternalEntityId 否 用于实体匹配的外部目录标识符(请参阅 ExternalEntityId)。每个标识符类型最多一个条目。
duration string (Duration) 否 电影时长(请参阅 Duration)。例如,"7200s" 表示 2 小时。
content_ratings array of ContentRating 否 官方内容分级(请参阅 ContentRating)。

TvShowCandidate

TvShowCandidate 对象表示节目级别的电视节目。Google TV 和 Android TV 设备会显示该节目的卡片;使用深层链接可决定是在节目页面上开始播放,还是播放特定剧集。

字段 类型 是否必需 说明
title LocalizedString 是 电视节目的标题(请参阅 LocalizedString)。每个值包含 1 到 100 个 Unicode 码位,并按发送时的原样显示。
description LocalizedString 是 电视节目的简短说明(请参阅 LocalizedString)。每个值包含 1 到 400 个 Unicode 码位。
localized_media_images array of LocalizedMediaImage 是 16:9 封面图片,每种语言一个条目(请参阅 LocalizedMediaImage)。必须至少包含一张图片。提供可用的最大来源;建议使用 1920x1080 像素。
localized_provider_playback_uris array of LocalizedProviderPlaybackUri 是 每个平台和每种语言的深层链接(请参阅 LocalizedProviderPlaybackUri)。至少有一个条目必须列出 PLATFORM_ANDROID_TV。uri 可以指向节目页面或某一集。
first_episode_air_date Date 是 第一集的播出日期(请参阅 Date)。
external_entity_ids array of ExternalEntityId 否 用于实体匹配的外部目录标识符(请参阅 ExternalEntityId)。每个标识符类型最多一个条目。
season_count integer (int32) 否 您的服务中提供的剧季数。
content_ratings array of ContentRating 否 官方内容分级(请参阅 ContentRating)。

LiveTvProgramCandidate

LiveTvProgramCandidate 对象代表已安排的直播电视广播或直播活动。广播窗口是候选卡片的一部分,与父级候选卡片的 availability_intervals 分开,后者控制卡片的显示时间。

字段 类型 是否必需 说明
title LocalizedString 是 直播电视节目的标题(请参阅 LocalizedString)。每个值包含 1 到 100 个 Unicode 码位,并按发送时的原样显示。
description LocalizedString 是 直播电视节目的简短说明(请参阅 LocalizedString)。每个值包含 1 到 400 个 Unicode 码位。
localized_media_images array of LocalizedMediaImage 是 16:9 封面图片,每种语言一个条目(请参阅 LocalizedMediaImage)。必须至少包含一张图片。提供可用的最大来源;建议使用 1920x1080 像素。
localized_provider_playback_uris array of LocalizedProviderPlaybackUri 是 每个平台和每种语言的深层链接(请参阅 LocalizedProviderPlaybackUri)。至少有一个条目必须列出 PLATFORM_ANDROID_TV。
broadcast_interval Interval 是 节目的开始和结束时间(请参阅 Interval)。start_time 和 end_time 均为必填项。
external_entity_ids array of ExternalEntityId 否 用于实体匹配的外部目录标识符(请参阅 ExternalEntityId)。每个标识符类型最多一个条目。
content_ratings array of ContentRating 否 官方内容分级(请参阅 ContentRating)。

支持架构

候选载荷会引用以下共享对象,以获取本地化文本、深层链接、图片、外部标识符、推荐原因、显示间隔、内容分级以及众所周知的日期和时间类型。

LocalizedString

LocalizedString 对象包含一种或多种语言的相同文本。 每个值都带有语言标记,以便 Google TV 和 Android TV 设备可以显示与用户的 TV 设备语言相匹配的文本:

字段 类型 是否必需 说明
values array of LocalizedText 是 您提供的每种语言的文本(请参阅 LocalizedText)。必须至少包含一个值。

LocalizedText

LocalizedText 对象是单一语言的文本:

字段 类型 是否必需 说明
text string 是 采用 language_code 指定语言的文本。
language_code string 是 text 的 BCP-47 语言代码,例如 "en-US" 或 "sr-Latn"。

LocalizedMediaImage

LocalizedMediaImage 对象将图片与图片中任何文本的语言配对:

字段 类型 是否必需 说明
language_code string 是 图片中文字的 BCP-47 语言代码,例如 "en-US" 或 "sr-Latn"。
image MediaImage 是 16:9 图片(请参阅 MediaImage)。请提供可用的最大来源;建议使用 1920x1080 像素。

LocalizedProviderPlaybackUri

LocalizedProviderPlaybackUri 对象会将深层链接与它打开的内容的语言以及打开它的应用配对:

字段 类型 是否必需 说明
playback_uri PlaybackUri 是 深层链接及其适用的平台(请参阅 PlaybackUri)。
language_code string 是 深层链接打开的内容的 BCP-47 语言代码,例如 "en-US" 或 "sr-Latn"。
package_name string 是 用于打开深层链接的 Android 应用软件包名称(例如 "com.example.tvapp")。

PlaybackUri

PlaybackUri 对象定义了深层链接及其目标平台:

字段 类型 是否必需 说明
uri string 是 用于在您的应用中开始播放候选内容的深层链接 URI。
platforms array of string (enum) 是 此深层链接适用的平台。允许使用的值有:PLATFORM_UNSPECIFIED、PLATFORM_ANDROID_TV、PLATFORM_ANDROID、PLATFORM_IOS。为 Google TV 和 Android TV 设备添加 PLATFORM_ANDROID_TV。

MediaImage

MediaImage 对象指定图片网址、其像素尺寸和无障碍文本:

字段 类型 是否必需 说明
url string 是 可公开访问的图片 HTTPS 网址。
width integer 是 未修改(最大)图片宽度(以像素为单位)。
height integer 是 未修改(最大)图片高度(以像素为单位)。
accessibility_text string 是 描述图片的无障碍(替代)文本。

ExternalEntityId

ExternalEntityId 对象会将候选对象映射到外部目录中的标识符。为每个条目设置以下字段中的一个,并且在候选人的 external_entity_ids 列表中,每个标识符类型最多包含一个条目:

字段 类型 是否必需 说明
tms_root_id string 以下权限之一: Gracenote TMS 根 ID。标识标题:电影、电视节目或剧集。
tms_id string 以下权限之一: Gracenote TMS 变体 ID。标识版本或广播列表。
data_feed_element_id string 以下权限之一: 媒体操作数据 Feed 中的实体 ID。此值与资源名称的 {recommendationsFeed} 段无关。

RecommendationContext

RecommendationContext 对象说明了推荐候选对象的原因以及该说明的适用时长:

字段 类型 是否必需 说明
recommendation_reason RecommendationReason 否 推荐候选人的原因(请参阅 RecommendationReason)。
validity_interval Interval 否 此上下文适用的时间范围(请参阅 Interval)。例如,候选内容仅在有限的天数内是新内容。如果未设置,则只要候选内容存储在系统中,上下文就会一直适用。

RecommendationReason

RecommendationReason 对象包含一个原因。请设置以下字段之一:

字段 类型 是否必需 说明
top_on_partner object 以下权限之一: 候选内容是您服务中排名靠前的商品。包含一个正整数型字段 rank(例如,{"rank": 1} 表示“合作伙伴排名第一”)。
popular_on_partner object 以下权限之一: 候选内容在您的服务中很受欢迎。传递空对象 ({})。
new_on_partner object 以下权限之一: 候选人是您服务的新用户。传递空对象 ({})。
generic object 以下权限之一: 自定义原因。包含单个 LocalizedString 字段 generic_reason(请参阅 LocalizedString)。每个值包含 1 到 100 个 Unicode 码位。

ContentRating

ContentRating 对象表示由分级机构指定的官方内容分级:

字段 类型 是否必需 说明
rating_system string 是 分级机构或系统,例如 "MPAA"、"BBFC" 或 "CBFC"。
rating_value string 是 rating_system 定义的分级,例如 "PG-13" 或 "U/A 13+"。

Timestamp

Timestamp 在 JSON 中编码为采用世界协调时间 (UTC) 且带有 Z 后缀的 RFC 3339 字符串,例如 "2026-10-01T18:00:00Z"。允许使用秒数的小数部分,例如 "2026-10-01T18:00:00.500Z"。

Duration

Duration 在 JSON 中编码为包含秒数后跟后缀 s 的字符串,例如 "7200s" 表示 2 小时。允许使用秒的小数部分,例如 "5400.5s"。

Date

Date 是不带时区的日历日期。它在 JSON 中编码为具有以下字段的对象:

字段 类型 是否必需 说明
year integer 是 日期中的年份,例如 2025。
month integer 否 一年中的月份,从 1 到 12。如果月份未知,请设置为 0 或省略。
day integer 否 日期,从 1 到 31,并且对给定的年份和月份有效。如果日期不明,请设置为 0 或省略。需要 month。

例如,{"year": 2025, "month": 1, "day": 17} 表示 2025 年 1 月 17 日,{"year": 2025, "month": 1} 表示 2025 年 1 月(日期未知),{"year": 2025} 表示 2025 年的某个日期(月份和日期未知)。

Interval

Interval 是一个半开时间范围,开始于 start_time(含),结束于 end_time(不含)。当 start_time <= T 且 T < end_time 时,时间 T 位于该时间间隔内。

字段 类型 是否必需 说明
start_time string (Timestamp) 是 时间窗口的开始时间(含)(请参阅 Timestamp),例如 "2026-10-01T18:00:00Z"。
end_time string (Timestamp) 是 窗口的结束时间(不含,请参阅 Timestamp),例如 "2026-10-01T21:00:00Z"。必须晚于 start_time。

示例请求

以下示例将合作伙伴 example-partner 的 Feed in-en-cricket 的候选内容替换为三个候选内容(一部电影、一个电视节目和一个直播电视节目)。该电影的文本有两种语言:

curl -X POST \
  "https://tvvideodiscovery.googleapis.com/v1/partners/example-partner/recommendationsFeeds/in-en-cricket:replaceCandidates" \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json; charset=utf-8" \
  -d '{
    "recommendation_candidates": [
      {
        "movie_candidate": {
          "title": {
            "values": [
              {
                "text": "Example Action Movie",
                "language_code": "en-US"
              },
              {
                "text": "Película de acción de ejemplo",
                "language_code": "es-419"
              }
            ]
          },
          "description": {
            "values": [
              {
                "text": "An example action movie synopsis.",
                "language_code": "en-US"
              },
              {
                "text": "Sinopsis de una película de acción de ejemplo.",
                "language_code": "es-419"
              }
            ]
          },
          "localized_media_images": [
            {
              "language_code": "en-US",
              "image": {
                "url": "https://www.example.com/images/movie-1001-16x9-en.jpg",
                "width": 1920,
                "height": 1080,
                "accessibility_text": "Artwork for Example Action Movie"
              }
            },
            {
              "language_code": "es-419",
              "image": {
                "url": "https://www.example.com/images/movie-1001-16x9-es.jpg",
                "width": 1920,
                "height": 1080,
                "accessibility_text": "Imagen de Película de acción de ejemplo"
              }
            }
          ],
          "localized_provider_playback_uris": [
            {
              "playback_uri": {
                "uri": "https://www.example.com/watch/movie-1001?lang=en",
                "platforms": ["PLATFORM_ANDROID_TV", "PLATFORM_ANDROID"]
              },
              "language_code": "en-US",
              "package_name": "com.example.tvapp"
            },
            {
              "playback_uri": {
                "uri": "https://www.example.com/watch/movie-1001?lang=es",
                "platforms": ["PLATFORM_ANDROID_TV", "PLATFORM_ANDROID"]
              },
              "language_code": "es-419",
              "package_name": "com.example.tvapp"
            }
          ],
          "release_date": {
            "year": 2025,
            "month": 11,
            "day": 14
          },
          "external_entity_ids": [
            {
              "tms_root_id": "MV001234560000"
            }
          ],
          "duration": "7200s",
          "content_ratings": [
            {
              "rating_system": "MPAA",
              "rating_value": "PG-13"
            }
          ]
        },
        "recommendation_contexts": [
          {
            "recommendation_reason": {
              "top_on_partner": {
                "rank": 1
              }
            }
          }
        ],
        "availability_intervals": [
          {
            "start_time": "2026-11-01T00:00:00Z",
            "end_time": "2026-12-01T00:00:00Z"
          }
        ]
      },
      {
        "tv_show_candidate": {
          "title": {
            "values": [
              {
                "text": "Example Drama Series",
                "language_code": "en-US"
              }
            ]
          },
          "description": {
            "values": [
              {
                "text": "An example drama series synopsis.",
                "language_code": "en-US"
              }
            ]
          },
          "localized_media_images": [
            {
              "language_code": "en-US",
              "image": {
                "url": "https://www.example.com/images/show-2002-16x9.jpg",
                "width": 1920,
                "height": 1080,
                "accessibility_text": "Artwork for Example Drama Series"
              }
            }
          ],
          "localized_provider_playback_uris": [
            {
              "playback_uri": {
                "uri": "https://www.example.com/watch/show-2002",
                "platforms": ["PLATFORM_ANDROID_TV"]
              },
              "language_code": "en-US",
              "package_name": "com.example.tvapp"
            }
          ],
          "first_episode_air_date": {
            "year": 2024,
            "month": 3,
            "day": 8
          },
          "external_entity_ids": [
            {
              "data_feed_element_id": "show-2002"
            }
          ],
          "season_count": 3,
          "content_ratings": [
            {
              "rating_system": "TV_PG",
              "rating_value": "TV-14"
            }
          ]
        },
        "recommendation_contexts": [
          {
            "recommendation_reason": {
              "new_on_partner": {}
            },
            "validity_interval": {
              "start_time": "2026-11-01T00:00:00Z",
              "end_time": "2026-11-15T00:00:00Z"
            }
          }
        ],
        "availability_intervals": [
          {
            "start_time": "2026-11-01T00:00:00Z",
            "end_time": "2026-12-01T00:00:00Z"
          }
        ]
      },
      {
        "live_tv_program_candidate": {
          "title": {
            "values": [
              {
                "text": "Championship Live Broadcast",
                "language_code": "en-US"
              }
            ]
          },
          "description": {
            "values": [
              {
                "text": "Live coverage of the championship match.",
                "language_code": "en-US"
              }
            ]
          },
          "localized_media_images": [
            {
              "language_code": "en-US",
              "image": {
                "url": "https://www.example.com/images/live-prog-500-16x9.jpg",
                "width": 1920,
                "height": 1080,
                "accessibility_text": "Artwork for Championship Live Broadcast"
              }
            }
          ],
          "localized_provider_playback_uris": [
            {
              "playback_uri": {
                "uri": "https://www.example.com/live/sports-1",
                "platforms": ["PLATFORM_ANDROID_TV"]
              },
              "language_code": "en-US",
              "package_name": "com.example.tvapp"
            }
          ],
          "broadcast_interval": {
            "start_time": "2026-11-15T18:00:00Z",
            "end_time": "2026-11-15T21:00:00Z"
          },
          "external_entity_ids": [
            {
              "tms_id": "EP012345670001"
            }
          ],
          "content_ratings": [
            {
              "rating_system": "TV_PG",
              "rating_value": "TV-PG"
            }
          ]
        },
        "recommendation_contexts": [
          {
            "recommendation_reason": {
              "generic": {
                "generic_reason": {
                  "values": [
                    {
                      "text": "Live this weekend",
                      "language_code": "en-US"
                    }
                  ]
                }
              }
            }
          }
        ],
        "availability_intervals": [
          {
            "start_time": "2026-11-14T18:00:00Z",
            "end_time": "2026-11-15T21:00:00Z"
          }
        ]
      }
    ]
  }'

响应和替换行为

本部分介绍了 replaceCandidates 返回的 HTTP 响应,以及每次调用如何更新存储的候选对象。

ReplaceCandidatesResponse

如果请求成功,API 会返回 HTTP 200 OK 以及 ReplaceCandidatesResponse 正文:

字段 类型 说明
replaced_candidates_count integer (int32) 已替换的候选集数量。

对于上述示例请求,响应如下:

{
  "replaced_candidates_count": 3
}

替换行为

了解 replaceCandidates 如何更新存储的候选凭据对于设计集成至关重要:

  • 按 Feed 完全替换。每次调用都会完全替换网址路径中指定的 Feed 之前存储的候选列表。请始终发送该 Feed 的完整有效候选集。
  • 其他 Feed 保持不变。您未向其发送候选内容的 Feed 将保持不变,直到您发送候选内容。例如,替换一个 Feed 的候选内容不会修改任何其他 Feed 的存储候选内容,替换 {recommendationsFeed}-staging 的候选内容不会修改 {recommendationsFeed}。
  • 每个 Feed 调用一次。如需更新多个 Feed,请为每个 Feed 发出一个调用。这些调用是独立的:如果其中一个调用失败,其他 Feed 会保留其新候选内容,您只需重试失败的调用。
  • 至少每 30 天重新发送一次有效 Feed。即使 Feed 的目录未发生变化,也请至少每 30 天重新发送一次每个有效 Feed(或按照每日或每周的常规时间表,并加入随机抖动),以便您的候选内容保持有效状态且不会过期。将 availability_intervals end_time 设置为遥远的未来时间并不能取代定期重新发送。
  • 原子执行。API 会以原子方式应用请求。如果任何候选内容未能通过验证,API 会拒绝整个请求,并且 Feed 会保留其之前的候选内容。