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://mybusiness.googleapis.com/v4/accounts

Adres URL używa składni transkodowania gRPC.

Parametry zapytania

Parametry
pageSize

integer

Liczba kont do pobrania na stronę. Wartość domyślna to 20, minimalna 2, a maksymalna – 20.
pageToken

string

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.
name

string

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.
filter

string

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.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

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

Komunikat z odpowiedzią na temat Kont.ListAccounts.

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 jednego z tych zakresów protokołu OAuth:

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

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