Hesaptaki kullanıcılar tarafından kullanılan varlıklara ait mülkler ve istatistiklerden oluşan bir rapor alır. Daha fazla bilgi için Varlık Kullanım Raporu rehberine bakın. Varlıklar raporunun parametreleri hakkında daha fazla bilgi için Varlık Kullanımı parametreleri başvuru kılavuzlarına bakın.
HTTP isteği
GET https://admin.googleapis.com/admin/reports/v1/usage/{entityType}/{entityKey or all}/dates/{date}
Verilerin filtreleneceği nesnenin anahtarını temsil eder. Tüm kullanıcılara ait etkinlik etkinliklerini veya uygulamaya özel bir varlık için başka herhangi bir değeri almak üzere all değerini alabilen bir dizedir. Belirli bir entityType için entityKey özelliğinin nasıl alınacağıyla ilgili ayrıntılar için Varlık Kullanımı parametreleri başvuru kılavuzlarına bakın.
date
string
UTC-8:00'a (Pasifik Standart Saati) göre kullanımın gerçekleştiği tarihi gösterir. Zaman damgası ISO 8601 biçiminde (yyyy-mm-dd) olmalıdır.
Sorgu parametreleri
Parametreler
customerId
string
Verileri alınacak müşterinin benzersiz kimliği.
filters
string
filters sorgu dizesi, parametre değerinin ilişkisel operatör tarafından değiştirildiği uygulama etkinlik parametrelerinin virgülle ayrılmış bir listesidir. filters sorgu dizesi, kullanımı raporda döndürülen uygulamanın adını içerir. Varlık kullanımı raporundaki uygulama değerleri accounts, docs ve gmail değerlerini içerir.
Bu örnekte, <> 'not equal to' operatörü, isteğin sorgu dizesinde URL olarak kodlanmış (%3C%3E):
GET
https://www.googleapis.com/admin/reports/v1/usage/gplus_communities/all/dates/2017-12-01
?parameters=gplus:community_name,gplus:num_total_members
&filters=gplus:num_total_members%3C%3E0
İlişkisel operatörler şunları içerir:
== - 'eşittir'.
<> - "eşit değil". URL olarak kodlanmış (%3C%3E).
< - "küçüktür". URL olarak kodlanmış (%3C).
<= - "küçüktür veya eşittir". URL olarak kodlanmış (%3C=).
> - "büyüktür". URL olarak kodlanmış (%3E).
>= - "büyüktür veya eşittir". URL olarak kodlanmış (%3E=).
Filtreler yalnızca sayısal parametrelere uygulanabilir.
Her yanıt sayfasında kaç etkinlik kaydının gösterileceğini belirler. Örneğin, istek <span>maxResults=1</span> değerini ayarlarsa ve raporda iki etkinlik varsa raporun iki sayfası vardır. Yanıtın <span>nextPageToken</span> özelliği, ikinci sayfanın jetonuna sahiptir.
pageToken
string
Sonraki sayfayı belirtmek için kullanılan jeton. Birden fazla sayfa içeren bir raporun yanıtta nextPageToken özelliği bulunur. Raporun sonraki sayfasını alma konusundaki takip isteğinizde, pageToken sorgu dizesine nextPageToken değerini girin.
parameters
string
parameters sorgu dizesi, raporun sonuçlarını hassaslaştıran etkinlik parametrelerinin virgülle ayrılmış listesidir. Parametre, belirli bir uygulamayla ilişkilendirilmiştir. Varlık kullanımı raporu için uygulama değerleri yalnızca gplus şeklindedir. parameter sorgu dizesi, [app_name1:param_name1],
[app_name2:param_name2]... CSV biçimindedir.
İ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.