Reports API: 승인 토큰 활동 보고서
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
승인 토큰 활동 보고서는 사용자가 액세스 권한을 부여한 서드 파티 웹사이트 및 애플리케이션에 관한 정보를 반환합니다. 각 보고서는 부여된 서드 파티 도메인 또는 승인 범위와 같은 보고서별 매개변수와 함께 기본 보고서 엔드포인트 요청을 사용합니다. 각 보고서의 최대 기간은 지난 180일입니다.
OAuth 토큰 활동 보고서는 고객 계약에 따라 합법적인 목적으로만 사용할 수 있습니다.
도메인의 모든 승인 토큰 이벤트 가져오기
서드 파티 애플리케이션의 모든 승인 이벤트를 가져오려면 다음 GET HTTP 요청을 사용하고 승인 문서에 설명된 승인 토큰을 포함합니다.
요청 쿼리 문자열 및 응답 속성에 대한 자세한 내용은 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
이벤트 이름으로 승인 토큰 이벤트 가져오기
경우에 따라 애플리케이션의 액세스 권한이 취소되었는지 등 특정 이벤트를 가져오고 싶을 수 있습니다. 이렇게 하려면 다음 형식의 GET HTTP 요청을 사용합니다.
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
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-29(UTC)
[null,null,["최종 업데이트: 2025-08-29(UTC)"],[],[],null,["# Reports API: Authorization Tokens Activity Report\n\nThe authorization token activity report returns information about third party\nwebsites and applications your users have granted access for. Each report\nuses the basic report endpoint request with report-specific parameters such\nas the third party domain or authorization scopes granted. The maximum time\nperiod for each report is the last 180 days.\n\nThe OAuth token activity report may be used only for lawful purposes in accordance with your Customer Agreement.\n\nRetrieve all authorization token events for a domain\n----------------------------------------------------\n\nTo retrieve all authorization events for third party applications, use the\nfollowing `GET` HTTP request and include the authorization token described in the\n[authorization documentation](https://developers.google.com/workspace/admin/reports/v1/guides/authorizing.html).\nFor more information about the request query strings and response properties,\nsee the [API Reference](/workspace/admin/reports/v1/reference/activity-ref-appendix-a/token-event-names).\nFor readability purposes, the following example is formatted with line returns: \n\n```\nGET https://admin.googleapis.com/admin/reports/v1/activity/users/all\n/applications/token?endTime=end date&startTime=start date\n&maxResults=maximum number of events returned on a response page\n```\n\nThe following example gets a report on all of your account's authorization events\nfor the past 180 days. The `maxResults` query parameter has this report return\n25 results per page. \n\n```\nGET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/token?maxResults=25\n```\n\nRetrieve authorization token events by event name\n-------------------------------------------------\n\nIn some instances, you may want to retrieve specific events, such as whether an\napplication's access has been revoked. To do this, use a `GET` HTTP request\nof the following form: \n\n```\nGET https://admin.googleapis.com/admin/reports/v1/activity/users/all\n/applications/token?maxResults=maximum number of events returned on a response page\n&eventName=name of the OAuth token event\n```\n\nThe following example shows how to retrieve all `revoke` events for a domain: \n\n```\nGET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/token?eventName=revoke&maxResults=25\n```"]]
