Google Ads API では、YouTube 動画を Google 広告アカウントにリンクできます。このガイドでは、API を使用してアカウントにリンクを追加、削除する方法について説明します。
動画をリンクする
動画をアカウントにリンクするには、プロセスを開始するユーザーに応じて次の 2 つの方法があります。
- 動画をアカウントにリンクするようリクエストします。この場合、クリエイターにリクエストを送信し、クリエイターがリクエストを承認すると、動画へのリンクが確立されます。リクエストが承認される前に取り消すことも、承認された後にリンクされた動画を削除することもできます。
- 動画のクリエイターが、自分の動画を Google 広告アカウントにリンクするようリクエストします。このリクエストを承認または拒否できます。
各シナリオでは、次のメソッドが使用されます。
| シナリオ | アクション | 備考 |
|---|---|---|
| シナリオ 1 | YouTube API から動画情報を取得する | YouTube API
を使用して、動画リンク リクエストを送信する channel_id、またはリンクする動画の video_id
を取得します。video_id は、動画の URL から "v=" の後の 11 文字を抽出して取得することもできます。 |
| リンク リクエストを作成 |
DataLinkService.CreateDataLink メソッド
を使用して、リンク リクエストを作成します。必要に応じて、
youtube_video.channel_id を指定して動画に関連付けられたチャンネルを明示的に識別したり、youtube_link_metadata.brand_channel_id
を指定してリンクされた YouTube ブランド チャンネルの ID を指定し、クリエイターがお客様のブランドを理解できるようにしたりできます。
status
の DataLink は設定しないでください。API 呼び出しが正常に完了すると、Google Ads 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 チャンネル ID やリンクされた YouTube ブランド チャンネル ID など、YouTube 動画リンクの詳細を取得します。
SELECT
data_link.resource_name,
data_link.status,
data_link.youtube_video.video_id,
data_link.youtube_video.channel_id,
data_link.youtube_link_metadata.brand_channel_id
FROM data_link
WHERE data_link.type = 'VIDEO'
このワークフローでは、次の一般的なエラーが発生する可能性があります。
| エラーコード | 説明 |
|---|---|
DataLinkError.PERMISSION_DENIED |
お客様には、この操作を実行する権限がありません。 |
DataLinkError.YOUTUBE_VIDEO_ID_INVALID |
動画 ID が無効なため、動画リンクを作成できませんでした。 |