Z tego samouczka dowiesz się, jak pracować z danymi konta. Interfejs My Business Account Management API umożliwia:
- Wyświetla listę wszystkich kont.
- Zwraca informacje o konkretnym koncie.
- zaktualizować konto;
Zanim zaczniesz
Zanim użyjesz interfejsu API do zarządzania kontem Google Moja Firma, musisz zarejestrować swoją aplikację i uzyskać poświadczenia OAuth 2.0.
Szczegółowe informacje o tym, jak zacząć korzystać z interfejsów Business Profile API, znajdziesz w artykule Konfiguracja podstawowa.
Wyświetlanie listy wszystkich kont
Doskonałym sposobem na sprawdzenie kont powiązanych z uwierzytelnionym użytkownikiem jest wyświetlenie wszystkich jego kont. Użyj interfejsu accounts.list
API, aby wyświetlić listę wszystkich kont powiązanych z użytkownikiem.
Aby wyświetlić wszystkie konta uwierzytelnionego użytkownika, użyj:
$ GET https://mybusinessaccountmanagement.googleapis.com/v1/accounts
Zwracanie konkretnego konta
Czasami chcesz wyświetlić tylko informacje o konkretnym koncie uwierzytelnionego użytkownika. Użyj interfejsu API accounts.get
, aby pobrać konkretne konto i sprawdzić dodatkowe informacje o nim.
Aby zwrócić konkretne konto według nazwy, użyj tych instrukcji:
$ GET https://mybusinessaccountmanagement.googleapis.com/v1/accounts/{accountId}
Aktualizowanie konta
Zmiana nazwy konta to podstawowe zadanie administracyjne. Aby zmienić nazwę konta, użyj interfejsu API accounts.update
.
Aby zaktualizować konkretne konto według nazwy, wykonaj te czynności:
$ PUT https://mybusinessaccountmanagement.googleapis.com/v1/accounts/{accountId} { "account": { "accountName": "Anne Droyd" }, "languageCode": "en", "validateOnly": "true" }
Ograniczenia
- Jedynym edytowalnym polem na koncie jest
accountName
. Pozostałe pola są ignorowane. - W ten sposób można aktualizować tylko konta typu
BUSINESS
.