Method: accounts.list

Wyświetla listę wszystkich kont uwierzytelnionego użytkownika. Dotyczy to wszystkich kont należących do użytkownika oraz tych, na których 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 bezpośrednio dostępnych kont. Ma to sens tylko w przypadku organizacji i grup użytkowników. Jeśli pole jest puste, w przypadku uwierzytelnionego użytkownika zwraca wartość accounts.list. accounts/{account_id}.
pageSize

integer

Opcjonalnie: Liczba kont do pobrania na stronę. Wartością domyślną i maksymalną jest 20.
pageToken

string

Opcjonalnie: Jeśli jest określony, pobierana jest następna strona kont. Parametr pageToken jest zwracany, gdy wywołanie funkcji accounts.list zwróci więcej wyników, niż mieści się w żądanym rozmiarze strony.
filter

string

Opcjonalnie: Filtr ograniczający konta do zwrócenia. Odpowiedź zawiera tylko wpisy pasujące do filtra. Jeśli pole filter jest puste, nie są stosowane żadne ograniczenia i wszystkie konta (z podziałem na strony) są pobierane z żądanego konta.

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

Jedynym obsługiwanym filtrem jest pole type.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Komunikat z odpowiedzią na temat Kont.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, który wykonał zapytanie, będzie zawsze pierwszym elementem wyniku, chyba że zostanie odfiltrowane.
nextPageToken

string

Jeśli liczba kont przekracza wymagany rozmiar strony, w tym polu pojawia się token umożliwiający pobranie następnej strony kont przy kolejnym wywołaniu funkcji accounts.list. Jeśli nie ma więcej kont, to pole nie występuje 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.