L'API Google Ads supporta il collegamento degli account Google Ads ad altri account di prodotto. 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 prodotto, il collegamento può avvenire in due modi diversi.
Flusso di invito
Il flusso di invito viene utilizzato quando 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 prodotto accetta l'invito per completare la procedura di collegamento dell'account.
- L'amministratore dell'account prodotto vuole collegare i due account, ma non ha accesso all'account Google Ads. L'amministratore dell'account 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 metodo
ProductLinkInvitationService.CreateProductLinkInvitation per creare un invito. status
di
ProductLinkInvitation non deve essere impostato; il server dell'API Google Ads lo imposterà su REQUESTED al termine della chiamata dell'API. |
| Controllare lo stato di un invito | Utilizza GoogleAdsService.Search
o GoogleAdsService.SearchStream
per eseguire query sulla risorsa product_link_invitation
e controllane 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. |
| 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 metodo
ProductLinkInvitationService.RemoveProductLinkInvitation per revocare un
ProductLinkInvitation esistente. |
In questo flusso di lavoro possono verificarsi 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 |
Non è stato possibile creare un invito, poiché l'utente ha già accesso amministrativo all'account invitato. L'utente deve utilizzare ProductLinkService per creare direttamente un link attivo. |
Flusso di collegamento diretto
Il flusso di collegamento diretto viene utilizzato quando 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 vengono utilizzati i seguenti metodi:
| Azione | Note |
|---|---|
| Creare un link attivo | Utilizza
ProductLinkService.createProductLink per creare un
ProductLink. |
| Disattivare un link attivo | Usa
ProductLinkService.removeProductLink per rimuovere un
ProductLink attivo. |
| Recuperare i link attivi | Utilizza
GoogleAdsService.Search o
GoogleAdsService.SearchStream
per eseguire query sulla risorsa
product_link. |
In questo flusso di lavoro potrebbero verificarsi i seguenti errori comuni:
| Codice di errore | Spiegazione |
|---|---|
ProductLinkError.CREATION_NOT_PERMITTED |
È stato tentato di collegare un account utilizzando il flusso di collegamento diretto, ma questa operazione non è supportata per mancanza di autorizzazioni. L'utente deve utilizzare
ProductLinkInvitationService
per eseguire il flusso di invito.
|
ProductLinkError.INVITATION_EXISTS |
Non è possibile creare un link perché esiste già un invito in attesa. |
Modifiche ad AccountLinkService
Se utilizzi AccountLinkService per collegare un account Google Ads a un altro account prodotto, devi eseguire la migrazione dell'applicazione esistente a uno dei flussi di lavoro elencati in precedenza. Per i seguenti tipi di link, esegui la migrazione da AccountLinkService
e utilizza ProductLinkService:
GoogleAdsIdentifierMerchantCenterIdentifierAdvertisingPartnerIdentifier
Per ThirdPartyAppAnalyticsLinkIdentifier, continua a utilizzare
AccountLinkService.