Gestire le relazioni tra gli account

Puoi utilizzare l'API Accounts per gestire le relazioni tra il tuo account Merchant Center e altri fornitori di servizi. Una relazione è un collegamento formale che consente a un fornitore di offrire servizi specifici alla tua attività. Un servizio definisce le autorizzazioni e le funzionalità concesse al fornitore, ad esempio la gestione dei prodotti o delle campagne. Ad esempio, il collegamento dell'account Merchant Center a un account Google Ads consente a quest'ultimo di utilizzare i tuoi dati di prodotto per pubblicare campagne pubblicitarie.

Una relazione è composta dai seguenti attributi:

  • L'account Merchant Center che riceve il servizio
  • Il fornitore di servizi
  • Il servizio o l'insieme di servizi forniti all'account Merchant Center

I fornitori di servizi possono associare un alias agli account che gestiscono (questo è l'equivalente del campo seller_id presente nella risorsa account in Content API for Shopping). L'alias può essere assegnato utilizzando il campo facoltativo account_id_alias all'interno della risorsa AccountRelationship e funge da identificatore personalizzato.

La struttura dell'URL per accedere a un account utilizzando il relativo alias è GET /accounts/v1/accounts/{provider}~{account_id_alias}.

Servizi

Nell'API Accounts, gli account possono ricevere i seguenti servizi:

  • Aggregazione degli account: questo modello descrive la relazione tra un account avanzato e gli account a cui fornisce servizi. Il fornitore di servizi (l'account avanzato) ottiene l'accesso completo e senza restrizioni agli account secondari collegati. Il externalAccountId è, in questo caso, l'identificatore dell'account Merchant Center. Quando crei un account secondario, il externalAccountId deve essere omesso, in quanto verrà assegnato all'ID dell'account al momento della creazione.

  • Gestione delle campagne: questo servizio modella il collegamento tra un account Merchant Center e un account Google Ads, consentendo all'account Google Ads di accedere ai dati di prodotto e dell'account necessari per pubblicare campagne pubblicitarie. Il fornitore di servizi in questo caso è GOOGLE_ADS e externalAccountId è l'ID dell'account Google Ads.

  • Shopping comparativo: rappresenta la relazione con un servizio di shopping comparativo (CSS) che gestisce l'account Merchant Center.

  • Gestione delle schede locali: rappresenta il rapporto con un responsabile del negozio per la gestione dell'inventario e delle schede locali utilizzando un profilo dell'attività su Google.

  • Gestione dell'account: questo servizio consente al fornitore di eseguire azioni amministrative sull'account Merchant Center, ad esempio configurare le impostazioni dell'account, gestire gli utenti o aggiornare le informazioni sull'attività. L'attività può anche limitare l'accesso concesso.

  • Gestione dei prodotti: questo servizio consente ai fornitori di gestire i prodotti e le funzionalità correlate, come le origini dati e le regole.

Stretta di mano

Per stabilire un servizio, sia l'account che fornisce il servizio sia l'account che lo riceve devono autorizzare la connessione. Questo processo di autorizzazione è chiamato handshake.

L'handshake è un processo in due passaggi:

  1. Una parte propone un collegamento al servizio.
  2. L'altra parte approva o rifiuta la proposta.

Una volta accettata una proposta, il servizio viene approvato e considerato completamente stabilito. Qualsiasi diritto di accesso conferito al fornitore di servizi è ora concesso agli utenti qualificati (vedi diritti di accesso di seguito).

Tieni presente che l'utente che crea una proposta, la rifiuta o la approva deve disporre dei ADMIN diritti di accesso all'account che avvia la procedura. Pertanto, se il fornitore di servizi propone un servizio, l'utente che lo propone deve essere un ADMIN nell'account del fornitore di servizi e l'utente che accetta o rifiuta la proposta deve essere un ADMIN nell'account ricevente.

Comportamento di handshake specifico per il servizio

Di seguito è riportata una descrizione dei requisiti di handshake specifici per ogni servizio:

  • Aggregazione degli account: questo servizio può essere stabilito solo nell'ambito della creazione dell'account. Il fornitore di servizi deve essere un account avanzato e il servizio viene approvato automaticamente poiché gli utenti dell'account avanzato hanno accesso completo ADMIN all'account in fase di creazione.

  • Gestione delle campagne: sebbene segua la normale procedura di handshake, le proposte vengono create in un sistema (ad esempio Google Ads) e le approvazioni vengono eseguite nell'altro sistema (ad esempio in Merchant Center o tramite l'API Merchant).

  • Gestione delle schede locali: per questo servizio, l'handshake viene proposto in un metodo dedicato e le approvazioni vengono eseguite nell'altro sistema (ad esempio Profilo dell'attività su Google). La procedura dettagliata è disponibile nella Guida per collegare un profilo dell'attività su Google.

  • Gestione dell'account: per questo servizio, si applica la normale procedura di handshake (proposta dal fornitore di servizi o dall'attività, seguita dall'accettazione dell'altra parte).

  • Gestione dei prodotti: per questo servizio, si applica la normale procedura di handshake (proposta da una parte, seguita dall'accettazione dell'altra).

Diritti di accesso

Ogni tipo di servizio fornisce un determinato livello di accesso per gli utenti del fornitore di servizi all'account in assistenza:

  • Aggregazione degli account: questo servizio fornisce diritti ADMIN completi.

  • Gestione delle campagne: questo servizio fornisce un diritto di accesso limitato, consentendo all'account Google Ads associato di accedere ai prodotti e alle informazioni di base dell'account.

  • Shopping comparativo: questo servizio fornisce, per impostazione predefinita, diritti ADMIN completi. Tuttavia, l'attività può limitare l'accesso concesso in Merchant Center.

  • Gestione delle schede locali: questo servizio non fornisce alcun diritto di accesso diretto. Consente invece alla scheda di sincronizzare i propri prodotti con l'account Merchant Center.

Importante: i diritti di accesso descritti per i seguenti tipi di servizi si applicano solo ai fornitori di servizi approvati. Se sei un fornitore di servizi e vuoi utilizzare questa funzionalità, contatta il nostro team di assistenza. Se hai già ricevuto l'approvazione per il metodo accounts.link per la gestione dei prodotti nell'API Content for Shopping, puoi utilizzare questo servizio nell'API Merchant senza ulteriori approvazioni.

  • Gestione account: questo servizio fornisce, per impostazione predefinita, diritti ADMIN completi.

  • Gestione dei prodotti: questo servizio fornisce diritti ADMIN completi. Tieni presente che in futuro questa funzionalità sarà limitata ai diritti di accesso correlati ai prodotti.

Come vengono applicate le relazioni per le piattaforme di terze parti

Se sei una piattaforma di terze parti che gestisce account per conto di altre attività, di seguito viene illustrato come i diversi concetti vengono mappati nella struttura del tuo account:

  1. Fornitore di servizi: il tuo account avanzato.
  2. Account che riceve il servizio: un account Merchant Center che rappresenta l'attività che gestisci.
  3. Servizio:
    • accountAggregation, se stai creando questi account come subaccount del tuo account avanzato. Tuttavia, questa operazione è sconsigliata e il servizio preferito è accountManagement.
    • accountManagement, se stai configurando questo servizio dopo la creazione dell'account per account che non sono secondari del tuo account avanzato.

Per informazioni dettagliate su come configurare un account avanzato e collegarlo a nuovi account Merchant Center, consulta Creare e gestire account secondari.