Transferir ubicaciones

Con la API My Business Account Management, puedes transferir ubicaciones a diferentes cuentas o grupos de ubicaciones. Para hacerlo, sigue las instrucciones de esta guía.

Empezar

Para transferir ubicaciones, se necesita lo siguiente:

Cuenta de origen: es una de las cuentas propietarias de la ubicación. Puede ser una cuenta personal o un grupo de ubicaciones. Una vez realizada la transferencia, la cuenta de origen deja de tener acceso a la ubicación.
Cuenta de destino: es la cuenta a la que se debe transferir la ubicación. Puede ser una cuenta personal o un grupo de ubicaciones. Una vez realizada la transferencia, la cuenta de destino pasa a ser la propietaria principal de la ubicación.
Tokens de OAuth 2.0 de actualización o acceso: para hacer la llamada a la API, se necesitan los tokens de OAuth 2.0 de actualización o acceso de las cuentas de origen y de destino.

Transferir ubicaciones

Para transferir ubicaciones, sigue estos pasos:

  1. Si no eres propietario de la ubicación, debes serlo. Utiliza las credenciales de OAuth de un propietario de la empresa para hacer una llamada a account.admins.create e invitar a un usuario a ser propietario de la ficha. A continuación, utiliza las credenciales de OAuth del usuario invitado para llamar a accounts.invitations.list y obtener el ID de la invitación. Haz una llamada a accounts.invitations.accept para aceptar esa invitación.

  2. Utiliza las credenciales de OAuth de la cuenta de destino para hacer una llamada a accounts.list. A continuación, busca en la lista el ID de la cuenta a la que quieres transferir la ubicación. El ID de administrador que se muestra en la respuesta a la llamada a account.admins.create o a la llamada a accounts.invitations.list del paso 1 también se puede usar como ID de cuenta. Este ID puede ser de una cuenta personal o de un grupo de ubicaciones.

  3. Usa el ID de cuenta que has obtenido en el paso 2 como cuenta de destino. Ese es el valor que debes escribir en el campo destinationAccount del cuerpo de la solicitud que puedes usar para hacer una llamada a locations.transfer.

Utiliza las credenciales de OAuth de la cuenta de destino para hacer una llamada a accounts.locations.list y verificar que la ubicación transferida aparece en los resultados. Si haces una llamada al endpoint accounts.locations.list con la cuenta de origen, la ubicación transferida no se incluirá en los resultados.

Transferir a un grupo de ubicaciones

Para transferir una ubicación a un location group de la organización, llama a locations.admins.create con las credenciales de OAuth de merchant. Usa el campo account del recurso Admin para enviar el location group account ID junto con el role adecuado. Debes usar las credenciales de administrador del location group para llamar a accounts.invitations.list utilizando el ID de la cuenta del grupo de ubicaciones como argumento de parent para obtener las invitaciones relacionadas con el location group. Busca la invitación que tenga la ubicación objetivo correcta y, a continuación, llama a accounts.invitations.accept para aceptar la invitación correcta.