Method: properties.recurringAudienceLists.list

Zawiera wszystkie cykliczne listy odbiorców danej usługi. Dzięki tej metodzie możesz znajdować i wykorzystywać istniejące cykliczne listy odbiorców zamiast tworzenia zbędnych cyklicznych list odbiorców. Ta sama lista odbiorców może mieć wiele cyklicznych list odbiorców, 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 opinii 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. Odpowiedź będzie zawierać wszystkie cykliczne listy odbiorców w przypadku tej usługi. Format: properties/{property}

Parametry zapytania

Parametry
pageSize

integer

Opcjonalnie. Maksymalna liczba cyklicznych 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 cyklicznych 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 recurringAudienceLists.list. Podaj je, aby pobrać kolejną stronę.

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

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Lista wszystkich cyklicznych list odbiorców danej 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 cykliczna lista odbiorców danej usługi.
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