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.
Collegare i video
I video possono essere collegati al tuo account in due modi, a seconda di chi avvia la procedura:
- Richiedi il collegamento di un video al tuo account. In questo caso, 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 anche dopo l'accettazione.
- Il creator del video richiede il collegamento del video 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 | Ottenere le informazioni sul video dall'API di 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 carattere video_id può essere recuperato anche dall'URL di un video estraendo gli 11 caratteri che seguono "v=". |
| Crea una richiesta di collegamento | Utilizza il metodo
DataLinkService.CreateDataLink
per creare una richiesta di collegamento. status
di DataLink non deve essere impostato. Il server dell'API Google Ads lo imposterà su REQUESTED al termine della chiamata dell'API. |
|
| Controllare lo stato di una richiesta | Utilizza GoogleAdsService.SearchStream o GoogleAdsService.Search per eseguire query sulla risorsa data_link
e controllane il
status. |
|
| Revocare 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 | Usa
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
su ENABLED per accettare o REJECTED per rifiutare la
richiesta. |
In questo flusso di lavoro possono verificarsi 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 |
Non è stato possibile creare un link al video perché l'ID video non è valido. |