L'API Google Ads supporta il collegamento di account Google Ads ad altri account del prodotto. Questa guida spiega come utilizzare la versione v16 dell'API per collegare gli account.
Modalità di collegamento degli account
Esistono due modi diversi per collegare un account Google Ads a un altro account del prodotto.
Flusso dell'invito
Il flusso di invito viene utilizzato quando disponi dell'accesso amministrativo all'account Google Ads, ma non a quello 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 a completare la procedura di collegamento dell'account.
- L'amministratore dell'account del prodotto vuole collegare i due account, ma non ha accesso all'account Google Ads. L'amministratore dell'account del prodotto crea un invito; tu accetti l'invito e completi la procedura di collegamento.
In questo scenario vengono utilizzati i seguenti metodi:
| Scenario | Azione | Note |
|---|---|---|
| Scenario 1 | Crea un invito | Utilizza il metodo
ProductLinkInvitationService.CreateProductLinkInvitation
per creare un invito. Non impostare status
di
ProductLinkInvitation. 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
e controllarne lo stato. |
|
| Scenario 2 | Recupera 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 in ACCEPTED o
REJECTED. |
|
| Revocare un invito | Utilizza il metodo
ProductLinkInvitationService.RemoveProductLinkInvitation per
revocare un
ProductLinkInvitation esistente. |
In questo flusso di lavoro possono essere visualizzati i seguenti errori comuni:
| Codice di errore | Spiegazione |
|---|---|
ProductLinkInvitationError.PERMISSION_DENIED |
Il cliente non dispone dell'autorizzazione necessaria per eseguire questa azione. |
ProductLinkError.NO_INVITATION_REQUIRED |
Impossibile creare un invito, poiché l'utente dispone già dell'accesso in qualità di amministratore all'account invitato. L'utente deve utilizzare ProductLinkService per creare direttamente un collegamento attivo. |
Flusso di collegamento diretto
Il flusso di collegamento diretto viene utilizzato quando disponi dell'accesso amministrativo sia all'account Google Ads sia a quello del prodotto. In questo caso, collegherai 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 collegamento attivo | Utilizza
ProductLinkService.createProductLink per creare un
ProductLink. |
| Disattivare un collegamento attivo | Utilizza
ProductLinkService.removeProductLink per rimuovere
un elemento
ProductLink attivo. |
| Recuperare i link attivi | Utilizza
GoogleAdsService.Search o
GoogleAdsService.SearchStream
per eseguire una query sulla risorsa
product_link. |
In questo flusso di lavoro potrebbero essere visualizzati i seguenti errori comuni:
| Codice di errore | Spiegazione |
|---|---|
ProductLinkError.CREATION_NOT_PERMITTED |
È stato tentato un collegamento dell'account utilizzando il flusso di link diretto, ma questa operazione non è supportata a causa della mancanza di autorizzazioni. L'utente deve invece utilizzare
ProductLinkInvitationService
per eseguire il flusso di invito.
|
ProductLinkError.INVITATION_EXISTS |
Impossibile creare un link perché esiste già un invito in attesa. |
Modifiche a AccountLinkService e MerchantCenterLinkService
Se in passato hai utilizzato MerchantCenterLinkService o AccountLinkService per collegare un account Google Ads a un altro account del prodotto, devi eseguire la migrazione dell'applicazione esistente a uno dei flussi di lavoro elencati in precedenza. La seguente tabella mostra lo stato della migrazione:
| Tipo di link | Supportato nei nuovi servizi? | Assistenza disponibile a partire da | Note |
|---|---|---|---|
DataPartnerIdentifier |
Sì | v15 | Esegui la migrazione da MerchantCenterLinkService |
GoogleAdsIdentifier |
Sì | v16 | Esegui la migrazione da AccountLinkService |
MerchantCenterIdentifier |
Sì | v16 | Esegui la migrazione da AccountLinkService |
AdvertisingPartnerIdentifier |
Sì | v16 | Esegui la migrazione da AccountLinkService |
ThirdPartyAppAnalyticsLinkIdentifier |
No | – | Continua a utilizzare AccountLinkService |