Veri erişimi kayıtlarının özelleştirilmiş bir raporunu döndürür. Bu rapor, bir kullanıcının Google Analytics raporlama verilerini her okuduğunda kaydedilen kayıtlarını sağlar. Erişim kayıtları 2 yıla kadar saklanır.
Bir mülk için Veri Erişim Raporu 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ü raporlaması, GA4 kullanıcı arayüzü Explorations ve GA4 veri API'sinin yanı sıra bir bağlantı üzerinden Google Analytics'ten veri alabilen Firebase ve AdMob gibi diğer ürünler yer alır. Bu kayıtlar, akış ekleme veya bir 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 öğesine 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 düzeyinde veya hesap düzeyinde istek göndermeyi destekler. Hesap düzeyinde istenirse Veri Erişim Raporları, söz konusu hesaptaki tüm mülkler için tüm erişimi içerir. GA4 mülk kimliğiniz "123" ise mülk düzeyinde istekte bulunmak için öğe "özellikler/123" örneğinde olmalıdır. GA4 hesap kimliğiniz "1234" ise hesap düzeyinde istekte bulunmak için varlığın örneğin "accounts/1234" olması gerekir. |
İstek içeriği
İsteğin gövdesi, aşağıdaki yapıya sahip veriler içerir:
JSON gösterimi |
---|
{ "dimensions": [ { object ( |
Alanlar | |
---|---|
dimensions[] |
Yanıtta istenen ve gösterilen boyutlar. İsteklerin 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ünlerin erişim kayıtları her iki tarih aralığının yanıt satırlarına eklenir. İstekler için 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ızı sağlar. Örneğin, tek bir kullanıcının erişim kayıtlarını filtreleme. Daha fazla bilgi edinmek için Boyut Filtreleriyle İlgili Temel Bilgiler başlıklı makaleyi inceleyin. Metrikler bu filtrede kullanılamaz. |
metricFilter |
Metrik filtreleri, rapor yanıtını filtreyle eşleşen belirli metrik değerleriyle kısıtlamanızı sağlar. Metrik filtreleri, SQL'in yan tümcesine benzer şekilde, raporun 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. Ofset belirtilmezse 0 olarak kabul edilir. Ofset sıfırsa bu yöntem, 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ı. Belirtilmemesi halinde 10.000 satır döndürülür. API, kaç tane istediğinize bakılmaksızın istek başına maksimum 100.000 satır döndürür.
Bu sayfalara ayırma parametresi hakkında daha fazla bilgi için Sayfaları numaralandırma konusuna bakın. |
timeZone |
Belirtildiyse bu isteğin saat dilimidir. Belirtilmemişse 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) alınan dizeler olarak biçimlendirilmiştir; örneğin, "America/New_York" veya "Asya/Tokyo". |
orderBys[] |
Yanıtta satırların nasıl sıralandığını belirtir. |
returnEntityQuota |
Bu Analytics Mülkü'nün kotasının mevcut durumunun döndürülüp döndürülmeyeceğini değiştirir. Kota, AccessQuota dosyası 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. True (doğru) değerine ayarlanırsa, belirtilen mülke veya hesaba erişimi olan tüm kullanıcılar, API çağrısı yapıp yapmadıklarına bakılmaksızın 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 değerine ayarlandığında çalışır. True (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