Il report sull'attività dei token di autorizzazione restituisce informazioni su siti web e applicazioni di terze parti a cui i tuoi utenti hanno concesso l'accesso. Ogni report utilizza la richiesta dell'endpoint di base del report con parametri specifici del report, ad esempio il dominio di terze parti o gli ambiti di autorizzazione concessi. Il periodo di tempo massimo per ogni report è di 180 giorni.
Il report sull'attività dei token OAuth può essere utilizzato solo per scopi leciti in conformità al Contratto con il cliente.
Recuperare tutti gli eventi dei token di autorizzazione per un dominio
Per recuperare tutti gli eventi di autorizzazione per 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à della 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 recupera un report su tutti gli eventi di autorizzazione del tuo account
negli ultimi 180 giorni. Il parametro della query maxResults fa in modo che questo report restituisca
25 risultati per pagina.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/token?maxResults=25
Recuperare gli eventi del token di autorizzazione per nome evento
In alcuni casi, potresti voler recuperare eventi specifici, ad esempio se l'accesso di un'applicazione è stato revocato. Per farlo, utilizza una richiesta HTTP GET
nel 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