Gdy Twoja organizacja się rozwija, zarządzanie lokalizacjami i uprawnieniami stanie się dla Ciebie przytłaczające. W tym przewodniku znajdziesz sprawdzone metody zarządzania wieloma lokalizacjami oraz następujące typy kont:
Rodzaje kont
Każdy rodzaj konta ma przypisaną rolę w zarządzaniu lokalizacjami. Konto osobiste może zarządzać kontem organizacji, a następnie uzyskiwać uprawnienia do grup użytkowników i grup lokalizacji w tej organizacji. Na koncie osobistym można potem zarządzać lokalizacjami i informacjami o produktach przez powiązane grupy lokalizacji.
Konto osobiste
Osobiste konto Google jest automatycznie dostępne dla Ciebie, gdy utworzysz konto Google. Konta osobiste mogą być właścicielami i menedżerami wizytówek.
Konto organizacji
Konto organizacji to konto nadrzędne, które reprezentuje Twoją agencję. 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.
Dzięki interfejsowi My Business Account Management API możesz za pomocą metody accounts.admins.create zapraszać konta osobiste do zarządzania kontem organizacji lub jego własności.
Konto grupy lokalizacji
Grupa lokalizacji służy do zarządzania grupą pojedynczych lokalizacji. Grup lokalizacji możesz używać do wykonywania zadań zbiorczych w wielu lokalizacjach. Gdy dodasz do grupy lokalizacji konta osobiste i grupy użytkowników, dziedziczą one uprawnienia tej grupy.
Możesz też tworzyć grupy lokalizacji, aby dzielić lokalizacje na kategorie, np. według sieci, regionu lub kategorii. Lokalizacje mogą należeć do wielu grup lokalizacji naraz.
Dzięki interfejsowi My Business Account Management API możesz tworzyć grupy lokalizacji i przenieść lokalizacje do grupy lokalizacji za pomocą metody accounts.create. Możesz też zaprosić konta osobiste do zarządzania grupami lokalizacji za pomocą interfejsu API. Grupy użytkowników można dodawać do grup lokalizacji bezpośrednio 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 dodać konta osobiste. Następnie możesz przyznać uprawnienia do zarządzania grupami użytkowników wielu grupom lokalizacji w organizacji. Teraz wszystkie konta osobiste w grupie użytkowników mogą wykonywać działania menedżerskie w odniesieniu do lokalizacji należących do grup lokalizacji.
Na przykład gdy nowy członek dołączy do zespołu operacyjnego, możesz dodać go bezpośrednio do grupy użytkowników, aby natychmiast uzyskać dostęp do wszystkich lokalizacji, do których mają dostęp inni użytkownicy. Przyznawanie użytkownikom dostępu do poszczególnych lokalizacji trwa dłużej, a zarządzanie nim w taki sposób jest trudniejsze.
Dzięki interfejsowi My Business Account Management API możesz tworzyć grupy użytkowników za pomocą metody accounts.create. Możesz też używać tego interfejsu API do zapraszania kont osobistych do zarządzania 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łaj metodę accounts.list, podając swoje dane logowania OAuth. Odpowiedź zawiera listę wszystkich kont, ich identyfikatory podane w polu nazwa oraz typy kont.
Prośba
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"
}
]
}
W odpowiedzi na Twoje żądanie accounts.list mogą być uwzględnione wszystkie typy kont wymienione w tym przewodniku. Przejrzyj listę kont i znajdź konto z dostępem do lokalizacji, którymi chcesz zarządzać. Następnie wywołaj accounts.locations.list, wpisując w polu nazwa odpowiednie konto, 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 Jana Kowalskiego”, wyślij następujące żądanie:
GET
https://mybusinessbusinessinformation.googleapis.com/v1/{accountId}/locations
Authorization: Bearer <access_token>
Odpowiedź zwraca listę lokalizacji, do których użytkownik ma dostęp, na przykład:
{
"locations": [
{
"name": "locations/{locationId}",
"locationName": "Test Business",
...
},
{
"name": "locations/{locationId}",
"locationName": "2nd Test Business",
...
}
]
}
Schemat 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 różnych organizacjach.
