Eseguire la migrazione del collegamento degli account

La gestione delle relazioni tra account si è evoluta da un unico metodo link nell'API Content for Shopping a un sistema più granulare ed esplicito nell'API Merchant. La nuova API utilizza risorse dedicate come AccountRelationship e AccountService per definire i servizi specifici che un account fornisce a un altro. Per maggiori dettagli, vedi Relazioni tra account.

Differenze principali

  • Risorse dedicate per relazioni e servizi: nell'API Merchant, la risorsa AccountRelationship definisce la connessione tra un fornitore di servizi e un commerciante, mentre la risorsa AccountService specifica il servizio esatto fornito (ad esempio accountAggregation). Questa sostituisce i campi generici linkType e services dell'API Content for Shopping.
  • Metodi di azione espliciti: anziché un singolo metodo link con un parametro action, l'API Merchant utilizza metodi distinti per la gestione dei servizi, come propose, approve e reject.
  • Collegamento dedicato a Profilo dell'attività su Google: il collegamento a un profilo dell'attività su Google, precedentemente gestito impostando il campo googleMyBusinessLink, ora ha un metodo dedicato, gbpAccounts.linkGbpAccount.
  • Creazione di un account cliente come servizio: la creazione di un account cliente in un account avanzato ora viene considerata come una proposta di servizio accountAggregation utilizzando il metodo accounts.createAndConfigure. Per ulteriori informazioni sugli account, consulta la pagina API Merchant Accounts. Non è necessario alcun handshake, poiché l'utente ha accesso sia all'account avanzato sia all'account cliente.

Richieste

L'API Merchant fornisce endpoint specifici per la gestione di diversi tipi di servizi e collegamenti degli account:

URL delle richieste API Merchant

  • Proponi un nuovo servizio: POST https://merchantapi.googleapis.com/accounts/v1/ {parent=accounts/*}/services:propose
  • Approvare un servizio: POST https://merchantapi.googleapis.com/accounts/v1/ {name=accounts/*/services/*}:approve
  • Rifiutare un servizio: POST https://merchantapi.googleapis.com/accounts/v1/ {name=accounts/*/services/*}:reject
  • Link a un profilo dell'attività su Google: POST https://merchantapi.googleapis.com/accounts/v1/ {parent=accounts/*}/gbpAccounts:linkGbpAccount
  • Crea un account cliente (link di aggregazione dell'account): POST https://merchantapi.googleapis.com/accounts/v1/ accounts:createAndConfigure

Richiedere il confronto degli URL

Descrizione della richiesta API Content per Shopping API Merchant
Collegare account (ad esempio, piattaforme di terze parti) POST .../v2.1/{merchantId}/accounts/{accountId}/link POST .../v1/{parent=accounts/*}/services:propose
Link a Profilo dell'attività su Google PUT .../v2.1/{merchantId}/accounts/{accountId} (con il campo googleMyBusinessLink) POST .../v1/{parent=accounts/*}/gbpAccounts:linkGbpAccount
Creare un account cliente POST .../v2.1/{merchantId}/accounts POST .../v1/accounts:createAndConfigure

Metodi

Metodo API Content for Shopping Metodo API Merchant Disponibilità e note
accounts.link accountServices.propose Utilizza questo metodo per avviare un nuovo servizio con un altro account.
accounts.link (con action: "approve") accountServices.approve Utilizza questo metodo per approvare una proposta di servizio in attesa.
accounts.link (con action: "remove") accountServices.reject Utilizza questo metodo per rifiutare un servizio in attesa o stabilito.
accounts.insert (per gli account cliente) accounts.createAndConfigure Utilizza questo metodo con un servizio accountAggregation per creare un nuovo account cliente in un account avanzato.
accounts.update (con googleMyBusinessLink) gbpAccounts.linkGbpAccount Utilizza questo metodo dedicato per collegare un account Merchant Center a un profilo dell'attività su Google.
accounts.update (con adsLinks) AccountRelationship risorsa Il collegamento a Google Ads viene gestito dall'interfaccia utente di Google Ads. Il link risultante è rappresentato come un AccountRelationship nell'API Merchant, che può essere visualizzato ma non creato direttamente.

Modifiche dettagliate ai campi

API Content per Shopping API Merchant Descrizione
AccountsLinkRequest.action propose, approve, reject metodi Il singolo campo action viene sostituito da metodi API dedicati per ogni modifica dello stato nel ciclo di vita del servizio.
AccountsLinkRequest.linkType AccountService.service_type La stringa generica linkType viene sostituita da un campo oneof strutturato service_type all'interno della risorsa AccountService, ad esempio productsManagement o accountAggregation.
AccountsLinkRequest.services AccountService.service_type L'elenco dei servizi basati su stringhe ora è rappresentato dal service_type specifico scelto all'interno della risorsa AccountService.
AccountsLinkRequest.linkedAccountId ProposeAccountServiceRequest.provider L'ID dell'account che fornisce il servizio è ora specificato nel campo provider della richiesta propose.
Account.googleMyBusinessLink LinkGbpAccountRequest L'oggetto contenente i dettagli del link GBP viene sostituito da un messaggio di richiesta dedicato per il metodo linkGbpAccount.
Account.adsLinks AccountRelationship I link Google Ads sono rappresentati come risorsa AccountRelationship in cui provider è providers/GOOGLE_ADS. Questa relazione viene in genere gestita dalla UI di Google Ads.