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

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

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

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

Para recuperar todos os eventos de autorização para aplicativos de terceiros, use o seguinte solicitação HTTP GET e incluir o token de autorização descrito no 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 gera um relatório sobre todos os eventos de autorização da conta. dos ú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 do token de autorização por nome de evento

Em alguns casos, você pode querer recuperar eventos específicos, por exemplo, se um o acesso do app for revogado. Para fazer isso, use uma solicitação HTTP GET da seguinte forma:

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