Associer YouTube

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 la personne qui lance la procédure :

1. Vous demandez qu'une vidéo soit associée à 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'association avant qu'elle ne soit acceptée, et supprimer une vidéo associée après qu'elle a été acceptée.
2. 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 l'channel_id auquel envoyer la demande d'association de vidéo et l'video_id de la vidéo que vous souhaitez associer. 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 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 à la fois 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 de marque YouTube associée afin d'aider les créateurs à comprendre votre marque. Le champ 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 remplaçant l'status de l' DataLink par REQUESTED au lieu de REVOKED.
	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 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 liens de vidéos YouTube, y compris l'ID de la vidéo YouTube 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 ê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	Renvoyé lorsque l'état actuel de la liaison de données n'est pas valide pour l'opération demandée.
DataLinkError.INVALID_UPDATE_STATUS	Lancé lors d'une tentative de transition d'état non compatible pendant une mise à jour (par exemple, passage direct de REVOKED à ENABLED).
MutateError.RESOURCE_ALREADY_EXISTS	Lancé lorsqu'un lien de données existe déjà pour la vidéo.