Raport aktywności na Dysku zawiera informacje o aktywności użytkowników podczas zarządzania plikami na Dysku Google w Google Workspace, modyfikowania ich i udostępniania. Możesz na przykład użyć raportu o aktywności na Dysku, aby uzyskać listę wszystkich nowych dokumentów na Dysku utworzonych przez określonego użytkownika w wybranym zakresie dat. Te informacje pomogą Ci lepiej zarządzać treściami i zapobiegać wyciekom danych. Aby uzyskać raport, użyj podstawowego żądania 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, zdobądź token autoryzacji zgodnie z opisem 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 o wszystkich zdarzeniach na Dysku z ostatnich 180 dni, czyli z 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 w Google Drive, 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 podaj 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 sekcji przykładowa odpowiedź 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 shared_drive_membership_change
event. W tym przykładzie pobierane są wszystkie zdarzenia dodania użytkownika do dysku współdzielonego:
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 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 wysyłasz do interfejsu API żądanie HTTP GET, w odpowiedzi na żądanie zakończone powodzeniem otrzymujesz kod stanu HTTP 200. Oprócz kodu stanu odpowiedź zawiera raport
dla Dysku. Te raporty są też dostępne w konsoli administracyjnej. Więcej informacji znajdziesz w Centrum pomocy dla administratorów Google Workspace.
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 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"
}
]
}
]
},
]
}