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 différentes, 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 qui a été prolongée avant d'être acceptée, et supprimer une vidéo associée après son acceptation.
- 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 l'channel_id à laquelle envoyer la demande de lien vidéo ou l'video_id de la vidéo que vous souhaitez associer. Vous pouvez également extraire le video_id de l'URL d'une vidéo en extrayant 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 à la fin de l'appel d'API. | |
| 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 requête | Utilisez la méthode DataLinkService.UpdateDataLink pour révoquer une requête d'association en remplaçant REQUESTED par REVOKED dans status de DataLink. | |
| Dissocier vos comptes | 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 par 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 requête. |
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 de la vidéo n'est pas valide. |