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 le processus :
- 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 qui a été étendue 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 à 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 et le video_id de la vidéo que vous souhaitez associer. video_id correspond à la chaîne de 11 caractères figurant dans les URL des vidéos YouTube (par exemple, le paramètre v dans www.youtube.com/watch?v=VIDEO_ID ou le chemin d'accès 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 associée à votre marque et aider les créateurs
à comprendre votre marque.
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 la demande ou sur REJECTED pour la refuser. |
Récupérer les détails d'un lien
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 vidéo et l'ID de la chaîne :
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 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 prise en charge lors d'une mise à jour (par exemple, passer directement de REVOKED à ENABLED). |
MutateError.RESOURCE_ALREADY_EXISTS |
Exception levée lorsqu'un lien de données pour la vidéo existe déjà. |