Method: properties.runAccessReport

Veri erişim kayıtlarının özelleştirilmiş bir raporunu döndürür. Bu rapor, bir kullanıcı Google Analytics raporlama verilerini her okuduğunda kaydedilen kayıtları sağlar. Erişim kayıtları en fazla 2 yıl saklanır.

Bir mülk için Veri Erişimi Raporları istenebilir. Tesis Google Analytics 360'ta olmalıdır. Bu yöntem yalnızca Yöneticiler tarafından kullanılabilir.

Bu veri erişimi kayıtları, GA4 kullanıcı arayüzü raporları, GA4 kullanıcı arayüzü keşifleri, GA4 veri API'si ve bir bağlantı üzerinden Google Analytics'ten veri alabilen Firebase ve AdMob gibi diğer ürünleri içerir. Bu kayıtlar, akış ekleme veya bir mülkün saat dilimini değiştirme gibi mülk yapılandırması değişikliklerini içermez. Yapılandırma değişiklik geçmişi için searchChangeHistoryEvents bölümüne bakın.

HTTP isteği

POST https://analyticsadmin.googleapis.com/v1alpha/{entity=properties/*}:runAccessReport

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
entity

string

Veri Erişim Raporu, mülk düzeyinde veya hesap düzeyinde isteği destekler. Hesap düzeyinde istenirse, Veri Erişimi Raporları o hesap altındaki tüm mülklere erişimi içerir.

GA4 mülk kimliğiniz "123" ise mülk düzeyinde istekte bulunmak için öğenin "özellikler/123" olması gerekir. Hesap düzeyinde istekte bulunmak için örneğin "1234" GA4 Hesap Kimliğiniz ise tüzel kişi "accounts/1234" olmalıdır.

İstek içeriği

İstek gövdesi aşağıdaki yapıya sahip veriler içerir:

JSON gösterimi 
{
  "dimensions": [
    {
      object (AccessDimension)
    }
  ],
  "metrics": [
    {
      object (AccessMetric)
    }
  ],
  "dateRanges": [
    {
      object (AccessDateRange)
    }
  ],
  "dimensionFilter": {
    object (AccessFilterExpression)
  },
  "metricFilter": {
    object (AccessFilterExpression)
  },
  "offset": string,
  "limit": string,
  "timeZone": string,
  "orderBys": [
    {
      object (AccessOrderBy)
    }
  ],
  "returnEntityQuota": boolean
}
Alanlar
dimensions[]

object (AccessDimension)

İstenen ve yanıtta görüntülenen boyutlar. En fazla 9 boyuta izin verilir.
metrics[]

object (AccessMetric)

İstenen ve yanıtta görüntülenen metrikler. En fazla 10 metriğe izin verilir.
dateRanges[]

object (AccessDateRange)

Okunacak erişim kayıtlarının tarih aralıkları. Birden fazla tarih aralığı istenirse her yanıt satırında sıfır tabanlı bir tarih aralığı dizini bulunur. İki tarih aralığı çakışırsa, çakışan günlere ait erişim kayıtları her iki tarih aralığının yanıt satırlarına eklenir. Taleplerde en fazla 2 tarih aralığı olabilir.
dimensionFilter

object (AccessFilterExpression)

Boyut filtreleri, rapor yanıtını filtreyle eşleşen belirli boyut değerleriyle kısıtlamanıza olanak tanır. Örneğin, tek bir kullanıcının erişim kayıtlarını filtreleyebilirsiniz. Daha fazla bilgi edinmek için Boyut Filtrelerinin Temelleri bölümünü inceleyin. Metrikler bu filtrede kullanılamaz.
metricFilter

object (AccessFilterExpression)

Metrik filtreleri, rapor yanıtını filtreyle eşleşen belirli metrik değerleriyle kısıtlamanıza olanak tanır. Metrik filtreleri, SQL'in sahip olduğu içeriğe benzer şekilde, rapor satırları toplandıktan sonra uygulanır. Boyutlar bu filtrede kullanılamaz.
offset

string (int64 format)

Başlangıç satırının satır sayısı. İlk satır 0. satır olarak sayılır. Uzaklık belirtilmezse 0 olarak kabul edilir. Uzaklık sıfır ise bu yöntem limit giriş içeren sonuçların ilk sayfasını döndürür.

Bu sayfalara ayırma parametresi hakkında daha fazla bilgi için Sayfalara ayırma bölümünü inceleyin.
limit

string (int64 format)

Döndürülecek satırların sayısı. Belirtilmemesi halinde 10.000 satır döndürülür. Kaç API isterseniz isteyin, API istek başına en fazla 100.000 satır döndürür. limit pozitif olmalıdır.

limit kadar çok satır yoksa API, istenen limit aralığından daha az satır döndürebilir. Örneğin, country boyutu için 300'den az olası değer vardır. Bu nedenle, yalnızca country ile ilgili rapor oluştururken limit değerini daha yüksek bir değere ayarlasanız bile 300'den fazla satır alamazsınız.

Bu sayfalara ayırma parametresi hakkında daha fazla bilgi için Sayfalara ayırma bölümünü inceleyin.
timeZone

string

Belirtilmişse bu isteğin saat dilimi. Belirtilmemesi durumunda mülkün saat dilimi kullanılır. İsteğin saat dilimi, raporun başlangıç ve bitiş tarihlerini yorumlamak için kullanılır.

IANA Saat Dilimi veritabanından (https://www.iana.org/time-zones) (ör. "Amerika/New_York" veya "Asya/Tokyo") dizeler olarak biçimlendirilir.
orderBys[]

object (AccessOrderBy)

Satırların yanıtta nasıl sıralanacağını belirtir.
returnEntityQuota

boolean

Bu Analytics Mülkünün kotasının geçerli durumunu döndürüp döndürmeyeceğini açar. Kota AccessQuota'te döndürülür. Hesap düzeyindeki istekler için bu alan yanlış olmalıdır.

Yanıt gövdesi

Başarılıysa yanıt metni, RunAccessReportResponse öğesinin bir örneğini içerir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics.edit