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"
}
]
}
]
},
]
}