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
Les vidéos peuvent être associées à votre compte de deux manières, selon qui lance le processus :
- Vous demandez qu'une vidéo soit associée à votre compte. Dans ce cas, vous envoyez une demande à un créateur, qu'il doit accepter pour établir l'association à sa vidéo. Vous pouvez révoquer une demande qui a été prolongée avant qu'elle ne soit acceptée, et également supprimer une vidéo associée après qu'elle a été acceptée.
- Le créateur de la vidéo demande que sa vidéo 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 d'association de la vidéo ou le video_id
de la vidéo que vous souhaitez associer. Le video_id peut également être extrait
de l'URL d'une vidéo en récupérant les 11 caractères après "v=". |
| Créer une demande d'association | Utilisez la
DataLinkService.CreateDataLink méthode
pour créer une demande d'association. Vous pouvez éventuellement spécifier le
youtube_video.channel_id pour identifier explicitement la chaîne
associée à la vidéo, et le youtube_link_metadata.brand_channel_id
pour spécifier l'ID de la chaîne de marque YouTube associée afin d'aider les créateurs à comprendre votre marque. Le
status
du 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 demande | 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 remplaçant le status du
DataLink par REQUESTED par 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
DataLinkService.UpdateDataLink méthode pour définir l'état
du DataLink
sur ENABLED pour accepter ou sur 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 associations de vidéos YouTube, y compris l'ID de la chaîne YouTube et l'ID de la chaîne de marque YouTube associée.
SELECT
data_link.resource_name,
data_link.status,
data_link.youtube_video.video_id,
data_link.youtube_video.channel_id,
data_link.youtube_link_metadata.brand_channel_id
FROM data_link
WHERE data_link.type = 'VIDEO'
Les erreurs courantes suivantes peuvent être générées 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 vidéo, car l'ID vidéo n'est pas valide. |