Reports API: отчет об активности токенов авторизации

Отчет о активности токена авторизации возвращает информацию о сторонних веб-сайтах и ​​приложениях, к которым ваши пользователи предоставили доступ. В каждом отчете используется базовый запрос конечной точки отчета с параметрами, специфичными для отчета, такими как сторонний домен или предоставленные области авторизации. Максимальный период времени для каждого отчета — последние 180 дней.

Отчет о активности токена OAuth можно использовать только в законных целях в соответствии с вашим Клиентским соглашением.

Получить все события токена авторизации для домена

Чтобы получить все события авторизации для сторонних приложений, используйте следующий HTTP-запрос GET и включите токен авторизации, описанный в документации по авторизации . Дополнительные сведения о строках запроса запроса и свойствах ответа см. в справочнике по API . Для удобства чтения следующий пример отформатирован с возвратом строк:

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

В следующем примере создается отчет обо всех событиях авторизации вашей учетной записи за последние 180 дней. Параметр запроса maxResults позволяет этому отчету возвращать 25 результатов на страницу.

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

Получение событий токена авторизации по имени события

В некоторых случаях вам может потребоваться получить определенные события, например, был ли отозван доступ к приложению. Для этого используйте HTTP-запрос GET следующего вида:

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

В следующем примере показано, как получить все события revoke для домена:

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