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 クエリ パラメータにより、このレポートは 1 ページあたり 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
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は 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```"]]
