Method: accounts.list

Wyświetla listę kont dostępnych dla wywołującego użytkownika i odpowiadających ograniczeniom żądania, takim jak rozmiar strony czy filtry. Nie są to tylko subkonta MCA, ale wszystkie konta, do których użytkownik wywołujący ma dostęp, w tym inne multikonta klientów, konta połączone, samodzielne konta itd. Jeśli nie zostanie podany żaden filtr, zwraca konta, do których użytkownik został bezpośrednio dodany.

Żądanie HTTP

GET https://merchantapi.googleapis.com/accounts/v1beta/accounts

Adres URL używa składni transkodowania gRPC.

Parametry zapytania

Parametry
pageSize

integer

Opcjonalnie: Maksymalna liczba kont do zwrócenia. Usługa może zwrócić mniej niż ta wartość. Jeśli nie podasz tej wartości, zwróci się maksymalnie 250 kont. Maksymalna wartość to 500. Wartości powyżej 500 są przymusowo ustawiane na 500.

pageToken

string

Opcjonalnie: Token strony otrzymany z poprzedniego wywołania funkcji accounts.list. Podaj ten parametr, aby pobrać kolejną stronę.

Podczas podziału na strony wszystkie inne parametry przekazane do funkcji accounts.list muszą być zgodne z wywołaniem, które dostarczyło token strony.

filter

string

Opcjonalnie: Zwraca tylko konta, które pasują do filtra. Więcej informacji znajdziesz w dokumentacji dotyczącej składni filtrów.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

wiadomość z odpowiedzią dla metody accounts.list.

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

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

object (Account)

Konta pasujące do ListAccountsRequest.

nextPageToken

string

token, który może być wysyłany jako pageToken w celu pobrania następnej strony. Jeśli pominiesz to pole, nie będzie kolejnych stron.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/content

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