Raport „Aktywność na Dysku” zawiera informacje o działaniach użytkowników związanych z zarządzaniem plikami na Dysku Google oraz ich modyfikowaniem i udostępnianiem w Google Workspace. Dzięki temu raportowi możesz na przykład wyświetlić listę wszystkich nowych dokumentów na Dysku utworzonych przez konkretnego użytkownika w wybranym zakresie dat. Dzięki tym informacjom możesz dowiedzieć się, jak lepiej zarządzać treścią i jakie są wycieki danych. Aby uzyskać raport, użyj podstawowego żądania punktu końcowego raportu z parametrami związanymi z raportami, takimi jak adres e-mail użytkownika lub określony rodzaj zmiany na Dysku Google. Raporty mogą zawierać dane z ostatnich 180 dni.
Raportu o aktywności na Dysku Google można używać wyłącznie do celów zgodnych z prawem na kontach, które mają przypisaną licencję.
Informacje o ciągach zapytań żądania i właściwościach odpowiedzi znajdziesz w dokumentacji interfejsu API. Informacje o określonych zdarzeniach na Dysku Google znajdziesz w artykule Nazwy zdarzeń na Dysku.
Pobieranie zdarzeń z Dysku Google w domenie
W raporcie „Aktywność na Dysku” możesz wyświetlić listę informacji o dokumentach na Dysku. Możesz na przykład poprosić o raport z 25 ostatnimi zdarzeniami na Dysku z okresu do 180 dni. Aby pobrać ten raport, uzyskaj token autoryzacji zgodnie z opisem w przewodniku po autoryzacji, a potem użyj tego żądania HTTP GET
:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?maxResults=25
Zobacz przykładową odpowiedź na to wywołanie interfejsu API.
Przykład poniżej pobiera raport o wszystkich zdarzeniach na Dysku z ostatnich 180 dni, czyli maksymalnego okresu.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive
Pobieranie zdarzeń z Dysku Google według użytkownika
Aby pobrać raport o aktywności na Dysku Google określonego użytkownika, użyj żądania HTTP GET
z tokenem autoryzacji opisanym w przewodniku po autoryzacji.
Pole userKey
to podstawowy adres e-mail użytkownika uwzględnionego w raporcie lub all
w przypadku wszystkich użytkowników.
Przykład poniżej pozwala pobrać raport zawierający wszystkie zmiany wprowadzone przez określonego użytkownika. Przykład odpowiedzi interfejsu API znajdziesz w przykładowej odpowiedzi JSON.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/kim@example.com
/applications/drive
Pobieranie zdarzeń z dysków współdzielonych na Dysku Google
Raport o aktywnościach na Dysku Google dla określonego dysku współdzielonego możesz pobrać przy użyciu żądania HTTP GET
z tokenem autoryzacji opisanym w przewodniku po autoryzacji. W polu userKey
podaj adres e-mail użytkownika, którego ma dotyczyć raport, lub wpisz all
, aby wygenerować raport dotyczący wszystkich użytkowników.
Poniższy przykład umożliwia pobranie raportu o wszystkich zmianach na określonym dysku współdzielonym. Przykład odpowiedzi interfejsu API znajdziesz w przykładowej odpowiedzi JSON.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?filters=shared_drive_id==<id of shared drive>
Aby pobrać zdarzenia z dysku współdzielonego, użyj filtra doc_type
. Poniższy przykład pobiera zdarzenia, które mają wpływ na wszystkie dyski współdzielone:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?filters=doc_type=shared_drive
Aby pobrać zdarzenia związane ze zmianą członkostwa, podaj zdarzenie shared_drive_membership_change
. Ten przykład pokazuje pobranie wszystkich użytkowników dodanych do dysków współdzielonych:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?evetName=shared_drive_membership_change&
filters=membership_change_type==add_to_shared_drive
Pobieranie zdarzeń z Dysku Google według typu zdarzenia
Aby pobrać raport o wszystkich wystąpieniach określonego typu zdarzenia, takich jak utworzenie lub edytowanie dokumentu, użyj żądania HTTP GET
z tokenem autoryzacji opisanym w przewodniku po autoryzacji.
Pole userKey
to podstawowy adres e-mail użytkownika uwzględnionego w raporcie lub all
w przypadku wszystkich użytkowników.
Poniższy przykład umożliwia pobranie raportu o wszystkich czynnościach związanych z tworzeniem dokumentacji konta. Przykład odpowiedzi interfejsu API znajdziesz w przykładowej odpowiedzi JSON:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?eventName=create
Przykładowa odpowiedź JSON
Gdy wysyłasz do interfejsu API żądanie HTTP GET
, pomyślna odpowiedź zwraca kod stanu HTTP 200. Wraz z kodem stanu odpowiedź
zwraca raport o Dysku. Raporty te są też dostępne
w konsoli administracyjnej. Więcej informacji znajdziesz w Centrum pomocy dla administratorów Google Workspace.
Informacje o eventName
znajdziesz w dokumentacji dotyczącej nazw zdarzeń na Dysku. Więcej informacji o ciągach zapytań żądania i właściwościach odpowiedzi znajdziesz w dokumentacji interfejsu API.
{ "kind": "reports#auditActivities", "nextPageToken": "next page's token", "items": [ { "kind": "audit#activity", "id": { "time": "2014-03-17T15:39:18.460Z", "uniqQualifier": "report's unique ID", "applicationName": "drive", "customerId": "ABC123xyz" }, "actor": { "callerType": "USER", "email": "kim@example.com", "profileId": "user's unique Google Workspace profile ID", "key": "consumer key of requestor in an OAuth 2LO request" }, "ownerDomain": "domain of the source owner", "ipAddress": "user's IP address", "events": [ { "type": "access", "name": "edit", "parameters": [ { "name": "primary_event", "boolValue": true }, { "name": "owner_is_shared_drive", "boolValue": false }, { "name": "doc_id", "value": "1DWuYM3ot_sAyEQqOz0xWJ9bVMSYzOmRNeBqbgtSwuK8" }, { "name": "doc_title", "value": "Meeting notes" }, { "name": "doc_type", "value": "document" }, { "name": "owner", "value": "mary@example.com" } ] } ] }, ] }