Method: accounts.runAccessReport

Veri erişimi kayıtlarının özelleştirilmiş bir raporunu döndürür. Rapor, bir kullanıcının Google Analytics raporlama verilerini her okuduğunda kayıt sağlar. Erişim kayıtları 2 yıla kadar saklanır.

Bir mülk için veri erişim raporları istenebilir. Raporlar herhangi bir mülk için istenebilir ancak kotayla ilgili olmayan boyutlar yalnızca Google Analytics 360 mülklerinde istenebilir. Bu yöntem yalnızca yöneticiler tarafından kullanılabilir.

Bu veri erişimi kayıtları arasında GA kullanıcı arayüzü raporları, GA kullanıcı arayüzü keşifleri, GA Veri API'si ve Firebase ile AdMob gibi, bağlantı üzerinden Google Analytics'ten veri alabilen diğer ürünler yer alır. Bu kayıtlar, akış ekleme veya mülkün saat dilimini değiştirme gibi mülk yapılandırma değişikliklerini içermez. Yapılandırma değişiklik geçmişi için searchChangeHistoryEvents işlevine bakın.

Bu API hakkında geri bildirimde bulunmak için Google Analytics Erişim Raporları geri bildirim formunu doldurun.

HTTP isteği

POST https://analyticsadmin.googleapis.com/v1beta/{entity=accounts/*}: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 istekte bulunmayı destekler. Hesap düzeyinde istenen veri erişim raporları, söz konusu hesaptaki tüm mülklere yönelik tüm erişimi içerir.

Mülk düzeyinde istek göndermek için varlık, Google Analytics mülk kimliğiniz "123" ise örneğin "properties/123" olmalıdır. Hesap düzeyinde istek göndermek için varlık, Google Analytics hesap kimliğiniz "1234" ise örneğin "hesaplar/1234" olmalıdır.

İstek içeriği

İstek metni aşağıdaki yapıyla birlikte verileri 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,
  "includeAllUsers": boolean,
  "expandGroups": boolean
}
Alanlar
dimensions[]

object (AccessDimension)

İstekte bulunulan ve yanıtta gösterilen boyutlar. İsteklere en fazla 9 boyuta izin verilir.
metrics[]

object (AccessMetric)

İstekte bulunulan ve yanıtta gösterilen metrikler. İsteklere en fazla 10 metrik dahil edilebilir.
dateRanges[]

object (AccessDateRange)

Okunacak erişim kayıtlarının 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ünlerin erişim kayıtları her iki tarih aralığının yanıt satırlarına dahil edilir. En fazla 2 tarih aralığı isteğinde bulunabilirsiniz.
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ına göre filtreleme. Daha fazla bilgi edinmek için örnekleri içeren Boyut Filtrelerinin Temel Özellikleri başlıklı makaleyi 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 having yan tümcesine benzer şekilde raporun 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. Ofset belirtilmezse 0 olarak değerlendirilir. Ofset sıfır ise bu yöntem, limit giriş içeren ilk sayfayı döndürür.

Bu sayfalandırma parametresi hakkında daha fazla bilgi edinmek için Sayfalandırma bölümüne bakın.
limit

string (int64 format)

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

limit kadar satır kalmamışsa API, istenen limit'ten 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 hakkında rapor oluştururken limit değerini daha yüksek bir değere ayarlasanız bile 300'den fazla satır alamazsınız.

Bu sayfalandırma parametresi hakkında daha fazla bilgi edinmek için Sayfalandırma bölümüne bakın.
timeZone

string

Belirtiliyse bu isteğin saat dilimi. Belirtilmezse tesisin 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ındaki (https://www.iana.org/time-zones) dize biçimindedir. Örneğin, "America/New_York" veya "Asia/Tokyo".
orderBys[]

object (AccessOrderBy)

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

boolean

Bu Analytics mülkünün kotasının mevcut durumunun döndürülüp döndürülmeyeceğini belirler. Kota, AccessQuota parametresinde döndürülür. Hesap düzeyindeki istekler için bu alan yanlış olmalıdır.
includeAllUsers

boolean

İsteğe bağlıdır. Hiç API çağrısı yapmamış kullanıcıların yanıta dahil edilip edilmeyeceğini belirler. Doğru ise API çağrısı yapıp yapmadıklarından bağımsız olarak, belirtilen mülke veya hesaba erişimi olan tüm kullanıcılar yanıta dahil edilir. Yanlış ise yalnızca API çağrısı yapan kullanıcılar dahil edilir.
expandGroups

boolean

İsteğe bağlıdır. Kullanıcıları kullanıcı grupları içinde döndürülüp döndürülmeyeceğine karar verir. Bu alan yalnızca includeAllUsers true olarak ayarlandığında çalışır. Bu değer doğru ise belirtilen mülke veya hesaba erişimi olan tüm kullanıcılar döndürülür. Yanlış ise yalnızca doğrudan erişimi olan kullanıcılar döndürülü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