Method: activities.list

特定の顧客のアカウントとアプリケーション（管理コンソール アプリケーションや Google ドライブ アプリケーションなど）のアクティビティのリストを取得します。詳しくは、管理者と Google ドライブのアクティビティ レポートのガイドをご覧ください。アクティビティ レポートのパラメータについて詳しくは、アクティビティ パラメータのリファレンス ガイドをご覧ください。

HTTP リクエスト

GET https://admin.googleapis.com/admin/reports/v1/activity/users/{userKey or all}/applications/{applicationName}

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
userKey or all

string

データをフィルタするプロファイル ID またはユーザーのメールアドレスを表します。すべての情報の場合は all、ユーザーの一意の Google Workspace プロファイル ID またはメインのメールアドレスの場合は userKey になります。削除されたユーザーであってはなりません。削除されたユーザーの場合は、Directory API で showDeleted=true を使用して users.list を呼び出し、返された ID を userKey として使用します。
applicationName

enum (ApplicationName)

イベントを取得するアプリケーションの名前。

クエリ パラメータ

パラメータ
actorIpAddress

string

イベントが実行されたホストのインターネット プロトコル（IP）アドレス。これは、アクティビティがレポートされるユーザーの IP アドレスを使用してレポートの概要をフィルタする別の方法です。この IP アドレスは、ユーザーの物理的な位置を反映している場合もあれば、反映していない場合もあります。たとえば、IP アドレスはユーザーのプロキシ サーバーのアドレスやバーチャル プライベート ネットワーク（VPN）のアドレスの場合があります。このパラメータは、IPv4 アドレス バージョンと IPv6 アドレス バージョンの両方をサポートします。
customerId

string

データを取得する顧客の一意の ID。
endTime

string

レポートに表示される期間の終了日を設定します。日付は RFC 3339 形式です（例: 2010-10-28T10:26:35.000Z）。デフォルト値は、API リクエストのおおよその時刻です。API レポートには、次の 3 つの基本的な時間コンセプトがあります。

  • API がレポートをリクエストした日付: API がレポートを作成して取得した日時。
  • レポートの開始時間: レポートに表示される期間の開始。startTime は、リクエストが行われた時点の endTime（指定されている場合）と現在時刻より前である必要があります。そうでない場合、API はエラーを返します。
  • レポートの終了時間: レポートに表示される期間の終了。たとえば、レポートにまとめられるイベントの期間は 4 月から 5 月までで、レポート自体は 8 月にリクエストできます。
endTime が指定されていない場合、レポートは startTime から現在までのすべてのアクティビティを返します。startTime が 180 日以上前の場合は、直近 180 日間のアクティビティを返します。

Gmail のリクエストの場合、startTime と endTime を指定する必要があります。また、その差が 30 日を超えてはなりません。
eventName

string

API によってクエリされるイベントの名前。各 eventName は、特定の Google Workspace サービスまたは機能に関連付けられており、API はこれをイベントのタイプに分類します。たとえば、管理コンソール アプリケーションのレポートに表示される Google カレンダーの予定などです。カレンダー設定の type 構造には、API によって報告されるカレンダーの eventName アクティビティがすべて含まれています。管理者がカレンダーの設定を変更すると、API はこのアクティビティをカレンダー設定の type パラメータと eventName パラメータで報告します。eventName クエリ文字列とパラメータの詳細については、上記の applicationName のさまざまなアプリケーションのイベント名のリストをご覧ください。
filters

string

filters クエリ文字列は、関係演算子によって操作されるイベント パラメータで構成されたカンマ区切りのリストです。イベント パラメータは {parameter1 name}{relational operator}{parameter1 value},{parameter2 name}{relational operator}{parameter2 value},... の形式です。

これらのイベント パラメータは特定の eventName に関連付けられています。リクエストのパラメータが eventName に属していない場合は、空のレポートが返されます。各アプリケーションで使用可能な eventName フィールドとその関連パラメータの詳細については、ApplicationName テーブルに移動し、目的のアプリケーションの付録にあるアクティビティ イベント ページをクリックしてください。

次のドライブ アクティビティの例では、doc_id パラメータ値が関係演算子で定義された条件と一致するすべての edit イベントで構成されるリストが返されます。最初の例では、リクエストは doc_id 値が 12345 に等しいすべての編集済みドキュメントを返します。2 番目の例では、レポートは doc_id 値が 98765 と等しくない編集済みドキュメントを返します。<> 演算子は、リクエストのクエリ文字列（%3C%3E）で URL エンコードされます。

GET...&eventName=edit&filters=doc_id==12345
GET...&eventName=edit&filters=doc_id%3C%3E98765

filters クエリは、次の関係演算子をサポートしています。

  • == - 「等しい」。
  • <> - 「等しくない」。URL エンコードされている必要があります（%3C%3E）。
  • < - 「未満」。URL エンコードされている必要があります（%3C）。
  • <= - 「以下」。URL エンコードされている必要があります（%3C=）。
  • > - 「より大きい」。URL エンコードされている必要があります（%3E）。
  • >= - 「以上」。URL エンコードされている必要があります（%3E=）。

注: API は、同じパラメータの複数の値を受け入れません。API リクエストでパラメータが複数回指定されている場合、API はそのパラメータの最後の値のみを受け入れます。また、API リクエストで無効なパラメータが指定された場合、API はそのパラメータを無視し、残りの有効なパラメータに対応するレスポンスを返します。パラメータがリクエストされていない場合は、すべてのパラメータが返されます。
maxResults

integer

各回答ページに表示するアクティビティ レコードの数を決定します。たとえば、リクエストで maxResults=1 が設定され、レポートに 2 つのアクティビティがある場合、レポートには 2 ページが含まれます。レスポンスの nextPageToken プロパティには、2 ページ目のトークンが含まれています。maxResults クエリ文字列はリクエストで省略可能です。デフォルト値は 1,000 です。
orgUnitID

string

レポートする組織部門の ID。アクティビティ レコードは、指定した組織部門に属するユーザーに対してのみ表示されます。
pageToken

string

次のページを指定するトークン。複数ページのレポートの場合、レスポンスに nextPageToken プロパティが含まれます。レポートの次のページを取得する後続のリクエストで、nextPageToken の値を pageToken クエリ文字列に入力します。
startTime

string

レポートに表示される期間の開始日を設定します。日付は RFC 3339 形式です（例: 2010-10-28T10:26:35.000Z）。レポートには、startTime から endTime までのすべてのアクティビティが返されます。startTime は、endTime（指定されている場合）とリクエストが行われた現在の時刻より前である必要があります。そうでない場合、API はエラーを返します。

Gmail のリクエストの場合、startTime と endTime を指定する必要があります。また、その差が 30 日を超えてはなりません。
groupIdFilter

string

ユーザー アクティビティをフィルタするグループ ID（難読化済み）をカンマ区切りで指定します。つまり、レスポンスには、ここに記載されているグループ ID の少なくとも 1 つに属するユーザーのアクティビティのみが含まれます。形式: 「id:abc123,id:xyz456」

をご覧ください。
resourceDetailsFilter

string

省略可。resourceDetailsFilter クエリ文字列は、関係演算子によって操作される リソースの詳細フィールドで構成された AND 区切りのリストです。

リソースの詳細フィルタは {resourceDetails.field1}{relational operator}{field1 value} AND {resourceDetails.field2}{relational operator}{field2 value}... の形式です。

次の例に示すように、すべての内部フィールドは . 演算子を使用してトラバースされます。

resourceDetails.id = "resourceId" AND resourceDetails.appliedLabels.id =
"appliedLabelId" AND resourceDetails.appliedLabels.fieldValue.id =
"fieldValueId"

resourceDetailsFilter クエリは、次の関係演算子をサポートしています。

  • = - 「等しい」。
  • != - 「等しくない」。
  • : - 「exists」。これは、繰り返しフィールドのフィルタリングに使用されます。

FieldValue タイプの繰り返しは、フィルタリングに exists 演算子を使用します。
次の FieldValue 型が繰り返されます。

たとえば、次のフィルタでは、SelectionListValue は繰り返しフィールドです。このフィルタは、SelectionListValue に selection_id が含まれているかどうかを確認します。

resourceDetails.id = "resourceId" AND resourceDetails.appliedLabels.id =
"appliedLabelId" AND resourceDetails.appliedLabels.fieldValue.id =
"fieldValueId" AND resourceDetails.appliedLabels.fieldValue.type =
"SELECTION_LIST_VALUE" AND
resourceDetails.appliedLabels.fieldValue.selectionListValue.id: "id"

使用方法

GET...&resourceDetailsFilter=resourceDetails.id = "resourceId" AND
resourceDetails.appliedLabels.id = "appliedLabelId"
GET...&resourceDetailsFilter=resourceDetails.id=%22resourceId%22%20AND%20resourceDetails.appliedLabels.id=%22appliedLabelId%22

次の点にご注意ください。

  • リクエストを送信する前に、クエリ文字列を URL エンコードする必要があります。

  • API では、AND 演算子で区切られた最大 5 つのフィールドがサポートされています。

  • より深いレベル（AppliedLabel、FieldValue など）でフィルタリングする場合は、階層内の前のレベルのすべての ID をフィルタに含める必要があります。たとえば、FieldValue でフィルタリングするには、AppliedLabel ID と resourceDetails ID が存在する必要があります。
    クエリの例:

    resourceDetails.id = "resourceId" AND resourceDetails.appliedLabels.id = "appliedLabelId" AND resourceDetails.appliedLabels.fieldValue.id = "fieldValueId"

  • longTextValue や textValue などの内部 FieldValue 型でフィルタリングするには、resourceDetails.appliedLabels.fieldValue.type が存在する必要があります。

  • 単一の AppliedLabel ID と FieldValue ID のフィルタリングのみがサポートされています。
networkInfoFilter

string

省略可。NetworkInfo メッセージに存在する regionCode フィールドでフィルタするために使用されます。

使用方法

GET...&networkInfoFilter=regionCode="IN"
GET...&networkInfoFilter=regionCode=%22IN%22
statusFilter

string

省略可。Status メッセージに存在する statusCode フィールドでフィルタするために使用されます。

使用方法

GET...&statusFilter=statusCode="200"
GET...&statusFilter=statusCode=%22200%22
applicationInfoFilter

string

省略可。ApplicationInfo メッセージに存在する oAuthClientId フィールドでフィルタするために使用されます。

使用方法

GET...&applicationInfoFilter=oAuthClientId="clientId"
GET...&applicationInfoFilter=oAuthClientId=%22clientId%22
includeSensitiveData

boolean

省略可。true に設定すると、このフィールドで、機密性の高いユーザー作成コンテンツを返された監査ログに含めることができます。このパラメータは、ルール（DLP）、Chat、Workspace Studio アプリケーションでのみサポートされています。他のアプリケーションで使用すると、権限エラーが発生します。
agentInfoFilter

string

省略可。アクティビティのエージェント情報フィールドのフィルタ。このフィルタは、他のフィルタと組み合わせて（AND）適用されます。例: 「agentInfoFilter=agentId="agent-id" AND agentName="agent-name" AND agentOwnerEmail="agent-owner-email"」
deviceFilter

string

省略可。deviceId、deviceType、deviceOsVersion など、UserDeviceInfo メッセージに存在するフィールドでフィルタリングするために使用されます。

使用方法

GET...&deviceFilter=deviceId="123"
GET...&deviceFilter=deviceType="ANDROID"
GET...&deviceFilter=deviceOsVersion="14.0"

リクエストの本文

リクエストの本文は空にする必要があります。

レスポンスの本文

アクティビティのコレクションの JSON テンプレート。

成功した場合、レスポンスの本文には次の構造のデータが含まれます。

JSON 表現 
{
  "kind": string,
  "etag": string,
  "items": [
    {
      object (Activity)
    }
  ],
  "nextPageToken": string
}
フィールド
kind

string

API リソースのタイプ。アクティビティ レポートの場合、値は reports#activities です。
etag

string

リソースの ETag。
items[]

object (Activity)

レスポンス内の各アクティビティ レコード。
nextPageToken

string

レポートの次のページを取得するためのトークン。nextPageToken 値は、リクエストの pageToken クエリ文字列で使用されます。

認可スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/admin.reports.audit.readonly

詳しくは、承認ガイドをご覧ください。

ApplicationName

列挙型
access_transparency

Google Workspace のアクセスの透明性アクティビティ レポートは、さまざまなタイプのアクセスの透明性アクティビティ イベントに関する情報を返します。
admin

管理コンソール アプリケーションのアクティビティ レポートには、さまざまな種類の管理者アクティビティ イベントに関するアカウント情報が返されます。
calendar

Google カレンダー アプリケーションのアクティビティ レポートは、さまざまなカレンダー アクティビティ イベントに関する情報を返します。
chat Chat アクティビティ レポートは、さまざまな Chat アクティビティ イベントに関する情報を返します。
drive

Google ドライブ アプリケーションのアクティビティ レポートは、さまざまな Google ドライブ アクティビティ イベントに関する情報を返します。ドライブ アクティビティ レポートは、Google Workspace Business および Enterprise をご利用のお客様のみが対象です。
gcp Google Cloud Platform アプリケーションのアクティビティ レポートは、さまざまな GCP アクティビティ イベントに関する情報を返します。
gmail Gmail アプリケーションのアクティビティ レポートは、さまざまな Gmail アクティビティ イベントに関する情報を返します。
gplus Google+ アプリケーションのアクティビティ レポートは、さまざまな Google+ アクティビティ イベントに関する情報を返します。
groups

Google グループ アプリケーションのアクティビティ レポートは、さまざまなグループ アクティビティ イベントに関する情報を返します。
groups_enterprise

Enterprise グループ アクティビティ レポートは、さまざまなエンタープライズ グループ アクティビティ イベントに関する情報を返します。
jamboard Jamboard アクティビティ レポートは、さまざまな Jamboard アクティビティ イベントに関する情報を返します。
login

ログイン アプリケーションのアクティビティ レポートは、さまざまなタイプのログイン アクティビティ イベントに関するアカウント情報を返します。
meet Meet 監査アクティビティ レポートには、さまざまなタイプの Meet 監査アクティビティ イベントに関する情報が返されます。
mobile デバイス監査アクティビティ レポートには、さまざまなタイプのデバイス監査アクティビティ イベントに関する情報が返されます。
rules

ルール アクティビティ レポートは、さまざまな種類のルール アクティビティ イベントに関する情報を返します。
saml

SAML アクティビティ レポートは、さまざまなタイプの SAML アクティビティ イベントに関する情報を返します。
token

トークン アプリケーションのアクティビティ レポートは、さまざまなタイプのトークン アクティビティ イベントに関するアカウント情報を返します。
user_accounts

ユーザー アカウント アプリケーションのアクティビティ レポートは、さまざまなタイプのユーザー アカウント アクティビティ イベントに関するアカウント情報を返します。
context_aware_access

コンテキストアウェア アクセス アクティビティ レポートは、 コンテキストアウェア アクセス ルールによりユーザーのアクセスが拒否されたイベントに関する情報を返します。
chrome

Chrome アクティビティ レポートには、 Chrome ブラウザと Chrome OS のイベントに関する情報が返されます。
data_studio データポータルのアクティビティ レポートは、さまざまなタイプのデータポータル アクティビティ イベントに関する情報を返します。
keep Keep アプリのアクティビティ レポートは、さまざまな Google Keep アクティビティ イベントに関する情報を返します。Keep アクティビティ レポートは、Google Workspace Business および Enterprise をご利用のお客様のみが対象です。
vault Vault アクティビティ レポートには、さまざまなタイプの Vault アクティビティ イベントに関する情報が返されます。
gemini_in_workspace_apps

Gemini for Workspace アクティビティ レポートは、Workspace アプリケーション内でユーザーが実行したさまざまなタイプの Gemini アクティビティ イベントに関する情報を返します。
classroom Classroom アクティビティ レポートは、さまざまなタイプの Classroom アクティビティ イベントに関する情報を返します。
assignments 課題アプリケーションのアクティビティ レポートは、さまざまな種類の課題アクティビティ イベントに関する情報を返します。
tasks Tasks アプリケーションのアクティビティ レポートは、さまざまな種類の Tasks アクティビティ イベントに関する情報を返します。
data_migration データ移行アプリケーションのアクティビティ レポートは、さまざまなタイプのデータ移行アクティビティ イベントに関する情報を返します。
meet_hardware Meet ハードウェア アプリケーションのアクティビティ レポートは、さまざまなタイプの Meet ハードウェア アクティビティ イベントに関する情報を返します。
directory_sync Directory Sync アプリケーションのアクティビティ レポートには、さまざまなタイプの Directory Sync アクティビティ イベントに関する情報が返されます。
ldap ldap アプリケーションのアクティビティ レポートは、さまざまなタイプの ldap アクティビティ イベントに関する情報を返します。
profile プロフィール アプリケーションのアクティビティ レポートは、さまざまなタイプのプロフィール アクティビティ イベントに関する情報を返します。
access_evaluation アクセス評価アクティビティ レポートは、さまざまなタイプのアクセス評価アクティビティ イベントに関する情報を返します。
admin_data_action 管理データの操作アプリケーションのアクティビティ レポートには、さまざまなタイプの管理データの操作アクティビティ イベントに関する情報が返されます。
contacts 連絡先アプリのアクティビティ レポートは、さまざまなタイプの連絡先アクティビティ イベントに関する情報を返します。
takeout データ エクスポート アプリケーションのアクティビティ レポートは、さまざまな種類のデータ エクスポート アクティビティ イベントに関する情報を返します。
graduation 卒業アプリケーションのアクティビティ レポートは、さまざまなタイプの卒業アクティビティ イベントに関する情報を返します。
voice Voice アプリケーションのアクティビティ レポートは、さまざまなタイプの Voice アクティビティ イベントに関する情報を返します。
chrome_sync Chrome 同期アプリのアクティビティ レポートは、さまざまな種類の Chrome 同期アクティビティ イベントに関する情報を返します。
workspace_studio Workspace Studio アプリケーションのアクティビティ レポートは、さまざまな種類の Workspace Studio アクティビティ イベントに関する情報を返します。
gemini_notebook Gemini Notebook アプリケーションのアクティビティ レポートは、さまざまなタイプの Gemini Notebook アクティビティ イベントに関する情報を返します。

アクティビティ

アクティビティ リソースの JSON テンプレート。

JSON 表現 
{
  "kind": string,
  "etag": string,
  "ownerDomain": string,
  "ipAddress": string,
  "events": [
    {
      "type": string,
      "name": string,
      "parameters": [
        {
          "messageValue": {
            "parameter": [
              {
                object (NestedParameter)
              }
            ]
          },
          "name": string,
          "value": string,
          "multiValue": [
            string
          ],
          "intValue": string,
          "multiIntValue": [
            string
          ],
          "boolValue": boolean,
          "multiMessageValue": [
            {
              "parameter": [
                {
                  object (NestedParameter)
                }
              ]
            }
          ]
        }
      ],
      "sensitiveParameters": [
        {
          "messageValue": {
            "parameter": [
              {
                object (NestedParameter)
              }
            ]
          },
          "name": string,
          "value": string,
          "multiValue": [
            string
          ],
          "intValue": string,
          "multiIntValue": [
            string
          ],
          "boolValue": boolean,
          "multiMessageValue": [
            {
              "parameter": [
                {
                  object (NestedParameter)
                }
              ]
            }
          ]
        }
      ],
      "resourceIds": [
        string
      ],
      "status": {
        object (Status)
      }
    }
  ],
  "id": {
    "time": string,
    "uniqueQualifier": string,
    "applicationName": string,
    "customerId": string
  },
  "actor": {
    "profileId": string,
    "email": string,
    "callerType": string,
    "key": string,
    "applicationInfo": {
      "oauthClientId": string,
      "applicationName": string,
      "impersonation": boolean
    },
    "agentAttributionInfo": {
      object (AgentAttributionInfo)
    }
  },
  "networkInfo": {
    object (NetworkInfo)
  },
  "resourceDetails": [
    {
      object (ResourceDetails)
    }
  ],
  "isAgenticAction": boolean,
  "userDeviceInfo": {
    object (UserDeviceInfo)
  }
}
フィールド
kind

string

API リソースのタイプ。アクティビティ レポートの場合、値は audit#activity です。
etag

string

エントリの ETag。
ownerDomain

string

これは、レポートのイベントの影響を受けるドメインです。たとえば、管理コンソールのドメインや、ドライブ アプリケーションのドキュメントのオーナーなどです。
ipAddress

string

操作を行ったユーザーの IP アドレス。これは、Google Workspace にログインしたときのユーザーのインターネット プロトコル（IP）アドレスです。ユーザーの物理的な場所を反映している場合もあれば、反映していない場合もあります。たとえば、IP アドレスはユーザーのプロキシ サーバーのアドレスやバーチャル プライベート ネットワーク（VPN）のアドレスの場合があります。この API は IPv4 と IPv6 をサポートしています。
events[]

object

レポート内のアクティビティ イベント。
events[].type

string

イベントの種類。管理者が変更する Google Workspace のサービスまたは機能は、eventName プロパティを使用してイベントを識別する type プロパティで識別されます。API の type カテゴリの完全なリストについては、上記の applicationName のさまざまなアプリケーションのイベント名の一覧をご覧ください。
events[].name

string

イベントの名前。これは、API によって報告されたアクティビティの具体的な名前です。各 eventName は、API がイベントのタイプに分類する特定の Google Workspace サービスまたは機能に関連付けられています。
一般的な eventName リクエスト パラメータの場合:

  • eventName が指定されていない場合、レポートは eventName の可能なすべてのインスタンスを返します。
  • eventName をリクエストすると、API のレスポンスで、その eventName を含むすべてのアクティビティが返されます。

eventName プロパティの詳細については、上記の applicationName のさまざまなアプリケーションのイベント名の一覧をご覧ください。
events[].parameters[]

object

さまざまなアプリケーションのパラメータ値のペア。eventName パラメータの詳細については、上記の applicationName のさまざまなアプリのイベント名の一覧をご覧ください。
events[].parameters[].messageValue

object

このパラメータに関連付けられたネストされたパラメータ値のペア。パラメータの複合値の型は、パラメータ値のリストとして返されます。たとえば、アドレス パラメータの値は [{parameter: [{name: city, value: abc}]}] になります。
events[].parameters[].messageValue.parameter[]

object (NestedParameter)

パラメータの値
events[].parameters[].name

string

パラメータの名前。
events[].parameters[].value

string

パラメータの文字列値。
events[].parameters[].multiValue[]

string

パラメータの文字列値。
events[].parameters[].intValue

string (int64 format)

パラメータの整数値。
events[].parameters[].multiIntValue[]

string (int64 format)

パラメータの整数値。
events[].parameters[].boolValue

boolean

パラメータのブール値。
events[].parameters[].multiMessageValue[]

object

activities.list の messageValue オブジェクト。
events[].parameters[].multiMessageValue[].parameter[]

object (NestedParameter)

パラメータの値
events[].sensitiveParameters[]

object

さまざまなアプリケーションの機密性の高いパラメータ値のペアが含まれます。
events[].sensitiveParameters[].messageValue

object

このパラメータに関連付けられたネストされたパラメータ値のペア。パラメータの複合値の型は、パラメータ値のリストとして返されます。たとえば、アドレス パラメータの値は [{parameter: [{name: city, value: abc}]}] になります。
events[].sensitiveParameters[].messageValue.parameter[]

object (NestedParameter)

パラメータの値
events[].sensitiveParameters[].name

string

パラメータの名前。
events[].sensitiveParameters[].value

string

パラメータの文字列値。
events[].sensitiveParameters[].multiValue[]

string

パラメータの文字列値。
events[].sensitiveParameters[].intValue

string (int64 format)

パラメータの整数値。
events[].sensitiveParameters[].multiIntValue[]

string (int64 format)

パラメータの整数値。
events[].sensitiveParameters[].boolValue

boolean

パラメータのブール値。
events[].sensitiveParameters[].multiMessageValue[]

object

activities.list の messageValue オブジェクト。
events[].sensitiveParameters[].multiMessageValue[].parameter[]

object (NestedParameter)

パラメータの値
events[].resourceIds[]

string

イベントに関連付けられたリソース ID。
events[].status

object (Status)

イベントのステータス。注: すべてのイベントにステータスがあるわけではありません。
id

object

各アクティビティ レコードの一意の識別子。
id.time

string

アクティビティの発生時刻。これは、UNIX エポック時間（秒単位）です。
id.uniqueQualifier

string (int64 format)

複数のイベントが同じ時間の場合の一意の修飾子。
id.applicationName

string

イベントが属するアプリケーションの名前。有効な値については、上記の applicationName のアプリケーションのリストをご覧ください。
id.customerId

string

Google Workspace アカウントの一意の識別子。
actor

object

アクションを実行しているユーザー。
actor.profileId

string

アクターの固有の Google Workspace プロファイル ID。アクターが Google Workspace ユーザーでない場合、この値は存在しない可能性があります。また、プレースホルダ ID として機能する数値 105250506097979753968 が指定されている場合もあります。
actor.email

string

アクターのメインのメールアドレス。アクターに関連付けられたメールアドレスがない場合は、存在しない可能性があります。
actor.callerType

string

アクターのタイプ。
actor.key

string

callerType が KEY の場合にのみ存在します。OAuth 2LO API リクエストのリクエスト元の consumer_key、またはロボット アカウントの識別子を指定できます。
actor.applicationInfo

object

アクティビティのアクターであったアプリケーションの詳細。
actor.applicationInfo.oauthClientId

string

アクションの実行に使用されたサードパーティ アプリケーションの OAuth クライアント ID。
actor.applicationInfo.applicationName

string

アクションの実行に使用されたアプリケーションの名前。
actor.applicationInfo.impersonation

boolean

アプリがユーザーになりすましていたかどうか。
actor.agentAttributionInfo

object (AgentAttributionInfo)

アクティビティのアクターであった AI エージェントの詳細。
networkInfo

object (NetworkInfo)

操作を行ったユーザーのネットワーク情報。
resourceDetails[]

object (ResourceDetails)

アクションが実行されたリソースの詳細。
isAgenticAction

boolean

アクティビティがエージェントによって実行されたかどうか。
userDeviceInfo

object (UserDeviceInfo)

操作を行ったユーザーのデバイスの詳細。このフィールドは、contacts、gemini_in_workspace_apps、keep、meet_hardware、meet、chat、chrome、directory_sync、drive、groups、rules、data_studio、saml アプリケーションでのみ公開されます。

NetworkInfo

操作を行ったユーザーのネットワーク情報。

JSON 表現 
{
  "ipAsn": [
    integer
  ],
  "regionCode": string,
  "subdivisionCode": string
}
フィールド
ipAsn[]

integer

操作を行ったユーザーの IP アドレス。
regionCode

string

アクションを実行しているユーザーの地域コード（ISO 3166-1 alpha-2 形式）。
subdivisionCode

string

アクションを実行しているユーザーの国の ISO 3166-2 地域コード（州と県）。

ResourceDetails

アクションが実行されたリソースの詳細。

JSON 表現 
{
  "id": string,
  "title": string,
  "type": string,
  "appliedLabels": [
    {
      object (AppliedLabel)
    }
  ],
  "relation": string,
  "ownerDetails": {
    object (OwnerDetails)
  }
}
フィールド
id

string

リソースの識別子（Google ドライブ ドキュメントの doc_id、Google Meet 会議の conference_id、メールの gaia_id/rfc2822_message_id など）。
title

string

リソースのタイトル。たとえば、ドライブ ドキュメントの場合、これはドキュメントのタイトルになります。メールの場合、これは件名になります。
type

string

リソースのタイプ - ドキュメント、メール、チャット メッセージ
appliedLabels[]

object (AppliedLabel)

リソースに適用されたラベルの activities.list
relation

string

リソースとイベントの関係を定義します
ownerDetails

object (OwnerDetails)

リソースのオーナーの詳細。

AppliedLabel

リソースに適用されたラベルの詳細。

JSON 表現 
{
  "id": string,
  "title": string,
  "fieldValues": [
    {
      object (FieldValue)
    }
  ],
  "reason": {
    object (Reason)
  }
}
フィールド
id

string

ラベルの識別子 - OnePlatform リソースの完全な名前ではなく、ラベル ID のみ。
title

string

ラベルのタイトル
fieldValues[]

object (FieldValue)

activities.list: ラベルの一部であり、ユーザーによって設定されたフィールドのリスト。ユーザーが設定していないフィールドがラベルに含まれている場合、そのラベルはこのリストに表示されません。
reason

object (Reason)

ラベルがリソースに適用された理由。

FieldValue

特定のラベルに対してユーザーが設定したフィールド値の詳細。

JSON 表現 
{
  "id": string,
  "displayName": string,
  "type": string,
  "reason": {
    object (Reason)
  },

  "unsetValue": boolean,
  "longTextValue": string,
  "textValue": string,
  "textListValue": {
    object (TextListValue)
  },
  "selectionValue": {
    object (SelectionValue)
  },
  "selectionListValue": {
    object (SelectionListValue)
  },
  "integerValue": string,
  "userValue": {
    object (UserValue)
  },
  "userListValue": {
    object (UserListValue)
  },
  "dateValue": {
    object (Date)
  }
}
フィールド
id

string

フィールドの識別子
displayName

string

フィールドの表示名
type

string

フィールドのタイプ
reason

object (Reason)

フィールドがラベルに適用された理由。
共用体フィールド value。フィールド value に格納される値は、次のいずれか 1 つのみです。
unsetValue

boolean

フィールドが設定されていない場合、これは true になります。
longTextValue

string

長いテキスト値を設定する。
textValue

string

テキスト値を設定します。
textListValue

object (TextListValue)

テキスト リストの値を設定します。
selectionValue

object (SelectionValue)

プルダウンから単一の値を選択して選択値を設定します。
selectionListValue

object (SelectionListValue)

プルダウンから複数の値を選択して選択リストの値を設定する。
integerValue

string (int64 format)

整数値を設定します。
userValue

object (UserValue)

単一のユーザーを選択してユーザー値を設定する。
userListValue

object (UserListValue)

複数のユーザーを選択してユーザーリストの値を設定する。
dateValue

object (Date)

日付値を設定します。

TextListValue

テキスト リストの値を設定します。

JSON 表現 
{
  "values": [
    string
  ]
}
フィールド
values[]

string

アクティビティのテキスト値のリスト。

SelectionValue

プルダウンから単一の値を選択して選択値を設定します。

JSON 表現 
{
  "id": string,
  "displayName": string,
  "badged": boolean
}
フィールド
id

string

選択の識別子。
displayName

string

選択の表示名。
badged

boolean

選択肢にバッジが付いているかどうか。

SelectionListValue

プルダウンから複数の値を選択して選択リストの値を設定する。

JSON 表現 
{
  "values": [
    {
      object (SelectionValue)
    }
  ]
}
フィールド
values[]

object (SelectionValue)

activities.list の選択。

UserValue

単一のユーザーを選択してユーザー値を設定する。

JSON 表現 
{
  "email": string
}
フィールド
email

string

ユーザーのメールアドレス。

UserListValue

複数のユーザーを選択してユーザーリストの値を設定する。

JSON 表現 
{
  "values": [
    {
      object (UserValue)
    }
  ]
}
フィールド
values[]

object (UserValue)

activities.list of users.

日付

誕生日などのように、カレンダーの日付全体またはその一部を表します。時間帯とタイムゾーンは、他の場所で指定されているか、重要ではありません。日付は西暦を基準にしており、これは次のいずれかを表します。

  • 年の値がゼロ以外である月と日の値を含む完全な日付
  • 年の値がゼロである月と日（記念日など）。
  • 月と日の値がゼロである単独の年。
  • 日の値がゼロである年と月（クレジット カードの有効期限など）

関連するタイプ:

JSON 表現 
{
  "year": integer,
  "month": integer,
  "day": integer
}
フィールド
year

integer

その日付の年。1～9999、または年のない日付を指定する場合は 0 にする必要があります。
month

integer

1 年の中の月。1～12、または月と日のない年を指定する場合は 0 にする必要があります。
day

integer

1 月の中の日付。1～31 で、その年と月で有効な値にする必要があります。または、日が重要でない場合は年のみか年と月を指定するには 0 にする必要があります。

理由

ラベル/フィールドが適用された理由。

JSON 表現 
{
  "reasonType": string
}
フィールド
reasonType

string

理由のタイプ。

OwnerDetails

リソースの所有者の詳細。

JSON 表現 
{
  "ownerType": string,
  "ownerIdentity": [
    {
      object (OwnerIdentity)
    }
  ]
}
フィールド
ownerType

string

リソースのオーナーのタイプ。
ownerIdentity[]

object (OwnerIdentity)

リソースのオーナーの ID の詳細。

OwnerIdentity

リソースの所有者の ID の詳細。

JSON 表現 
{

  "customerIdentity": {
    object (CustomerIdentity)
  },
  "userIdentity": {
    object (UserIdentity)
  },
  "groupIdentity": {
    object (GroupIdentity)
  },
  "sharedDriveIdentity": {
    object (SharedDriveIdentity)
  }
}
フィールド
共用体フィールド identity。これは oneof フィールドであり、次のフィールドのいずれか 1 つのみを設定できます。identity は次のいずれかになります。
customerIdentity

object (CustomerIdentity)

リソースを所有する Google Workspace ユーザーの ID。
userIdentity

object (UserIdentity)

リソースを所有するユーザーの ID。
groupIdentity

object (GroupIdentity)

リソースを所有するグループの ID。
sharedDriveIdentity

object (SharedDriveIdentity)

リソースを所有する共有ドライブの ID。

CustomerIdentity

リソースを所有する Google Workspace ユーザーの ID。

JSON 表現 
{
  "id": string
}
フィールド
id

string

お客様 ID。

UserIdentity

リソースを所有するユーザーの ID。

JSON 表現 
{
  "id": string,
  "userEmail": string
}
フィールド
id

string

ユーザーの GAIA ID。
userEmail

string

ユーザーのメールアドレス。

GroupIdentity

リソースを所有するグループの ID。

JSON 表現 
{
  "id": string,
  "groupEmail": string
}
フィールド
id

string

グループの GAIA ID。
groupEmail

string

グループのメールアドレス。

SharedDriveIdentity

リソースを所有する共有ドライブの ID。

JSON 表現 
{
  "id": string,
  "sharedDriveName": string
}
フィールド
id

string

共有ドライブの GAIA ID。
sharedDriveName

string

共有ドライブ名。

UserDeviceInfo

操作を行ったユーザーのデバイスの詳細。

JSON 表現 
{
  "deviceId": string,
  "deviceType": string,
  "deviceOsVersion": string
}
フィールド
deviceId

string

出力専用。ユーザーのデバイスのデバイス ID。
deviceType

string

出力専用。ユーザーのデバイスの種類。
deviceOsVersion

string

出力専用。ユーザーのデバイスのデバイス OS バージョン。