API de informes: Informe de actividad de tokens de autorización

El informe de actividad del token de autorización muestra información sobre sitios web y aplicaciones de terceros a los que los usuarios les otorgaron acceso. Cada informe utiliza la solicitud básica del extremo del informe con parámetros específicos del informe, como el dominio de terceros o los alcances de autorización otorgados. El período máximo de cada informe comprende los últimos 180 días.

El informe de actividad de tokens de OAuth solo se puede utilizar con fines jurídicos, de conformidad con el Acuerdo del Cliente.

Recuperar todos los eventos de token de autorización de un dominio

Para recuperar todos los eventos de autorización para aplicaciones de terceros, usa la siguiente solicitud HTTP GET e incluye el token de autorización descrito en la documentación de autorización. Si deseas obtener más información sobre las cadenas de consulta de solicitud y las propiedades de respuesta, consulta la Referencia de la API. Para facilitar la lectura, el siguiente ejemplo tiene un formato con resultados de línea:

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

En el siguiente ejemplo, se obtiene un informe sobre todos los eventos de autorización de tu cuenta durante los últimos 180 días. El parámetro de consulta maxResults hace que este informe muestre 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 autorización por nombre de evento

En algunas instancias, es posible que desees recuperar eventos específicos, por ejemplo, si se revocó el acceso a una aplicación. Para ello, usa una solicitud HTTP GET con el siguiente 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

En el siguiente ejemplo, se muestra cómo recuperar todos los eventos revoke de un dominio:

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