Google Ads API 支援將 YouTube 影片連結至 Google Ads 帳戶。本指南說明如何使用 API 新增及移除帳戶連結。
連結影片
視啟動程序的對象而定,影片可透過下列任一方式連結至帳戶:
- 要求將影片連結至帳戶。在這種情況下,您需要向創作者提出要求,對方必須接受,才能建立影片連結。在要求獲得核准前,你可以撤銷延長要求,核准後則可以移除已連結的影片。
- 影片創作者要求將影片連結至您的 Google Ads 帳戶。然後選擇接受或拒絕對方的要求。
每個情境都會使用下列方法:
情境 | 動作 | 附註 |
---|---|---|
情境 1 | 透過 YouTube API 取得影片資訊 | 使用 YouTube API 取得要傳送影片連結要求的 channel_id ,或是要連結的影片 video_id 。你也可以從影片網址中擷取 video_id ,只要找出 "v=" 後的 11 個字元即可。 |
建立連結要求 | 使用
DataLinkService.CreateDataLink 方法建立連結要求。不應設定 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 (拒絕) 要求。 |
這個工作流程可能會擲回下列常見錯誤:
錯誤代碼 | 說明 |
---|---|
DataLinkError.PERMISSION_DENIED |
顧客沒有執行這項操作的權限。 |
DataLinkError.YOUTUBE_VIDEO_ID_INVALID |
影片 ID 無效,因此無法建立影片連結。 |