- HTTP isteği
- Yol parametreleri
- İstek gövdesi
- Yanıt metni
- Yetkilendirme kapsamları
- RunPivotReportRequest
- Deneyin.
Bir toplu işlemde birden çok pivot rapor döndürür. Tüm raporlar aynı GA4 Mülkü için olmalıdır.
HTTP isteği
POST https://analyticsdata.googleapis.com/v1beta/{property=properties/*}:batchRunPivotReports
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Yol parametreleri
Parametreler | |
---|---|
property |
Etkinlikleri izlenen bir Google Analytics GA4 mülkü tanımlayıcısı. Gövdede değil, URL yolunda belirtilir. Daha fazla bilgi edinmek için Mülk Kimliğinizi nerede bulabileceğinizi öğrenin. Grup için bu özellik belirtilmelidir. RunPivotRaporRequest içindeki özellik belirtilmemiş veya bu özellikle tutarlı olabilir. Örnek: mülkler/1234 |
İstek içeriği
İstek gövdesi, aşağıdaki yapıya sahip verileri içerir:
JSON gösterimi |
---|
{
"requests": [
{
object ( |
Alanlar | |
---|---|
requests[] |
Bağımsız talepler. Her isteğin ayrı bir pivot rapor yanıtı vardır. Her toplu isteğe en fazla 5 isteğe izin verilir. |
Yanıt gövdesi
Birden fazla pivot rapor içeren toplu yanıt.
Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:
JSON gösterimi |
---|
{
"pivotReports": [
{
object ( |
Alanlar | |
---|---|
pivotReports[] |
Bireysel yanıtlar. Her yanıt için ayrı bir pivot rapor isteği vardır. |
kind |
Bu mesajın ne tür bir kaynak olduğunu tanımlar. Bu |
Yetkilendirme kapsamları
Aşağıdaki OAuth kapsamlarından birini gerektirir:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics
RunPivotReportRequest
Pivot rapor oluşturma isteği.
JSON gösterimi |
---|
{ "property": string, "dimensions": [ { object ( |
Alanlar | |
---|---|
property |
Etkinlikleri izlenen bir Google Analytics GA4 mülkü tanımlayıcısı. Gövdede değil, URL yolunda belirtilir. Daha fazla bilgi edinmek için Mülk Kimliğinizi nerede bulabileceğinizi öğrenin. Toplu istek içinde, bu özelliğin belirtilmemiş olması veya grup düzeyindeki özellikle tutarlı olması gerekir. Örnek: mülkler/1234 |
dimensions[] |
İstenen boyutlar. Tanımlanmış tüm boyutlar, şunlardan biri tarafından kullanılmalıdır: dimensionExpression,dimensionFilter, pivots, orderBys. |
metrics[] |
İstenen metrikler, en az bir metriğin belirtilmesi gerekiyor. Tanımlanan tüm metrikler şunlardan biri tarafından kullanılmalıdır: metric_expression, metricFilter, orderBys. |
dateRanges[] |
Rapordaki etkinlik verilerinin alınacağı tarih aralığı. Birden çok tarih aralığı belirtilirse raporda her bir tarih aralığına ait etkinlik verileri kullanılır. Alan adı "dateRange" olan özel bir boyut Özet'in alan adlarına dahil edilebilir; varsa rapor, tarih aralıkları arasında karşılaştırma yapar. Bir kohort isteğinde bu |
pivots[] |
Rapordaki boyutların görsel biçimini sütun veya satırlar halinde açıklar. Tüm özetlerdeki FieldNames toplamı (boyut adları), Boyutlar'da tanımlanan boyut adlarının bir alt kümesi olmalıdır. Hiçbir özet bir boyutu paylaşamaz. Bir boyut yalnızca özette yer alıyorsa görünür. |
dimensionFilter |
Boyutların filtre koşulu. Boyutların bu filtrede kullanılmaları için istenmesi gerekir. Bu filtrede metrikler kullanılamaz. |
metricFilter |
Metriklerin filtre koşulu. SQL'in sahip tümcesine benzer şekilde, toplama sonrası aşamada uygulanır. Metriklerin bu filtrede kullanılmaları için istenmesi gerekir. Boyutlar bu filtrede kullanılamaz. |
currencyCode |
ISO4217 biçiminde, "AED", "USD", "JPY" gibi bir para birimi kodu. Alan boşsa raporda mülkün varsayılan para birimi kullanılır. |
cohortSpec |
Bu istekle ilişkili grup grubu. "Kohort" isteğinde bir kohort grubu varsa boyutu bulunmalıdır. |
keepEmptyRows |
Yanlış veya belirtilmediyse tüm metriklerin 0'a eşit olduğu her bir satır döndürülmez. Doğru değerine ayarlanırsa bu satırlar, bir filtre tarafından ayrıca kaldırılmadıklarında döndürülür. Bu Örneğin, bir mülk hiçbir zaman |
returnPropertyQuota |
Bu Analytics Mülküne ait kotanın mevcut durumunun döndürülüp döndürülmeyeceğini belirler. Kota, PropertyQuota özelliğinde döndürülür. |
comparisons[] |
İsteğe bağlı. İstenen ve görüntülenen karşılaştırmaların yapılandırması. İstekte karşılaştırma sütunu alabilmek için hem karşılaştırmalar alanı hem de karşılaştırmalar boyutu gerekir. |