关联 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 方法 创建关联请求。您可以选择指定 youtube_video.channel_id，以明确标识与视频 关联的频道。不应设置 DataLink 的 status ；Google Ads API 服务器会在 API 调用成功完成后将其设置为 REQUESTED。
检查请求的状态 使用 GoogleAdsService.SearchStream 或 GoogleAdsService.Search 查询 data_link 资源并检查其 status。
撤销请求 使用 DataLinkService.UpdateDataLink 方法 撤销关联请求，方法是将 status 的 DataLink 从 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。

SELECT
  data_link.resource_name,
  data_link.status,
  data_link.youtube_video.video_id,
  data_link.youtube_video.channel_id
FROM data_link
WHERE data_link.type = 'VIDEO'

在此工作流程中，可能会抛出以下常见错误：

错误代码 说明
DataLinkError.PERMISSION_DENIED 客户无权执行此操作。
DataLinkError.YOUTUBE_VIDEO_ID_INVALID 由于视频 ID 无效，因此无法创建视频关联。
上一页
关联产品账号
下一页
变更状态