关联 YouTube

Google Ads API 支持将 YouTube 视频与您的 Google Ads 账号相关联。本指南介绍了如何使用 API 向您的账号添加和移除关联。

关联视频

视频可以通过以下两种方式之一与您的账号相关联，具体取决于谁启动了该流程：

1. 您请求将视频与您的账号相关联。在这种情况下，您需要向创作者发送请求，对方必须接受该请求，才能建立与相应视频的关联。在关联视频被接受之前，您可以撤消已延长的关联请求；在关联视频被接受之后，您也可以将其移除。
2. 视频创作者请求将其视频与您的 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 无效，无法创建视频链接。