Method: entityUsageReports.get

Pobiera raport będący zbiorem usług i statystyk dotyczących elementów używanych przez użytkowników na koncie. Więcej informacji znajdziesz w przewodniku po raportach wykorzystania jednostek. Więcej informacji o parametrach raportu encji znajdziesz w przewodnikach dotyczących parametrów wykorzystania encji.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
entityType

enum (EntityType)

Reprezentuje typ elementu w raporcie.

entityKey or all

string

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.

maxResults

integer (uint32 format)

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.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Więcej informacji znajdziesz w przewodniku na temat autoryzacji.

Typ encji

Wartości w polu enum
gplus_communities Zwraca raport o społecznościach Google+.