Method: properties.audienceExports.list

Wyświetla listę wszystkich eksportów list odbiorców z usługi. Dzięki tej metodzie możesz znajdować i ponownie wykorzystywać dotychczasowe eksporty list odbiorców zamiast tworzyć niepotrzebne nowe eksporty list odbiorców. Ta sama lista odbiorców może zawierać wiele eksportów danych o użytkownikach, którzy należeli do tej samej listy odbiorców w różnych dniach.

Wprowadzenie do eksportowania list odbiorców z przykładami znajdziesz w artykule Tworzenie eksportu list odbiorców.

Interfejsy API eksportowania list odbiorców mają pewne metody w wersji alfa i inne metody zapewniające stabilność w wersji beta. W ramach naszych działań zamierzamy rozwijać metody zwiększania stabilności w wersji beta po zebraniu opinii i wdrożeniu tych metod. 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/v1beta/{parent=properties/*}/audienceExports

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
parent

string

Wymagane. W odpowiedzi będą wymienione wszystkie eksporty list odbiorców z tej usługi. Format: properties/{property}

Parametry zapytania

Parametry
pageSize

integer

Opcjonalnie. Maksymalna liczba eksportów list odbiorców do zwrócenia. Usługa może zwrócić mniejszą wartość od tej wartości. Jeśli nie określono inaczej, zwróconych zostanie maksymalnie 200 eksportów 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 audienceExports.list. Podaj je, aby pobrać kolejną stronę.

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

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

Lista wszystkich eksportów list odbiorców z danej usługi.

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

Zapis JSON 
{
  "audienceExports": [
    {
      object (AudienceExport)
    }
  ],
  "nextPageToken": string
}
Pola
audienceExports[]

object (AudienceExport)

Każdy eksport listy odbiorców z 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