Praca z danymi na koncie

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:

HTTP
$ 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:

HTTP
$ 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:

HTTP
$ 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.