O relatório de atividade do token de autorização retorna informações sobre sites e aplicativos de terceiros a que seus usuários concederam acesso. Cada relatório usa a solicitação básica de endpoint de relatório 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 o 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 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 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 o 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 do evento
Em alguns casos, talvez seja necessário recuperar eventos específicos, como se o acesso de um
aplicativo foi revogado. Para isso, use uma solicitação HTTP GET
deste 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