Collega YouTube

L'API Google Ads supporta il collegamento dei video di YouTube al tuo account Google Ads. Questa guida spiega come utilizzare l'API per aggiungere e rimuovere i link al tuo account.

Collega video

I video possono essere collegati al tuo account in uno dei due modi seguenti, a seconda di chi avvia la procedura:

1. Richiedi che un video venga collegato al tuo account. In questo scenario, invii una richiesta a un creator, che deve accettarla per stabilire il collegamento al suo video. Puoi revocare una richiesta che è stata estesa prima che venga accettata, nonché rimuovere un video collegato dopo che è stato accettato.
2. Il creator del video richiede che il suo video venga collegato al tuo account Google Ads. Puoi quindi scegliere di accettare o rifiutare la richiesta.

In ogni scenario vengono utilizzati i seguenti metodi:

Scenario	Azione	Note
Scenario 1	Recupera le informazioni sul video dall'API di YouTube	Utilizza l'API di YouTube per ottenere l'channel_id a cui inviare la richiesta di collegamento del video e l'video_id del video che vuoi collegare. video_id è la stringa di 11 caratteri presente negli URL dei video di YouTube (ad esempio, il parametro v in www.youtube.com/watch?v=VIDEO_ID o il percorso in youtu.be/VIDEO_ID).
	Crea una richiesta di collegamento	Utilizza il metodo DataLinkService.CreateDataLink per creare una richiesta di collegamento, specificando sia youtube_video.channel_id che youtube_video.video_id per identificare il video e il canale associato. A partire dalla versione 24, puoi anche specificare youtube_link_metadata.brand_channel_id per fornire l'ID del canale del brand YouTube collegato per aiutare i creator a comprendere il tuo brand. Il campo status di DataLink non deve essere impostato. Il server dell'API Google Ads lo imposterà su REQUESTED al completamento della chiamata API.
	Controlla lo stato di una richiesta	Utilizza GoogleAdsService.SearchStream o GoogleAdsService.Search per eseguire query sulla risorsa data_link e ispezionare il relativo status.
	Revoca una richiesta	Utilizza il metodo DataLinkService.UpdateDataLink per revocare una richiesta di collegamento modificando il valore status di DataLink da REQUESTED a REVOKED.
	Rimuovere un link	Utilizza DataLinkService.RemoveDataLink per rimuovere un video collegato.
Scenario 2	Recuperare un invito	Utilizza GoogleAdsService.Search o GoogleAdsService.SearchStream per eseguire query sulla risorsa data_link. Filtra per status = PENDING_APPROVAL per trovare le richieste di collegamento da accettare o rifiutare.
	Accetta o rifiuta una richiesta di collegamento	Utilizza il metodo DataLinkService.UpdateDataLink per aggiornare lo stato di DataLink su ENABLED per accettare o REJECTED per rifiutare la richiesta.

Recupera i dettagli del link

Puoi utilizzare GoogleAdsService.Search o GoogleAdsService.SearchStream per eseguire query sulla risorsa data_link. La seguente query recupera i dettagli dei link ai video di YouTube, inclusi l'ID video di YouTube e l'ID canale:

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'

In questo workflow possono essere generati i seguenti errori comuni:

Codice di errore	Spiegazione
DataLinkError.PERMISSION_DENIED	Il cliente non dispone dell'autorizzazione necessaria per eseguire questa azione.
DataLinkError.YOUTUBE_VIDEO_ID_INVALID	Non è stato possibile creare un link al video perché l'ID video non è valido.
DataLinkError.INVALID_STATUS	Generato quando lo stato attuale del link dati non è valido per l'operazione richiesta.
DataLinkError.INVALID_UPDATE_STATUS	Generato quando si tenta una transizione di stato non supportata durante un aggiornamento (ad esempio, il passaggio diretto da REVOKED a ENABLED).
MutateError.RESOURCE_ALREADY_EXISTS	Generato quando esiste già un link ai dati per il video.