Raport „Aktywność na Dysku” zawiera informacje o działaniach użytkowników aktywności gdy zarządzają plikami na Dysku Google w Google Workspace oraz je modyfikują i udostępniają. Możesz na przykład użyć raportu Działania na Dysku, aby uzyskać listę wszystkich nowych dokumentów na Dysku utworzonych przez określonego użytkownika w okresie dla wybranego zakresu dat. Możesz wykorzystać te informacje, aby dowiedzieć się, lepsze zarządzanie treścią i możliwe wycieki danych. Aby uzyskać raport, podstawowe żądanie punktu końcowego raportu zawierające parametry związane z raportem, takie jak adresu e-mail użytkownika lub konkretnego rodzaju zmiany na Dysku Google. Raporty mogą obejmują dane z ostatnich 180 dni.
Raportu o aktywności na Dysku Google można używać wyłącznie do celów zgodnych z prawem w przypadku kont, mają przypisaną licencję.
Aby uzyskać informacje o ciągach zapytań i właściwościach odpowiedzi, zobacz dokumentację API. Dla: informacji o konkretnych zdarzeniach związanych z Dyskiem Google, zobacz Nazwy zdarzeń na Dysku.
Pobieranie zdarzeń z Dysku Google dla domeny
W raporcie Aktywności na Dysku możesz znaleźć informacje o
Dokumenty na Dysku. Możesz na przykład poprosić o utworzenie raportu
25 najnowszych zdarzeń związanych z Dyskiem na Twoim koncie, obejmując do 180
dni. Aby otrzymać ten raport, uzyskaj token autoryzacji zgodnie z opisem w
przewodnika po autoryzacji, a następnie użyj
to żądanie 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.
Ten przykład umożliwia pobranie raportu o wszystkich danych na Dysku zdarzenia z ostatnich 180 dni, czyli maksymalny okres.
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 określonego użytkownika na Dysku Google, użyj funkcji
Żądanie HTTP GET z tokenem autoryzacji opisanym w
przewodnika po autoryzacji.
Pole userKey to podstawowy adres e-mail użytkownika uwzględnionego w raporcie lub
all dla wszystkich użytkowników.
Poniższy przykład umożliwia pobranie raportu z listą wszystkich zmian wprowadzonych przez do określonego użytkownika. Przykładowa odpowiedź interfejsu API znajdziesz w sekcji przykładową odpowiedź 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
Możesz pobrać raport o aktywności na Dysku Google dla określonego udostępnionego elementu
za pomocą żądania HTTP GET z tokenem autoryzacji opisanym w
przewodnik po autoryzacji. Podaj wartość
w polu userKey wpisz 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 wszystkich zmian w określonym Dysku Google. Przykładowa 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ć zdarzenia z dysku współdzielonego, odfiltruj dane przy użyciu: doc_type.
Ten przykład pozwala pobrać 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 dla zmian w członkostwie, określ shared_drive_membership_change
. Ten przykład pobiera wszystkie dane 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, np. o utworzeniu
lub edytować dokument, użyj żądania HTTP GET z autoryzacją.
token opisany w przewodniku po autoryzacji.
Pole userKey to podstawowy adres e-mail użytkownika uwzględnionego w raporcie lub
all dla wszystkich użytkowników.
Ten przykład umożliwia pobranie raportu całej tworzenia dokumentacji konta aktywności. Przykładowa odpowiedź interfejsu API znajdziesz w sekcji przykładowa odpowiedź 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.
dla Dysku. Raporty te są również dostępne w
konsoli administracyjnej. Więcej informacji:
Centrum pomocy Google Workspace dla administratorów.
Więcej informacji o eventName znajdziesz tutaj:
Nazwy zdarzeń na Dysku
odwołania. Aby uzyskać więcej informacji o ciągach zapytań żądania oraz
właściwości odpowiedzi można znaleźć 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"
}
]
}
]
},
]
}