Vincular o YouTube

A API Google Ads oferece suporte à vinculação de 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:

1. Você pede para um vídeo ser vinculado à sua conta. Nesse cenário, você envia um pedido a um criador de conteúdo, que precisa aceitar para estabelecer o link com o vídeo. É possível revogar um pedido que foi estendido antes de ser aceito e também remover um vídeo vinculado depois que ele for aceito.
2. O criador de conteúdo pede para o vídeo ser vinculado à sua conta do Google Ads. Em seguida, você pode aceitar ou recusar o pedido.

Os métodos a seguir são usados em cada cenário:

Cenário	Ação	Comentários
Cenário 1	Receber as informações do vídeo da API YouTube	Use a API YouTube para receber o channel_id para enviar o pedido de vinculação de vídeo ou o video_id do vídeo que você quer vincular. O video_id também pode ser extraído do URL de um vídeo, buscando os 11 caracteres após "v=".
	Criar um pedido de vinculação	Use o método DataLinkService.CreateDataLink para criar um pedido de vinculação. Opcionalmente, você pode especificar o youtube_video.channel_id para identificar explicitamente o canal associado ao vídeo. O status do DataLink não deve ser definido. O servidor da API Google Ads vai definir esse valor como REQUESTED após a conclusão bem-sucedida da chamada de API.
	Inspecionar o status de um pedido	Use GoogleAdsService.SearchStream ou GoogleAdsService.Search para consultar o recurso data_link e inspecionar o status.
	Revogar um pedido	Use o DataLinkService.UpdateDataLink método para revogar um pedido de vinculação, mudando o status do DataLink de REQUESTED para REVOKED.
	Remover uma vinculação	Use DataLinkService.RemoveDataLink para remover um vídeo vinculado.
Cenário 2	Recuperar um convite	Use GoogleAdsService.Search or GoogleAdsService.SearchStream to query the data_link resource. Filtre por status = PENDING_APPROVAL para encontrar pedidos de vinculação a serem aceitos ou recusados.
	Aceitar ou recusar um pedido de vinculação	Use o DataLinkService.UpdateDataLink método para atualizar o status do DataLink para ENABLED para aceitar ou REJECTED para recusar o pedido.

Recuperar detalhes da vinculação

Você pode usar GoogleAdsService.Search ou GoogleAdsService.SearchStream para consultar o recurso data_link. A consulta a seguir recupera detalhes dos links de vídeos do YouTube, incluindo o ID do canal do YouTube.

SELECT
  data_link.resource_name,
  data_link.status,
  data_link.youtube_video.video_id,
  data_link.youtube_video.channel_id
FROM data_link
WHERE data_link.type = 'VIDEO'

Os erros comuns a seguir podem ocorrer nesse fluxo de trabalho:

Código do erro	Explicação
DataLinkError.PERMISSION_DENIED	O cliente não tem permissão para realizar essa ação.
DataLinkError.YOUTUBE_VIDEO_ID_INVALID	Não foi possível criar um link de vídeo porque o ID do vídeo é inválido.