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.
Modalità di collegamento degli account
Quando colleghi un account Google Ads a un altro account di prodotto, esistono due modi diversi in cui può avvenire il collegamento.
Flusso degli inviti
Il flusso degli inviti viene utilizzato quando hai accesso amministrativo all'account Google Ads, ma non all'account di 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 dell'account.
- L'amministratore dell'account di 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 vengono utilizzati i seguenti metodi:
| Scenario | Azione | Note |
|---|---|---|
| Scenario 1 | Creare un invito | Utilizza il
ProductLinkInvitationService.CreateProductLinkInvitation metodo
per creare un invito. Il status
di
ProductLinkInvitation non deve essere impostato; il server dell'API Google Ads
lo imposterà su REQUESTED al completamento
della chiamata API. |
| Esaminare lo stato di un invito | Utilizza GoogleAdsService.Search
o GoogleAdsService.SearchStream
per eseguire una query sulla risorsa product_link_invitation
ed esaminarne lo stato. |
|
| Scenario 2 | Recuperare un invito | Utilizza GoogleAdsService.Search
o GoogleAdsService.SearchStream
per eseguire una query sulla risorsa product_link_invitation. Filtra per
status = PENDING_APPROVAL per accettare o rifiutare
un invito in attesa. |
| Accettare o rifiutare un invito | Utilizza il metodo
ProductLinkInvitationService.UpdateProductLinkInvitation per
aggiornare lo stato di
ProductLinkInvitation su ACCEPTED o
REJECTED. |
|
| Revocare un invito | Utilizza il
ProductLinkInvitationService.RemoveProductLinkInvitation metodo per
revocare un
ProductLinkInvitation esistente. |
In questo flusso possono essere generati i seguenti errori comuni:
| Codice di errore | Spiegazione |
|---|---|
ProductLinkInvitationError.PERMISSION_DENIED |
Il cliente non dispone dell'autorizzazione per eseguire questa azione. |
ProductLinkError.NO_INVITATION_REQUIRED |
Impossibile creare un invito perché l'utente ha già accesso amministrativo all'account invitato. L'utente deve utilizzare ProductLinkService per direttamente creare un link attivo. |
Flusso di collegamento diretto
Il flusso di collegamento diretto viene utilizzato quando hai accesso amministrativo sia all'account Google Ads sia all'account del prodotto. In questo caso, colleghi direttamente l'account Google Ads all'account del prodotto anziché inviare un invito.
In questo scenario vengono utilizzati i seguenti metodi:
| Azione | Note |
|---|---|
| Creare un link attivo | Utilizza
ProductLinkService.CreateProductLink per creare un
ProductLink. |
| Disattivare un link attivo | Utilizza
ProductLinkService.RemoveProductLink per rimuovere un
attivo
ProductLink. |
| Recuperare i link attivi | Utilizza
GoogleAdsService.Search o
GoogleAdsService.SearchStream
per eseguire una query sulla risorsa
product_link. |
In questo flusso possono essere generati i seguenti errori comuni:
| Codice di errore | Spiegazione |
|---|---|
ProductLinkError.CREATION_NOT_PERMITTED |
È stato tentato un collegamento dell'account utilizzando il flusso di collegamento diretto, ma questa
operazione non è supportata a causa della mancanza di autorizzazioni. L'utente deve utilizzare
ProductLinkInvitationService
per eseguire il flusso degli inviti.
|
ProductLinkError.INVITATION_EXISTS |
Impossibile creare un link 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 del type, verranno compilati altri campi all'interno della risorsa product_link, fornendo maggiori dettagli sul link. Ad esempio, se il tipo è THIRD_PARTY_APP_ANALYTICS, il campo third_party_app_analytics conterrà informazioni sul fornitore di analisi.
In questo modo puoi ottenere un elenco di servizi e applicazioni esterni collegati direttamente al tuo account Google Ads, come Google Play, partner di dati o piattaforme di analisi delle app di terze parti.
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 flussi elencati in precedenza. Per i seguenti tipi di link, esegui la migrazione da AccountLinkService e utilizza ProductLinkService:
GoogleAdsIdentifierMerchantCenterIdentifierAdvertisingPartnerIdentifier
Per ThirdPartyAppAnalyticsLinkIdentifier, continua a utilizzare AccountLinkService.