- Żądanie HTTP
- Parametry ścieżki
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
- AudienceRow
- AudienceDimensionValue
- Wypróbuj
Pobiera eksport list odbiorców z użytkownikami. Po utworzeniu listy odbiorców użytkownicy nie są od razu dostępni do eksportu. Najpierw żądanie wysłane do audienceExports.create
jest konieczne do utworzenia eksportu list odbiorców z użytkownikami. Po drugie, ta metoda służy do pobierania użytkowników ujętych w eksporcie list odbiorców.
Wprowadzenie do eksportowania list odbiorców wraz z przykładami znajdziesz w artykule Tworzenie eksportu odbiorców.
Listy odbiorców w Google Analytics 4 umożliwiają dzielenie użytkowników na segmenty w sposób odpowiadający wymaganiom Twojej firmy. Więcej informacji znajdziesz na stronie https://support.google.com/analytics/answer/9267572.
Interfejsy API eksportowania list odbiorców korzystają z pewnych metod w wersji alfa, a inne w stabilności beta. Celem jest rozwijanie metod stabilizacji wersji beta po uzyskaniu opinii i wdrożenia aplikacji. Aby przesłać opinię o tym interfejsie API, wypełnij formularz opinii o interfejsie Google Analytics Audience Export API.
Żądanie HTTP
POST https://analyticsdata.googleapis.com/v1beta/{name=properties/*/audienceExports/*}:query
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
Parametry | |
---|---|
name |
Wymagane. Nazwa eksportu list odbiorców, z którego mają zostać pobrane dane użytkowników. Format: |
Treść żądania
Treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{ "offset": string, "limit": string } |
Pola | |
---|---|
offset |
Opcjonalnie: Liczba wierszy w wierszu początkowym. Pierwszy wiersz jest liczony jako wiersz 0. Podczas stronicowania pierwsze żądanie nie określa przesunięcia. lub równoważnie ustawia przesunięcie na 0; pierwsze żądanie zwraca pierwsze Więcej informacji o tym parametrze podziału na strony znajdziesz w sekcji Podział na strony. |
limit |
Opcjonalnie: Liczba wierszy do zwrócenia. Jeśli wartość nie jest określona, zwracanych jest 10 000 wierszy. Interfejs API zwraca maksymalnie 250 000 wierszy na żądanie bez względu na to, o ile prosisz. Wartość Interfejs API może też zwrócić mniej wierszy niż żądane Więcej informacji o tym parametrze podziału na strony znajdziesz w sekcji Podział na strony. |
Treść odpowiedzi
Lista użytkowników objętych eksportem list odbiorców.
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{ "audienceRows": [ { object ( |
Pola | |
---|---|
audienceRows[] |
Wiersze każdego użytkownika w eksporcie list odbiorców. Liczba wierszy w tej odpowiedzi będzie mniejsza od rozmiaru strony w żądaniu lub jej równa. |
audienceExport |
Dane konfiguracji dotyczące eksportowanych danych odbiorców AudienceExport. Powrót pomaga zinterpretować wiersze odbiorców w tej odpowiedzi. Na przykład wymiary w tym raporcie AudienceExport odpowiadają kolumnom w kolumnie AudienceRows. |
rowCount |
Łączna liczba wierszy w wyniku AudienceExport. Wartość Więcej informacji o tym parametrze podziału na strony znajdziesz w sekcji Podział na strony. |
Zakresy autoryzacji
Wymaga jednego z tych zakresów protokołu OAuth:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics
AudienceRow
Atrybuty wartości wymiaru w wierszu użytkownika listy odbiorców.
Zapis JSON |
---|
{
"dimensionValues": [
{
object ( |
Pola | |
---|---|
dimensionValues[] |
Każdy atrybut wartości wymiaru u użytkownika na liście odbiorców. Jedna wartość wymiaru zostanie dodana do każdej żądanej kolumny wymiaru. |
AudienceDimensionValue
Wartość wymiaru.
Zapis JSON |
---|
{ // Union field |
Pola | |
---|---|
Pole sumy one_value . Jeden rodzaj wartości wymiaru. one_value może mieć tylko jedną z tych wartości: |
|
value |
Wartość w postaci ciągu znaków, jeśli typem wymiaru jest ciąg znaków. |