連結 YouTube

Google Ads API 支援將 YouTube 影片連結至 Google Ads 帳戶。本指南說明如何使用 API 新增及移除帳戶連結。

視啟動程序的人員而定，影片可透過下列任一方式連結至帳戶：

  1. 要求將影片連結至帳戶。在這種情況下，您需要向創作者傳送要求，對方必須接受，才能建立影片連結。延長要求後，你可以在對方接受前撤銷要求，也可以在對方接受後移除連結的影片。
  2. 影片創作者要求將影片連結至您的 Google Ads 帳戶。然後選擇接受或拒絕要求。

每個情境都會使用下列方法：

情境 動作 附註
情境 1 從 YouTube API 取得影片資訊 使用 YouTube API 取得 channel_id，將影片連結要求傳送至該處，並取得要連結的影片 video_id。video_id 是 YouTube 影片網址中的 11 個字元字串 (例如 www.youtube.com/watch?v=VIDEO_ID 中的 v 參數，或 youtu.be/VIDEO_ID 中的路徑)。
建立連結要求 使用 DataLinkService.CreateDataLink 方法 建立連結要求，並指定 youtube_video.channel_id 和 youtube_video.video_id 來識別影片及其相關聯的頻道。從第 24 版開始，您也可以指定 youtube_link_metadata.brand_channel_id 提供連結的 YouTube 品牌頻道 ID，協助創作者瞭解您的品牌。 不應設定 status 的 DataLink，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 和頻道 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 無效，因此無法建立影片連結。
DataLinkError.INVALID_STATUS 當資料連結的目前狀態不適合所要求作業時，就會擲回這個例外狀況。
DataLinkError.INVALID_UPDATE_STATUS 嘗試在更新期間進行不支援的狀態轉換時 (例如直接從 REVOKED 移至 ENABLED) 擲回。
MutateError.RESOURCE_ALREADY_EXISTS 影片的資料連結已存在時擲回。
上一頁
連結產品帳戶
下一頁
變更狀態