Method: accounts.runAccessReport

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ı sağlar. Erişim kayıtları 2 yıla kadar saklanır.

Bir mülk için Veri Erişim 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ü raporlaması, GA4 kullanıcı arayüzü Explorations ve GA4 Data API'sinin yanı sıra bir bağlantı üzerinden Google Analytics'ten veri alabilen Firebase ve AdMob gibi diğer ürünler bulunur. 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 öğelerine bakın.

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şimi raporu, mülk düzeyinde veya hesap düzeyinde istekte bulunmayı destekler. Hesap düzeyinde istenirse Veri Erişim Raporları, ilgili hesap altındaki tüm mülklerin tüm erişimini içerir.

GA4 mülk kimliğiniz "123" ise mülk düzeyinde istek göndermek için varlık, örneğin "mülkler/123" olmalıdır. GA4 hesap kimliğiniz "1234" ise hesap düzeyinde istek göndermek için varlığın "accounts/1234" gibi olması gerekir.

İstek içeriği

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

object (AccessDimension)

İstenen ve yanıtta gösterilen boyutlar. İstekler en fazla 9 boyuta izin verilir.

metrics[]

object (AccessMetric)

İstenen ve yanıtta gösterilen metrikler. İstekler 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ı 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 en fazla 2 tarih aralığına izin verilir.

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ı filtreleme. Daha fazla bilgi 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 yan tümcesine 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ı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 limit girişli sonuçların ilk sayfasını döndürür.

Bu sayfalara ayırma parametresi hakkında daha fazla bilgi için Sayfaları numaralandırma konusuna bakın.

limit

string (int64 format)

Döndürülecek satır sayısı. Belirtilmemişse 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. limit pozitif olmalıdır.

limit satır sayısı kadar değilse API, istenen limit satırdan 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 Sayfaları numaralandırma konusuna bakın.

timeZone

string

Belirtilmişse bu isteğin saat dilimi. Belirtilmemişse 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ından (https://www.iana.org/time-zones) dize olarak biçimlendirilmiştir. Örneğin, "America/New_York" veya "Asya/Tokyo".

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 mevcut durumunun döndürülüp döndürülmeyeceğini belirler. Kota, AccessQuota öğesinde döndürülür. Hesap düzeyindeki istekler için bu alan yanlış olmalıdır.

includeAllUsers

boolean

İsteğe bağlı. Yanıta hiç API çağrısı yapmamış kullanıcıların dahil edilip edilmeyeceğini belirler. Bu değer true (doğru) ise, belirtilen mülke veya hesaba erişimi olan tüm kullanıcılar, bir API çağrısı yapıp yapmadıklarına bakılmaksızın yanıta dahil edilir. Politika, yanlış değerine ayarlanırsa yalnızca API çağrısı yapan kullanıcılar dahil edilir.

expandGroups

boolean

İ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. Politika, 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