L'API Google Ads supporta il collegamento degli account Google Ads ad altri account di prodotti. Questa guida spiega come utilizzare l'API per collegare i tuoi account.
Modi per collegare gli account
Quando colleghi un account Google Ads a un altro account di un prodotto, il collegamento può avvenire in due modi diversi.
Flusso di invito
Utilizza il flusso di invito se disponi dell'accesso amministrativo all'account Google Ads, ma non all'account del prodotto. Questo flusso funziona in due scenari:
- Vuoi collegare i due account e creare un invito per un amministratore dell'account del prodotto. L'amministratore dell'account del prodotto accetta l'invito per completare la procedura di collegamento degli account.
- L'amministratore dell'account prodotto vuole collegare i due account, ma non ha accesso all'account Google Ads. L'amministratore dell'account del prodotto crea un invito, che tu accetti per completare la procedura di collegamento.
In questo scenario, utilizza i seguenti metodi:
| Scenario | Azione | Note |
|---|---|---|
| Scenario 1 | Crea un invito | Utilizza il metodo
ProductLinkInvitationService.CreateProductLinkInvitation per creare un invito. Il campo status
di
ProductLinkInvitation non deve essere impostato; il server dell'API Google Ads
lo imposterà su REQUESTED al completamento della
chiamata API. Quando crei un invito per un partner pubblicitario (AdvertisingPartnerLinkInvitationIdentifier), advertising_partner_properties.allowed_domain è obbligatorio a partire dalla versione 25 (e facoltativo nella versione 24 e precedenti). |
| Controlla lo stato di un invito | Utilizza GoogleAdsService.Search
o GoogleAdsService.SearchStream
per eseguire query sulla risorsa product_link_invitation
e controllarne lo stato. |
|
| Scenario 2 | Recuperare un invito | Utilizza GoogleAdsService.Search
o GoogleAdsService.SearchStream
per eseguire query sulla risorsa product_link_invitation. Filtra per
status = PENDING_APPROVAL per accettare o rifiutare
un invito in attesa. |
| Accetta o rifiuta un invito | Utilizza il metodo
ProductLinkInvitationService.UpdateProductLinkInvitation per aggiornare lo stato di
ProductLinkInvitation in ACCEPTED o REJECTED. |
|
| Revoca un invito | Utilizza il metodo
ProductLinkInvitationService.RemoveProductLinkInvitation per
revocare un
ProductLinkInvitation esistente. |
In questo workflow possono essere generati i seguenti errori comuni:
| Codice di errore | Spiegazione |
|---|---|
ProductLinkInvitationError.PERMISSION_DENIED |
Il cliente non dispone dell'autorizzazione necessaria per eseguire questa azione. |
ProductLinkInvitationError.NO_INVITATION_REQUIRED |
Non è stato possibile creare un invito perché l'utente dispone già dell'accesso amministrativo all'account invitato. L'utente deve utilizzare ProductLinkService per creare direttamente un link attivo. |
Flusso di collegamento diretto
Utilizza il flusso di collegamento diretto se disponi dell'accesso amministrativo sia all'account Google Ads sia all'account del prodotto. In questo caso, collega direttamente l'account Google Ads all'account del prodotto anziché inviare un invito.
In questo scenario, utilizza i seguenti metodi:
| Azione | Note |
|---|---|
| Crea un link attivo | Utilizza
ProductLinkService.CreateProductLink per creare un
ProductLink. |
| Disattiva un link attivo | Utilizza
ProductLinkService.RemoveProductLink per rimuovere un
ProductLink
attivo. |
| Recupera i link attivi | Utilizza
GoogleAdsService.Search o
GoogleAdsService.SearchStream
per eseguire query sulla risorsa
product_link. |
In questo workflow potrebbero essere generati i seguenti errori comuni:
| Codice di errore | Spiegazione |
|---|---|
ProductLinkError.CREATION_NOT_PERMITTED |
È stato tentato un collegamento dell'account utilizzando il flusso del link diretto, ma questa operazione non è supportata a causa della mancanza di autorizzazioni. L'utente deve utilizzare
ProductLinkInvitationService
per eseguire il flusso di invito.
|
ProductLinkError.INVITATION_EXISTS |
Impossibile creare un collegamento perché esiste già un invito in attesa. |
Recuperare i link ai prodotti esistenti
Puoi recuperare tutti i link ai prodotti associati al tuo account Google Ads utilizzando una query GAQL sulla risorsa product_link.
SELECT
product_link.product_link_id,
product_link.type
FROM product_link
Il campo product_link.type indica il tipo di prodotto o servizio collegato.
A seconda di type, verranno compilati altri campi all'interno della risorsa product_link, fornendo ulteriori dettagli sul link. Ad esempio, se il tipo è
DATA_PARTNER, il campo data_partner conterrà informazioni sull'account
partner di dati collegato.
In questo modo, puoi ottenere un elenco di servizi esterni e account di prodotti collegati direttamente al tuo account Google Ads, ad esempio Merchant Center, Google Ads, partner pubblicitari o partner di dati.
Modifiche a AccountLinkService
Se utilizzi AccountLinkService per collegare un account Google Ads a un altro account di prodotto, devi eseguire la migrazione dell'applicazione esistente a uno dei workflow elencati in precedenza. Per i seguenti tipi di link, esegui la migrazione da AccountLinkService e utilizza ProductLinkService:
Per ThirdPartyAppAnalyticsLinkIdentifier, continua a utilizzare
AccountLinkService.