Man mano che la tua organizzazione cresce, la gestione delle sedi e delle autorizzazioni può sovraccaricarti. Questa guida descrive le best practice per gestire più sedi 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 quindi ottenere autorizzazioni per i gruppi di utenti e i gruppi di sedi all'interno di quella organizzazione. L'account personale può quindi gestire le sedi e le schede tramite i gruppi di sedi associati.
Account personale
Un account personale è automaticamente disponibile quando crei un Account Google. Gli account personali possono essere proprietari e gestori delle schede.
Account dell'organizzazione
Un account dell'organizzazione è l'account sovrapposto che rappresenta la tua agenzia. Il gruppo di sedi e i gruppi di utenti vengono salvati al suo interno e sono accessibili a tutti i membri di un'organizzazione. Le sedi possono far parte di più organizzazioni.
Con l'API My Business Account Management, puoi utilizzare il metodo accounts.admins.create per invitare account personali a gestire o possedere l'account dell'organizzazione.
Account del gruppo di sedi
Un gruppo di sedi viene utilizzato per gestire un gruppo di singole sedi. Puoi usare un gruppo di sedi per eseguire attività collettive in più sedi. Quando aggiungi account personali e gruppi di utenti a un gruppo di sedi, questi ereditano le autorizzazioni del gruppo di sedi.
Puoi anche creare gruppi di località per classificare le sedi, ad esempio per catena, area geografica o categoria. Le sedi possono essere incluse in più gruppi di località contemporaneamente.
Con l'API My Business Account Management, puoi utilizzare il metodo accounts.create per creare gruppi di località e trasferire le sedi a un gruppo. Puoi anche invitare account personali a gestire i gruppi di località con l'API. I gruppi di utenti possono essere aggiunti direttamente ai gruppi di località dall'interfaccia web.
Account gruppo utenti
Per gestire le autorizzazioni su larga scala, utilizza un gruppo di utenti. È possibile aggiungere account personali a un gruppo di utenti. Successivamente, puoi concedere al gruppo di utenti l'accesso per la gestione dei gruppi di utenti a più gruppi di sedi dell'organizzazione. Ora tutti gli account personali nel gruppo di utenti possono eseguire azioni gestionali sulle sedi appartenenti ai gruppi di sedi.
Ad esempio, quando un nuovo membro entra a far parte di un team operativo, puoi aggiungerlo direttamente a un gruppo di utenti in modo che abbia accesso immediato a tutte le sedi a cui hanno accesso i suoi peer. Ci vuole più tempo per concedere agli utenti l'accesso a ogni singola sede ed è più difficile da gestire in questo modo.
Con l'API My Business Account Management, puoi utilizzare il metodo accounts.create 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 tipi di account associati, chiama il metodo accounts.list con le tue credenziali OAuth. La risposta contiene un elenco di tutti gli account, i relativi ID account, presenti nel campo nome, e i 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 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 potrebbero essere inclusi nella risposta alla tua richiesta accounts.list. Esamina
l'elenco degli account e identifica l'account specifico che ha accesso alle
sedi da gestire. Poi chiama accounts.locations.list con il campo name dell'account specifico per recuperare un elenco di sedi a cui ha accesso l'account.
Ad esempio, se vuoi recuperare tutte le località che appartengono al "Gruppo località di Mario Rossi", effettua la richiesta seguente:
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 segue:
{
"locations": [
{
"name": "locations/{locationId}",
"locationName": "Test Business",
...
},
{
"name": "locations/{locationId}",
"locationName": "2nd Test Business",
...
}
]
}
Diagramma della gestione delle località
Il seguente diagramma illustra quanto segue:
- Le organizzazioni possono contenere più gruppi utenti.
- I gruppi di utenti possono gestire più gruppi di località.
- I gruppi di località possono contenere più località.
- Le sedi possono includere più gruppi di sedi all'interno delle organizzazioni.
