Praca z danymi konta

Z tego samouczka dowiesz się, jak pracować z danymi na koncie. Interfejs My Business Account Management API umożliwia wykonywanie tych czynności:

  • wyświetlanie listy wszystkich kont;
  • wyświetlanie konkretnego konta;
  • aktualizowanie konta.

Zanim zaczniesz

Zanim zaczniesz korzystać z interfejsu My Business Account Management API, musisz zarejestrować aplikację i uzyskać dane logowania OAuth 2.0.

Więcej informacji o tym, jak zacząć korzystać z interfejsów Business Profile API, znajdziesz w artykule Podstawowa konfiguracja.

Wyświetlanie listy wszystkich kont

Dobrym sposobem na sprawdzenie kont powiązanych z uwierzytelnionym użytkownikiem jest wyświetlenie listy wszystkich jego kont. Aby wyświetlić listę wszystkich kont powiązanych z użytkownikiem, użyj interfejsu accounts.list API.

Aby wyświetlić listę wszystkich kont uwierzytelnionego użytkownika, użyj tego kodu:

HTTP
$ GET https://mybusinessaccountmanagement.googleapis.com/v1/accounts

Wyświetlanie konkretnego konta

Czasami chcesz wyświetlić tylko informacje o konkretnym koncie uwierzytelnionego użytkownika. Aby wyświetlić konkretne konto i dodatkowe informacje o nim, użyj interfejsu accounts.get API.

Aby wyświetlić konkretne konto według nazwy, użyj tego kodu:

HTTP
$ GET https://mybusinessaccountmanagement.googleapis.com/v1/accounts/{accountId}

Aktualizowanie konta

Zmiana nazwy konta to podstawowe zadanie administracyjne. Aby zmienić nazwę konta, użyj interfejsu accounts.update API.

Aby zaktualizować konkretne konto według nazwy, użyj tego kodu:

HTTP
$ PUT https://mybusinessaccountmanagement.googleapis.com/v1/accounts/{accountId}

{
  "account": {
    "accountName": "Anne Droyd"
  },
  "languageCode": "en",
  "validateOnly": "true"
}

Ograniczenia

  • Jedynym polem, które można edytować na koncie, jest accountName. Wszystkie inne przekazane pola są ignorowane.
  • W ten sposób można aktualizować tylko konta typu BUSINESS.