Il report sull'attività dei token di autorizzazione restituisce informazioni sui siti web e sulle applicazioni di terze parti a cui gli utenti hanno concesso l'accesso. Ogni report utilizza la richiesta di endpoint di report di base con parametri specifici, come il dominio di terze parti o gli ambiti di autorizzazione concessi. Il periodo di tempo massimo per ogni report corrisponde agli ultimi 180 giorni.
Il report sull'attività del token OAuth può essere utilizzato solo per scopi leciti, in conformità con il Contratto con il cliente.
Recuperare 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 seguente richiesta HTTP GET e includi il token di autorizzazione descritto nella documentazione relativa all'autorizzazione.
Per ulteriori informazioni sulle stringhe di query di richiesta e sulle proprietà della risposta, consulta la documentazione di riferimento API.
Per motivi di leggibilità, il seguente esempio viene formattato con 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 restituisce un report su tutti gli eventi di autorizzazione del tuo account
per gli ultimi 180 giorni. Il parametro di query maxResults consente di restituire 25 risultati per pagina in questo report.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/token?maxResults=25
Recupera gli eventi dei token di autorizzazione in base al nome evento
In alcuni casi, potresti voler recuperare eventi specifici, ad esempio se l'accesso di un'applicazione è stato revocato. A questo scopo, utilizza una richiesta HTTP GET
del seguente modulo:
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