A medida que tu organización crece, la administración de tus ubicaciones y permisos puede ser abrumadora. En esta guía, se detallan las prácticas recomendadas para administrar varias ubicaciones y se describen los siguientes tipos de cuentas:
Tipos de cuentas
Cada tipo de cuenta tiene un rol en la administración de las ubicaciones. Una cuenta personal puede administrar una cuenta de organización y, luego, obtener permisos para los grupos de usuarios y de ubicaciones de esa organización. Luego, la cuenta personal puede administrar las ubicaciones y las fichas a través de los grupos de ubicaciones asociados.
Cuenta personal
Una cuenta personal estará disponible automáticamente cuando crees una Cuenta de Google. Las cuentas personales pueden ser propietarias y administradoras de fichas.
Cuenta de organización
Una cuenta de organización es la cuenta superior que representa a tu agencia. Allí se guardan tu grupo de ubicaciones y tus grupos de usuarios, y todos los miembros de una organización tienen acceso a ellos. Las ubicaciones pueden ser parte de varias organizaciones.
Con la API de My Business Account Management, puedes usar el método accounts.admins.create para invitar a cuentas personales a administrar la cuenta de organización o ser propietarios de ella.
Cuenta del grupo por ubicación
Un grupo por ubicación se usa para administrar un grupo de ubicaciones individuales. Puedes usar un grupo por ubicación para realizar tareas masivas en varias ubicaciones. Cuando agregas cuentas personales y grupos de usuarios a un grupo de ubicaciones, estos heredan los permisos del grupo de ubicaciones.
También puedes crear grupos de ubicaciones para categorizarlas, por ejemplo, por cadena, región o categoría. Las ubicaciones pueden estar en varios grupos de ubicaciones a la vez.
Con la API de My Business Account Management, puedes usar el método accounts.create para crear grupos por ubicación y transferir ubicaciones a un grupo por ubicación. También puedes invitar cuentas personales a administrar grupos de ubicaciones con la API. Los grupos de usuarios se pueden agregar directamente a los grupos de ubicaciones desde la interfaz web.
Cuenta de grupo de usuarios
Para administrar los permisos a gran escala, usa un grupo de usuarios. Puedes agregar cuentas personales a un grupo de usuarios. Luego, puedes otorgarle al administrador del grupo de usuarios acceso a varios grupos por ubicación de la organización. Ahora, todas las cuentas personales del grupo de usuarios pueden realizar acciones de administración en las ubicaciones de los grupos de ubicaciones.
Por ejemplo, cuando un miembro nuevo se une a un equipo de operaciones, puedes agregarlo directamente a un grupo de usuarios y este tendrá acceso inmediato a todas las ubicaciones a las que tienen acceso sus colegas. Lleva más tiempo otorgarles acceso a los usuarios a cada ubicación individual y es más difícil de administrar de esa manera.
Con la API de Administración de cuentas de Mi Negocio, puedes usar el método accounts.create para crear grupos de usuarios. También puedes usar la API para invitar a cuentas personales a administrar administradores de cuentas y ubicaciones.
Usa la API para llamar a una lista de todas las cuentas
Para obtener una lista de todas las cuentas a las que tienes acceso y sus tipos de cuenta asociados, llama al método accounts.list con tus credenciales de OAuth. La respuesta contiene una lista de todas las cuentas, sus IDs, que se encuentran en el campo name, y los tipos de cuentas.
Solicitud
El siguiente es un ejemplo de solicitud de accounts.list:
GET https://mybusinessaccountmanagement.googleapis.com/v1/accounts Authorization: Bearer <access_token>
Respuesta
A continuación, se muestra un ejemplo de respuesta de accounts.list:
{ "accounts": [ { "name": "accounts/{accountId} ", "accountName": "John Doe", "type": "PERSONAL", "state": { "status": "UNVERIFIED" }, "profilePhotoUrl": "//lh5.googleusercontent.com/REDACTED" }, { "name": "accounts/{accountId} ", "accountName": "John Doe’s Location Group", "type": "LOCATION_GROUP", "role": "OWNER", "state": { "status": "UNVERIFIED" }, "accountNumber": "{accountNumber} ", "permissionLevel": "OWNER_LEVEL" } ] }
Es posible que todos los tipos de cuentas detallados en esta guía se incluyan en la respuesta a tu solicitud de accounts.list. Revisa la lista de cuentas y, luego, identifica la cuenta específica que tiene acceso a las ubicaciones que deseas administrar. Luego, llama a accounts.locations.list con el campo name de la cuenta específica para recuperar una lista de las ubicaciones a las que tiene acceso esa cuenta.
Por ejemplo, si deseas recuperar todas las ubicaciones que pertenecen al "Grupo de ubicaciones de John Doe", realiza la siguiente solicitud:
GET https://mybusinessbusinessinformation.googleapis.com/v1/{accountId} /locations Authorization: Bearer <access_token>
La respuesta muestra una lista de ubicaciones a las que el usuario tiene acceso, como se muestra a continuación:
{
"locations": [
{
"name": "locations/{locationId} ",
"locationName": "Test Business",
...
},
{
"name": "locations/{locationId} ",
"locationName": "2nd Test Business",
...
}
]
}Diagrama de administración de ubicaciones
En el siguiente diagrama, se ilustra lo siguiente:
- Las organizaciones pueden contener varios grupos de usuarios.
- Los grupos de usuarios pueden administrar varios grupos por ubicación.
- Los grupos de ubicaciones pueden contener varias ubicaciones.
- Las ubicaciones pueden abarcar varios grupos de ubicaciones en diferentes organizaciones.
