Collegare 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 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 richiesta.

In ogni scenario vengono utilizzati i seguenti metodi:

Scenario Azione Note
Scenario 1 Recuperare le informazioni del video dall'API di YouTube Utilizza l'API YouTube per ottenere l'channel_id a cui inviare la richiesta di link al video o l'video_id del video che vuoi collegare. L'video_id può essere estratto anche dall'URL di un video prendendo gli 11 caratteri dopo "v=".
Crea una richiesta di collegamento Utilizza il metodo DataLinkService.CreateDataLink per creare una richiesta di collegamento. Il campo 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.
Revocare 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.

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.