Method: accounts.list

Wyświetla listę wszystkich kont uwierzytelnionego użytkownika. Dotyczy to wszystkich kont należących do użytkownika i kont, którymi ten użytkownik ma uprawnienia do zarządzania.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry zapytania

Parametry
parentAccount

string

Opcjonalnie. Nazwa zasobu konta, dla którego ma zostać pobrana lista kont dostępnych bezpośrednio. Ma to sens tylko w przypadku organizacji i grup użytkowników. Jeśli pole jest puste, zwraca wartość accounts.list w przypadku uwierzytelnionego użytkownika. accounts/{account_id}.
pageSize

integer

Opcjonalnie. Liczba kont do pobrania na stronę. Wartości domyślne i maksymalne to 20.
pageToken

string

Opcjonalnie. Jeśli określono wartość, pobierana jest następna strona kont. Wartość pageToken jest zwracana, gdy wywołanie metody accounts.list zwraca więcej wyników, niż może się zmieścić w żądanym rozmiarze strony.
filter

string

Opcjonalnie. Filtr ograniczający konta, które mają zostać zwrócone. Odpowiedź zawiera tylko wpisy pasujące do filtra. Jeśli pole filter jest puste, nie są stosowane żadne ograniczenia i wszystkie konta (podzielone na strony) są pobierane z żądanego konta.

Na przykład żądanie z filtrem type=USER_GROUP zwróci tylko grupy użytkowników.

Pole type jest jedynym obsługiwanym filtrem.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Odpowiedź dotycząca konta accounts.ListAccounts.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "accounts": [
    {
      object (Account)
    }
  ],
  "nextPageToken": string
}
Pola
accounts[]

object (Account)

Zbiór kont, do których użytkownik ma dostęp. Konto osobiste użytkownika wykonującego zapytanie będzie zawsze pierwszym elementem wyniku, chyba że zostanie odfiltrowane.
nextPageToken

string

Jeśli liczba kont przekracza żądany rozmiar strony, w tym polu pojawia się token służący do pobierania następnej strony kont przy kolejnym wywołaniu funkcji accounts.list. Jeśli nie ma więcej kont, to pole nie jest obecne w odpowiedzi.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/business.manage

Więcej informacji znajdziesz w artykule Omówienie protokołu OAuth 2.0.