Stay organized with collectionsSave and categorize content based on your preferences.
The Google Ads API supports linking YouTube videos to your Google Ads account. This guide
explains how to use the API to add and remove links to your account.
Link videos
Videos can be linked to your account in one of two ways, depending on who starts
the process, either:
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.
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.
The following methods are used in each scenario:
Scenario
Action
Remarks
Scenario 1
Get the video information from the YouTube API
Use theYouTube APIto get thechannel_idto send the video link request to, or thevideo_idof the video you want to link. Thevideo_idcan also be pulled
from the URL of a video by pulling the 11 characters after"v=".
Create a link request
Use theDataLinkService.CreateDataLinkmethod
to create a link request. Thestatusof theDataLinkshouldn't
be set; the Google Ads API server will set this toREQUESTEDupon the
successful completion of the API call.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-03 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. |"]]
