O relatório "Atividade do Drive" fornece informações sobre os usuários atividades ao gerenciar, modificar e compartilhar arquivos no Google Drive no Google Workspace. Por exemplo, você pode usar o relatório "Atividade do Drive" para ver uma lista de todos os novos documentos do Google Drive criados por um determinado usuário um intervalo específico de datas. Você pode usar essas informações para obter insights sobre melhor gerenciamento de conteúdo e possíveis vazamentos de dados. Para gerar um relatório, você usa a solicitação de ponto de extremidade do relatório básico com parâmetros específicos do relatório, como um 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: que têm uma licença atribuída.
Para mais informações sobre as strings de consulta da solicitação e as propriedades da resposta, consulte a Referência da API. Para informações sobre eventos específicos relacionados ao Google Drive, consulte Nomes de eventos do Drive:
Recuperar eventos do Google Drive de um domínio
Você pode usar o Relatório de atividade do Google Drive para listar informações sobre sua
Documentos do Google Drive. Por exemplo, é possível solicitar um relatório
25 eventos do Google Drive mais recentes em sua conta, cobrindo até 180
dias. Para acessar esse relatório, consiga 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
Veja um exemplo de resposta para essa chamada de API.
O exemplo a seguir recupera um relatório de todos os itens do Google Drive eventos nos últimos 180 dias, que é o período máximo.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive
Recuperar eventos do Google Drive por usuário
Para recuperar um relatório das atividades do Google Drive de um usuário específico, use um
solicitação HTTP GET com o token de autorização descrito no
guia de autorização.
o campo userKey for 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 que lista todas as alterações feitas por o usuário especificado. Para ver um exemplo de resposta da API, consulte a exemplo de resposta JSON.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/kim@example.com
/applications/drive
Recuperar eventos do Google Drive nos drives compartilhados
Você pode recuperar um relatório das atividades do Google Drive de uma pasta
usando uma solicitação HTTP GET com o token de autorização descrito no
guia de autorização. Especifique o
o endereço de e-mail do usuário sobre quem você quer gerar o relatório no campo userKey
ou especificar all para gerar o relatório com todos os usuários.
O exemplo a seguir recupera um relatório de todas as alterações de uma conta unidade Para ver um exemplo de resposta da API, consulte o exemplo de resposta JSON.
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, filtre usando doc_type. A
este exemplo 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 recuperar eventos de mudanças na associação, especifique o shared_drive_membership_change
evento. O exemplo a seguir recupera todas as adições de participantes 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
Recuperar eventos do Google Drive por tipo de evento
Recuperar um relatório de todas as instâncias de um tipo de evento específico, como a criação de
ou editando um documento, use uma solicitação GET HTTP com a autorização
descrito no guia de autorização.
o campo userKey for 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 toda a criação da documentação da conta atividades. Para conferir um exemplo de resposta da API, consulte o exemplo de resposta JSON:
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. Junto com o código de status, a resposta retorna um relatório
para o Drive. Esses relatórios também estão disponíveis
Admin Console. Para mais informações, consulte a
Central de Ajuda para admins do Google Workspace.
Para mais informações sobre eventName, consulte a
Nomes de eventos do Drive
de referência. Para mais informações sobre as strings de consulta da solicitação e o
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"
}
]
}
]
},
]
}