Google Ads API 支持将 YouTube 视频与您的 Google Ads 账号相关联。本指南介绍了如何使用此 API 添加和移除与您的账号的关联。
关联视频
视频可以通过以下两种方式与您的账号相关联，具体取决于发起关联流程的人员：
- 您请求将某个视频与您的账号相关联。在这种情况下，您需要向创作者发送请求，对方必须接受请求，您才能建立与其视频的关联。您可以在关联的视频被接受之前撤消已延长期限的要求，也可以在关联的视频被接受后移除该视频。
- 视频创作者请求将其视频与您的 Google Ads 账号相关联。然后，您可以选择接受或拒绝他们的请求。
每种场景中都使用以下方法：
| 场景 | 操作 | 备注 |
|---|---|---|
| 场景 1 | 从 YouTube API 获取视频信息 | 使用 YouTube API 获取要将视频关联请求发送到的 channel_id，或要关联的视频的 video_id。您也可以从视频的网址中提取 video_id，方法是提取 "v=" 后面的 11 个字符。 |
| 创建关联请求 | 使用
DataLinkService.CreateDataLink 方法创建关联请求。不应设置 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（拒绝）请求。 |
此工作流程中可能会抛出以下常见错误：
| 错误代码 | 说明 |
|---|---|
DataLinkError.PERMISSION_DENIED |
客户无权执行此操作。 |
DataLinkError.YOUTUBE_VIDEO_ID_INVALID |
由于视频 ID 无效，因此无法创建视频链接。 |