API Reports: rapport sur l'activité des jetons d'autorisation

Le rapport "Activité des jetons d'autorisation" renvoie des informations sur les tiers les sites Web et les applications auxquels vos utilisateurs ont accordé l'accès. Chaque rapport utilise la demande de point de terminaison du rapport de base avec des paramètres spécifiques au rapport tels que que le domaine tiers ou les niveaux d'autorisation accordés. La durée maximale pour chaque rapport correspond aux 180 derniers jours.

Le rapport sur l'activité des jetons OAuth ne peut être utilisé qu'à des fins légales, conformément à votre contrat client.

Récupérer tous les événements de jeton d'autorisation pour un domaine

Pour récupérer tous les événements d'autorisation associés à des applications tierces, utilisez la classe la requête HTTP GET suivante et inclure le jeton d'autorisation décrit dans la documents d'autorisation. Pour en savoir plus sur les chaînes de requête et les propriétés de réponse, consultez la documentation de référence de l'API. Pour des raisons de lisibilité, l'exemple suivant est mis en forme avec des retours à la ligne:

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

L'exemple suivant permet de générer un rapport sur tous les événements d'autorisation de votre compte au cours des 180 derniers jours. Ce rapport renvoie le paramètre de requête maxResults 25 résultats par page.

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

Récupérer les événements de jeton d'autorisation par nom d'événement

Dans certains cas, vous pouvez souhaiter récupérer des événements spécifiques, par exemple si un l'accès de cette application a été révoqué. Pour ce faire, utilisez une requête HTTP GET. sous la forme suivante:

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

L'exemple suivant montre comment récupérer tous les événements revoke d'un domaine:

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