Method: userUsageReport.get

Hesabı olan bir kullanıcı grubuna ait mülkler ve istatistikler koleksiyonundan oluşan bir rapor alır. Daha fazla bilgi için Kullanıcı Kullanım Raporu kılavuzuna göz atın. Kullanıcı raporunun parametreleri hakkında daha fazla bilgi için Kullanıcı Kullanımı parametreleri referans kılavuzlarına bakın.

HTTP isteği

GET https://admin.googleapis.com/admin/reports/v1/usage/users/{userKey or all}/dates/{date}

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

Yol parametreleri

Parametreler
userKey or all

string

Verilerin filtrelenmesi gereken profil kimliğini veya kullanıcı e-posta adresini temsil eder. Tüm bilgiler için all veya kullanıcının benzersiz Google Workspace profil kimliği ya da birincil e-posta adresi için userKey olabilir. Silinen bir kullanıcı olmamalıdır. Silinen bir kullanıcı için Directory API'de showDeleted=true ile users.list çağrısı yapın, ardından döndürülen ID değerini userKey olarak kullanın.
date

string

UTC-8:00'a (Pasifik Standart) göre, kullanımın gerçekleştiği tarihi temsil eder. Zaman damgası ISO 8601 biçimindedir, yyyy-mm-dd.

Sorgu parametreleri

Parametreler
customerId

string

Verileri alınacağı müşterinin benzersiz kimliği.
filters

string

filters sorgu dizesi, bir uygulamanın etkinlik parametrelerinin virgülle ayrılmış bir listesidir. Bu listede, parametrenin değeri bir ilişkisel operatör tarafından değiştirilir. filters sorgu dizesi, raporda kullanımı döndürülen uygulamanın adını içerir. Kullanıcılar Kullanım Raporu'ndaki uygulama değerleri accounts, chat, docs ve gmail'dır.

Filtreler [application name]:[parameter name][relational operator][parameter value],... biçimindedir.

Bu örnekte, <> "eşit değil" operatörü, isteğin sorgu dizesinde URL olarak kodlanmıştır (%3C%3E): 

GET
https://www.googleapis.com/admin/reports/v1/usage/users/all/dates/2013-03-03
?parameters=accounts:last_login_time
&filters=accounts:last_login_time%3C%3E2010-10-28T10:26:35.000Z

İlişkisel operatörler şunlardır:

  • ==: "eşittir".
  • <>: "eşit değildir". URL olarak kodlanmıştır (%3C%3E).
  • <: "Daha az". URL olarak kodlanmıştır (%3C).
  • <=: "Küçük veya eşittir". URL olarak kodlanmış olmalıdır (%3C=).
  • >: "Büyüktür". URL olarak kodlanmıştır (%3E).
  • >=: "Büyük veya eşittir". URL olarak kodlanmıştır (%3E=).
maxResults

integer (uint32 format)

Her yanıt sayfasında kaç etkinlik kaydının gösterileceğini belirler. Örneğin, istek maxResults=1 değerini ayarlarsa ve raporda iki etkinlik varsa raporda iki sayfa vardır. Yanıtın nextPageToken mülkünde ikinci sayfanın jetonu bulunur.
maxResults sorgu dizesi isteğe bağlıdır.
orgUnitID

string

Raporlanılacak kuruluş biriminin kimliği. Kullanıcı etkinliği yalnızca belirtilen kuruluş birimine ait kullanıcılar için gösterilir.

pageToken

string

Sonraki sayfayı belirtmek için jeton. Birden fazla sayfa içeren bir raporda yanıtta nextPageToken mülkü bulunur. Raporun bir sonraki sayfasını alan takip isteğinizde, pageToken sorgu dizesine nextPageToken değerini girin.
parameters

string

parameters sorgu dizesi, bir raporun sonuçlarını hassaslaştıran, virgülle ayrılmış bir etkinlik parametresi listesidir. Parametre, belirli bir uygulamayla ilişkilidir. Müşteri Kullanımı raporu için uygulama değerleri accounts, app_maker, apps_scripts, calendar, chat, classroom, cros, docs, gmail, gplus, device_management, meet ve sites'dir.
parameters sorgu dizesi, app_name1:param_name1, app_name2:param_name2 CSV biçimindedir.

groupIdFilter

string

Kullanıcı etkinliklerinin filtrelendiği, virgül ile ayrılmış grup kimlikleri (gizlenmiş). Yani yanıtta yalnızca burada belirtilen grup kimliklerinden en az birinin parçası olan kullanıcıların etkinlikleri yer alır. Biçim: "id:abc123,id:xyz456"

İstek içeriği

İstek metni boş olmalıdır.

Yanıt metni

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

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/admin.reports.usage.readonly

Daha fazla bilgi için Yetkilendirme kılavuzuna bakın.