L'API Google Ads permet d'associer des vidéos YouTube à votre compte Google Ads. Ce guide explique comment utiliser l'API pour ajouter et supprimer des associations à votre compte.
Associer des vidéos
Il existe deux façons d'associer des vidéos à votre compte, selon qui lance la procédure :
- Vous demandez à associer une vidéo à votre compte. Dans ce scénario, vous envoyez une demande à un créateur, qu'il doit accepter pour établir l'association à sa vidéo. Vous pouvez révoquer une demande d'extension avant qu'elle ne soit acceptée, et supprimer une vidéo associée après qu'elle a été acceptée.
- Le créateur de la vidéo demande à ce qu'elle soit associée à votre compte Google Ads. Vous pouvez ensuite choisir d'accepter ou de refuser sa demande.
Les méthodes suivantes sont utilisées dans chaque scénario :
| Scénario | Action | Remarques |
|---|---|---|
| Scénario 1 | Obtenir les informations sur la vidéo à partir de l'API YouTube | Utilisez l'API YouTube pour obtenir le channel_id auquel envoyer la demande de lien vidéo ou le video_id de la vidéo que vous souhaitez associer. L'video_id peut également être extrait de l'URL d'une vidéo en récupérant les 11 caractères qui suivent "v=". |
| Créer une demande d'association | Utilisez la méthode
DataLinkService.CreateDataLink pour créer une demande d'association. Vous pouvez éventuellement spécifier youtube_video.channel_id pour identifier explicitement la chaîne associée à la vidéo. Le status de DataLink ne doit pas être défini. Le serveur de l'API Google Ads le définira sur REQUESTED une fois l'appel d'API terminé. |
|
| Inspecter l'état d'une requête | Utilisez GoogleAdsService.SearchStream ou GoogleAdsService.Search pour interroger la ressource data_link et inspecter son
status. |
|
| Révoquer une demande | Utilisez la méthode
DataLinkService.UpdateDataLink pour révoquer une demande d'association en modifiant le status de
DataLink de REQUESTED à REVOKED. |
|
| Supprimer une association | Utilisez
DataLinkService.RemoveDataLink pour supprimer une vidéo associée. |
|
| Scénario 2 | Récupérer une invitation | Utilisez GoogleAdsService.Search ou GoogleAdsService.SearchStream pour interroger la ressource data_link. Filtrez sur
status = PENDING_APPROVAL pour trouver les demandes d'association
à accepter ou à refuser. |
| Accepter ou refuser une demande d'association | Utilisez la méthode
DataLinkService.UpdateDataLink pour mettre à jour l'état de DataLink sur ENABLED pour accepter ou REJECTED pour refuser la demande. |
Récupérer les détails de l'association
Vous pouvez utiliser GoogleAdsService.Search ou GoogleAdsService.SearchStream pour interroger la ressource data_link.
La requête suivante récupère les détails des liens vers des vidéos YouTube, y compris l'ID de la chaîne 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'
Les erreurs courantes suivantes peuvent se produire dans ce workflow :
| Code d'erreur | Explication |
|---|---|
DataLinkError.PERMISSION_DENIED |
Le client n'est pas autorisé à effectuer cette action. |
DataLinkError.YOUTUBE_VIDEO_ID_INVALID |
Impossible de créer un lien vers la vidéo, car l'ID de la vidéo n'est pas valide. |