- Żądanie HTTP
- Parametry ścieżki
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
- ResponseMetaData
- SchemaRestrictionResponse
- ActiveMetricRestriction:
- RestrictedMetricType
- Wypróbuj
Pobiera treść zadania raportu. Po wysłaniu żądania reportTasks.create
możesz pobrać treść raportu, gdy stanie się on AKTYWNY. Ta metoda zwróci błąd, jeśli zadanie raportu ma stan inny niż ACTIVE
. Odpowiedź na zapytanie zwróci wartości wiersza i kolumny raportu przedstawione w tabeli.
Żądanie HTTP
POST https://analyticsdata.googleapis.com/v1alpha/{name=properties/*/reportTasks/*}:query
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
Parametry | |
---|---|
name |
Wymagane. Nazwa źródła raportu. Format: |
Treść żądania
Treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{ "offset": string, "limit": string } |
Pola | |
---|---|
offset |
Opcjonalnie. Liczba wierszy w początkowym wierszu raportu. 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 artykule Podział na strony. |
limit |
Opcjonalnie. Liczba wierszy zwracanych z raportu. Jeśli nie określono inaczej, zwracanych jest 10 000 wierszy. Interfejs API zwraca maksymalnie 250 000 wierszy na żądanie,niezależnie od tego, ile zażądasz. Interfejs API może też zwrócić mniej wierszy niż w żądaniu Więcej informacji o tym parametrze podziału na strony znajdziesz w artykule Podział na strony. |
Treść odpowiedzi
Treść raportu odpowiadająca zadaniu w postaci raportu.
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{ "dimensionHeaders": [ { object ( |
Pola | |
---|---|
dimensionHeaders[] |
Opisuje kolumny wymiarów. Liczba nagłówków wymiarów i ich kolejność są zgodne z wymiarami podanymi w wierszach. |
metricHeaders[] |
Opisuje kolumny danych. Liczba i kolejność nagłówków MetricHeaders są zgodne z danymi w wierszach. |
rows[] |
Wiersze z kombinacjami wartości wymiarów i wartościami danych w raporcie. |
totals[] |
Zsumowane wartości danych (w razie potrzeby). |
maximums[] |
Maksymalne wartości danych, jeśli jest to wymagane. |
minimums[] |
Minimalne wartości danych, jeśli są wymagane. |
rowCount |
Łączna liczba wierszy w wyniku zapytania. |
metadata |
Metadane raportu. |
Zakresy autoryzacji
Wymaga jednego z tych zakresów OAuth:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics
ResponseMetaData
Metadane odpowiedzi z dodatkowymi informacjami o treści raportu.
Zapis JSON |
---|
{
"dataLossFromOtherRow": boolean,
"schemaRestrictionResponse": {
object ( |
Pola | |
---|---|
dataLossFromOtherRow |
Jeśli wartość to prawda, wskazuje, że niektóre grupy kombinacji wymiarów zostały umieszczone w wierszu „(inne)”. Może się tak zdarzyć w przypadku raportów o dużej mocy zbioru. Parametr metadanych dataLossFromOtherRow jest wypełniany na podstawie tabeli danych zbiorczych używanej w raporcie. Parametr zostanie wypełniony dokładnie niezależnie od filtrów i limitów w raporcie. Na przykład wiersz „(inne)” może zostać usunięty z raportu, ponieważ żądanie zawiera filtr sessionSource = google. Ten parametr będzie nadal wypełniany, jeśli w danych zbiorczych użytych do wygenerowania tego raportu wykryto utratę danych z innego wiersza. Więcej informacji znajdziesz w artykule Wiersz „(inne)” i próbkowanie danych. |
schemaRestrictionResponse |
Opisuje ograniczenia schematu aktywnie egzekwowane podczas tworzenia tego raportu. Więcej informacji znajdziesz w artykule Zarządzanie dostępem i ograniczeniami dotyczącymi danych. |
currencyCode |
Kod waluty używany w tym raporcie. Przeznaczona do formatowania danych walutowych, takich jak Kody walut to zakodowane ciągi znaków określające typy walut zgodne ze standardem ISO 4217 (https://en.wikipedia.org/wiki/ISO_4217), takie jak „PLN”, „EUR”, „JPY”. Więcej informacji znajdziesz na stronie https://support.google.com/analytics/answer/9796179. |
timeZone |
Bieżąca strefa czasowa usługi. Służy do interpretacji wymiarów opartych na czasie, np. |
emptyReason |
Jeśli podasz pustą przyczynę, raport będzie z tego powodu pusty. |
subjectToThresholding |
Jeśli |
SchemaRestrictionResponse
Ograniczenia schematu są aktywnie egzekwowane podczas tworzenia tego raportu. Więcej informacji znajdziesz w artykule Zarządzanie dostępem i ograniczeniami dotyczącymi danych.
Zapis JSON |
---|
{
"activeMetricRestrictions": [
{
object ( |
Pola | |
---|---|
activeMetricRestrictions[] |
Wszystkie ograniczenia są aktywnie egzekwowane podczas tworzenia raportu. Na przykład |
ActiveMetricRestriction
Dane, w przypadku których tworzenie raportu jest aktywnie ograniczone.
Zapis JSON |
---|
{
"restrictedMetricTypes": [
enum ( |
Pola | |
---|---|
restrictedMetricTypes[] |
Przyczyna ograniczenia tych danych. |
metricName |
Nazwa danych objętych ograniczeniami. |
RestrictedMetricType
Kategorie danych, których możesz nie widzieć w niektórych usługach w GA4.
Wartości w polu enum | |
---|---|
RESTRICTED_METRIC_TYPE_UNSPECIFIED |
Nieokreślony typ. |
COST_DATA |
Dane o kosztach, np. adCost . |
REVENUE_DATA |
Dane o przychodach, np. purchaseRevenue . |