Przenoszenie lokalizacji

Interfejs API do zarządzania kontem Moja Firma umożliwia przenoszenie lokalizacji na inne konta lub do innych grup lokalizacji. Aby dowiedzieć się, jak to zrobić, postępuj zgodnie z instrukcjami w tej dokumentacji.

Uwaga: aby przenieść lokalizację, osoba wywołująca musi być jej właścicielem, a właściciel konta docelowego musi być co najmniej menedżerem tej lokalizacji. Więcej informacji o przyznawaniu prawa własności do wizytówki znajdziesz w artykule Zarządzanie administratorami kont i lokalizacji.

Rozpocznij

Aby przenieść lokalizacje, musisz mieć te elementy:

Konto źródłowe: jest to konto, które jest właścicielem lokalizacji. Może to być konto osobiste lub grupa lokalizacji. Po zakończeniu przenoszenia konto źródłowe nie ma już dostępu do lokalizacji.
Konto docelowe: jest to konto, na które ma zostać przeniesiona lokalizacja. Może to być konto osobiste lub grupa lokalizacji. Po zakończeniu przenoszenia konto docelowe jest głównym właścicielem lokalizacji.
Tokeny odświeżania i dostępu OAuth2: Aby wywołać interfejs API, musisz mieć tokeny odśświeżania i dostępu OAuth2 dla konta źródłowego i docelowego.

Przenoszenie lokalizacji

Uwaga: w przypadku profili firm obowiązuje okres próbny dla administratorów lokalizacji. Gdy użytkownik zostanie dodany do profilu jako właściciel lub menedżer, przez 7 dni będzie miał ograniczone możliwości wykonywania operacji na użytkownikach innej lokalizacji i na samej lokalizacji. W tym czasie użytkownicy w okresie próbnym nie będą mogli przenieść uprawnień głównego właściciela profilu na siebie ani na innego użytkownika.

Aby przenieść lokalizacje, wykonaj te czynności:

1. Jeśli nie jesteś właścicielem lokalizacji, musisz nim zostać. Użyj danych logowania OAuth obecnego właściciela firmy, aby wywołać account.admins.create i zaprosić użytkownika do przejęcia prawa własności do wizytówki. Następnie użyj danych logowania OAuth zaproszonego użytkownika, aby wywołać accounts.invitations.list i uzyskać identyfikator zaproszenia. Wywołaj accounts.invitations.accept , aby zaakceptować to zaproszenie.

   Uwaga: odbiorca nie może być członkiem konta organizacji ani grupy użytkowników.

2. Użyj danych logowania OAuth konta docelowego, aby wywołać accounts.list. Następnie znajdź na liście identyfikator konta, na które chcesz przenieść lokalizację. Jako identyfikator konta możesz też użyć identyfikatora administratora w odpowiedzi na wywołanie account.admins.create lub accounts.invitations.list w kroku 1. Ten identyfikator konta może odnosić się do konta osobistego lub grupy lokalizacji.

3. Użyj identyfikatora konta pobranego w kroku 2 jako konta docelowego. Jest to pole destinationAccount w treści żądania, którego możesz użyć do wywołania locations.transfer.

   Uwaga: po zakończeniu przenoszenia konto docelowe jest głównym kontem powiązanym z właścicielem wizytówki. Jeśli nie jest to oczekiwany wynik, powtórz kroki 1–3 z nowym użytkownikiem. Następnie przenieś lokalizację z powrotem na pierwotne konto główne. Aby obniżyć rolę administratora pierwotnego konta docelowego, możesz użyć accounts.admins.patch punktu końcowego.

Użyj danych logowania OAuth konta docelowego, aby wywołać accounts.locations.list i sprawdzić, czy przeniesiona lokalizacja pojawia się w wynikach. Jeśli wywołasz punkt końcowy accounts.locations.list z konta źródłowego, przeniesiona lokalizacja nie zostanie uwzględniona w wynikach.

Przenoszenie do grupy lokalizacji

Aby przenieść lokalizację do location group w organizacji, wywołaj locations.admins.create za pomocą danych logowania OAuth merchant. Użyj pola account w zasobie Admin, aby przekazać location group account ID wraz z odpowiednią role. Aby pobrać zaproszenia związane z location group, użyj danych logowania administratora do wywołania accounts.invitations.list z identyfikatorem konta grupy lokalizacji jako argumentem parent do pobrania zaproszeń związanych z location group. Znajdź zaproszenie, które ma prawidłową lokalizację docelową, a następnie wywołaj accounts.invitations.accept , aby zaakceptować prawidłowe zaproszenie.