Raport o aktywności na Dysku zawiera informacje o tym, co użytkownicy robią na Dysku Google w Google Workspace, gdy zarządzają plikami, modyfikują je i udostępniają je innym. Za pomocą raportu o aktywności na Dysku możesz na przykład 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ć ewentualnym 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 maksymalnie 180 dni.
Raport o aktywności na Dysku Google może być używany tylko do celów zgodnych z prawem na kontach, na których przypisano licencję.
Informacje o ciągu zapytania żądania i właściwościach odpowiedzi znajdziesz w dokumentacji API. Informacje o konkretnych zdarzeniach związanych z Dyskiem Google znajdziesz w artykule Nazwy zdarzeń Dysku.
Pobieranie zdarzeń Dysku Google w domenie
Za pomocą raportu o aktywności na Dysku możesz wyświetlić informacje o dokumentach na Dysku. Możesz na przykład poprosić o raport zawierający 25 najnowszych zdarzeń na koncie z Dysk, które miały miejsce w ciągu ostatnich 180 dni. Aby uzyskać ten raport, uzyskaj token autoryzacji w sposób opisany w przewodniku autoryzacji, a potem użyj tego żądania HTTP GET:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?maxResults=25
Poniżej znajdziesz przykładową odpowiedź na to wywołanie interfejsu API.
W tym przykładzie pobierany jest raport ze wszystkimi zdarzeniami z Dysku z ostatnich 180 dni (maksymalny okres).
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 autoryzacji.
Pole userKey to główny adres e-mail użytkownika w raporcie lub all dla wszystkich użytkowników.
W tym przykładzie pobieramy raport zawierający wszystkie zmiany wprowadzone przez wskazanego 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ń Dysku Google na dyskach współdzielonych
Raport o działaniach na Dysku Google dotyczących konkretnego udostępnionego dysku możesz pobrać, wysyłając żądanie HTTP GET z tokenem autoryzacji opisanym w przewodniku po autoryzacji. W polu userKey wpisz adres e-mail użytkownika, dla którego chcesz utworzyć raport, lub wybierz all, aby utworzyć raport dla wszystkich użytkowników.
W tym przykładzie pobieramy raport ze wszystkimi zmianami 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 dotyczące dysku współdzielonego, zastosuj filtr doc_type. W tym przykładzie pobierane są zdarzenia, które wpływają 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 dodane osoby na dyskach 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 Google Dysku według typu zdarzenia
Aby pobrać raport ze wszystkimi wystąpieniami określonego typu zdarzenia, np. tworzenia lub edytowania dokumentu, użyj żądania HTTP GET z tokenem autoryzacji opisanym w przewodniku dotyczącym autoryzacji.
Pole userKey to główny adres e-mail użytkownika w raporcie lub all dla wszystkich użytkowników.
W tym przykładzie pobierany jest raport ze wszystkimi działaniami dotyczącymi tworzenia dokumentacji konta. Przykład odpowiedzi interfejsu API: przykładowa odpowiedź JSON:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?eventName=create
Przykład odpowiedzi JSON
Gdy wysyłasz żądanie HTTP GET do interfejsu API, pomyślna odpowiedź zwraca kod stanu HTTP 200. Oprócz kodu stanu odpowiedź zawiera też 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 przewodniku Nazwy zdarzeń na Dysku. Więcej informacji o ciągu zapytania żą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"
}
]
}
]
},
]
}