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

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

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 básica de endpoints de 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 é nos últimos 180 dias.

O Relatório de atividade de token do OAuth pode ser usado apenas 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 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 fins de legibilidade, o exemplo a seguir é formatado com devoluções 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 exibe um relatório sobre todos os eventos de autorização da sua conta dos últimos 180 dias. O parâmetro de consulta maxResults tem esse relatório que retorna 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 do evento

Em alguns casos, pode ser necessário recuperar eventos específicos, como 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 de revoke de um domínio:

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