Google Ads API では、YouTube 動画を Google 広告アカウントにリンクできます。このガイドでは、API を使用してアカウントへのリンクを追加、削除する方法について説明します。
動画をリンクする
動画は、プロセスを開始したユーザーに応じて、次のいずれかの方法でアカウントにリンクできます。
- 動画をアカウントにリンクするようリクエストします。このシナリオでは、クリエイターにリクエストを送信します。クリエイターは、動画へのリンクを確立するために、このリクエストを承認する必要があります。承認前に延長されたリクエストを取り消したり、承認後にリンクされた動画を削除したりできます。
- 動画のクリエイターが、動画をお客様の Google 広告アカウントにリンクするようリクエストします。リクエストを承認または拒否できます。
各シナリオでは、次のメソッドが使用されます。
| シナリオ | アクション | 備考 |
|---|---|---|
| シナリオ 1 | YouTube API から動画情報を取得する | YouTube API を使用して、動画リンク リクエストを送信する channel_id またはリンクする動画の video_id を取得します。video_id は、"v=" の後の 11 文字を取得することで、動画の URL から取得することもできます。 |
| リンク リクエストを作成 |
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 が無効であるため、動画リンクを作成できませんでした。 |