Vincular o YouTube
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
A API Google Ads permite vincular vídeos do YouTube à sua conta do Google Ads. Este guia
explica como usar a API para adicionar e remover links da sua conta.
Vincular vídeos
Os vídeos podem ser vinculados à sua conta de duas maneiras, dependendo de quem inicia o processo:
- Você pede para vincular um vídeo à sua conta. Nesse cenário, você envia um pedido a um criador de conteúdo, que precisa aceitar para estabelecer a vinculação ao vídeo dele. É possível revogar uma solicitação que foi estendida antes de ser aceita e remover um vídeo vinculado depois que ele for aceito.
- O criador de conteúdo pede que o vídeo dele seja vinculado à sua conta do Google Ads. Você pode aceitar ou recusar a solicitação.
Os seguintes métodos são usados em cada cenário:
Os seguintes erros comuns podem ser gerados neste fluxo de trabalho:
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-08-27 UTC.
[null,null,["Última atualização 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. |"]]
