Method: properties.recurringAudienceLists.list

Zawiera listę wszystkich cyklicznych list odbiorców w danej usłudze. Możesz użyć tej metody, aby znaleźć i ponownie wykorzystać istniejące cykliczne listy odbiorców, zamiast tworzyć nowe, niepotrzebne nowe listy odbiorców. Ta sama grupa odbiorców może mieć wiele powtarzających się list odbiorców, które reprezentują różne kombinacje wymiarów. na przykład 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ę 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/*}/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 powtarzających się list odbiorców, które możesz zwrócić. Usługa może zwrócić mniej niż ta wartość. Jeśli nie określono inaczej, zwróconych zostanie maksymalnie 200 cyklicznych 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 recurringAudienceLists.list. Podaj go, aby pobrać kolejną stronę.

Podczas dzielenia na strony wszystkie pozostałe parametry podane w narzędziu 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 cyklicznych list odbiorców w danej usłudze.

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 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