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 wykrywać ewentualne wycieki 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, 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 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, prawidłowa odpowiedź zwraca 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 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"
}
]
}
]
},
]
}