Google Ads API 支援將 YouTube 影片連結至 Google Ads 帳戶。本指南說明如何使用 API 新增及移除帳戶連結。
連結影片
影片可以透過下列任一方式連結至你的帳戶，具體取決於誰啟動了這個程序：
- 您要求將影片連結至您的帳戶。在這種情況下，您會向創作者傳送要求，對方必須接受才能建立影片連結。你可以在要求獲得核准前撤銷已延長的期限，也可以在要求獲得核准後移除已連結的影片。
- 影片創作者要求將影片連結至您的 Google Ads 帳戶。接著，你可以選擇接受或拒絕對方的要求。
每個情境都會使用下列方法：
| 情境 | 動作 | 附註 |
|---|---|---|
| 情境 1： | 從 YouTube API 取得影片資訊 | 使用 YouTube API 取得要傳送影片連結要求的 channel_id，或是要連結的影片 video_id。您也可以從影片網址中，將 "v=" 後面的 11 個字元拉出 video_id。 |
| 建立連結要求 | 使用
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 無效，因此無法建立影片連結。 |