A medida que tu organización crezca, es posible que te abrume la administración de las ubicaciones y los permisos. En esta guía, se detallan las prácticas recomendadas para administrar varias ubicaciones y se describen los siguientes tipos de cuenta:
Tipos de cuentas
Cada tipo de cuenta cumple una función 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 los grupos de ubicaciones de esa organización. Luego, la cuenta personal puede administrar ubicaciones y fichas mediante los grupos por ubicación asociados.
Cuenta personal
Cuando creas una Cuenta de Google, hay una cuenta personal disponible automáticamente. Las cuentas personales pueden ser propietarios y administradores de fichas.
Cuenta de organización
Una cuenta de organización es la cuenta superpuesta que representa a tu agencia. Tus grupos por ubicación y grupos de usuarios se guardan en él, 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 o poseer la cuenta de organización.
Cuenta de grupo por ubicación
Se usa un grupo por ubicación 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 por ubicación, estos heredan los permisos del grupo por ubicación.
También puedes crear grupos por ubicación para categorizar las ubicaciones, por ejemplo, por cadena, región o categoría. Las ubicaciones pueden estar en varios grupos por ubicación 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 a cuentas personales a administrar grupos por ubicación con la API. Los grupos de usuarios se pueden agregar directamente a los grupos por ubicación desde la interfaz web.
Cuenta del grupo de usuarios
Para administrar permisos a gran escala, usa un grupo de usuarios. Puedes agregar cuentas personales a un grupo de usuarios. Luego, puedes otorgar al usuario acceso de administración a varios grupos por ubicación de la organización. Ahora, todas las cuentas personales del grupo de usuarios pueden realizar acciones gerenciales en las ubicaciones de los grupos por ubicación.
Por ejemplo, cuando un miembro nuevo se une a un equipo de operaciones, puedes agregarlo directamente a un grupo de usuarios y tendrá acceso inmediato a todas las ubicaciones a las que tienen acceso sus pares. Lleva más tiempo otorgar a los usuarios acceso a cada ubicación individual y es más difícil de administrar de esa manera.
Con la API de My Business Account Management, 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 enumerar 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 ID de cuenta (que están presentes en el campo name) y los tipos de cuenta.
Solicitud
A continuación, se muestra un ejemplo de solicitud accounts.list:
GET https://mybusinessaccountmanagement.googleapis.com/v1/accounts Authorization: Bearer <access_token>
Respuesta
A continuación, se muestra un ejemplo de una respuesta 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"
}
]
}
Todos los tipos de cuentas que se detallan en esta guía se pueden incluir 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 ubicaciones a las que tiene acceso esa cuenta.
Por ejemplo, si deseas recuperar todas las ubicaciones que pertenecen al “Grupo por ubicaciones de Juan Pérez”, 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, de la siguiente manera:
{
"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 por ubicación pueden contener varias ubicaciones.
- Las ubicaciones pueden abarcar varios grupos por ubicación de distintas organizaciones.
