- HTTP isteği
- Yol parametreleri
- İstek metni
- Yanıt metni
- Yetkilendirme kapsamları
- ResponseMetaData
- SchemaRestrictionResponse
- ActiveMetricRestriction
- RestrictedMetricType
- Deneyin.
Bir rapor görevinin içeriğini alır. reportTasks.create
için istekte bulunduktan sonra, rapor ETKİN duruma geldikten sonra rapor içeriğini alabilirsiniz. Rapor görevinin durumu ACTIVE
değilse bu yöntem bir hata döndürür. Sorgu yanıtı, raporun tablo satır ve sütun değerlerini döndürür.
HTTP isteği
POST https://analyticsdata.googleapis.com/v1alpha/{name=properties/*/reportTasks/*}:query
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Yol parametreleri
Parametreler | |
---|---|
name |
Zorunlu. Rapor kaynağının adı. Biçim: |
İstek içeriği
İsteğin gövdesi, aşağıdaki yapıya sahip veriler içerir:
JSON gösterimi |
---|
{ "offset": string, "limit": string } |
Alanlar | |
---|---|
offset |
İsteğe bağlı. Rapordaki başlangıç satırının satır sayısı. İ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 değerine ayarlar; ilk istek satırların ilk Bu sayfalara ayırma parametresi hakkında daha fazla bilgi için Sayfaları numaralandırma konusuna bakın. |
limit |
İsteğe bağlı. Rapordan döndürülecek satır sayısı. Belirtilmemesi halinde 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. |
Yanıt gövdesi
Bir rapor görevine karşılık gelen rapor içeriği.
Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:
JSON gösterimi |
---|
{ "dimensionHeaders": [ { object ( |
Alanlar | |
---|---|
dimensionHeaders[] |
Boyut sütunlarını açıklar. DimensionHeaders sayısı ve DimensionHeaders öğesinin sıralaması, satırlarda bulunan boyutlarla eşleşir. |
metricHeaders[] |
Metrik sütunlarını açıklar. MetricHeaders'ın sayısı ve MetricHeaders'ın sıralaması, satırlardaki metriklerle eşleşir. |
rows[] |
Rapordaki boyut değeri kombinasyonları ve metrik değerleri satırları. |
totals[] |
İstenirse metriklerin toplam değerleri. |
maximums[] |
İstenirse metriklerin maksimum değerleri. |
minimums[] |
İstenirse metriklerin minimum değerleri. |
rowCount |
Sorgu sonucundaki toplam satır sayısı. |
metadata |
Raporla ilgili meta veriler. |
Yetkilendirme kapsamları
Aşağıdaki OAuth kapsamlarından birini gerektirir:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics
ResponseMetaData
Yanıtın meta verileri, rapor içeriği hakkında ek bilgiler içerir.
JSON gösterimi |
---|
{
"dataLossFromOtherRow": boolean,
"schemaRestrictionResponse": {
object ( |
Alanlar | |
---|---|
dataLossFromOtherRow |
Doğru değeri, bazı boyut kombinasyonu gruplarının "(diğer)" satırında toplandığını gösterir. Bu durum, yüksek kardinaliteli raporlarda görülebilir. dataLossFromOtherRow meta veri parametresi, raporda kullanılan birleştirilmiş veri tablosuna göre doldurulur. Parametre, rapordaki filtreler ve sınırlardan bağımsız olarak doğru şekilde doldurulur. Örneğin, istek sessionSource = google ile ilgili bir filtre içerdiğinden (other) satırı rapordan çıkarılabilir. Bu raporu oluşturmak için kullanılan birleştirilmiş giriş verilerinde diğer satırdan veri kaybı varsa bu parametre yine de doldurulur. Daha fazla bilgi edinmek için (other) satırı ve veri örnekleme hakkında bölümünü inceleyin. |
schemaRestrictionResponse |
Bu raporu oluştururken etkin bir şekilde uygulanan şema kısıtlamalarını açıklar. Daha fazla bilgi edinmek için Erişim ve veri kısıtlama yönetimi başlıklı makaleyi inceleyin. |
currencyCode |
Bu raporda kullanılan para birimi kodu. Para birimi kodları, ISO 4217 standardındaki (https://en.wikipedia.org/wiki/ISO_4217) para birimi türlerinin dize kodlamalarıdır; örneğin, "USD", "EUR", "JPY". Daha fazla bilgi için https://support.google.com/analytics/answer/9796179 adresini inceleyin. |
timeZone |
Mülkün geçerli saat dilimi. |
emptyReason |
Neden boş bırakılırsa rapor bu nedenle boş olur. |
subjectToThresholding |
|
SchemaRestrictionResponse
Bu raporu oluştururken etkin şekilde uygulanan şema kısıtlamaları. Daha fazla bilgi edinmek için Erişim ve veri kısıtlama yönetimi başlıklı makaleyi inceleyin.
JSON gösterimi |
---|
{
"activeMetricRestrictions": [
{
object ( |
Alanlar | |
---|---|
activeMetricRestrictions[] |
Rapor oluşturulurken tüm kısıtlamalar etkin bir şekilde uygulanır. Örneğin, |
ActiveMetricRestriction
Rapor oluşturulurken aktif olarak kısıtlanmış bir metriktir.
JSON gösterimi |
---|
{
"restrictedMetricTypes": [
enum ( |
Alanlar | |
---|---|
restrictedMetricTypes[] |
Bu metrikle ilgili kısıtlamanın nedeni. |
metricName |
Kısıtlanmış metriğin adı. |
RestrictedMetricType
Belirli GA4 mülklerinde görüntülemeniz kısıtlanabilecek veri kategorileri.
Sıralamalar | |
---|---|
RESTRICTED_METRIC_TYPE_UNSPECIFIED |
Belirtilmemiş tür. |
COST_DATA |
adCost gibi maliyet metrikleri. |
REVENUE_DATA |
purchaseRevenue gibi gelir metrikleri. |