Reprezentuje klucz obiektu, za pomocą którego chcesz filtrować dane. Jest to ciąg znaków, który może przyjąć wartość all, aby uzyskać zdarzenia związane z aktywnością wszystkich użytkowników, lub dowolną inną wartość w przypadku elementu związanego z aplikacją. Szczegółowe informacje o tym, jak uzyskać entityKey dla określonego elementu entityType, znajdziesz w przewodnikach dotyczących parametrów wykorzystania encji.
date
string
Reprezentuje datę użycia danych według czasu UTC–8:00 (czasu pacyficznego). Sygnatura czasowa jest w formacie ISO 8601, yyyy-mm-dd.
Parametry zapytania
Parametry
customerId
string
Unikalny identyfikator klienta, dla którego chcesz pobrać dane.
filters
string
Ciąg zapytania filters to rozdzielana przecinkami lista parametrów zdarzenia aplikacji, w których wartość tego parametru jest modyfikowana przez operator relacyjny. Ciąg zapytania filters zawiera nazwę aplikacji, której użycie jest zwracane w raporcie. Wartości aplikacji w raporcie wykorzystania encji to accounts, docs i gmail.
Filtry mają postać [application name]:[parameter
name][relational operator][parameter value],....
W tym przykładzie <> „nie równa się” jest zakodowany na potrzeby adresu URL w ciągu zapytania żądania (%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
Operatory relacyjne to między innymi:
== – „równa się”.
<> – „nie równa się”. Jest on zakodowany w adresie URL (%3C%3E).
< – „mniej niż”. Jest on zakodowany na potrzeby adresu URL (%3C).
<= – „mniejsze lub równe”. Jest on zakodowany w adresie URL (%3C=).
> – „większe niż”. Jest on zakodowany na potrzeby adresu URL (%3E).
>= – „większe niż lub równe”. Jest on zakodowany w adresie URL (%3E=).
Filtry można stosować tylko do parametrów liczbowych.
Określa, ile rekordów aktywności ma być wyświetlanych na każdej stronie odpowiedzi. Jeśli np. żądanie ustawia <span>maxResults=1</span>, a raport zawiera 2 działania, raport ma 2 strony. Właściwość <span>nextPageToken</span> odpowiedzi ma token drugiej strony.
pageToken
string
Token do określenia następnej strony. Raport z wieloma stronami zawiera w odpowiedzi właściwość nextPageToken. W kolejnym żądaniu pobierającym następną stronę raportu wpisz wartość nextPageToken w ciągu zapytania pageToken.
parameters
string
Ciąg zapytania parameters to rozdzielana przecinkami lista parametrów zdarzenia, które zawężają wyniki raportu. Parametr jest powiązany z konkretną aplikacją. W raporcie wykorzystania encji wartość aplikacji w raporcie to tylko gplus. Ciąg zapytania typu parameter ma format CSV [app_name1:param_name1],
[app_name2:param_name2]....
Treść żądania
Treść żądania musi być pusta.
Treść odpowiedzi
W przypadku powodzenia treść odpowiedzi obejmuje wystąpienie elementu UsageReports.