El informe de actividad de tokens de autorización muestra información sobre los sitios web y las aplicaciones de terceros a los que tus usuarios otorgaron acceso. Cada informe usa la solicitud de extremo de informe básica 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 es de los últimos 180 días.
El informe de actividad de tokens de OAuth solo se puede usar con fines legales de conformidad con tu Acuerdo con el Cliente.
Cómo recuperar todos los eventos de tokens de autorización de un dominio
Para recuperar todos los eventos de autorización de aplicaciones de terceros, usa la siguiente solicitud HTTP GET y, luego, incluye el token de autorización que se describe en la documentación de autorización.
Para obtener más información sobre las cadenas de consulta de solicitudes y las propiedades de respuesta, consulta la referencia de la API.
Para facilitar la lectura, el siguiente ejemplo tiene formato con saltos 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 de 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
Cómo recuperar eventos de tokens de autorización por nombre del evento
En algunos casos, es posible que desees recuperar eventos específicos, como si se revocó el acceso de una
aplicación. Para ello, usa una solicitud HTTP GET del 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