- HTTP isteği
- Yol parametreleri
- İstek metni
- Yanıt metni
- Yetkilendirme kapsamları
- RunReportRequest
- Deneyin.
Bir grup halinde birden çok 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/*}:batchRunReports
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 için Mülk Kimliğinizi nerede bulabileceğinize bakın. Grup için bu özellik belirtilmelidir. RunReportRequest içindeki özellik, belirtilmemiş veya bu mülkle tutarlı olabilir. Örnek: mülkler/1234 |
İstek içeriği
İstek gövdesi, aşağıdaki yapıyla birlikte veriler içerir:
JSON gösterimi |
---|
{
"requests": [
{
object ( |
Alanlar | |
---|---|
requests[] |
Bireysel istekler. Her isteğin ayrı bir rapor yanıtı vardır. Her toplu isteğe en fazla 5 isteğe izin verilir. |
Yanıt gövdesi
Birden çok 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 |
---|
{
"reports": [
{
object ( |
Alanlar | |
---|---|
reports[] |
Tek tek yanıtlar. Her yanıtın ayrı bir 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
RunReportRequest
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 için Mülk Kimliğinizi nerede bulabileceğinize bakın. Toplu istekte, bu özellik belirtilmemiş veya toplu düzeyindeki özellikle tutarlı olmalıdır. Örnek: mülkler/1234 |
dimensions[] |
İstenen ve görüntülenen boyutlar. |
metrics[] |
İstenen ve görüntülenen metrikler. |
dateRanges[] |
Okunacak verilerin tarih aralıkları. Birden fazla tarih aralığı istenirse her yanıt satırı sıfır tabanlı bir tarih aralığı dizini içerir. İki tarih aralığı çakışırsa çakışan günlere ait etkinlik verileri her iki tarih aralığının yanıt satırlarına eklenir. Grup isteğinde bu |
dimensionFilter |
Boyut filtreleri, raporda yalnızca belirli boyut değerlerini istemenize olanak tanır. Daha fazla bilgi için Boyut Filtrelerinin Temelleri bölümünü inceleyin. Metrikler bu filtrede kullanılamaz. |
metricFilter |
Metriklerin filtre ifadesi. SQL'in yan tümcesine benzer şekilde, rapor satırları toplandıktan sonra uygulanır. Boyutlar bu filtrede kullanılamaz. |
offset |
Başlangıç satırının satır sayısıdır. İlk satır 0. satır olarak sayılır. Sayfalara ayırma sırasında, ilk istek ofseti belirtmez veya eşdeğer olarak, ofseti 0'a ayarlar; ilk istek, ilk Bu sayfalara ayırma parametresi hakkında daha fazla bilgi için Sayfaları numaralandırma konusuna bakın. |
limit |
Döndürülecek satır sayısı. Belirtilmemişse 10.000 satır döndürülür. API, kaç tane istediğinize bakılmaksızın istek başına maksimum 250.000 satır döndürür. Ayrıca, Bu sayfalara ayırma parametresi hakkında daha fazla bilgi için Sayfaları numaralandırma konusuna bakın. |
metricAggregations[] |
Metriklerin toplamı. Birleştirilmiş metrik değerleri, boyutValues değerinin "RESERVED_(MetricAggregation)" olarak ayarlandığı satırlarda gösterilir. |
orderBys[] |
Satırların yanıtta nasıl sıralanacağını belirtir. |
currencyCode |
"AED", "USD", "JPY" gibi ISO4217 biçimindeki 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. İstekte bir kohort grubu varsa "kohort" boyutu bulunmalıdır. |
keepEmptyRows |
Yanlış değerine ayarlanırsa veya belirtilmemişse tüm metriklerin 0'a eşit olduğu her satır döndürülmez. True (doğru) değerine ayarlanırsa bu satırlar bir filtre tarafından ayrıca kaldırılmazsa döndürülür. Bu Örneğin, bir mülk hiçbir zaman |
returnPropertyQuota |
Bu Analytics Mülkü'nün kotasının mevcut durumunun döndürülüp döndürülmeyeceğini belirler. Kota, PropertyQuota içinde döndürülür. |