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
Vous pouvez associer des vidéos à votre compte de deux manières, selon qui lance le processus :
- Vous demandez à associer une vidéo à votre compte. Dans ce cas, vous envoyez une demande à un créateur, qui doit l'accepter pour établir l'association à sa vidéo. Vous pouvez révoquer une demande qui a été envoyé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 à associer sa vidéo à 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, ainsi que le video_id
de la vidéo que vous souhaitez associer. Le video_id est la chaîne de 11 caractères qui se trouve dans les URL des vidéos YouTube (par exemple, le paramètre v dans www.youtube.com/watch?v=VIDEO_ID ou le chemin dans youtu.be/VIDEO_ID). |
| Créer une demande d'association | Utilisez la méthode
DataLinkService.CreateDataLink
pour créer une demande d’association, en spécifiant
youtube_video.channel_id et youtube_video.video_id
pour identifier la vidéo et la chaîne associée. À partir de la version 24, vous pouvez également spécifier
youtube_link_metadata.brand_channel_id
pour fournir l'ID de la chaîne YouTube de la marque 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 méthode
DataLinkService.UpdateDataLink pour définir l'état
du DataLink
sur ENABLED pour accepter la demande ou sur REJECTED pour la
refuser. |
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 vidéo et 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 ê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. |
DataLinkError.INVALID_STATUS |
Générée lorsque l'état actuel de l'association de données n'est pas valide pour l'opération demandée. |
DataLinkError.INVALID_UPDATE_STATUS |
Générée lors d'une tentative de transition d'état non compatible lors d'une mise à jour (par exemple, passer directement de REVOKED à ENABLED). |
MutateError.RESOURCE_ALREADY_EXISTS |
Générée lorsqu'une association de données pour la vidéo existe déjà. |