Veri erişim 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 kaydedilen kayıtlar sağlar. Erişim kayıtları 2 yıla kadar saklanır.
Bir mülk için veri erişimi raporları istenebilir. Herhangi bir mülk için rapor 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 GA4 Kullanıcı Arayüzü Raporları, GA4 Kullanıcı Arayüzü Explorations, GA4 Veri API'si ve Firebase gibi diğer ürünler yer alır. Bağlantı üzerinden Google Analytics'ten veri alabilen AdMob. 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 konusuna 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 |
Veri erişimi raporu, mülk veya hesap düzeyinde istekleri destekler. Hesap düzeyinde istenirse Veri Erişimi Raporları, söz konusu hesap kapsamındaki tüm mülklere ilişkin tüm erişimi içerir. Mülk düzeyinde istekte bulunmak için varlık örneği "özellikler/123" gibi olmalıdır "123" ise GA4 mülk kimliğinizdir. Hesap düzeyinde istekte bulunmak için varlığın örneğin "accounts/1234" olması gerekir "1234" ise GA4 hesap kimliğinizdir. |
İstek içeriği
İstek gövdesi, aşağıdaki yapıya sahip verileri içerir:
JSON gösterimi |
---|
{ "dimensions": [ { object ( |
Alanlar | |
---|---|
dimensions[] |
İstenen ve yanıtta gösterilen boyutlar. İsteklere en fazla 9 boyuta izin verilir. |
metrics[] |
İstenen ve yanıtta gösterilen metrikler. İstekler için en fazla 10 metriğe izin verilir. |
dateRanges[] |
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ünlere ait erişim kayıtları her iki tarih aralığının yanıt satırlarına eklenir. İsteklere en fazla 2 tarih aralığına izin verilir. |
dimensionFilter |
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 filtre uygulanır. Daha fazla bilgi edinmek üzere örnekler için Boyut Filtrelerinin Temelleri bölümüne bakın. Bu filtrede metrikler kullanılamaz. |
metricFilter |
Metrik filtreleri, rapor yanıtını filtreyle eşleşen belirli metrik değerleriyle kısıtlamanıza olanak tanır. Metrik filtreleri, SQL sahip 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ı. İlk satır, 0. satır olarak sayılır. Ofset belirtilmemişse 0 olarak kabul edilir. Ofset sıfırsa bu yöntem, Bu sayfalara ayırma parametresi hakkında daha fazla bilgi için Sayfalara ayırma bölümüne bakın. |
limit |
Döndürülecek satır sayısı. Belirtilmezse 10.000 satır döndürülür. API, istediğiniz sayıda satırdan bağımsız olarak istek başına en fazla 100.000 satır döndürür.
Bu sayfalara ayırma parametresi hakkında daha fazla bilgi için Sayfalara ayırma bölümüne bakın. |
timeZone |
Belirtilmişse bu isteğin saat dilimidir. Belirtilmemişse mülkün saat dilimi kullanılır. İsteğin saat dilimi, başlangıç ve bitiş zamanlarını yorumlamak için raporun bitiş tarihlerini tanımlar. IANA Saat Dilimi veritabanından dize olarak biçimlendirilmiştir (https://www.iana.org/time-zones); örneğin "America/New_York" "Asya/Tokyo" gibi bir ad kullanabilirsiniz. |
orderBys[] |
Satırların yanıtta nasıl sıralandığını belirtir. |
returnEntityQuota |
Bu Analytics Mülküne ait kotanın mevcut durumunun döndürülüp döndürülmeyeceğini belirler. Kota, AccessQuota içinde döndürülür. Hesap düzeyindeki istekler için bu alan yanlış olmalıdır. |
includeAllUsers |
İsteğe bağlı. Yanıta hiç API çağrısı yapmamış kullanıcıların dahil edilip edilmeyeceğini belirler. Politika, Doğru değerine ayarlanırsa, API çağrısı yapıp yapmadıklarına bakılmaksızın, belirtilen mülke veya hesaba erişimi olan tüm kullanıcılar yanıta dahil edilir. Yanlış değerine ayarlanırsa yalnızca API çağrısı yapan kullanıcılar dahil edilir. |
expandGroups |
İsteğe bağlı. Kullanıcı gruplarındaki kullanıcıların döndürülüp döndürülmeyeceğine karar verir. Bu alan yalnızca includeAllUsers doğru olarak ayarlandığında çalışır. Doğru değerine ayarlanırsa belirtilen mülke veya hesaba erişimi olan tüm kullanıcıları döndürür. False (yanlış) değerine ayarlanırsa 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