Method: properties.audienceLists.create

Tworzy listę odbiorców do późniejszego pobrania. Ta metoda szybko zwraca nazwę zasobu listy odbiorców i inicjuje długotrwałe asynchroniczne żądanie utworzenia listy odbiorców. Aby umieścić użytkowników na liście odbiorców, najpierw utwórz listę odbiorców za pomocą tej metody, a potem wyślij nazwę zasobu odbiorców do metody audienceLists.query.

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

Lista odbiorców to podsumowanie użytkowników znajdujących się obecnie na liście odbiorców w momencie jej tworzenia. Tworzenie list odbiorców dla jednej grupy odbiorców w różnych dniach będzie zwracać różne wyniki w miarę, w jaki użytkownicy wchodzą na tę listę, a potem ją opuszczają.

Listy odbiorców w Google Analytics 4 umożliwiają podział użytkowników na segmenty odpowiadające wymaganiom Twojej firmy. Więcej informacji znajdziesz na stronie https://support.google.com/analytics/answer/9267572. Listy odbiorców zawierają użytkowników z poszczególnych grup odbiorców.

Ta metoda jest dostępna w przypadku stabilności beta pod adresem audienceExports.create. Aby przesłać opinię na temat tego interfejsu API, wypełnij formularz opinii o interfejsie Google Analytics Audience Export API.

Żądanie HTTP

POST https://analyticsdata.googleapis.com/v1alpha/{parent=properties/*}/audienceLists

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
parent

string

To pole jest wymagane. Zasób nadrzędny, w którym zostanie utworzona ta lista odbiorców. Format: properties/{property}

Treść żądania

Treść żądania zawiera wystąpienie elementu AudienceList.

Treść odpowiedzi

Jeśli operacja się uda, treść odpowiedzi będzie zawierała nowo utworzoną instancję Operation.

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

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