API Reports: report sull'attività dei token di autorizzazione

Il report sull'attività dei token di autorizzazione restituisce informazioni sulle terze parti i siti web e le applicazioni a cui gli utenti hanno concesso l'accesso. Ogni report utilizza la richiesta di base dell'endpoint del report con parametri specifici del report come come gli ambiti di autorizzazione o dominio di terze parti concessi. Il tempo massimo per ciascun report sia gli ultimi 180 giorni.

Il report Attività del token OAuth può essere utilizzato solo per scopi legittimi in conformità con il Contratto con il cliente.

Recupera tutti gli eventi dei token di autorizzazione per un dominio

Per recuperare tutti gli eventi di autorizzazione per le applicazioni di terze parti, utilizza la classe a seguito di una richiesta HTTP GET e includere il token di autorizzazione descritto in documentazione sull'autorizzazione. Per ulteriori informazioni sulle stringhe di query per la richiesta e sulle proprietà delle risposte, consulta Riferimento API. Per motivi di leggibilità, l'esempio seguente è formattato con i ritorni a riga:

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'esempio seguente genera un report su tutti gli eventi di autorizzazione del tuo account degli ultimi 180 giorni. Il parametro di query maxResults restituisce questo report 25 risultati per pagina.

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

Recuperare gli eventi dei token di autorizzazione per nome evento

In alcuni casi, potresti voler recuperare eventi specifici, ad esempio se un l'accesso dell'applicazione è stato revocato. A questo scopo, utilizza una richiesta HTTP GET con il seguente 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

L'esempio seguente mostra come recuperare tutti gli eventi revoke per un dominio:

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