Eseguire la migrazione della gestione degli utenti e dell'accesso

Nell'API Content for Shopping, gestivi gli utenti e i loro diritti di accesso con un campo nella risorsa Account. L'API Merchant sostituisce questo elemento con la risorsa dedicata denominata User e i metodi corrispondenti (create, delete, get, list, path). Per saperne di più, consulta Controllare l'accesso al tuo account.

Differenze principali

Rispetto a Content API for Shopping, l'API Merchant offre i seguenti vantaggi per la gestione degli utenti:

• Risorsa dedicata: offre un modo più granulare e diretto per controllare chi può accedere al tuo account Merchant Center e cosa può fare.
• Nomi delle risorse RESTful: nell'API Merchant, identifica le risorse User tramite un nome completo della risorsa, ad esempio accounts/12345/users/example@example.com.
• Alias me: puoi utilizzare l'alias me al posto di un indirizzo email nel nome della risorsa per fare riferimento all'utente autenticato, ad esempio accounts/12345/users/me.
• Diritti di accesso consolidati: l'API Merchant consolida i campi di accesso booleani dell'API Content (ad esempio, admin, reportingManager) in un unico campo ripetibileaccess_rights.
• Invito e verifica dell'utente: l'API Merchant introduce uno stato utente esplicito (PENDING o VERIFIED). Quando crei un nuovo utente, questi si trova nello stato PENDING finché non accetta l'invito. In questo modo l'API ha visibilità sullo stato dell'utente, cosa che non era disponibile nella Content API for Shopping. Aggiungi ## Richieste

L'API Merchant utilizza i seguenti URL di richiesta per gestire gli utenti:

• GET /accounts/v1/accounts/{account}/users/{email}
• GET /accounts/v1/accounts/{account}/users
• POST /accounts/v1/accounts/{account}/users
• PATCH /accounts/v1/accounts/{account}/users/{email}
• DELETE /accounts/v1/accounts/{account}/users/{email}

La seguente tabella confronta gli URL delle richieste tra l'API Content for Shopping e l'API Merchant.

Descrizione della richiesta	API Content per Shopping	API Merchant
Recuperare gli utenti di un account	GET {api_version}/{merchantId}/accounts/{accountId}	GET {api_version}/accounts/{account}/users
Crea un utente	PATCH {api_version}/{merchantId}/accounts/{accountId}	POST {api_version}/accounts/{account}/users
Aggiornare un utente	PATCH {api_version}/{merchantId}/accounts/{accountId}	PATCH {api_version}/accounts/{account}/users/{email}
Eliminazione di un utente	PATCH {api_version}/{merchantId}/accounts/{accountId}	DELETE {api_version}/accounts/{account}/users/{email}

Identificatori

La tabella seguente confronta gli identificatori utilizzati nelle richieste tra Content API for Shopping e Merchant API.

Descrizione dell'identificatore	API Content per Shopping	API Merchant
Identificatore dell'account	accountId	account in accounts/{account}
Identificatore utente	email_address all'interno dell'oggetto AccountUser	email in accounts/{account}/users/{email}

Metodi

La seguente tabella mette a confronto i metodi dell'API Content for Shopping e dell'API Merchant.

API Content per Shopping	API Merchant	Disponibilità e note
accounts.update	users.create	Crea un nuovo utente per un account.
accounts.get	users.get	Recupera un singolo utente.
accounts.get	users.list	Elenca tutti gli utenti di un account.
accounts.update	users.update	Aggiorna i diritti di accesso di un utente.
accounts.update	users.delete	Elimina un utente da un account.

Modifiche dettagliate ai campi

Aggiorna l'utilizzo dei campi come segue:

API Content per Shopping	API Merchant	Descrizione
users (ripetuto AccountUser)	users (ripetuto User)	La risorsa User ora è una risorsa di primo livello con un proprio servizio.
AccountUser.email_address	CreateUserRequest.user_id e parte di User.name	L'indirizzo email dell'utente ora fa parte del nome della risorsa. Specificalo nel campo user_id durante la creazione.
AccountUser.admin	access_rights: "ADMIN"	L'API Merchant sostituisce il campo booleano admin con il valore ADMIN nell'enumerazione access_rights.
AccountUser.order_manager, AccountUser.payments_manager, AccountUser.payments_analyst	access_rights: "STANDARD"	L'API Merchant sostituisce questi ruoli con il diritto di accesso STANDARD.
AccountUser.reporting_manager	access_rights: "PERFORMANCE_REPORTING"	Il ruolo reporting_manager ora è il diritto di accesso PERFORMANCE_REPORTING.
AccountUser.read_only	access_rights: "READ_ONLY"	Il ruolo read_only ora è il diritto di accesso READ_ONLY.
Non disponibile	User.name	Contiene il nome completo della risorsa dell'utente, ad esempio accounts/{account}/users/{email}.
Non disponibile	User.state	Indica lo stato dell'invito dell'utente, ovvero PENDING o VERIFIED.