Method: properties.audienceLists.list

Wyświetla listę wszystkich list odbiorców związanych z usługą. Dzięki tej metodzie możesz znajdować i ponownie wykorzystywać istniejące listy odbiorców zamiast tworzyć niepotrzebne nowe listy. Ta sama lista odbiorców może mieć wiele list odbiorców reprezentujących listę użytkowników, którzy należeli do listy odbiorców w różnych dniach.

Wprowadzenie do list odbiorców z przykładami znajdziesz w artykule Tworzenie listy odbiorców.

Ta metoda jest dostępna w przypadku stabilności beta na stronie audienceExports.list. Aby przesłać opinię na temat tego interfejsu API, wypełnij formularz opinii o interfejsie Google Analytics Audience Export API.

Żądanie HTTP

GET https://analyticsdata.googleapis.com/v1alpha/{parent=properties/*}/audienceLists

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
parent

string

To pole jest wymagane. Odpowiedź zawiera wszystkie listy odbiorców powiązane z tą usługą. Format: properties/{property}

Parametry zapytania

Parametry
pageSize

integer

Opcjonalnie. Maksymalna liczba list odbiorców do zwrócenia. Usługa może zwrócić mniejszą wartość od tej wartości. Jeśli wartość nie zostanie podana, zwróconych zostanie maksymalnie 200 list odbiorców. Wartość maksymalna to 1000 (wyższe wartości zostaną przekształcone w wartości maksymalnej).

pageToken

string

Opcjonalnie. Token strony odebrany z poprzedniego wywołania audienceLists.list. Podaj je, aby pobrać kolejną stronę.

W przypadku podziału na strony wszystkie pozostałe parametry podane w interfejsie audienceLists.list muszą odpowiadać wywołaniu, które podało token strony.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Lista wszystkich list odbiorców danej usługi.

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

Zapis JSON
{
  "audienceLists": [
    {
      object (AudienceList)
    }
  ],
  "nextPageToken": string
}
Pola
audienceLists[]

object (AudienceList)

Każda lista odbiorców określona w usłudze.

nextPageToken

string

Token, który można wysłać jako pageToken, aby pobrać następną stronę. Jeśli pominiesz to pole, nie będzie kolejnych stron.

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics