Zarządzanie lokalizacjami na dużą skalę

W miarę rozwoju organizacji zarządzanie lokalizacjami i uprawnieniami może przytłacza Cię. Ten przewodnik zawiera szczegółowe informacje na temat sprawdzonych metod zarządzania oraz następujące typy kont:

Rodzaje kont

Każdy rodzaj konta ma swoją rolę w zarządzaniu lokalizacjami. Konto osobiste może zarządzać kontem organizacji, a następnie uzyskiwać uprawnienia do grup użytkowników i grupy lokalizacji w tej organizacji. Pozwala to zarządzać kontem osobistym lokalizacje i informacje o produktach za pomocą powiązanych grup lokalizacji.

Konto osobiste

Konto osobiste jest automatycznie dostępne po utworzeniu Konto Google. Konta osobiste może być właścicieli i menedżerów wizytówek.

Konto organizacji

An konto organizacji to konto nadrzędne, które reprezentuje agencja. Zostanie w niej zapisana grupa lokalizacji i grupy użytkowników, a wszyscy członkowie które organizacja ma do nich dostęp. Lokalizacje mogą być częścią wielu organizacji non-profit.

Dzięki interfejsowi My Business Account Management API możesz używać accounts.admins.create , aby zaprosić konta osobiste do zarządzania kontem organizacji lub być jego właścicielem.

Konto grupy lokalizacji

O grupa lokalizacji służy do zarządzania grupą poszczególnych lokalizacji. Możesz użyć grupy lokalizacji do wykonywania zadań zbiorczych w wielu lokalizacjach. Jeśli dodasz konta osobiste grupy użytkowników do grupy lokalizacji, dziedziczą one uprawnienia tej grupy.

Możesz też tworzyć grupy lokalizacji, by klasyfikować lokalizacje, np. według sieci, regionu lub kategorii. Lokalizacje mogą znajdować się w wielu grupach lokalizacji jednocześnie.

Dzięki interfejsowi My Business Account Management API możesz używać accounts.create do tworzyć grupy lokalizacji; przenieś lokalizacje do lokalizacji grupy reklam. Konta osobiste można też zapraszać do zarządzać grupami lokalizacji za pomocą interfejsu API. Użytkownik do grup lokalizacji można dodawać bezpośrednio z poziomu interfejsu internetowego.

Konto grupy użytkowników

Aby zarządzać uprawnieniami na dużą skalę, użyj grupie użytkowników. Do grupy użytkowników możesz dodać konta osobiste. Następnie możesz przyznać użytkownikowi dostęp do zarządzania grupami do wielu grup lokalizacji w organizacji. Teraz wszystkie użytkownicy kont osobistych należących do grupy użytkowników mogą wykonywać działania menedżerskie w witrynie lokalizacje w grupach lokalizacji.

Gdy na przykład nowy członek dołącza do zespołu operacyjnego, możesz go dodać do grupy użytkowników i zyskają oni natychmiastowy dostęp do wszystkich lokalizacji do których inne osoby mają dostęp. Przyznanie użytkownikom dostępu do każdego do pojedynczej lokalizacji, co jest trudniejsze do zarządzania w ten sposób.

Dzięki interfejsowi My Business Account Management API możesz używać accounts.create do tworzyć grupy użytkowników. Za pomocą interfejsu API możesz też zapraszać konta osobiste do korzystania zarządzanie administratorami kont i lokalizacji

Wywoływanie listy wszystkich kont za pomocą interfejsu API

Aby wyświetlić listę wszystkich kont, do których masz dostęp, oraz powiązanych z nimi typów kont: wywołanie metody accounts.list za pomocą danych logowania OAuth. zawiera listę wszystkich kont, ich identyfikatorów podane w polu name (nazwa) i rodzaje kont.

Żądanie

Oto Przykład żądania accounts.list:

HTTP
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ź może zawierać wszystkie typy kont opisane w tym przewodniku do accounts.list. Sprawdź listę kont i zidentyfikować konto, które ma dostęp do lokalizacjami, którymi chcesz zarządzać. Następnie zadzwoń accounts.locations.list pola name konkretnego konta, aby uzyskać listę lokalizacji, do których to konto ma dostęp.

Jeśli na przykład chcesz pobrać wszystkie lokalizacje, które należą do „Location Group” (Grupa lokalizacji), wyślij następujące żądanie:

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

Odpowiedź zwraca listę lokalizacji, do których użytkownik ma dostęp, np. następujące:

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

Diagram zarządzania lokalizacją

Na tym diagramie widać:

  • 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 organizacjach.
.
Hierarchia zarządzania lokalizacją
Rysunek 1. Hierarchia zarządzania lokalizacją
.