Raport aktywności na Dysku zawiera informacje o aktywności użytkowników podczas zarządzania plikami na Dysku Google w Google Workspace, ich modyfikowania i udostępniania. Możesz na przykład użyć raportu Aktywność na Dysku, aby uzyskać listę wszystkich nowych dokumentów na Dysku utworzonych przez określonego użytkownika w wybranym zakresie dat. Dzięki tym informacjom możesz lepiej zarządzać treściami i zapobiegać wyciekom danych. Aby uzyskać raport, użyj podstawowego punktu końcowego raportu z parametrami specyficznymi dla raportu, takimi jak adres e-mail użytkownika lub określony rodzaj zmiany na Dysku Google. Raporty mogą zawierać dane z ostatnich 180 dni.
Raport aktywności na Dysku Google może być używany wyłącznie w celach zgodnych z prawem na kontach, które mają przypisaną licencję.
Informacje o ciągach zapytania w żądaniu i właściwościach odpowiedzi znajdziesz w dokumentacji API. Informacje o konkretnych zdarzeniach związanych z Dyskiem Google znajdziesz w artykule Nazwy zdarzeń na Dysku.
Pobieranie zdarzeń z Dysku Google w domenie
Raport aktywności na Dysku zawiera informacje o dokumentach na Dysku. Możesz na przykład poprosić o raport zawierający 25 najnowszych zdarzeń na Dysku na Twoim koncie z okresu do 180 dni. Aby uzyskać ten raport, pobierz token autoryzacji zgodnie z instrukcjami w przewodniku po autoryzacji, a następnie użyj tego żądania HTTP GET:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?maxResults=25
Możesz zobaczyć przykładową odpowiedź na to wywołanie interfejsu API.
W tym przykładzie pobierany jest raport wszystkich zdarzeń na Dysku z ostatnich 180 dni, czyli maksymalnego okresu.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive
Pobieranie zdarzeń na Dysku Google według użytkownika
Aby pobrać raport o aktywności użytkownika na Dysku Google, użyj żądania HTTP GET z tokenem autoryzacji opisanym w przewodniku po autoryzacji.
Pole userKey to podstawowy adres e-mail użytkownika w raporcie lub all dla wszystkich użytkowników.
Poniższy przykład pobiera raport zawierający wszystkie zmiany wprowadzone przez określonego użytkownika. Przykładową odpowiedź 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 Dysku Google dotyczących dysków współdzielonych
Raport o aktywności na Dysku Google w przypadku konkretnego dysku współdzielonego możesz pobrać za pomocą żądania HTTP GET z tokenem autoryzacji opisanym w przewodniku po autoryzacji. W polu userKey
wpisz adres e-mail użytkownika, dla którego chcesz wygenerować raport, lub wpisz all, aby wygenerować raport dla wszystkich użytkowników.
W tym przykładzie pobieramy raport ze wszystkimi zmianami na konkretnym dysku współdzielonym. Przykładową odpowiedź 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ć wydarzenia z dysku współdzielonego, przefiltruj je za pomocą parametru doc_type. W tym przykładzie pobierane są 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 dotyczące zmian członkostwa, określ zdarzenie shared_drive_membership_change. W tym przykładzie pobierane są wszystkie zdarzenia dodania użytkownika do dysków współdzielonych:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?eventName=shared_drive_membership_change&
filters=membership_change_type==add_to_shared_drive
Pobieranie zdarzeń z Dysku Google według typu zdarzenia
Aby pobrać raport ze wszystkimi wystąpieniami określonego typu zdarzenia, np. utworzenia lub edytowania dokumentu, użyj żądania HTTP GET z tokenem autoryzacji opisanym w przewodniku po autoryzacji.
Pole userKey to podstawowy adres e-mail użytkownika w raporcie lub all dla wszystkich użytkowników.
W tym przykładzie pobierany jest raport o wszystkich działaniach związanych z tworzeniem dokumentacji konta. Przykładową odpowiedź 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 wyślesz do interfejsu API żądanie HTTP GET, prawidłowa odpowiedź zwróci kod stanu HTTP 200. Oprócz kodu stanu odpowiedź zawiera raport
dotyczący Dysku. Te raporty są też dostępne w konsoli administracyjnej. Więcej informacji znajdziesz w Centrum pomocy Google Workspace dla administratorów.
Informacje o eventName znajdziesz w nazwach zdarzeń na Dysku. Więcej informacji o ciągach zapytania w żądaniu i właściwościach odpowiedzi znajdziesz w dokumentacji 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 requester 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"
}
]
}
]
},
]
}