Google Ads API 支持将 YouTube 视频与您的 Google Ads 账号相关联。本指南介绍了如何使用 API 向您的账号添加和移除关联。
关联视频
视频可以通过以下两种方式之一与您的账号相关联，具体取决于谁启动了该流程：
- 您请求将视频与您的账号相关联。在这种情况下，您需要向创作者发送请求，对方必须接受该请求，才能建立与相应视频的关联。在延期请求被接受之前，您可以撤消该请求；在延期请求被接受之后，您也可以移除关联的视频。
- 视频创作者请求将其视频与您的 Google Ads 账号相关联。然后，您可以选择接受或拒绝对方的请求。
每种场景中都使用了以下方法：
| 场景 | 操作 | 备注 |
|---|---|---|
| 场景 1 | 从 YouTube API 获取视频信息 | 使用 YouTube API 获取要向其发送视频链接请求的 channel_id 或要链接的视频的 video_id。您还可以从视频的网址中提取 video_id，方法是提取 "v=" 后面的 11 个字符。 |
| 创建关联请求 | 使用
DataLinkService.CreateDataLink 方法
创建关联请求。您可以选择指定 youtube_video.channel_id 以明确标识与视频相关联的频道，并指定 youtube_link_metadata.brand_channel_id 以指定关联的 YouTube 品牌频道的 ID，帮助创作者了解您的品牌。不应设置 DataLink 的 status；Google Ads API 服务器会在 API 调用成功完成后将此属性设置为 REQUESTED。 |
|
| 检查请求的状态 | 使用 GoogleAdsService.SearchStream 或 GoogleAdsService.Search 查询 data_link 资源并检查其
status。 |
|
| 撤销请求 | 使用
DataLinkService.UpdateDataLink 方法，通过将
DataLink 的 status 从 REQUESTED 更改为 REVOKED 来撤消关联请求。 |
|
| 移除链接 | 使用
DataLinkService.RemoveDataLink 移除关联的视频。 |
|
| 情景 2 | 检索邀请 | 使用 GoogleAdsService.Search 或 GoogleAdsService.SearchStream 查询 data_link 资源。过滤
status = PENDING_APPROVAL，以查找要接受或拒绝的关联请求。 |
| 接受或拒绝关联请求 | 使用
DataLinkService.UpdateDataLink 方法将 DataLink 的状态更新为 ENABLED（接受）或 REJECTED（拒绝）请求。 |
检索链接详情
您可以使用 GoogleAdsService.Search 或 GoogleAdsService.SearchStream 查询 data_link 资源。以下查询会检索 YouTube 视频链接的详细信息，包括 YouTube 频道 ID 和关联的 YouTube 品牌频道 ID。
SELECT
data_link.resource_name,
data_link.status,
data_link.youtube_video.video_id,
data_link.youtube_video.channel_id,
data_link.youtube_link_metadata.brand_channel_id
FROM data_link
WHERE data_link.type = 'VIDEO'
此工作流中可能会抛出以下常见错误：
| 错误代码 | 说明 |
|---|---|
DataLinkError.PERMISSION_DENIED |
客户无权执行此操作。 |
DataLinkError.YOUTUBE_VIDEO_ID_INVALID |
由于视频 ID 无效，无法创建视频链接。 |