Zarządzanie lokalizacjami na dużą skalę

W miarę rozwoju organizacji zarządzanie lokalizacjami i uprawnieniami może być przytłaczające. W tym przewodniku znajdziesz szczegółowe informacje o sprawdzonych metodach zarządzania wieloma lokalizacjami oraz opisy tych typów kont:

• Konto osobiste
• Konto organizacji
• Konto grupy lokalizacji
• Konto grupy użytkowników

Rodzaje kont

Każdy typ konta odgrywa rolę w zarządzaniu lokalizacjami. Konto osobiste może zarządzać kontem organizacji, a potem uzyskać uprawnienia do grup użytkowników i grup lokalizacji w tej organizacji. Konto osobiste może wtedy zarządzać lokalizacjami i ofertami za pomocą powiązanych grup lokalizacji.

Konto osobiste

Konto osobiste jest automatycznie dostępne po utworzeniu konta Google. Konta osobiste mogą być właścicielami i menedżerami wizytówek.

Konto organizacji

Konto organizacji to nadrzędne konto, które reprezentuje Twoją agencję. Twoja grupa lokalizacji i grupy użytkowników są w niej zapisane i mają do nich dostęp wszyscy członkowie organizacji. Lokalizacje mogą należeć do wielu organizacji.

Za pomocą interfejsu API do zarządzania kontem Mojej Firmy możesz używać metody accounts.admins.create, aby zapraszać użytkowników kont osobistych do zarządzania kontem organizacji lub do korzystania z niego.

Konto grupy lokalizacji

Grupa lokalizacji służy do zarządzania grupą poszczególnych lokalizacji. Możesz użyć grupy lokalizacji, aby wykonać zadania zbiorcze w wielu lokalizacjach. Gdy dodasz do grupy lokalizacji konta osobiste i grupy użytkowników, odziedziczą one uprawnienia grupy lokalizacji.

Możesz też tworzyć grupy lokalizacji, aby kategoryzować lokalizacje według takich kryteriów jak sieć, region czy kategoria. Lokalizacje mogą należeć do wielu grup lokalizacji jednocześnie.

Za pomocą interfejsu API do zarządzania kontem Google Moja Firma możesz użyć metody accounts.create, aby tworzyć grupy lokalizacji i przenosić lokalizacje do grupy lokalizacji. Możesz też zaprosić konta osobiste do zarządzania grupami lokalizacji za pomocą interfejsu API. Grupy użytkowników można dodawać bezpośrednio do grup lokalizacji z poziomu interfejsu internetowego.

Konto grupy użytkowników

Aby zarządzać uprawnieniami na dużą skalę, użyj grupy użytkowników. Do grupy użytkowników możesz dodawać konta osobiste. Następnie możesz przyznać grupie użytkowników dostęp do zarządzania wieloma grupami lokalizacji w organizacji. Teraz wszystkie konta osobiste w grupie użytkowników mogą wykonywać czynności administracyjne w lokalizacjach należących do grup lokalizacji.

Gdy na przykład nowy członek dołącza do zespołu operacyjnego, możesz go bezpośrednio dodać do grupy użytkowników, dzięki czemu uzyska on natychmiastowy dostęp do wszystkich lokalizacji, do których mają dostęp jego koledzy. Przyznawanie użytkownikom dostępu do poszczególnych lokalizacji zajmuje więcej czasu i jest trudniejsze w zarządzaniu.

Za pomocą interfejsu API do zarządzania kontem Google Moja Firma możesz użyć metody accounts.create, aby utworzyć grupy użytkowników. Możesz też użyć interfejsu API, aby zaprosić konta osobiste do zarządzania kontami i lokalizacjami.

Wywoływanie listy wszystkich kont za pomocą interfejsu API

Aby wyświetlić listę wszystkich kont, do których masz dostęp, oraz ich typów, wywołaj metodę accounts.list, podając dane logowania OAuth. Odpowiedź zawiera listę wszystkich kont i ich identyfikatorów (znajdują się one w polu name) oraz typy kont.

Żądanie

Oto przykład żądania accounts.list:

GET
https://mybusinessaccountmanagement.googleapis.com/v1/accounts
Authorization: Bearer <access_token>

Odpowiedź

Oto przykład odpowiedzi 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"
        }
    ]
}

Odpowiedź na Twoją prośbę accounts.list może zawierać wszystkie typy kont opisane w tym przewodniku. Przejrzyj listę kont i znajdź konto, które ma dostęp do lokalizacji, którymi chcesz zarządzać. Następnie wywołaj funkcję accounts.locations.list z polem name określonego konta, aby pobrać listę lokalizacji, do których to konto ma dostęp.

Jeśli na przykład chcesz pobrać wszystkie lokalizacje należące do grupy lokalizacji „Jan Kowalski”, wyślij to zapytanie:

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

Odpowiedź zwraca listę lokalizacji, do których użytkownik ma dostęp:

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

Schemat zarządzania lokalizacją

Ten diagram przedstawia:

• Organizacje mogą zawierać wiele grup użytkowników.
• Grupy użytkowników mogą zarządzać wieloma grupami lokalizacji.
• Grupy lokalizacji mogą zawierać wiele lokalizacji.
• Lokalizacje mogą obejmować wiele grup lokalizacji w różnych organizacjach.