Method: properties.audienceLists.list

Wyświetla listę wszystkich list odbiorców w usłudze. Pozwala to znaleźć i ponownie wykorzystać istniejące listy odbiorców, zamiast tworzyć zbędną nową listę. Ta sama lista odbiorców może mieć kilka list odbiorców reprezentujących listę użytkowników, którzy byli na danej liście odbiorców w różne dni.

Wprowadzenie do list odbiorców wraz z przykładami znajdziesz w części Tworzenie listy odbiorców.

Ta metoda jest dostępna w wersji beta o stabilności beta na stronie audienceExports.list. Aby przesłać opinię o tym interfejsie 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

Wymagane. W odpowiedzi zostaną wymienione 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ć mniej niż ta wartość. Jeśli nie określono inaczej, zwróconych zostanie maksymalnie 200 list odbiorców. Wartość maksymalna to 1000 (wyższe wartości zostaną zmienione na wartość maksymalną).
pageToken

string

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

Podczas dzielenia na strony wszystkie pozostałe parametry podane w narzędziu audienceLists.list muszą być zgodne z wywołaniem, które dostarczyło token strony.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Lista wszystkich list odbiorców w danej usłudze.

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 w usłudze.
nextPageToken

string

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

Zakresy autoryzacji

Wymaga jednego z tych zakresów protokołu OAuth:

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