Migrer la gestion des utilisateurs et des accès

Dans Content API for Shopping, vous gérez les utilisateurs et leurs droits d'accès à l'aide d'un champ dans la ressource Account. L'API Merchant remplace cela par la ressource dédiée nommée User et les méthodes correspondantes (create, delete, get, list, path). Pour en savoir plus, consultez Contrôler l'accès à votre compte.

Différences majeures

Par rapport à Content API for Shopping, Merchant API offre les avantages suivants pour la gestion des utilisateurs :

• Ressource dédiée : cette option vous permet de contrôler plus précisément et directement qui peut accéder à votre compte Merchant Center et ce qu'il peut y faire.
• Noms de ressources RESTful : dans Merchant API, identifiez les ressources User par un nom de ressource complet, par exemple accounts/12345/users/example@example.com.
• Alias me : vous pouvez utiliser l'alias me à la place d'une adresse e-mail dans le nom de la ressource pour faire référence à l'utilisateur authentifié, par exemple accounts/12345/users/me.
• Droits d'accès consolidés : l'API Merchant consolide les champs d'accès booléens de l'API Content (par exemple, admin, reportingManager) dans un seul champ access_rights répétable.
• Invitation et validation des utilisateurs : l'API Merchant introduit un état utilisateur explicite (PENDING ou VERIFIED). Lorsque vous créez un utilisateur, il est à l'état PENDING jusqu'à ce qu'il accepte l'invitation. Cela permet à l'API de connaître l'état de l'utilisateur, ce qui n'était pas possible dans Content API for Shopping. Ajouter ## Demandes

L'API Merchant utilise les URL de requête suivantes pour gérer les utilisateurs :

• 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}

Le tableau suivant compare les URL de requête entre Content API for Shopping et l'API Merchant.

Description de la requête	Content API for Shopping	API Merchant
Obtenir les utilisateurs d'un compte	GET {api_version}/{merchantId}/accounts/{accountId}	GET {api_version}/accounts/{account}/users
Créer un compte utilisateur	PATCH {api_version}/{merchantId}/accounts/{accountId}	POST {api_version}/accounts/{account}/users
Modifier un utilisateur	PATCH {api_version}/{merchantId}/accounts/{accountId}	PATCH {api_version}/accounts/{account}/users/{email}
Supprimer un compte utilisateur	PATCH {api_version}/{merchantId}/accounts/{accountId}	DELETE {api_version}/accounts/{account}/users/{email}

Identifiants

Le tableau suivant compare les identifiants utilisés dans les requêtes entre Content API for Shopping et l'API Merchant.

Description de l'identifiant	Content API for Shopping	API Merchant
Identifiant de compte	accountId	account à accounts/{account}
Identifiant utilisateur	email_address dans l'objet AccountUser	email à accounts/{account}/users/{email}

Méthodes

Le tableau suivant compare les méthodes de Content API for Shopping et de Merchant API.

Content API for Shopping	API Merchant	Disponibilité et notes
accounts.update	users.create	Crée un nouvel utilisateur pour un compte.
accounts.get	users.get	Récupère un seul utilisateur.
accounts.get	users.list	Liste tous les utilisateurs d'un compte.
accounts.update	users.patch	Met à jour les droits d'accès d'un utilisateur.
accounts.update	users.delete	Supprime un utilisateur d'un compte.

Modifications détaillées des champs

Modifiez votre utilisation des champs comme suit :

Content API for Shopping	API Merchant	Description
users (AccountUser répétitions)	users (User répétitions)	La ressource User est désormais une ressource de premier niveau avec son propre service.
AccountUser.email_address	CreateUserRequest.user_id et une partie de User.name	L'adresse e-mail de l'utilisateur fait désormais partie du nom de ressource. Spécifiez-le dans le champ user_id lors de la création.
AccountUser.admin	access_rights: "ADMIN"	L'API Merchant remplace le champ booléen admin par la valeur ADMIN dans l'énumération access_rights.
AccountUser.order_manager, AccountUser.payments_manager, AccountUser.payments_analyst	access_rights: "STANDARD"	L'API Merchant remplace ces rôles par le droit d'accès STANDARD.
AccountUser.reporting_manager	access_rights: "PERFORMANCE_REPORTING"	Le rôle reporting_manager est désormais le droit d'accès PERFORMANCE_REPORTING.
AccountUser.read_only	access_rights: "READ_ONLY"	Le rôle read_only est désormais le droit d'accès READ_ONLY.
Non disponible	User.name	Contient le nom complet de la ressource de l'utilisateur (par exemple, accounts/{account}/users/{email}).
Non disponible	User.state	Indique l'état de l'invitation de l'utilisateur (PENDING ou VERIFIED).