La versione v1beta dell'API Merchant è stata ritirata e disattivata il 28 febbraio 2026. Per i passaggi per eseguire la transizione all'ultima versione stabile, consulta Eseguire la migrazione dalla v1beta alla v1.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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 è una connessione 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 la gestione delle campagne. Ad esempio, il collegamento del tuo account Merchant Center a un account Google Ads consente all'account Ads di utilizzare i 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

Alias

I fornitori di servizi possono associare un alias agli account che gestiscono (questo è l' equivalente del campo seller_id presente nella risorsa account nell'API Content for Shopping). L'alias può essere assegnato utilizzando il campo facoltativo account_id_alias all'interno della risorsa AccountRelationship e funge da identificatore personalizzato. L'alias deve essere composto da 1 a 50 caratteri scelti tra lettere ASCII, cifre decimali, trattini, trattini bassi, punti o tilde ([A-Za-z0-9_~.-]{1,50}).

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. Puoi aggiungere molti di questi servizi durante la creazione dell'account.

Aggregazione account: questo servizio collega un account avanzato a un altro account, concedendo all'account avanzato l'accesso completo e senza restrizioni. In genere viene utilizzato da marketplace, rivenditori multimarca o rivenditori internazionali che necessitano di un controllo centralizzato sugli account nidificati. Se sei una piattaforma di e-commerce o un partner di canale, ti consigliamo di utilizzare accountManagement. Quando crei un account utilizzando l'aggregazione di account, devi omettere externalAccountId.
Gestione delle campagne: questo servizio modella il collegamento tra un account Merchant Center e un account Google Ads, consentendo all'account Ads di accedere ai dati di prodotto e dell'account necessari per pubblicare campagne pubblicitarie. In questo caso, il fornitore di servizi è GOOGLE_ADS e externalAccountId è l'ID dell'account Google Ads. Questo servizio può essere proposto anche a un account esistente.

Shopping comparativo: rappresenta la relazione con un Servizio di shopping comparativo (CSS) che gestisce l'account Merchant Center.
Gestione delle schede locali: rappresenta la relazione con un gestore 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. Se utilizzato durante la creazione dell'account, questo servizio crea un account collegato al fornitore, che è l'approccio consigliato per le piattaforme di e-commerce e i partner di canale. Può essere proposto anche a un account esistente.
Gestione dei prodotti: questo servizio consente ai fornitori di gestire i prodotti e le funzionalità correlate, come le origini dati e le regole. Se aggiunto durante la creazione dell'account, in genere viene utilizzato in combinazione con accountManagement o accountAggregation. Questo servizio può essere proposto anche a un account esistente.

Stretta di mano

Per stabilire un servizio, sia l'account che fornisce il servizio sia l'account che lo riceve devono autorizzare la connessione. Questa procedura di autorizzazione è chiamata stretta di mano.

La stretta di mano è una procedura in due passaggi:

Una parte propone un link di servizio.
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 viene ora concesso agli utenti qualificati (vedi i diritti di accesso di seguito).

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

Comportamento della stretta di mano specifico per il servizio

Di seguito è riportata una descrizione dei requisiti specifici della stretta di mano per ogni singolo servizio:

Aggregazione 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 perché gli utenti dell'account avanzato hanno accesso ADMIN completo all'account in fase di creazione.
Shopping comparativo: questo servizio viene approvato automaticamente quando viene aggiunto durante la creazione dell'account utilizzando createAndConfigure.
Gestione delle campagne: sebbene segua la normale procedura di stretta di mano, le proposte vengono effettuate 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, la stretta di mano viene proposta 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, la normale procedura di stretta di mano si applica quando si utilizza propose. Se il servizio viene aggiunto durante la creazione dell'account utilizzando createAndConfigure, viene approvato automaticamente.
Gestione dei prodotti: per questo servizio, si applica la normale procedura di stretta di mano (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 gestito:

Aggregazione account: questo servizio fornisce diritti ADMIN completi.
Gestione delle campagne: questo servizio fornisce un diritto di accesso limitato, che consente all'account Ads associato di accedere ai prodotti e alle informazioni di base dell'account.
Shopping comparativo: per impostazione predefinita, questo servizio fornisce diritti ADMIN completi. Tuttavia, l'attività può limitare l'accesso concesso in Merchant Center.
Gestione delle schede locali: questo servizio non fornisce diritti di accesso diretti. 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. Contatta il nostro support team di assistenza se sei un fornitore di servizi e vuoi utilizzare questa funzionalità. 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 dell'account: per impostazione predefinita, questo servizio fornisce diritti ADMIN completi.
Gestione dei prodotti: questo servizio fornisce diritti ADMIN completi. Tieni presente che in futuro questo sarà limitato ai soli diritti di accesso relativi ai prodotti.

Come si applicano le relazioni per le piattaforme di terze parti

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

Fornitore di servizi: il tuo account avanzato.
Account che riceve il servizio: un account Merchant Center che rappresenta l'attività che gestisci.
Servizio:
- accountManagement: questo è il servizio consigliato per le piattaforme di e-commerce e i partner di canale che creano nuovi account per conto dei commercianti. Crea un account di proprietà del commerciante, collegato a te per la gestione. Questo è in linea con la struttura di Merchant Center preferita per questo caso d'uso.
- accountAggregation: questo servizio collega il tuo account avanzato a un altro account. Sebbene sia supportato, non è consigliato per le piattaforme di e-commerce e i partner di canale.

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

Indietro

Create accounts

Avanti

Control access to your account