Отчёт об активности токенов авторизации содержит информацию о сторонних веб-сайтах и приложениях, к которым ваши пользователи предоставили доступ. Каждый отчёт использует базовый запрос к конечной точке отчёта со специфическими для отчёта параметрами, такими как сторонний домен или предоставленные области авторизации. Максимальный временной период для каждого отчёта — последние 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