A medida que tu organización crece, la administración de las ubicaciones y los permisos abrumarte. En esta guía, se detallan las prácticas recomendadas para administrar varias y describe los siguientes tipos de cuentas:
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 grupos por ubicación en esa organización. Luego, la cuenta personal puede administrar ubicaciones y fichas a través de los grupos por ubicación asociados.
Cuenta personal
Una cuenta personal está disponible automáticamente cuando creas una Cuenta de Google. Cuentas personales puede ser propietarios y administradores de fichas.
Cuenta de organización
Los cuenta de organización es la cuenta superpuesta que representa tu agencia. Tus grupos por ubicación y grupos de usuarios se guardan allí, y todos los miembros de un organización tengan acceso a ellos. Las ubicaciones pueden formar parte de varias organizaciones.
Con la API de My Business Account Management, puedes usar la
accounts.admins.create
para invitar a cuentas personales a administrar o ser la propietaria de la cuenta de organización.
Cuenta de grupo por ubicación
R grupo por ubicación se utiliza para administrar un grupo de ubicaciones individuales. Puedes usar un grupo por ubicación realizar tareas masivas en varias ubicaciones. Cuando agregas cuentas personales y grupos de usuarios a un grupo por ubicación, heredan los permisos de ese grupo por ubicación.
También puede crear grupos por ubicación para categorizar 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 la
accounts.create para
crear grupos por ubicación y
transferir ubicaciones a una ubicación
grupo. También puedes invitar a cuentas personales a
administrar grupos por ubicación con la API Usuario
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 otorgarle al usuario acceso de administración de grupos a varios grupos por ubicación de la organización. Ahora todas las cuentas personales en el grupo de usuarios pueden realizar acciones gerenciales en el ubicaciones en 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, quienes tendrán acceso inmediato a todas las ubicaciones a las que tienen acceso sus pares. Se tarda más tiempo en 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 la
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, sigue estos pasos:
llamar al método accounts.list
con tus credenciales de OAuth. El
contiene una lista de todas las cuentas, sus IDs de cuenta,
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 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"
}
]
}
Todos los tipos de cuenta detallados en esta guía pueden incluirse en la respuesta
a tu
accounts.list. Revisión
la lista de cuentas e identificar la cuenta específica que tiene acceso a la cuenta
ubicaciones que deseas administrar. Luego, llama
accounts.locations.list
con el campo name de la cuenta específica para recuperar una lista de
ubicaciones a las que esa cuenta tiene acceso.
Por ejemplo, si deseas recuperar todas las ubicaciones que pertenecen a la por ubicación," realiza la siguiente solicitud:
GET
https://mybusinessbusinessinformation.googleapis.com/v1/{accountId}/locations
Authorization: Bearer <access_token>
La respuesta devuelve una lista de ubicaciones a las que el usuario tiene acceso, como sigue:
{
"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.
