Transférer des établissements

L'API My Business Account Management vous permet de transférer des établissements vers différents comptes ou groupes d'établissements. Pour savoir comment procéder, suivez les instructions ci-dessous.

Remarque : Pour transférer un établissement, l'appelant doit en être le propriétaire, et le titulaire du compte de destination doit être au moins un responsable de l'établissement. Pour savoir comment accorder des droits de propriété à une fiche, consultez Gérer les administrateurs de comptes et d'établissements.

Commencer

Pour transférer des établissements, vous avez besoin des éléments suivants :

Compte source : il doit correspondre au propriétaire de l'établissement. Il peut s'agir d'un compte personnel ou d'un groupe d'établissements. Une fois le transfert terminé, le compte source n'a plus accès à l'établissement.
Compte de destination : il s'agit du compte vers lequel l'établissement doit être transféré. Il peut s'agir d'un compte personnel ou d'un groupe d'établissements. Une fois le transfert terminé, le compte de destination devient le propriétaire principal de l'établissement.
Jetons d'actualisation/d'accès OAuth2 : Pour pouvoir appeler l'API, chaque compte source et de destination doit utiliser les jetons d'actualisation/d'accès OAuth2.

Transférer des établissements

Remarque : Les fiches d'établissement comportent une période d'essai pour les administrateurs d'établissements. Lorsqu'un utilisateur est ajouté à une fiche en tant que propriétaire ou administrateur, les opérations qu'il peut effectuer sur les utilisateurs de l'autre établissement et sur l'établissement lui-même sont limitées pendant sept jours. Au cours de cette période d'essai, l'utilisateur ne peut pas se transférer la propriété principale d'une fiche ni la transférer à un tiers.

Pour transférer des établissements, procédez comme suit :

1. Devenez propriétaire de l'établissement si vous ne l'êtes pas encore. Utilisez les identifiants OAuth du propriétaire actuel pour appeler account.admins.create et inviter un utilisateur à devenir le propriétaire de la fiche. Utilisez ensuite les identifiants OAuth de l'utilisateur invité pour appeler accounts.invitations.list afin d'obtenir l'ID d'invitation. Appelez accounts.invitations.accept pour accepter cette invitation.

   Remarque : Le destinataire ne peut pas être membre d'un compte d'organisation ni d'un groupe d'utilisateurs.

2. Utilisez les identifiants OAuth du compte de destination prévu pour appeler accounts.list. Recherchez ensuite, dans la liste, l'ID du compte vers lequel vous souhaitez transférer l'établissement. L'ID d'administrateur dans la réponse à l'appel account.admins.create ou à l'appel accounts.invitations.list à l'étape 1 peut également servir d'ID de compte. Cet ID de compte peut faire référence à un compte personnel ou à un groupe d'établissements.

3. Utilisez l'ID de compte récupéré à l'étape 2 comme compte de destination. Il s'agit du champ destinationAccount dans le corps de la requête, que vous pouvez utiliser pour appeler locations.transfer.

   Remarque : Une fois le transfert terminé, le compte de destination est le compte principal associé au propriétaire de la fiche. Si ce n'est pas le cas, répétez les étapes 1 à 3 avec un nouvel utilisateur. Ensuite, transférez l'établissement vers le compte principal d'origine. Vous pouvez utiliser le point de terminaison accounts.admins.patch pour supprimer le rôle d'administrateur du compte de destination d'origine.

Utilisez les identifiants OAuth du compte de destination pour appeler accounts.locations.list et vérifiez que l'établissement transféré apparaît dans les résultats. Si vous appelez le point de terminaison accounts.locations.list avec le compte source, l'établissement transféré n'est pas inclus dans les résultats.

Transférer à un groupe d'établissements

Pour transférer un établissement à un location group de l'organisation, appelez locations.admins.create à l'aide des identifiants OAuth du merchant. Utilisez le champ account de la ressource Admin pour transmettre le location group account ID avec le role approprié. Vous devez utiliser les identifiants d'administrateur location group pour appeler accounts.invitations.list en utilisant l'ID de compte du groupe d'établissements comme argument parent afin de récupérer les invitations associées au location group. Recherchez l'invitation associée à la zone géographique ciblée qui vous intéresse, puis appelez accounts.invitations.accept pour accepter la bonne invitation.