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

El informe de actividad del token de autorización devuelve información sobre terceros sitios web y aplicaciones a los que tus usuarios les hayan otorgado acceso. Cada informe usa la solicitud básica del extremo del informe con los parámetros específicos del informe, como como el dominio de terceros o los alcances de autorización otorgados. Tiempo máximo de cada informe son los últimos 180 días.

El informe de actividad del token de OAuth solo se puede usar con fines legales de acuerdo 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 el después de la solicitud HTTP GET e incluye el token de autorización descrito en el documentación de autorización. Para obtener más información sobre las cadenas de consulta de solicitud y las propiedades de las respuestas, consulta la Referencia de la API. Para facilitar la lectura, el siguiente ejemplo tiene un formato que muestra resultados de líneas:

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. de los últimos 180 días. El parámetro de búsqueda maxResults muestra este informe 25 resultados por página

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

Recupera eventos de token de autorización por nombre de evento

En algunos casos, es posible que quieras recuperar eventos específicos, por ejemplo, si un se revocó el acceso de la aplicación. Para ello, usa una solicitud HTTP GET de la siguiente 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

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