- Żądanie HTTP
- Parametry ścieżki
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
- RunReportRequest
- Wypróbuj
Zwraca wiele raportów zbiorczo. Wszystkie raporty muszą dotyczyć tej samej usługi w GA4.
Żądanie HTTP
POST https://analyticsdata.googleapis.com/v1beta/{property=properties/*}:batchRunReports
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
Parametry | |
---|---|
property |
Identyfikator usługi w GA4 w Google Analytics, której zdarzenia są śledzone. Jest określona w ścieżce adresu URL, a nie w treści. Więcej informacji znajdziesz w sekcji, gdzie możesz znaleźć identyfikator usługi. Tę właściwość należy określić dla grupy. Właściwość RunReportRequest może być nieokreślona lub zgodna z tą właściwością. Przykład: properties/1234 |
Treść żądania
Treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{
"requests": [
{
object ( |
Pola | |
---|---|
requests[] |
Pojedyncze żądania. Każde żądanie wiąże się z osobną odpowiedzią w raporcie. Każde żądanie zbiorcze może zawierać maksymalnie 5 żądań. |
Treść odpowiedzi
Odpowiedź zbiorcza zawierająca wiele raportów.
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{
"reports": [
{
object ( |
Pola | |
---|---|
reports[] |
Poszczególne odpowiedzi. Każda odpowiedź zawiera osobne żądanie raportu. |
kind |
Określa rodzaj zasobu, do którego należy ten komunikat. Ta wiadomość |
Zakresy autoryzacji
Wymaga jednego z tych zakresów OAuth:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics
RunReportRequest
Żądanie wygenerowania raportu.
Zapis JSON |
---|
{ "property": string, "dimensions": [ { object ( |
Pola | |
---|---|
property |
Identyfikator usługi w GA4 w Google Analytics, której zdarzenia są śledzone. Jest określona w ścieżce adresu URL, a nie w treści. Więcej informacji znajdziesz w sekcji, gdzie możesz znaleźć identyfikator usługi. W żądaniu zbiorczym ta właściwość powinna być nieokreślona lub spójna z właściwością na poziomie wsadu. Przykład: properties/1234 |
dimensions[] |
Żądane i wyświetlone wymiary. |
metrics[] |
Żądane i wyświetlone wskaźniki. |
dateRanges[] |
Zakresy dat danych do odczytania. Jeśli poprosisz o wiele zakresów dat, każdy wiersz odpowiedzi będzie zawierał indeks zakresu dat liczony od 0. Jeśli 2 zakresy dat się pokrywają, dane zdarzeń z pokrywających się dni znajdą się w wierszach odpowiedzi dla obu zakresów dat. W żądaniu dotyczącym kohorty parametr |
dimensionFilter |
Za pomocą filtrów wymiarów możesz poprosić o podawanie w raporcie tylko określonych wartości wymiarów. Aby dowiedzieć się więcej, zapoznaj się z przykładami w artykule Podstawy filtrów wymiarów. W tym filtrze nie można używać danych. |
metricFilter |
Klauzula filtra wskaźników. Stosowana po zagregowaniu wierszy raportu, podobnie jak w przypadku klauzuli SQL. W tym filtrze nie można używać wymiarów. |
offset |
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 artykule Podział na strony. |
limit |
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. 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. |
metricAggregations[] |
Agregacja danych. Łączne wartości danych będą widoczne w wierszach, w których wymiar wymiar ma wartość „RESERVED_(MetricAggregation)”. |
orderBys[] |
Określa kolejność wierszy w odpowiedzi. |
currencyCode |
Kod waluty w formacie ISO4217, np. „AED”, „USD” lub „JPY”. Jeśli to pole jest puste, raport używa domyślnej waluty usługi. |
cohortSpec |
Grupa kohorty powiązana z tym żądaniem. Jeśli żądanie zawiera grupę kohorty, musi być obecny wymiar „kohorta”. |
keepEmptyRows |
Jeśli zasada ma wartość Fałsz lub jest nieokreślona, każdy wiersz ze wszystkimi danymi równymi 0 nie jest zwracany. Jeśli ma wartość true (prawda), te wiersze zostaną zwrócone, jeśli nie zostaną osobno usunięte przez filtr. Niezależnie od tego ustawienia Jeśli np. usługa nigdy nie rejestruje zdarzenia |
returnPropertyQuota |
Określa, czy ma być zwracany bieżący stan limitu tej usługi Analytics. Limit jest zwracany w polu PropertyQuota. |