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 due modi, a seconda di chi avvia la procedura:
- 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.
- 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 di YouTube | Utilizza l'API di YouTube
per recuperare il channel_id a cui inviare la richiesta di collegamento del video e il video_id
del video che vuoi collegare. Il 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 sia 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 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 link
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 video e l'ID canale di YouTube:
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 |
Impossibile 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 |
Generato quando esiste già un collegamento dati per il video. |