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:
| Cenário | Ação | Comentários |
|---|---|---|
| Cenário 1 | Receber as informações do vídeo da API YouTube | Use a API do YouTube
para receber o channel_id a que enviar a solicitação de link do 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, pegando os 11 caracteres depois de "v=". |
| Criar um pedido de vinculação | Use o método
DataLinkService.CreateDataLink
para criar um pedido de vinculação. O status da DataLink não deve ser definido. O servidor da API Google Ads vai definir isso como REQUESTED após a conclusão da chamada de 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
e aceitar ou recusar. |
| Aceitar ou recusar um pedido de vinculação | Use o método
DataLinkService.UpdateDataLink para atualizar o status
do DataLink
para ENABLED (aceitar) ou REJECTED (rejeitar) o
pedido. |
Os seguintes erros comuns podem ser gerados 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 é inválido. |