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 collegamenti al tuo account.

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

  1. Richiedi il collegamento di un video 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 e 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. A questo punto, puoi scegliere se accettare o rifiutare la richiesta.

In ogni scenario vengono utilizzati i seguenti metodi:

Scenario Azione Note
Scenario 1 Recuperare le informazioni sul video dall'API di YouTube Utilizza l'API YouTube per ottenere l'channel_id a cui inviare la richiesta di link del video e l'video_id del video che vuoi collegare. L'video_id è la stringa di 11 caratteri che si trova 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 YouTube del brand collegato e aiutare i creator a comprendere il tuo brand. Il valore status di DataLink non deve essere impostato; il server dell'API Google Ads lo imposterà su REQUESTED al completamento della chiamata API.
Controllare 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 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.
Accettare o rifiutare una richiesta di collegamento Utilizza il metodo DataLinkService.UpdateDataLink per aggiornare lo stato di DataLink a ENABLED per accettare o REJECTED per rifiutare la richiesta.

Recuperare i dettagli del collegamento

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 flusso di lavoro 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 collegamento 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 Generata quando esiste già un collegamento ai dati per il video.
Indietro
Collegare gli account del prodotto
Avanti
Modifica stato