YouTube をリンクする
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
Google Ads API では、YouTube 動画を Google 広告アカウントにリンクできます。このガイドでは、API を使用してアカウントへのリンクを追加、削除する方法について説明します。
動画をリンクする
動画をアカウントにリンクする方法は、プロセスを開始するユーザーに応じて次の 2 つがあります。
- 動画をお客様のアカウントにリンクするようリクエストします。このシナリオでは、クリエイターにリクエストを送信し、クリエイターがリクエストを承認することで、動画へのリンクが確立されます。延長されたリクエストは、承認される前に取り消すことができます。また、リンクされた動画は、承認された後でも削除できます。
- 動画のクリエイターが、動画をお客様の Google 広告アカウントにリンクするようリクエストします。リクエストを承認するか拒否するかを選択できます。
各シナリオでは、次のメソッドが使用されます。
このワークフローでは、次の一般的なエラーが発生する可能性があります。
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-08-27 UTC。
[null,null,["最終更新日 2025-08-27 UTC。"],[],[],null,["# Link YouTube\n\nThe Google Ads API supports linking YouTube videos to your Google Ads account. This guide\nexplains how to use the API to add and remove links to your account.\n\nLink videos\n-----------\n\nVideos can be linked to your account in one of two ways, depending on who starts\nthe process, either:\n\n1. You request that a video is linked to your account. In this scenario, you send a request to a creator, which they must accept in order to establish the link to their video. You can revoke a request that has been extended before it's accepted, and also remove a linked video after it's accepted.\n2. The creator of the video requests that their video is linked to your Google Ads account. You can then choose to accept or reject their request.\n\nThe following methods are used in each scenario:\n\n| Scenario | Action | Remarks |\n| Scenario 1 | Get the video information from the YouTube API | Use the [YouTube API](https://developers.google.com/youtube/v3/docs/channels/list) to get the `channel_id` to send the video link request to, or the `video_id` of the video you want to link. The `video_id` can also be pulled from the URL of a video by pulling the 11 characters after `\"v=\"`. |\n| Scenario 1 |\n| Scenario 1 |\n| Scenario 1 |\n| Scenario 1 |\n|---------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Create a link request | Use the [`DataLinkService.CreateDataLink`](/google-ads/api/reference/rpc/v21/DataLinkService/CreateDataLink) method to create a link request. The [`status`](/google-ads/api/reference/rpc/v21/DataLink#status) of the [`DataLink`](/google-ads/api/reference/rpc/v21/DataLink) shouldn't be set; the Google Ads API server will set this to `REQUESTED` upon the successful completion of the API call. |\n| Inspect the status of a request | Use [`GoogleAdsService.SearchStream`](/google-ads/api/reference/rpc/v21/GoogleAdsService/SearchStream) or [`GoogleAdsService.Search`](/google-ads/api/reference/rpc/v21/GoogleAdsService/Search) to query the [`data_link`](/google-ads/api/fields/v21/data_link) resource and inspect its [`status`](/google-ads/api/fields/v21/data_link#data_link.status). |\n| Revoke a request | Use the [`DataLinkService.UpdateDataLink`](/google-ads/api/reference/rpc/v21/DataLinkService/UpdateDataLink) method to revoke a link request by changing the [`status`](/google-ads/api/reference/rpc/v21/DataLink#status) of the [`DataLink`](/google-ads/api/reference/rpc/v21/DataLink) from `REQUESTED` to `REVOKED`. |\n| Remove a link | Use [`DataLinkService.RemoveDataLink`](/google-ads/api/reference/rpc/v21/DataLinkService/RemoveDataLink) to remove a linked video. |\n| Accept or reject a link request | Use the [`DataLinkService.UpdateDataLink`](/google-ads/api/reference/rpc/v21/DataLinkService/UpdateDataLink) method to update the status of the [`DataLink`](/google-ads/api/reference/rpc/v21/DataLink) to `ENABLED` to accept or `REJECTED` to reject the request. |\n\nThe following common errors can be thrown in this workflow:\n\n| Error code | Explanation |\n|----------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------|\n| [`DataLinkError.PERMISSION_DENIED`](/google-ads/api/reference/rpc/v21/DataLinkErrorEnum.DataLinkError#permission_denied) | The customer doesn't have the permission to perform this action. |\n| [`DataLinkError.YOUTUBE_VIDEO_ID_INVALID`](/google-ads/api/reference/rpc/v21/DataLinkErrorEnum.DataLinkError#youtube_video_id_invalid) | A video link couldn't be created, since the video ID is invalid. |"]]
