Method: userUsageReport.get

string

Reprezentuje identyfikator profilu lub adres e-mail użytkownika, którego dane mają zostać przefiltrowane. Może to być all dla wszystkich informacji lub userKey dla unikalnego identyfikatora profilu Google Workspace lub podstawowego adresu e-mail użytkownika. Nie może to być usunięty użytkownik. W przypadku usuniętego użytkownika wywołaj funkcję users.list w interfejsie Directory API z parametrem showDeleted=true, a następnie użyj zwróconej wartości ID jako userKey.

string

Reprezentuje datę, w której nastąpiło wykorzystanie, według czasu UTC-8:00 (czasu pacyficznego standardowego). Znak czasu jest podany w formacie ISO 8601, yyyy-mm-dd.

string

Unikalny identyfikator klienta, którego dane mają zostać pobrane.

string

Parametr ciągu zapytania filters to lista oddzielonych przecinkami parametrów zdarzenia aplikacji, których wartością można manipulować za pomocą operatora relacji. Parametr ciągu zapytania filters zawiera nazwę aplikacji, której użycie jest zwracane w raporcie. Wartości aplikacji w raporcie Użytkownicy dotyczące użycia to accounts, chat, docs i gmail.

Filtry mają postać [application name]:[parameter name][relational operator][parameter value],....

W tym przykładzie operator „nierówna” <> jest zakodowany w adresie URL w ciągu zapytania żądania (%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 

Operatory relacji:

• == – „równe”.
• <> – „nie równa się”. Jest on zakodowany w formacie adresu URL (%3C%3E).
• < – „mniej niż”. Jest on zakodowany w formacie adresu URL (%3C).
• <= – „mniejsze lub równe”. Jest zakodowany w formacie adresu URL (%3C=).
• > – „większe niż”. Jest on zakodowany w formacie adresu URL (%3E).
• >= – „większe lub równe”. Jest on zakodowany w formacie adresu URL (%3E=).

integer (uint32 format)

Określa, ile rekordów aktywności jest wyświetlanych na każdej stronie odpowiedzi. Jeśli na przykład żądanie zawiera parametr maxResults=1, a raport ma 2 działania, będzie ono miało 2 strony. Właściwość nextPageToken odpowiedzi zawiera token do drugiej strony.
Ciąg zapytania maxResults jest opcjonalny.

string

Identyfikator jednostki organizacyjnej, której dotyczy raport. Aktywność użytkowników będzie widoczna tylko w przypadku użytkowników należących do określonej jednostki organizacyjnej.

string

Token określający następną stronę. Raport obejmujący kilka stron zawiera w odpowiedzi właściwość nextPageToken. W kolejnych żądaniach, które mają pobrać kolejną stronę raportu, w ciągu zapytania pageToken wpisz wartość nextPageToken.

string

Ciąg znaków zapytania parameters to lista oddzielonych przecinkami parametrów zdarzenia, które umożliwiają doprecyzowanie wyników raportu. Parametr jest powiązany z konkretną aplikacją. Wartości aplikacji w raporcie Użycie przez klientów to: accounts, app_maker, apps_scripts, calendar, chat, classroom, cros, docs, gmail, gplus, device_management, meet i sites.
Ciąg znaków zapytania parameters ma postać app_name1:param_name1, app_name2:param_name2 w formacie CSV.

string

Identyfikatory grup (zaciemnione) oddzielone przecinkami, według których filtrowane są działania użytkowników, czyli odpowiedź będzie zawierać działania tylko tych użytkowników, którzy należą do co najmniej 1 z wymienionych tutaj identyfikatorów grup. Format: „id:abc123,id:xyz456”