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:
- Você solicita a vinculação de um vídeo à sua conta. Nesse cenário, você envia uma solicitação a um criador de conteúdo, que precisa ser aceita para estabelecer a vinculação ao vídeo. É possível revogar uma solicitação que foi estendida antes da aceitação e também remover um vídeo vinculado após a aceitação.
- O criador do vídeo pede que ele 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:
| Cenário | Ação | Comentários |
|---|---|---|
| Cenário 1 | Receber as informações do vídeo da API do YouTube | Use a API do YouTube
para receber o channel_id para enviar a solicitação 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 extraindo os 11 caracteres após "v=". |
| Criar um pedido de vinculação | Use o método
DataLinkService.CreateDataLink
para criar uma solicitação de vinculação. O status
do DataLink não pode
ser definido. O servidor da API Google Ads vai definir esse valor como REQUESTED após a
conclusão da chamada da API. |
|
| Inspecionar o status de uma solicitação | Use GoogleAdsService.SearchStream ou GoogleAdsService.Search para consultar o recurso data_link
e inspecionar o
status. |
|
| Revogar uma solicitação | Use o método
DataLinkService.UpdateDataLink
para revogar uma solicitação de vinculação mudando o status do
DataLink de REQUESTED para REVOKED. |
|
| Remover um link | Use
DataLinkService.RemoveDataLink para remover um vídeo vinculado. |
|
| Cenário 2 | Recuperar um convite | Use GoogleAdsService.Search
ou GoogleAdsService.SearchStream
para consultar o recurso
data_link. Filtre por
status = PENDING_APPROVAL para encontrar pedidos de vinculação
para aceitar ou recusar. |
| Aceitar ou recusar um pedido de vinculação | Use o método
DataLinkService.UpdateDataLink para atualizar o status
do DataLink
em ENABLED para aceitar ou REJECTED para rejeitar a
solicitação. |
Os seguintes erros comuns podem ser gerados neste 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. |