O relatório de atividade do token de autorização retorna informações sobre sites e aplicativos de terceiros aos quais os usuários concederam acesso. Cada relatório usa a solicitação de endpoint de relatório básica com parâmetros específicos, como o domínio de terceiros ou os escopos de autorização concedidos. O período máximo de cada relatório é de 180 dias.
O Relatório de atividade do token OAuth só pode ser usado para fins legais, de acordo com seu Contrato de Cliente.
Extrair todos os eventos de token de autorização de um domínio
Para extrair todos os eventos de autorização de aplicativos de terceiros, use a
solicitação HTTP GET abaixo 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 está 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 mostra 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
Extrair eventos de token de autorização por nome
Em alguns casos, convém recuperar eventos específicos, como se o
acesso de um app foi revogado. Para fazer isso, use uma solicitação HTTP GET
neste 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 extrair 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