API Reports: relatório de atividade de tokens de autorização

O relatório de atividade do token de autorização retorna informações sobre sites e aplicativos de terceiros a que os usuários concederam acesso. Cada relatório usa a solicitação básica de endpoint do relatório com parâmetros específicos do relatório, como o domínio de terceiros ou os escopos de autorização concedidos. O período máximo de cada relatório são os últimos 180 dias.

O relatório de atividades do token OAuth só pode ser usado para fins legais de acordo com seu Contrato de Cliente.

Recuperar todos os eventos de token de autorização de um domínio

Para recuperar todos os eventos de autorização de aplicativos de terceiros, use a solicitação HTTP GET a seguir e inclua o token de autorização descrito na documentação de autorização. Para mais informações sobre as strings de consulta de solicitação e as propriedades de resposta, consulte 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/token?endTime=end date&startTime=start date
&maxResults=maximum number of events returned on a response page

O exemplo a seguir recebe um relatório sobre todos os eventos de autorização da sua conta nos últimos 180 dias. O parâmetro de consulta maxResults faz com que esse relatório retorne 25 resultados por página.

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/token?maxResults=25

Recuperar eventos de token de autorização por nome de evento

Em alguns casos, é possível recuperar eventos específicos, por exemplo, se o acesso de um aplicativo foi revogado. Para fazer isso, use uma solicitação HTTP GET no seguinte formato:

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/token?maxResults=maximum number of events returned on a response page
&eventName=name of the OAuth token event

O exemplo a seguir mostra como recuperar todos os eventos revoke de um domínio:

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/token?eventName=revoke&maxResults=25