Method: properties.audienceLists.list

Wyświetla wszystkie listy odbiorców w przypadku danej usługi. Dzięki tej metodzie możesz znajdować i wykorzystywać istniejące listy odbiorców zamiast tworzyć niepotrzebne nowe listy odbiorców. Ta sama lista odbiorców może zawierać wiele list odbiorców, które reprezentują listę użytkowników, którzy byli na liście odbiorców w różne dni.

Więcej informacji o listach odbiorców wraz z przykładami znajdziesz w artykule Tworzenie listy odbiorców.

Ta metoda jest dostępna w wersji beta w metodzie audienceExports.list. Aby przesłać opinię na temat tego interfejsu API, wypełnij formularz Opinie 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 dla tej usługi. Format: properties/{property}

Parametry zapytania

Parametry
pageSize

integer

Opcjonalnie: Maksymalna liczba zwracanych list odbiorców. Usługa może zwrócić mniej niż ta wartość. Jeśli nie podasz tej wartości, zwróci się maksymalnie 200 list odbiorców. Maksymalna wartość to 1000 (wyższe wartości zostaną przymusowo zastąpione maksymalną).
pageToken

string

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

Podczas podziału na strony wszystkie inne parametry przekazane do funkcji 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 przypadku 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 w usłudze.
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 jednego z tych zakresów OAuth:

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