Man mano che la tua organizzazione cresce, la gestione delle sedi e delle autorizzazioni può ti sovraccarichi. Questa guida illustra nel dettaglio le best practice per gestire di località e descrive i seguenti tipi di account:
- Account personale
- Account dell'organizzazione
- Account del gruppo di sedi
- Account del gruppo di utenti
Tipi di account
Ogni tipo di account ha un ruolo nella gestione delle sedi. Un account personale può gestire un account dell'organizzazione e ottenere le autorizzazioni per i gruppi di utenti e gruppi di località all'interno dell'organizzazione. L'account personale può quindi gestire sedi e schede tramite i gruppi di località associati.
Account personale
Un account personale è automaticamente disponibile quando crei un Account Google. Account personali può essere proprietari e gestori delle schede.
Account dell'organizzazione
Un account dell'organizzazione è l'account sovrapposto che rappresenta agenzia. Il gruppo di località e i gruppi di utenti vengono salvati al suo interno, insieme a tutti i membri di che un'organizzazione abbia accesso a questi dati. Le località possono far parte di più le tue organizzazioni.
Con l'API My Business Account Management, puoi utilizzare
accounts.admins.create
per invitare account personali a gestire o possedere l'account dell'organizzazione.
Account del gruppo di sedi
R gruppo di località viene utilizzato per gestire un gruppo di singole sedi. Puoi utilizzare un gruppo di località eseguire attività collettive in più sedi. Quando aggiungi account personali e gruppi di utenti a un gruppo di località, quest'ultimo ereditano le autorizzazioni del gruppo.
Puoi anche creare gruppi di località per classificare le sedi, ad esempio per catena, regione o categoria. Le sedi possono essere in più gruppi di sedi contemporaneamente.
Con l'API My Business Account Management, puoi utilizzare
accounts.create per
creare gruppi di località;
trasferire sedi a una sede
gruppo. Puoi anche invitare account personali a
gestire i gruppi di località con l'API. Utente
i gruppi possono essere aggiunti direttamente ai gruppi di località dall'interfaccia web.
Account gruppo di utenti
Per gestire le autorizzazioni su larga scala, utilizza gruppo di utenti. È possibile aggiungere account personali a un gruppo di utenti. Quindi, puoi concedere all'utente Accesso alla gestione di gruppi a più gruppi di sedi nell'organizzazione. Ora tutti gli account personali del gruppo utenti possono eseguire azioni gestionali nella località all'interno dei gruppi di località.
Ad esempio, quando un nuovo membro entra a far parte di un team operativo, puoi aggiungerlo direttamente a un gruppo di utenti, che ha immediatamente accesso a tutte le località a cui hanno accesso i loro colleghi. Ci vuole più tempo per concedere agli utenti l'accesso a ciascun singola località ed è più difficile da gestire in questo modo.
Con l'API My Business Account Management, puoi utilizzare
accounts.create per
per creare gruppi di utenti. Puoi utilizzare l'API anche per invitare account personali a
gestire gli amministratori di account e sedi.
Utilizzare l'API per chiamare un elenco di tutti gli account
Per elencare tutti gli account a cui hai accesso e i relativi tipi di account,
chiama il metodo accounts.list
con le tue credenziali OAuth. La
la risposta contiene un elenco di tutti gli account, i relativi ID account,
presenti nel campo name e nei tipi di account.
Richiesta
Di seguito è riportato un
Esempio di richiesta accounts.list:
GET https://mybusinessaccountmanagement.googleapis.com/v1/accounts Authorization: Bearer <access_token>
Risposta
Di seguito è riportato un
Esempio di risposta di 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"
}
]
}
Tutti i tipi di account descritti in questa guida possono essere inclusi nella risposta
al tuo
Richiesta accounts.list. Rivedi
l'elenco degli account e identificare quello specifico che ha accesso
dalle località che vuoi gestire. Quindi chiama
accounts.locations.list
con il campo name dell'account specifico per recuperare un elenco di
le località a cui ha accesso l'account.
Ad esempio, se vuoi recuperare tutte le località che appartengono all' Gruppo di località", effettua la seguente richiesta:
GET
https://mybusinessbusinessinformation.googleapis.com/v1/{accountId}/locations
Authorization: Bearer <access_token>
La risposta restituisce un elenco di posizioni a cui l'utente ha accesso, come che segue:
{
"locations": [
{
"name": "locations/{locationId}",
"locationName": "Test Business",
...
},
{
"name": "locations/{locationId}",
"locationName": "2nd Test Business",
...
}
]
}
Diagramma di Gestione delle sedi
Il seguente diagramma illustra quanto segue:
- Le organizzazioni possono contenere più gruppi di utenti.
- I gruppi di utenti possono gestire più gruppi di località.
- I gruppi di località possono contenere più sedi.
- Le località possono abbracciare più gruppi di sedi in tutte le organizzazioni.
