Gestire le sedi su larga scala

Man mano che la tua organizzazione cresce, la gestione delle sedi e delle autorizzazioni può essere eccessiva. Questa guida illustra le best practice per gestire più sedi e descrive i seguenti tipi di account:

• Account personale
• Account dell'organizzazione
• Account gruppo di località
• Account 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 i gruppi di sedi dell'organizzazione. L'account personale può quindi gestire le sedi e le schede tramite i gruppi di sedi associati.

Account personale

Un account personale è disponibile automaticamente quando crei un Account Google. Gli account personali possono essere proprietari e gestori di schede.

Account dell'organizzazione

Un account dell'organizzazione è l'account principale che rappresenta la tua agenzia. Il gruppo di località e i gruppi di utenti vengono salvati al suo interno e tutti i membri di un'organizzazione hanno accesso. 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 gruppo di località

Un gruppo di località viene utilizzato per gestire un gruppo di singole località. Puoi utilizzare 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, regione o categoria. Le sedi possono far parte di più gruppi contemporaneamente.

Con l'API di gestione dell'account My Business, puoi utilizzare il metodo accounts.create per creare gruppi di sedi e trasferire sedi a un gruppo di sedi. Con l'API puoi anche invitare account personali a gestire i gruppi di sedi. I gruppi di utenti possono essere aggiunti direttamente ai gruppi di sedi dall'interfaccia web.

Account gruppo di utenti

Per gestire le autorizzazioni su larga scala, utilizza un gruppo di utenti. Puoi aggiungere account personali a un gruppo di utenti. Dopodiché puoi concedere al gruppo di utenti accesso alla gestione di più gruppi di sedi nell'organizzazione. Ora tutti gli account personali nel gruppo di utenti possono eseguire azioni di gestione sulle sedi dei gruppi di sedi.

Ad esempio, quando un nuovo membro si unisce a un team operativo, puoi aggiungerlo direttamente a un gruppo di utenti e avrà immediatamente accesso a tutte le località a cui hanno accesso i suoi colleghi. Richiede più tempo concedere agli utenti l'accesso a ogni singola sede ed è più difficile da gestire.

Con l'API di gestione dell'account My Business, puoi utilizzare il metodo accounts.create per creare gruppi di utenti. Puoi anche utilizzare l'API per invitare account personali a gestire gli amministratori per 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 risposta contiene un elenco di tutti gli account, i relativi ID account, che sono presenti nel campo name, 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 example 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 località che vuoi gestire. Quindi, chiama accounts.locations.list con il campo name dell'account specifico per recuperare un elenco di località a cui ha accesso l'account.

Ad esempio, se vuoi recuperare tutte le località che appartengono al "Gruppo di località di Mario Rossi", effettua la seguente richiesta:

GET
https://mybusinessbusinessinformation.googleapis.com/v1/{accountId}/locations
Authorization: Bearer <access_token>

La risposta restituisce un elenco di località a cui l'utente ha accesso, come segue:

{
    "locations": [
        {
            "name": "locations/{locationId}",
            "locationName": "Test Business",
            ...
        },
        {
            "name": "locations/{locationId}",
            "locationName": "2nd Test Business",
            ...
         }
     ]
}

Diagramma di gestione della località

Il seguente diagramma illustra quanto segue:

• Le organizzazioni possono contenere più gruppi di utenti.
• I gruppi di utenti possono gestire più gruppi di sedi.
• I gruppi di sedi possono contenere più sedi.
• Le sedi possono includere più gruppi di sedi in più organizzazioni.