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