Method: properties.recurringAudienceLists.list

Wyświetla wszystkie cykliczne listy odbiorców w usłudze. Dzięki tej metodzie możesz znaleźć i ponowić użycie istniejących list odbiorców, zamiast tworzyć niepotrzebne nowe listy odbiorców. Ta sama grupa odbiorców może mieć wiele list odbiorców powtarzających się, które reprezentują różne kombinacje wymiarów, np. tylko wymiar deviceId lub oba wymiary deviceId i userId.

Wprowadzamy tę metodę na poziomie stabilności alfa, aby zebrać opinie na temat jej składni i możliwości, zanim udostępnimy wersję beta. 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/*}/recurringAudienceLists

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
parent

string

Wymagane. W odpowiedzi zostaną wymienione wszystkie cykliczne listy odbiorców w tej usłudze. Format: properties/{property}

Parametry zapytania

Parametry
pageSize

integer

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

string

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

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

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Lista wszystkich powtarzających się list odbiorców w przypadku usługi.

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

Zapis JSON 
{
  "recurringAudienceLists": [
    {
      object (RecurringAudienceList)
    }
  ],
  "nextPageToken": string
}
Pola
recurringAudienceLists[]

object (RecurringAudienceList)

Każda lista odbiorców powtarzających się w przypadku usługi.
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