W tym samouczku pokazujemy, jak korzystać z danych na koncie. Dzięki interfejsowi My Business Account Management API możesz:
- Wyświetl wszystkie konta.
- Przywrócić określone konto.
- Zaktualizuj konto.
Zanim zaczniesz
Zanim skorzystasz z interfejsu My Business Account Management API, musisz zarejestrować swoją aplikację i uzyskać dane uwierzytelniające OAuth 2.0.
Szczegółowe informacje o tym, jak zacząć korzystać z interfejsów Business Profile API, znajdziesz w artykule Podstawowa konfiguracja.
Wyświetl listę wszystkich kont
Świetnym sposobem na zweryfikowanie kont powiązanych z uwierzytelnionym użytkownikiem jest
wyświetlenie wszystkich ich kont. Za pomocą interfejsu API accounts.list
możesz wyświetlić listę wszystkich kont powiązanych z użytkownikiem.
Aby wyświetlić wszystkie konta uwierzytelnionego użytkownika:
$ GET https://mybusinessaccountmanagement.googleapis.com/v1/accounts
Zwrot określonego konta
Czasami chcesz zobaczyć tylko informacje o konkretnym koncie powiązanym z uwierzytelnionym użytkownikiem. Aby zwrócić konkretne konto i sprawdzić dodatkowe szczegóły konta, użyj interfejsu API accounts.get
.
Aby zwrócić konkretne konto według nazwy, użyj tych elementów:
$ GET https://mybusinessaccountmanagement.googleapis.com/v1/accounts/{accountId}
Aktualizacja konta
Zmiana nazwy konta to podstawowe zadanie administracyjne. Aby zmienić nazwę konta, użyj interfejsu API accounts.update
.
Aby zaktualizować nazwę konkretnego konta, skorzystaj z tych metod:
$ PUT https://mybusinessaccountmanagement.googleapis.com/v1/accounts/{accountId} { "account": { "accountName": "Anne Droyd" }, "languageCode": "en", "validateOnly": "true" }
Ograniczenia
- Jedyne pole, które można edytować na koncie, to
accountName
. Pozostałe pola są ignorowane. - W ten sposób można zaktualizować tylko konta typu
BUSINESS
.