O Relatório de atividade do Drive mostra informações sobre as atividades dos seus usuários ao gerenciar, modificar e compartilhar arquivos no Google Drive no Google Workspace. Por exemplo, você pode usar o Relatório de atividade do Drive para conferir uma lista de todos os novos documentos do Drive criados por um usuário específico em um período especificado. Você pode usar essas informações para ter insights sobre melhor gerenciamento de conteúdo e possíveis vazamentos de dados. Para receber um relatório, use a solicitação de endpoint de relatório básico com parâmetros específicos, como o endereço de e-mail do usuário ou um tipo específico de alteração no Google Drive. Os relatórios podem incluir dados dos últimos 180 dias.
O Relatório de atividades do Google Drive só pode ser usado para fins legais em contas que têm uma licença atribuída.
Para informações sobre as strings de consulta da solicitação e as propriedades de resposta, consulte a Referência da API. Para informações sobre eventos específicos relacionados ao Google Drive, consulte Nomes de eventos do Drive.
Extrair eventos do Google Drive de um domínio
Você pode usar o Relatório de atividade do Drive para listar informações sobre seus
documentos do Drive. Por exemplo, é possível solicitar um relatório com os
25 eventos mais recentes do Drive da sua conta, cobrindo até 180
dias. Para gerar esse relatório, receba um token de autorização, conforme descrito no
guia de autorização, e use
a seguinte solicitação HTTP GET:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?maxResults=25
Confira um exemplo de resposta para essa chamada de API.
O exemplo a seguir recupera um relatório de todos os eventos do Drive dos últimos 180 dias, o período máximo.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive
Extrair eventos do Google Drive por usuário
Para extrair um relatório das atividades do Google Drive de um usuário específico, use uma
solicitação HTTP GET com o token de autorização descrito no
guia autorização.
O campo userKey é o endereço de e-mail principal do usuário no relatório ou
all para todos os usuários.
O exemplo a seguir recupera um relatório com a lista de todas as alterações feitas pelo usuário especificado. Para conferir um exemplo de resposta da API, consulte o exemplo de resposta JSON.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/kim@example.com
/applications/drive
Extrair eventos do Google Drive para drives compartilhados
É possível extrair um relatório de atividades do Google Drive para um drive compartilhado
específico usando uma solicitação GET HTTP com o token de autorização descrito no
guia de autorização. Especifique o
endereço de e-mail do usuário para quem você quer gerar o relatório no campo userKey
ou especifique all para gerar o relatório para todos os usuários.
O exemplo a seguir recupera um relatório de todas as mudanças de uma unidade compartilhada específica. Para conferir um exemplo de resposta da API, consulte a resposta JSON de exemplo.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?filters=shared_drive_id==<id of shared drive>
Para recuperar eventos de um drive compartilhado, use o filtro doc_type. O
exemplo a seguir recupera eventos que afetam todos os drives compartilhados:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?filters=doc_type=shared_drive
Para extrair eventos de mudanças de associação, especifique o evento
shared_drive_membership_change. O exemplo a seguir recupera todas as adições de membros aos drives compartilhados:
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
Extrair eventos do Google Drive por tipo de evento
Para extrair um relatório de todas as instâncias de um tipo de evento específico, como a criação
ou edição de um documento, use uma solicitação HTTP GET com o token de autorização
descrito no guia de autorização.
O campo userKey é o endereço de e-mail principal do usuário no relatório ou
all para todos os usuários.
O exemplo a seguir recupera um relatório de todas as atividades de criação de documentação da conta. Para conferir um exemplo de resposta da API, consulte a resposta JSON de exemplo:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?eventName=create
Exemplo de resposta JSON
Quando você faz uma solicitação HTTP GET para a API, uma resposta bem-sucedida retorna um
código de status HTTP 200. Além do código de status, a resposta retorna um relatório
para o Drive. Esses relatórios também estão disponíveis no
Admin Console. Para mais informações, consulte a
Central de Ajuda para admins do Google Workspace.
Para informações sobre eventName, consulte a
referência de
nomes de eventos do Drive. Para mais informações sobre as strings de consulta da solicitação e as
propriedades de resposta, consulte a Referência da 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"
}
]
}
]
},
]
}