- Żądanie HTTP
- Parametry ścieżki
- Treść żądania
- Treść odpowiedzi
- Zakresy autoryzacji
- RunPivotReportRequest
- Wypróbuj
Zwraca wiele raportów przestawnych w grupie. Wszystkie raporty muszą dotyczyć tej samej usługi w GA4.
Żądanie HTTP
POST https://analyticsdata.googleapis.com/v1beta/{property=properties/*}:batchRunPivotReports
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
Parametry | |
---|---|
property |
Identyfikator usługi w GA4 w Google Analytics, którego zdarzenia są śledzone. Jest określony w ścieżce adresu URL, a nie w treści. Więcej informacji znajdziesz w artykule, gdzie znaleźć identyfikator usługi. Musisz określić tę właściwość dla wsadu. Właściwość w obiekcie RunPivotReportRequest 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[] |
Prośby indywidualne. Każde żądanie zawiera osobną odpowiedź z raportem przestawnym. Dozwolonych jest maksymalnie 5 żądań zbiorczych. |
Treść odpowiedzi
Odpowiedź zbiorcza zawierająca wiele raportów przestawnych.
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{
"pivotReports": [
{
object ( |
Pola | |
---|---|
pivotReports[] |
Pojedyncze odpowiedzi. Każda odpowiedź ma oddzielne żądanie raportu przestawnego. |
kind |
Określa, jakiego rodzaju jest ten komunikat. Ten |
Zakresy autoryzacji
Wymaga jednego z tych zakresów protokołu OAuth:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics
RunPivotReportRequest
Żądanie wygenerowania raportu przestawnego.
Zapis JSON |
---|
{ "property": string, "dimensions": [ { object ( |
Pola | |
---|---|
property |
Identyfikator usługi w GA4 w Google Analytics, którego zdarzenia są śledzone. Jest określony w ścieżce adresu URL, a nie w treści. Więcej informacji znajdziesz w artykule, gdzie znaleźć identyfikator usługi. W żądaniu zbiorczym ta właściwość powinna być albo nieokreślona, lub zgodna z właściwością na poziomie wsadu. Przykład: properties/1234 |
dimensions[] |
Żądane wymiary. Wszystkie zdefiniowane wymiary muszą być używane w jednym z tych wymiarów: orderExpression, dimensionsFilter, przestaw lub orderBys. |
metrics[] |
Żądane dane, należy określić co najmniej jeden rodzaj danych. Wszystkie zdefiniowane dane muszą być używane przez: metric_expression, metricFilter lub orderBys. |
dateRanges[] |
Zakres dat, z którego mają zostać pobrane dane zdarzeń na potrzeby raportu. Jeśli określisz wiele zakresów dat, w raporcie zostaną wykorzystane dane o zdarzeniach z każdego z nich. Wymiar specjalny o nazwie pola „dateRange” można umieścić w nazwach pól tabeli przestawnej; jeśli zostaną uwzględnione, raport porówna poszczególne zakresy dat. W żądaniu dotyczącym kohorty wartość |
pivots[] |
Opisuje format wizualny wymiarów raportu w kolumnach lub wierszach. Połączenie wartości „fieldNames” (nazw wymiarów) we wszystkich przestawieniach musi być podzbiorem nazw wymiarów zdefiniowanych w sekcji Wymiary. Jeden wymiar nie może być używany przez 2 przestawienia. Wymiar jest widoczny tylko wtedy, gdy znajduje się w tabeli przestawnej. |
dimensionFilter |
Klauzula filtrowania wymiarów. Użycie wymiarów w tym filtrze wymaga wysłania prośby o przesłanie prośby. W tym filtrze nie można używać danych. |
metricFilter |
Klauzula filtra wskaźników. Stosowane na etapie po agregacji, podobnie jak w klauzuli SQL. Użycie danych w tym filtrze wymaga wysłania prośby o przesłanie prośby. W tym filtrze nie można używać wymiarów. |
currencyCode |
Kod waluty w formacie ISO4217, np. „AED”, „USD” lub „JPY”. Jeśli to pole jest puste, w raporcie używana jest domyślna waluta usługi. |
cohortSpec |
Grupa kohort powiązana z tym żądaniem. Jeśli w żądaniu jest grupa kohortowa, „kohorta” wymiar musi być podany. |
keepEmptyRows |
Jeśli wartość to fałsz lub nieokreślona wartość, nie zostaną zwrócone żadne wiersze z żadnymi danymi równymi 0. Jeśli tak, wiersze te zostaną zwrócone, jeśli nie zostały usunięte osobno 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 usługi Analytics. Limit jest zwracany w polu PropertyQuota. |
comparisons[] |
Opcjonalnie: Konfiguracja porównań żądanych i wyświetlanych. Aby otrzymać w odpowiedzi kolumnę porównania, żądanie wymaga zarówno pola porównań, jak i wymiaru porównań. |