O relatório de atividade do administrador retorna informações sobre as atividades do Admin Console de todos os administradores da conta. Cada relatório usa a solicitação básica do endpoint com parâmetros específicos do relatório, como o nome de um administrador ou um evento específico do Admin Console. O período máximo de cada relatório são os últimos 180 dias.
O relatório de atividades do administrador só pode ser usado para fins legais, de acordo com seu Contrato de Cliente. Esses relatórios são válidos para contas do Google Workspace, Education e ISPs.
Recuperar todas as atividades administrativas
Para recuperar um relatório de todas as atividades administrativas realizadas para uma conta, use a seguinte solicitação HTTP GET e inclua o token de autorização descrito na documentação de autorização. Para mais informações sobre as strings de consulta e as propriedades de resposta da solicitação, veja a Referência da API. Para facilitar a leitura, o exemplo a seguir é formatado com retornos de linha:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all /applications/admin?endTime=a date&startTime=a date &maxResults=number of events listed on each page of the report
O exemplo a seguir exibe um relatório sobre todas as atividades administrativas da sua conta nos últimos 180 dias, que é o período máximo para um relatório. E a string de consulta maxResults determina que esse relatório contém dois eventos por página de relatório. Para ver um exemplo de resposta de API, consulte o exemplo de resposta JSON:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all /applications/admin?maxResults=2
O exemplo a seguir exibe um relatório sobre todas as atividades administrativas de um cliente nos últimos 180 dias. O customerId especifica para qual cliente o relatório será recuperado.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all /applications/admin?customerId=C03az79cb
Recuperar todas as atividades do administrador
Para recuperar um relatório de todas as atividades do Admin Console realizadas por um administrador específico, use a seguinte solicitação HTTP GET e inclua o token de autorização descrito na documentação de autorização. O userKey é o endereço de e-mail principal do administrador no relatório. Para mais informações sobre as strings de consulta e as propriedades de resposta da solicitação, veja a Referência da API. Para facilitar a leitura, o exemplo a seguir é formatado com retornos de linha:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/userKey /applications/admin?endTime=a date&startTime=a date &maxResults=number of events listed on each page of the report &filters=event name parameter relational operator parameter value
O exemplo a seguir gera um relatório sobre todas as mudanças no aplicativo Admin Console feitas por john@example.com, e a resposta é filtrada para retornar todas as atividades com OLD_VALUE igual a ALLOW_CAMERA. Para ver um exemplo de resposta de API, consulte o exemplo de resposta JSON. Se quiser informações sobre as atividades, consulte os nomes dos eventos do administrador:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/john@example.com /applications/admin?maxResults=2&filters=OLD_VALUE==ALLOW_CAMERA
Recuperar todas as atividades por nome do evento
Para recuperar um relatório de todas as atividades de um nome de evento específico, use a seguinte solicitação HTTP GET e inclua o token de autorização descrito na documentação de autorização. Saiba mais sobre eventName na referência dos nomes de eventos do administrador. Para mais informações sobre as strings de consulta e as propriedades de resposta da solicitação, veja a Referência da API. Para facilitar a leitura, o exemplo a seguir é formatado com retornos de linha:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all /applications/admin?endTime=a date&startTime=a date &maxResults=maximum number of events returned on a response page &eventName=name of the administrative event
O exemplo a seguir recupera um relatório de todas as instâncias do Admin Console que alteram o sobrenome de um usuário. Para ver um exemplo de resposta de API, consulte o exemplo de resposta JSON:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all /applications/admin?maxResults=1&eventName=CHANGE_LAST_NAME
Recuperar todas as atividades por evento e administrador
Para recuperar um relatório de todas as mudanças no Admin Console para um nome de evento específico feita por um administrador específico, use a seguinte solicitação HTTP GET e inclua o token de autorização descrito na documentação de autorização. O userKey é o endereço de e-mail principal do administrador no relatório. Saiba mais sobre eventName na referência dos nomes de eventos do administrador. Para mais informações sobre as strings de consulta e as propriedades de resposta da solicitação, veja a Referência da API. Para facilitar a leitura, o exemplo a seguir é formatado com retornos de linha:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/userKey /applications/admin?endTime=a date&startTime=a date &maxResults=maximum number of events returned on a response page &eventName=name of the administrative event
O exemplo a seguir recupera um relatório de todas as alterações no Admin Console no sobrenome de um usuário específico feitas por john@example.com. Para ver um exemplo de resposta de API, consulte o exemplo de resposta JSON:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/john@example.com /applications/admin?maxResults=1&eventName=CHANGE_LAST_NAME
Exemplo de resposta JSON do relatório de atividades do administrador
Se a resposta for bem-sucedida, o código de status HTTP 200 será retornado. Juntamente com o código de status, a resposta retorna um relatório. Saiba mais sobre eventName na referência dos nomes de eventos do administrador. Para mais informações sobre as strings de consulta do URL do pedido e as propriedades de resposta, consulte a Referência da API.
{
"kind": "reports#auditActivities",
"nextPageToken": "the next page's token",
"items": [
{
"kind": "audit#activity",
"id": {
"time": "2011-06-17T15:39:18.460Z",
"uniqueQualifier": "report's unique ID",
"applicationName": "admin",
"customerId": "C03az79cb"
},
"actor": {
"callerType": "USER",
"email": "liz@example.com",
"profileId": "user's unique Google Workspace profile ID",
"key": "consumer key of requestor in OAuth 2LO requests"
},
"ownerDomain": "example.com",
"ipAddress": "user's IP address",
"events": [
{
"type": "GROUP_SETTINGS",
"name": "CHANGE_GROUP_SETTING",
"parameters": [
{
"name": "SETTING_NAME",
"value": "WHO_CAN_JOIN",
"intValue": "integer value of parameter",
"boolValue": "boolean value of parameter"
}
]
}
]
},
{
"kind": "audit#activity",
"id": {
"time": "2011-06-17T15:39:18.460Z",
"uniqueQualifier": "reports unique ID",
"applicationName": "admin",
"customerId": "C03az79cb"
},
"actor": {
"callerType": "USER",
"email": "liz@example.com",
"profileId": "user's unique Google Workspace profile ID",
"key": "consumer key of requestor in an OAuth 2LO request"
},
"ownerDomain": "example.com",
"ipAddress": "user's IP address",
"events": [
{
"type": "GROUP_SETTINGS",
"name": "CREATE_GROUP",
"parameters": [
{
"name": "GROUP_EMAIL",
"value": "helpdesk@example.com",
"intValue": "",
"boolValue": ""
}
]
}
]
}
]
}