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. 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 un lien | 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. |
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. |