Google Workspace コネクタ リファレンス

備考

ベータ版

この機能はベータ版です。ワークスペース管理者は、 プレビュー ページからこの機能へのアクセスを制御できます。Databricksのプレビューを管理するを参照してください。

このページには、管理対象の Google Workspace コネクタに関する参考情報（サポートされているソーステーブルやその宛先スキーマなど）が含まれています。

サポートされているソーステーブル

Google ワークスペース コネクタは、default ソース スキーマの下で、Google ワークスペース アクティビティ アプリケーションごとに 1 つずつ、計 33 のソース テーブルをサポートしています。各テーブルは増分取り込みをサポートしています。コネクタは、増分取り込みのカーソル フィールドとして time フィールドを使用します。

サポートされているテーブルは次のとおりです。

• access_evaluation
• access_transparency
• admin
• assignments
• calendar
• chat
• chrome
• classroom
• cloud_search
• contacts
• context_aware_access
• data_migration
• data_studio
• directory_sync
• gcp
• gemini_in_workspace_apps
• graduation
• groups
• groups_enterprise
• keep
• ldap
• login
• meet
• meet_hardware
• mobile
• profile
• rules
• saml
• takeout
• tasks
• token
• user_accounts
• vault

各テーブルには、Google Workspace Admin SDK Reports API のアクティビティ レコードが含まれています。すべてのテーブルが同じスキーマを共有し、time をカーソル フィールドとして増分取り込みをサポートしています。

ソーステーブル	プライマリーキー	説明	同期モード	Cursor フィールド
上記の33個のアプリケーションすべて	lw_id	さまざまなアプリケーションに対する Admin SDK Reports API からの Google Workspace アクティビティ イベント。	インクリメンタル	time

ソーステーブル	プライマリーキー	説明	同期モード	Cursor フィールド
上記の33個のアプリケーションすべて	lw_id	さまざまなアプリケーションに対する Admin SDK Reports API からの Google Workspace アクティビティ イベント。	インクリメンタル	time

注記

gmail および drive アプリケーションは上記のリストに含まれていません。これらのソースを取り込むには、専用の Gmail コネクタおよび Google Drive コネクタを使用します。

注記

Databricks UI の取り込みウィザードでは、ソーステーブルセレクターにこれらのテーブルのうち 30 個が表示されます。login、groups、または groups_enterprise を取り込むには、API ベースのパイプライン オーサリングまたは Declarative Automation Bundles を使用します。

コネクターオプション

Google ワークスペース コネクタは、すべてのマネージド コネクタで使用できるパイプライン設定に加えて、次の構成オプションをサポートしています。

• start_datetime （オプション）：ISO 8601 形式でのバックフィル開始日（例：2024-01-01T00:00:00Z）。設定されていない場合、コネクタのデフォルトでは最初の同期の 180 日前になります。Google ワークスペース コネクタの制限を参照してください。

宛先テーブルのスキーマ

33個のアプリケーションテーブルすべてが次のスキーマを共有しており、これは Google Workspace Admin SDK Reports API アクティビティエンベロープから派生しています。

主キー： lw_id カーソルフィールド： time

フィールド	データ型
lw_id	STRING
time	TIMESTAMP
kind	STRING
etag	STRING
id	STRUCT<time: STRING, uniqueQualifier: STRING, applicationName: STRING, customerId: STRING>
actor	STRUCT<profileId: STRING, email: STRING, callerType: STRING, key: STRING, applicationInfo: STRUCT<oauthClientId: STRING, applicationName: STRING, impersonation: BOOLEAN>>
ownerDomain	STRING
ipAddress	STRING
isAgenticAction	BOOLEAN
networkInfo	STRUCT<ipAsn: ARRAY<INT>, regionCode: STRING, subdivisionCode: STRING>
events	ARRAY<STRUCT<type: STRING, name: STRING, status: STRING, resourceIds: ARRAY<STRING>, parameters: ARRAY<STRUCT<name: STRING, value: STRING, intValue: STRING, boolValue: BOOLEAN, multiValue: ARRAY<STRING>, multiIntValue: ARRAY<STRING>, messageValue: VARIANT, multiMessageValue: VARIANT>>>>
userDeviceInfo	VARIANT
resourceDetails	VARIANT

フィールド	データ型
lw_id	STRING
time	TIMESTAMP
kind	STRING
etag	STRING
id	STRUCT<time: STRING, uniqueQualifier: STRING, applicationName: STRING, customerId: STRING>
actor	STRUCT<profileId: STRING, email: STRING, callerType: STRING, key: STRING, applicationInfo: STRUCT<oauthClientId: STRING, applicationName: STRING, impersonation: BOOLEAN>>
ownerDomain	STRING
ipAddress	STRING
isAgenticAction	BOOLEAN
networkInfo	STRUCT<ipAsn: ARRAY<INT>, regionCode: STRING, subdivisionCode: STRING>
events	ARRAY<STRUCT<type: STRING, name: STRING, status: STRING, resourceIds: ARRAY<STRING>, parameters: ARRAY<STRUCT<name: STRING, value: STRING, intValue: STRING, boolValue: BOOLEAN, multiValue: ARRAY<STRING>, multiIntValue: ARRAY<STRING>, messageValue: VARIANT, multiMessageValue: VARIANT>>>>
userDeviceInfo	VARIANT
resourceDetails	VARIANT

注記

これらのテーブルは VARIANT 列を持つため、SCD タイプ 2 をサポートしていません。

増分取り込み

各テーブルは、time フィールドをカーソルとして使用してインクリメンタルに取り込まれます。start_datetime が設定されていない場合、コネクタは過去 180 日間のバックフィルを実行します。Google ワークスペース Admin SDK Reports API はアクティビティ Logs を最大 180 日間保持するため、コネクタはその期間より古いイベントを取り込むことができません。アプリケーションによって報告される遅延ウィンドウが異なるため、コネクタはアプリケーションごとのルックバックを適用してこの遅延を吸収します。Google Workspace コネクタの制限事項を参照してください。