Cómo transferir ubicaciones

Con la API de My Business Account Management, puedes transferir ubicaciones a diferentes cuentas o grupos por ubicación. Sigue las instrucciones de esta documentación para obtener más información.

Comenzar

Se requieren los siguientes elementos para transferir ubicaciones:

Cuenta de origen: Es la cuenta que es propietaria de la ubicación. Esta cuenta puede ser personal o de un grupo de ubicaciones. Una vez que se complete la transferencia, la cuenta de origen ya no tendrá acceso a la ubicación.
Cuenta de destino: La cuenta de destino es la cuenta a la que se debe transferir la ubicación. Esta cuenta puede ser una cuenta personal o un grupo de ubicaciones. Una vez que se complete la transferencia, la cuenta de destino será el propietario principal de la ubicación.
Tokens de acceso o actualización de OAuth2: Los tokens de acceso o actualización de OAuth2 para las cuentas de origen y destino son necesarios para cada cuenta para llamar a la API.

Ubicaciones de transferencia

Para transferir ubicaciones, completa los siguientes pasos:

  1. Si no eres propietario de la ubicación, debes convertirte en uno. Usa las credenciales de OAuth del propietario actual de la empresa para llamar a account.admins.create y, luego, invita a un usuario a ser propietario de la ficha. Luego, usa las credenciales de OAuth del usuario invitado para llamar a accounts.invitations.list y obtener el ID de invitación. Llama a accounts.invitations.accept para aceptar esta invitación.

  2. Usa las credenciales de OAuth de la cuenta de destino prevista para llamar a accounts.list. Luego, busca el ID de la cuenta a la que deseas transferir la ubicación. El ID de administrador en la respuesta a la llamada account.admins.create o a la llamada accounts.invitations.list en el paso 1 también se puede usar como el ID de la cuenta. Este ID de cuenta puede referirse a una cuenta personal o a un grupo de ubicaciones.

  3. Usa el ID de la cuenta que recuperaste en el paso 2 como la cuenta de destino. Este es el campo destinationAccount en el cuerpo de la solicitud, que puedes usar para llamar a locations.transfer.

Usa las credenciales de OAuth de la cuenta de destino para llamar a accounts.locations.list y verificar que la ubicación transferida aparezca en los resultados. Si llamas al extremo accounts.locations.list con la cuenta de origen, la ubicación transferida no se incluye en los resultados.

Cómo transferir a un grupo por ubicación

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