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.

Nota: La llamada para transferir una ubicación debe hacerla un propietario de la ubicación, y el titular de la cuenta de destino debe ser al menos administrador de la ubicación. Consulta cómo conceder la propiedad de una ficha en el artículo Gestionar administradores de cuentas y de ubicaciones.

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

Nota: En los Perfiles de Empresa, a los administradores de la ubicación se les aplica un periodo de prueba. Cuando se añade un usuario a un perfil como propietario o administrador, se limitan durante un periodo de 7 días las operaciones que puede realizar en los demás usuarios de la ubicación y en la propia ubicación. Durante este tiempo, los usuarios que estén en periodo de prueba no podrán transferirse a sí mismos la propiedad principal del perfil ni tampoco transferirla a un tercero.

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 llamar 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.

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

2. Utiliza las credenciales de OAuth de la cuenta de destino para llamar 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 llamar a locations.transfer.

   Nota: Una vez realizada la transferencia, la cuenta de destino será la cuenta principal asociada al propietario de la ficha. Si ese no es el resultado que quieres, repite los pasos del 1 al 3 con otro usuario. A continuación, vuelve a transferir la ubicación a la cuenta principal original. Puedes usar el endpoint accounts.admins.patch para cambiar el rol del administrador a uno inferior en la cuenta de destino original.

Utiliza las credenciales de OAuth de la cuenta de destino para llamar a accounts.locations.list y verificar que la ubicación transferida aparece en los resultados. Si llamas 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.