連結 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，明確指出與影片相關聯的頻道。statusDataLink 不應設定，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 無效，因此無法建立影片連結。