Transferir ubicaciones

Con la API de My Business Account Management, puedes transferir ubicaciones a diferentes cuentas o grupos por ubicación. Sigue las instrucciones en esta documentación para saber cómo hacerlo.

Nota: Para transferir una ubicación, el emisor debe ser propietario de la ubicación y el titular de la cuenta de destino debe ser al menos un administrador de la ubicación. Si deseas obtener detalles sobre cómo otorgar la propiedad de una ficha, consulta Administra administradores de cuentas y ubicaciones.

Comenzar

Debes cumplir con los siguientes elementos para transferir ubicaciones:

Cuenta de origen: La cuenta de origen es la cuenta que posee la ubicación. Esta cuenta puede ser personal o de grupo por ubicación. Una vez que se completa la transferencia, la cuenta de origen ya no tiene acceso a la ubicación.
Cuenta de destino: La cuenta de destino es la cuenta a la que se debe transferir la ubicación. Puede ser una cuenta personal o un grupo por ubicación. Una vez que se completa la transferencia, la cuenta de destino es la propietaria principal de la ubicación.
Tokens de actualización y acceso de OAuth2: Los tokens de actualización o acceso de OAuth2 para las cuentas de origen y destino son necesarios en cada cuenta para llamar a la API.

Transferir ubicaciones

Nota: Los Perfiles de Negocio tienen un período de prueba para los administradores de ubicación. Una vez que se agrega un usuario a un perfil como propietario o administrador, las operaciones que puede realizar con los usuarios de la otra ubicación y con la propia ubicación se limitarán durante un período de 7 días. Durante este período, los usuarios en el período de prueba no podrán transferirse la propiedad principal de un perfil a sí mismos ni a un tercer usuario.

Para transferir ubicaciones, completa los siguientes pasos:

1. Si no eres propietario de la ubicación, debes convertirte en uno. Utiliza 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.

   Nota: El destinatario no puede ser miembro de una cuenta de organización ni de un grupo de usuarios.

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

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.

   Nota: Una vez que se completa la transferencia, la cuenta de destino es la cuenta principal asociada con el propietario de la ficha. Si este no es el resultado previsto, repite los pasos 1 a 3 con un usuario nuevo. Luego, vuelve a transferir la ubicación a la cuenta principal original. Puedes usar el extremo accounts.admins.patch para cambiar a una versión inferior del rol de administrador de la cuenta de destino original.

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 de 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 cuenta del grupo por ubicación como argumento parent para recuperar invitaciones relacionadas con location group. Busca la invitación que tenga la ubicación de segmentación correcta y, luego, llama a accounts.invitations.accept para aceptar la invitación correcta.