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.

I video possono essere collegati al tuo account in due modi, 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 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. Puoi quindi scegliere di accettare o rifiutare la sua richiesta.

In ogni scenario vengono utilizzati i seguenti metodi:

Scenario Azione Note
Scenario 1 Recupera le informazioni sul video dall'API YouTube Utilizza l'API YouTube per recuperare il channel_id a cui inviare la richiesta di collegamento del video o il video_id del video che vuoi collegare. Il video_id può essere estratto dall'URL di un video recuperando gli 11 caratteri dopo "v=".
Crea una richiesta di collegamento Utilizza il DataLinkService.CreateDataLink metodo per creare una richiesta di collegamento. Facoltativamente, puoi specificare il youtube_video.channel_id per identificare in modo esplicito il canale associato al video e il youtube_link_metadata.brand_channel_id per specificare l'ID del canale YouTube del brand collegato per aiutare i creator a comprendere il tuo brand. Lo 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 una query sulla risorsa data_link e controllarne lo status.
Revoca una richiesta Utilizza il DataLinkService.UpdateDataLink metodo per revocare una richiesta di collegamento modificando lo status di DataLink da REQUESTED a REVOKED.
Rimuovi un link Utilizza DataLinkService.RemoveDataLink per rimuovere un video collegato.
Scenario 2 Recupera un invito Utilizza GoogleAdsService.Search o GoogleAdsService.SearchStream per eseguire una 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 DataLinkService.UpdateDataLink metodo per aggiornare lo stato di DataLink a ENABLED per accettare o REJECTED per rifiutare la richiesta.

Recupera i dettagli del collegamento

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

SELECT
  data_link.resource_name,
  data_link.status,
  data_link.youtube_video.video_id,
  data_link.youtube_video.channel_id,
  data_link.youtube_link_metadata.brand_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 per eseguire questa azione.
DataLinkError.YOUTUBE_VIDEO_ID_INVALID Impossibile creare un link al video perché l'ID video non è valido.
Indietro
Collegare gli account del prodotto
Avanti
Modifica stato