API で利用可能な設定

このドキュメントでは、Policy API でサポートされている設定について説明します。

サポートされている設定が Cloud Identity Policy API レスポンスにない場合は、デフォルトのフィールド値をご覧ください。不足している設定がデフォルトのフィールド値に記載されていない場合は、Cloud カスタマーケアにお問い合わせください。

API の制御

管理コンソールのページ 管理コンソールの特定の設定 Policy API の設定タイプ 変更に対応 管理コンソールのキャプション Policy API のフィールド名 データ型
API の制御 [設定] > [カスタム ユーザー メッセージ] api_controls.custom_user_message × アクセス設定が原因でアプリにアクセスできない場合にユーザーに表示するメッセージをカスタマイズします。 error_text 文字列
[設定] > [未設定のサードパーティ製アプリ] api_controls.unconfigured_third_party_apps × 未設定のサードパーティ製アプリとは、アクセス設定(信頼されている、制限付き、ブロック中など)が行われていないアプリです。
ユーザーが自身のアカウントを使用して未設定のサードパーティ製アプリにアクセスしようとした場合の対応を選択してください。
access_level 列挙型:
  • ACCESS_LEVEL_UNSPECIFIED
  • BLOCK_ALL
  • ALLOW_SIGN_IN_ONLY
[設定] > [未設定のサードパーティ製アプリ] api_controls.unconfigured_third_party_apps × 未設定のサードパーティ製アプリとは、アクセス設定(信頼されている、制限付き、ブロック中など)が行われていないアプリです。
18 歳未満のユーザーが自身のアカウントを使用して未設定のサードパーティ製アプリにアクセスしようとした場合の対応を選択します。
access_level_under18 列挙型:
  • ACCESS_LEVEL_UNSPECIFIED
  • ALLOW_SIGN_IN_ONLY
[設定] > [内部アプリ] api_controls.internal_apps × 組織で所有している内部アプリには、自動的に [信頼できる] のアクセスが設定されます。これらのアプリは、ユーザーのあらゆる Google データへの API アクセスをリクエストできます。 trust_internal_apps ブール値
[設定] > [未設定のアプリへのアクセスに対するユーザー リクエスト] api_controls.app_approval_requests × ユーザーに未設定のサードパーティ製アプリへのアクセスのリクエストを許可する allowed_for_all 列挙型:
  • OPTION_UNSPECIFIED
  • ENABLED
  • DISABLED
[アプリのアクセス制御] > [Google サービスを管理] > [Google サービス] api_controls.google_services × Google サービス API のアクセス設定を選択して、これらのサービスへのアクセスをリクエストできるサードパーティ製アプリの種類を管理します。 サービス Service[]

API の制御のサブ設定

次の表に、他の API コントロール設定で参照される API コントロールのサブ設定を示します。

Policy API のサブ設定名 管理コンソールのキャプション Policy API のフィールド名 データ型
サービス アクセス scopes_group 列挙型:
  • UNSPECIFIED
  • DRIVE_ALL
  • DRIVE_HIGH_RISK
  • GMAIL_ALL
  • GMAIL_HIGH_RISK
  • CALENDAR_ALL
  • CONTACTS_ALL
  • GSUITE_ADMIN_ALL
  • VAULT_ALL
  • CLOUD_PLATFORM
  • CLOUD_BILLING
  • CLOUD_ML
  • APPS_SCRIPT_RUNTIME
  • APPS_SCRIPT_API
  • CLASSROOM_ALL
  • CLASSROOM_HIGH_RISK
  • COMMUNICATIONS
  • TASKS
  • GROUPS
  • KEEP
  • CLOUD_SEARCH
  • CHAT
  • SIGN_IN
  • CHAT_HIGH_RISK
  • MEET
制限付き / 制限なし is_enabled ブール値

カレンダーの設定

管理コンソールのページ 管理コンソールの特定の設定 Policy API の設定タイプ 変更に対応 管理コンソールのキャプション Policy API のフィールド名 データ型
カレンダー [詳細設定] > [支払いを伴う予約スケジュール] calendar.appointment_schedules × 所有する決済機関のアカウントを使用した予約済みの時間枠に対する支払い要求を、予約スケジュールのユーザーに対して許可します。 enable_payments ブール値
[共有設定] > [外部の招待] calendar.external_invitations × ドメイン ORGANIZATION_UNIT_NAME 外のゲストを招待するときに警告を表示する warn_on_invite ブール値
[カレンダーの相互運用管理] > [カレンダーでの Exchange の空き情報] calendar.interoperability × Google カレンダーに Exchange ユーザーの空き情報の表示を許可する enable_interoperability ブール値
予定の詳細を表示する enable_full_event_details ブール値
[カレンダーの相互運用管理] > [Exchange リソースの予約] calendar.interoperability × Google カレンダーで Microsoft Exchange の会議室を予約できるようにする enable_exchange_room_booking ブール値
[共有設定] > [メイン カレンダーの外部共有オプション] calendar.primary_calendar_max_allowed_external_sharing × ORGANIZATION_UNIT_NAME 外 - メイン カレンダーに対するユーザー機能の設定 max_allowed_external_sharing 列挙型:
  • EXTERNAL_FREE_BUSY_ONLY
  • EXTERNAL_ALL_INFO_READ_ONLY
  • EXTERNAL_ALL_INFO_READ_WRITE
  • EXTERNAL_ALL_INFO_READ_WRITE_MANAGE
[共有設定] > [予備カレンダーの外部共有オプション] calendar.secondary_calendar_max_allowed_external_sharing × <組織名> 外 - 予備カレンダーに対するユーザー機能の設定 max_allowed_external_sharing 列挙型:
  • EXTERNAL_FREE_BUSY_ONLY
  • EXTERNAL_ALL_INFO_READ_ONLY
  • EXTERNAL_ALL_INFO_READ_WRITE
  • EXTERNAL_ALL_INFO_READ_WRITE_MANAGE

チャットの設定

管理コンソールのページ 管理コンソールの特定の設定 Policy API の設定タイプ 変更に対応 管理コンソールのキャプション Policy API のフィールド名 データ型
Google Chat チャットの履歴 chat.chat_history × 履歴がオン / オフになっています history_on_by_default ブール値
ユーザーに履歴設定の変更を許可する allow_user_modification ブール値
チャット内でのファイル共有 chat.chat_file_sharing × 外部とのファイル共有 external_file_sharing 列挙型:
  • ALL_FILES
  • IMAGES_ONLY
  • NO_FILES
  • FILE_SHARING_OPTION_UNSPECIFIED
internal_file_sharing 同じ
スペースの履歴 chat.space_history × スペースの会話履歴の設定 history_state 列挙型:
  • DEFAULT_HISTORY_ON
  • DEFAULT_HISTORY_OFF
  • HISTORY_ALWAYS_ON
  • HISTORY_ALWAYS_OFF
  • HISTORY_STATE_UNSPECIFIED
外部チャットの設定 chat.external_chat_restriction × ユーザーがチャットとスペースで組織外にメッセージを送信できるようにする allow_external_chat ブール値
external_chat_restriction 列挙型:
  • NO_RESTRICTION
  • TRUSTED_DOMAINS
  • RESTRICTION_UNSPECIFIED
Chat 用アプリ chat.chat_apps_access × ユーザーに Chat 用アプリのインストールを許可する enable_apps ブール値
ユーザーに着信 Webhook の追加と使用を許可する enable_webhooks ブール値
サードパーティによるアーカイブ chat.third_party_archiving × サードパーティによるアーカイブを有効にする 有効 ブール値
Chat コンテンツのアーカイブ先のメールアドレスを指定します。 destination_email_address 文字列
Chat のアーカイブ メッセージを送信する頻度を指定します(1 ~ 24 時間) archival_frequency 所要時間
アーカイブ先のアドレスで必要なカスタム ヘッダーのカンマ区切りのリスト custom_headers 文字列
外部スペース chat.external_spaces × ユーザーに、組織外のユーザーを追加できるスペースを作成したり、それらに参加したりすることを許可する 有効 ブール値
許可リスト登録済みドメインからのみユーザーの追加を許可する domain_allowlist_mode enum:
  • DOMAIN_ALLOWLIST_MODE_UNSPECIFIED
  • TRUSTED_DOMAINS
  • ALL_DOMAINS
[共有設定] > [スペースへのデフォルト アクセス] chat.space_access_default × ユーザーが新しいスペースを作成したときのデフォルトのスペース アクセス。 access_type enum:
  • ACCESS_TYPE_UNSPECIFIED
  • RESTRICTED
  • PRIMARY_TARGET_AUDIENCE
コンテンツの報告 chat.content_reporting × ユーザーに 1 対 1 のダイレクト メッセージのコンテンツの報告を許可する one_on_one_direct_messages_reporting enum:
  • CONTENT_REPORTING_STATE_UNSPECIFIED
  • ENABLED
  • DISABLED
ユーザーにグループ向けダイレクト メッセージのコンテンツの報告を許可する group_direct_messages_reporting 同じ
ユーザーが指定したスペースのコンテンツを報告できるようにする spaces_reporting 同じ
spaces_reporting_type enum:
  • SPACES_REPORTING_TYPE_UNSPECIFIED
  • ALL_SPACES
  • DISCOVERABLE_SPACES_ONLY
ユーザーがコンテンツを報告する際に選択できるカテゴリを指定する reporting_categories 繰り返しオブジェクト:
  • category(列挙型):
    • CATEGORY_UNSPECIFIED
    • HARASSMENT
    • DISCRIMINATION
    • EXPLICIT_CONTENT
    • SPAM
    • CONFIDENTIAL_INFO
    • SENSITIVE_INFO
    • OTHER
報告フォームのタイトルと説明をカスタマイズする reporting_form_customization_enabled ブール値
custom_reporting_form_title 文字列
custom_reporting_form_description 文字列
チャットとスペースの制限 chat.chat_and_space_restrictions × メッセージ、グループ メッセージ、スペースの作成を制限する。この制限が適用されているユーザーはメンバーを管理できません。 restriction_level enum:
  • RESTRICTION_LEVEL_UNSPECIFIED
  • UNRESTRICTED
  • RESTRICTED

Classroom の設定

管理コンソールのページ 管理コンソールの特定の設定 Policy API の設定タイプ 変更に対応 管理コンソールのキャプション Policy API のフィールド名 データ型
Classroom [全般設定] > [教師の権限] classroom.teacher_permissions × クラスを作成できるユーザー whoCanCreateClasses 列挙型:
  • ANYONE_IN_DOMAIN
  • ALL_PENDING_AND_VERIFIED_TEACHERS
  • VERIFIED_TEACHERS_ONLY
[全般設定] > [保護者のアクセス] classroom.guardian_access × 保護者に Classroom 情報へのアクセスを許可する allowAccess ブール値
保護者を管理できるユーザー whoCanManageGuardianAccess 列挙型:
  • VERIFIED_TEACHERS_AND_DOMAIN_ADMINS
  • DOMAIN_ADMINS_ONLY
[クラスの設定] > [クラスのメンバーについて] classroom.class_membership × ドメインのクラスに参加できるユーザー whoCanJoinClasses 列挙型:
  • ANYONE_IN_DOMAIN
  • ANYONE_IN_ALLOWLISTED_DOMAINS
  • ANY_GOOGLE_WORKSPACE_USER
  • ANYONE
このドメインのユーザーが参加できるクラス whichClassesCanUsersJoin 列挙型:
  • CLASSES_IN_DOMAIN
  • CLASSES_IN_ALLOWLISTED_DOMAINS
  • ANY_GOOGLE_WORKSPACE_CLASS
[データアクセス] > [Classroom API] classroom.api_data_access × ユーザーは、Google Classroom データへのアクセスをアプリに許可することができます enableApiAccess ブール値
[独自性レポート] > [校内での一致] classroom.originality_reports × 独自性レポートで校内での一致を有効にする enableOriginalityReportsSchoolMatches ブール値
生徒の登録解除 > 登録解除の権限 classroom.student_unenrollment × 生徒のクラス登録を解除できるユーザー whoCanUnenrollStudents 列挙型
  • STUDENTS_AND_TEACHERS
  • TEACHERS_ONLY
[名簿のインポート] > [設定] classroom.roster_import × 名簿のインポート rosterImportOption 列挙型:
  • OFF
  • ON_CLEVER
Gemini in Workspace アプリ Gemini for Workspace > Classroom の機能へのアクセス > Classroom classroom.gemini_access × ユーザーが Gemini in Classroom にアクセスできるかどうかを選択する 有効 ブール値

データ コンプライアンスの設定

管理コンソールのページ 管理コンソールの特定の設定 Policy API の設定タイプ 変更に対応 管理コンソールのキャプション Policy API のフィールド名 データ型
アクセス管理 アクセス管理 > アクセス管理ポリシー access_management.user_scoping × 対象データに適用するアクセス管理ポリシーの選択 allowed_audience 列挙型:
  • PREFERENCE_UNSPECIFIED
  • CJIS_IRS_1075_GOOGLE_STAFF
  • US_GOOGLE_STAFF
  • EU_GOOGLE_STAFF
データ リージョン リージョン > 保存データ data_regions.data_at_rest_region × 保存データを配置するリージョン region 列挙型:
  • REGION_UNSPECIFIED
  • ANY_REGION
  • US
  • EUROPE
リージョン > データ処理 data_regions.data_processing_region × データ処理に対するデータ リージョン ポリシー limit_to_storage_region ブール値
アクセス承認 [アクセス承認] > [アクセス承認ポリシー] access_approval.axa_user_scoping × Google スタッフがサポート対応に必要なデータを閲覧するにあたり、承認のリクエストを求めます requires_customer_approval ブール値

デバイスの設定

管理コンソールのページ 管理コンソールの特定の設定 Policy API の設定タイプ v1beta1 でサポートされている mutate 管理コンソールのキャプション Policy API のフィールド名 データ型
一般設定 [データアクセス] > [Android 同期] devices.android_work_data_sync × Android デバイスでの仕事用データの同期を許可する 許可 ブール値
[セキュリティ] > [暗号化] devices.encryption × デバイスの暗号化を必須にする device_encryption_option enum:
  • ENCRYPTION_OPTION_UNSPECIFIED
  • NOT_REQUIRED
  • REQUIRED
[セキュリティ] > [不正使用されたデバイス] devices.compromised_devices × 不正使用された Android デバイスをブロックする compromised_android_devices_blocked ブール値
制限解除された iOS デバイスをブロックする jailbroken_ios_devices_blocked ブール値
[セキュリティ] > [デバイスの承認] devices.activation_approval × 管理者の承認を必須にする admin_approval_required ブール値
承認リクエスト メールの送信先 approver_email_address 文字列
Android の設定 [アプリとデータ共有] > [他のプロファイルへの共有] devices.android_work_profile_sharing × 仕事用プロファイルから個人用スペースへのコンテンツ共有を許可する(仕事用プロファイルを設定したデバイスのみ) 許可 ブール値
[アプリとデータ共有] > [クロス プロファイル コピー] devices.android_cross_profile_copy_paste × 仕事用プロファイルと個人用スペースの間で貼り付けを許可する(仕事用プロファイルを設定したデバイスのみ) 有効 ブール値
[アプリとデータ共有] > [Google Play 限定公開アプリ] devices.android_google_play_private_apps × Google Play の限定公開アプリへのアクセスをユーザーに許可する access_allowed ブール値
Google Play の限定公開アプリの公開、更新をユーザーに許可する publish_and_update_allowed ブール値
[アプリとデータ共有] > [スクリーン キャプチャ] devices.android_screen_capture × 画面キャプチャの使用を許可します 許可 ブール値
アプリとデータ共有 > Android ビーム devices.android_beam × 送信ビームを許可する outgoing_beam_allowed ブール値
[アプリとデータ共有] > [現在地の共有] devices.android_location_sharing × 現在地の共有を許可します。 許可 ブール値
[アプリとデータ共有] > [使用できるアプリ] devices.android_available_apps × ユーザーが Google Play ストアからインストールできるアプリを設定する playstore_installable_apps 列挙型:
  • PLAYSTORE_INSTALLABLE_APPS_UNSPECIFIED
  • ALL
  • ALLOWLISTED
[アプリとデータ共有] > [アプリの確認] devices.android_verify_apps × Google Play プロテクトのオフへの切り替えをユーザーに許可する(会社所有デバイスのみ) turnoff_google_play_protect_allowed ブール値
[アプリとデータ共有] > [開発者向けオプション] devices.android_developer_options × 開発者向けオプションの使用を許可する 許可 ブール値
ロック画面機能 > PIN、パスワード、パターンのいずれかを使用した定期的な認証 devices.android_periodic_secure_authentication × 顔認証または指紋認証を使用するユーザーに対し、PIN、パスワード、パターンなどのより安全な方法で定期的に認証することを要求します 必須 ブール値
下記の期間が経過した後、ユーザーは次回デバイスのロックを解除するときに、より安全な認証方法を使用する必要があります expiration_period 列挙型:
  • EXPIRATION_PERIOD_UNSPECIFIED
  • ONE_HOUR
  • THREE_HOURS
  • SIX_HOURS
  • EIGHT_HOURS
  • TWELVE_HOURS
  • TWENTY_FOUR_HOURS
  • FORTY_EIGHT_HOURS
  • SEVENTY_TWO_HOURS
[アプリとデータ共有] > [提供元不明のアプリ] devices.android_unknown_source_apps × 仕事用プロファイルに対して、ユーザーが提供元不明のアプリをインストールできないようにします。 work_profile_installation_allowed ブール値
個人用プロファイルに対して、ユーザーが提供元不明のアプリをインストールできないようにします。 personal_profile_installation_allowed ブール値
[アプリとデータ共有] > [アプリの設定] devices.android_apps_settings × アプリ設定の変更をユーザーに許可する(会社所有デバイスのみ)。 modification_allowed ブール値
[アプリとデータ共有] > [ロック画面機能] devices.android_trust_agents × Smart Lock によるデバイスのロック解除状態の維持を許可する。 smart_lock_allowed ブール値
[アプリとデータ共有] > [ロック画面機能] devices.android_lock_screen_notifications × ロック画面での通知の表示を許可する。 許可 ブール値
[アプリとデータ共有] > [ロック画面機能] devices.android_lock_screen_notification_details × 通知の詳細を許可する。 許可 ブール値
iOS の設定 [Advanced Security] > [Apple Watch] devices.ios_apple_watch × 手首検出を行わずに Apple Watch の使用を許可する no_wrist_detection_usage_allowed ブール値
[Advanced Security] > [Siri] devices.ios_siri × Siri の使用を許可する 許可 ブール値
ロック画面での Siri の使用を許可する allowed_on_lock_screen ブール値
高度なセキュリティ > 引き継ぎ devices.ios_handoff × Handoff を許可する(管理対象デバイスと登録済みのデバイスのみ) 許可 ブール値
データ共有 > iCloud ストレージ devices.ios_icloud_storage × iCloud でのデータの保存を管理対象アプリに許可する managed_apps_sync_allowed ブール値
[高度なセキュリティ] > [スクリーン キャプチャ] devices.ios_screen_capture × スクリーンショットと画面録画を許可する 許可 ブール値
[バックアップと iCloud 同期] > [iCloud バックアップ] devices.ios_icloud_backup × iCloud でのデバイスのバックアップを許可する(管理対象デバイスのみ) 許可 ブール値
[バックアップと iCloud 同期] > [暗号化バックアップ] devices.ios_backup_encryption × バックアップの暗号化を必須とする 必須 ブール値
[ロック画面] > [コントロール センター] devices.ios_lock_screen_control_center × ロック画面でのコントロール センターの使用を許可する 許可 ブール値
[アプリとサービス] > [ファイル] アプリ devices.ios_files_app × ファイルでの USB ドライブへの接続をユーザーに許可する(iOS 13.1 以降の管理対象デバイスのみ) usb_drives_connection_allowed ブール値
ファイルでのネットワーク ドライブへの接続をユーザーに許可する(iOS 13.1 以降の管理対象デバイスのみ) network_drives_connection_allowed ブール値
[デバイスの機能] > [日付と時刻] devices.ios_date_time × 日時の自動設定を適用する(iOS 12 以降の管理対象デバイスのみ) automatic_date_time_enforced ブール値
[ロック画面] > [通知ビュー] devices.ios_lock_screen_notifications_view × ロック画面での通知ビューの表示を許可する 許可 ブール値
データ共有 > データ操作 devices.ios_data_actions × Google Workspace の該当データに対して iOS デバイスでどの操作をユーザーが行えるようにするかを選択します。 external_data_sharing_allowed ブール値
仕事用データをコピーして個人アカウントまたはアプリに貼り付けることを許可する work_data_operation_type.non_workspace_apps_copy_paste_allowed ブール値
iOS の共有シート上で仕事用データを個人用アプリ(Google Workspace 以外のすべてのアプリを含む)に送信することを許可する work_data_operation_type.non_workspace_apps_sharing_allowed ブール値
iOS 共有シートを使用して、仕事用データを個人アカウントまたは iOS のメールに共有することを許可する work_data_operation_type.personal_accounts_sharing_allowed ブール値
AirDrop を使用して、仕事用データを iOS の共有シート上で共有することを許可する work_data_operation_type.airdrop_sharing_allowed ブール値
作業ファイルの印刷を許可する work_data_operation_type.files_printing_allowed ブール値
iOS の共有シートを使用して仕事用データを「ファイル」に保存し、仕事用データに「ファイル」から直接アクセスすることを許可する work_data_operation_type.files_access_allowed ブール値
仕事用の画像や動画を iOS の「写真」に保存することを許可する work_data_operation_type.images_videos_saving_allowed ブール値
iOS の共有シートを使用してアイテムを連絡先に割り当てることを許可する work_data_operation_type.contacts_items_assignment_allowed ブール値
[Safari] > [安全なブラウジング] devices.ios_safari_secure_browsing × Safari の不正なウェブサイトに関する警告を適用する fraudulent_website_warning_enforced ブール値
データ共有 > Apple Intelligence devices.ios_apple_intelligence × iOS デバイスの Google Workspace アプリで Apple Intelligence の文章作成ツールの使用を許可する writing_tools_allowed ブール値
[バックアップと iCloud 同期] > [キーチェーンの同期] devices.ios_keychain_sync × iCloud とのキーチェーン同期をユーザーに許可する(管理対象デバイスのみ)。 icloud_sync_allowed ブール値
[バックアップと iCloud 同期] > [ドキュメントの同期] devices.ios_document_sync × iCloud とのドキュメントおよびデータの同期をユーザーに許可する。 icloud_data_sync_allowed ブール値

ディレクトリの設定

管理コンソールのページ 管理コンソールの特定の設定 Policy API の設定タイプ 変更に対応 管理コンソールのキャプション Policy API のフィールド名 データ型
ディレクトリ設定 [共有設定] > [外部ディレクトリ共有] directory.external_directory_sharing × なし sharing_option 列挙型:
  • SHARING_OPTION_UNSPECIFIED
  • REQUESTER_BASIC_PROFILE_ONLY
  • ORGANIZATION_DIRECTORY_DATA

ドライブとドキュメントの設定

管理コンソールのページ 管理コンソールの特定の設定 Policy API の設定タイプ 変更に対応 管理コンソールのキャプション Policy API のフィールド名 データ型
ドライブとドキュメント [共有設定] > [共有オプション] drive_and_docs.external_sharing × CUSTOMER_NAME の外部に許可する最大の共有レベルを選択する external_sharing_mode 列挙型:
  • DISALLOWED
  • ALLOWLISTED_DOMAINS
  • ALLOWED
ORGANIZATION_UNIT_NAME のユーザーが CUSTOMER_NAME 外のユーザーまたは共有ドライブからファイルを受信することを許可する allow_receiving_external_files ブール値
ORGANIZATION_UNIT_NAME のユーザーまたは共有ドライブがオーナーとなっているファイルが許可リスト登録済みドメインのユーザーと共有されたときに警告する warn_for_sharing_outside_allowlisted_domains ブール値
許可リスト登録済みドメイン以外のユーザーまたは共有ドライブからのファイル受信を ORGANIZATION_UNIT_NAME のユーザーに許可する allow_receiving_files_outside_allowlisted_domains ブール値
ORGANIZATION_UNIT_NAME のユーザーまたは共有ドライブが、ビジターとの共有機能を使用して、信頼ドメイン内の Google アカウントを持たないユーザーとアイテムを共有することを許可する allow_non_google_invites_in_allowlisted_domains ブール値
ORGANIZATION_UNIT_NAME のユーザーまたは共有ドライブがオーナーとなっているファイルが CUSTOMER_NAME の外部で共有されたときに警告する warn_for_external_sharing ブール値
ORGANIZATION_UNIT_NAME のユーザーまたは共有ドライブが、Google アカウントを使用していない CUSTOMER_NAME 外のユーザーとアイテムを共有することを許可する allow_non_google_invites ブール値
CUSTOMER_NAME の外部との共有が許可されている場合、ORGANIZATION_UNIT_NAME 内のユーザーは、リンクを知っているすべてのユーザーに対して、ファイルおよび公開済みのウェブ コンテンツを公開することができます allow_publishing_files ブール値
ユーザーが Google ドキュメントや Google ドライブ以外の Google サービス経由でファイルを共有した場合(例: Gmail にリンクを貼り付ける)、共有相手にファイルへのアクセス権があるかどうかを確認できます。アクセス権が共有相手にない場合、次のユーザーとファイルを共有してよいかどうかの確認を求めるメッセージを表示します(可能な場合) access_checker_suggestions 列挙型:
  • RECIPIENTS_OR_AUDIENCE_OR_PUBLIC
  • RECIPIENTS_OR_AUDIENCE
  • RECIPIENTS_ONLY
CUSTOMER_NAME 外の ORGANIZATION_UNIT_NAME でコンテンツを配信できるユーザーを選択します。この設定を行うことで、別の組織が所有する共有ドライブにコンテンツをアップロード、移動できるユーザーを制限できます allowed_parties_for_distributing_content 列挙型:
  • ALL_ELIGIBLE_USERS
  • ELIGIBLE_INTERNAL_USERS
  • NONE
[共有設定] > [一般的なアクセスのデフォルト] drive_and_docs.general_access_default × ORGANIZATION_UNIT_NAME 内のユーザーがアイテムを作成すると、デフォルトのアクセスは次のようになります default_file_access 列挙型:
  • PRIVATE_TO_OWNER
  • PRIMARY_AUDIENCE_WITH_LINK
  • PRIMARY_AUDIENCE_WITH_LINK_OR_SEARCH
[共有設定] > [共有ドライブの作成] drive_and_docs.shared_drive_creation × ORGANIZATION_UNIT_NAME のユーザーが新しい共有ドライブを作成できないようにする allow_shared_drive_creation ブール値(API レスポンスは UI 値の反対を返します)
ORGANIZATION_UNIT_NAME 内のユーザーが作成した共有ドライブは、以下の組織部門に割り当てられます org_unit_for_new_shared_drives 列挙型:
  • CREATOR_ORG_UNIT
  • CUSTOM_ORG_UNIT
選択した組織部門 custom_org_unit 文字列
管理者権限を持つユーザーが、以下の設定をオーバーライドできるようになります allow_managers_to_override_settings ブール値
CUSTOMER_NAME 外のユーザーが共有ドライブ内のファイルにアクセスできるようにする allow_external_user_access ブール値
共有ドライブのメンバー以外のユーザーに、ファイルの追加を許可します allow_non_member_access ブール値
ダウンロード、印刷、コピーを有効にするユーザー: allowed_parties_for_download_print_copy 列挙型:
  • ALL
  • EDITORS_ONLY(管理者、投稿者、コンテンツ管理者)
  • MANAGERS_ONLY
コンテンツ管理者にフォルダの共有を許可する allow_content_managers_to_share_folders ブール値
[共有設定] > [ファイルのセキュリティ アップデート] drive_and_docs.file_security_update × このアップデートを適用すると、ファイルリンクの安全性が強化されます。アップデート適用時に、ファイルへのアクセス リクエストがユーザーに届く場合があります security_update 列挙型:
  • APPLY_TO_IMPACTED_FILES
  • REMOVE_FROM_IMPACTED_FILES
所有または管理しているファイルに対して、ユーザー自身でセキュリティ アップデートを削除または適用できるようにする allow_users_to_manage_update ブール値
[機能とアプリケーション] > [ドライブ SDK] drive_and_docs.drive_sdk × Drive SDK API 経由での Google ドライブへのアクセスをユーザーに許可する enable_drive_sdk_api_access ブール値
[パソコン版 Google ドライブ] > [パソコン版ドライブを有効にする] drive_and_docs.drive_for_desktop × 組織内でのパソコン版 Google ドライブの使用を許可する allow_drive_for_desktop ブール値
承認されたデバイスでのみパソコン版 Google ドライブの使用を許可する restrict_to_authorized_devices ブール値
パソコン版 Google ドライブのダウンロード リンクを表示する show_download_link ブール値
ユーザーにパソコン版 Google ドライブからの Microsoft Office のリアルタイム プレゼンス機能の有効化を許可する allow_real_time_presence ブール値
[共有設定] > [外部ファイルをハイライト表示する] drive_and_docs.external_file_warning × 外部と共有されているファイルや外部で所有されているファイルを「外部」としてマークし、コンテンツが組織外で表示される可能性があることを示します。Google ドライブ、ドキュメント、スプレッドシート、スライド、図形描画、Google Vids に適用されます。 highlighting_enabled ブール値

Gemini アプリの設定

管理コンソールのページ 管理コンソールの特定の設定 Policy API の設定タイプ 変更に対応 管理コンソールのキャプション Policy API のフィールド名 データ型
Gemini アプリ ユーザー アクセス gemini_app.unlicensed_user_access × ライセンスの有無にかかわらず、すべてのユーザーに Gemini アプリへのアクセスを許可 有効 ブール値

Gemini in Workspace の設定

管理コンソールのページ 管理コンソールの特定の設定 Policy API の設定タイプ 変更に対応 管理コンソールのキャプション Policy API のフィールド名 データ型
Gemini in Workspace ベータ版 Gemini 機能 > ベータ版機能 gemini_for_workspace.beta_features × Gemini for Google Workspace のベータ版機能へのアクセスを有効にする 有効 ブール値
Gemini for Google Workspace の改善を目的としたアンケートや UX フィードバック調査に参加していただくために、選択された組織部門またはグループのユーザーを招待することを Google に許可する feedback_and_testing_enabled ブール値

Gmail の設定

管理コンソールのページ 管理コンソールの特定の設定 Policy API の設定タイプ 変更に対応 管理コンソールのキャプション Policy API のフィールド名 データ型
Gmail [ユーザー設定] > [情報保護モード] gmail.confidential_mode × 情報保護モードを有効にする enable_confidential_mode ブール値
[ユーザー設定] > [S/MIME] gmail.smime_encryption × メール送受信で S/MIME 暗号化を有効にする enable_smime_encryption 列挙型:
  • STATUS_UNSPECIFIED
  • STATUS_DISABLED
  • STATUS_ENABLED
SHA-1 をグローバルに許可する(非推奨) allow_sha1_globally_in_smime_signature ブール値
gmail.enhanced_smime_encryption × 独自証明書のアップロードをユーザーに許可する allow_user_to_upload_certificates ブール値
特定のドメインに関する追加のルート証明書を受け入れてください: custom_root_certificates CustomRootCertificates のリスト。ルート証明書のリスト、中間 CA 証明書のリスト、制限付きドメイン名のリスト、アドレスの不一致を許可するブール値、さまざまな検証レベルの列挙型が含まれます。
[迷惑メール、フィッシング、マルウェア] > [メール配信前のスキャンの強化] gmail.enhanced_pre_delivery_message_scanning × 配信前に不審なコンテンツを高い精度で検出できるようにします enable_improved_suspicious_content_detection ブール値
[迷惑メール、フィッシング、マルウェア] > [メールの許可リスト] gmail.email_spam_filter_ip_allowlist × メールの許可リストに登録する IP アドレスを入力 allowed_ip_addresses 文字列のリスト
[安全性] > [なりすましと認証] gmail.spoofing_and_authentication × 類似したドメイン名に基づくドメインのなりすましに対する保護機能 detect_domain_name_spoofing ブール値
操作を選択 domain_name_spoofing_consequence 列挙型:
  • WARNING
  • SPAM_FOLDER
  • QUARANTINE
  • NO_ACTION
検疫を選択する domain_name_spoofing_quarantine_id integer
従業員名のなりすましに対する保護機能 detect_employee_name_spoofing ブール値
操作を選択 employee_name_spoofing_consequence 列挙型:
  • WARNING
  • SPAM_FOLDER
  • QUARANTINE
  • NO_ACTION
検疫を選択する employee_name_spoofing_quarantine_id integer
受信メールによるドメインのなりすましに対する保護機能 detect_domain_spoofing_from_unauthenticated_senders ブール値
操作を選択 domain_spoofing_consequence 列挙型:
  • WARNING
  • SPAM_FOLDER
  • QUARANTINE
  • NO_ACTION
検疫を選択する domain_spoofing_quarantine_id integer
未認証メールに対する保護機能 detect_unauthenticated_emails ブール値
操作を選択 unauthenticated_email_consequence 列挙型:
  • WARNING
  • SPAM_FOLDER
  • QUARANTINE
  • NO_ACTION
検疫を選択する unauthenticated_email_quarantine_id integer
受信メールによるドメインのなりすましから Google グループを保護 detect_groups_spoofing ブール値
この設定の適用対象 groups_spoofing_visibility_type 列挙型:
  • PRIVATE_GROUPS_ONLY
  • ALL_GROUPS
操作を選択 groups_spoofing_consequence 列挙型:
  • WARNING
  • SPAM_FOLDER
  • QUARANTINE
  • NO_ACTION
検疫を選択する groups_spoofing_quarantine_id integer
今後のおすすめの設定を自動的に適用 apply_future_settings_automatically ブール値
[安全性] > [リンクと外部画像] gmail.links_and_external_images × 短縮 URL により隠されたリンクを特定 enable_shortener_scanning ブール値
リンク先の画像をスキャン enable_external_image_scanning ブール値
信頼できないドメインへのリンクをクリックした場合に警告メッセージを表示 enable_aggressive_warnings_on_untrusted_links ブール値
今後のおすすめの設定を自動的に適用 apply_future_settings_automatically ブール値
[安全性] > [アタッチメント] gmail.email_attachment_safety × 信頼できない送信者から送られる暗号化された添付ファイルに対する保護機能 enable_encrypted_attachment_protection ブール値
操作を選択 encrypted_attachment_protection_consequence 列挙型:
  • WARNING
  • SPAM_FOLDER
  • QUARANTINE
検疫を選択する encrypted_attachment_protection_quarantine_id integer
信頼できない送信者から送られる、スクリプトを含む添付ファイルに対する保護機能 enable_attachment_with_scripts_protection ブール値
操作を選択 attachment_with_scripts_protection_consequence 列挙型:
  • WARNING
  • SPAM_FOLDER
  • QUARANTINE
検疫を選択する attachment_with_scripts_protection_quarantine_id integer
異常な種類の添付ファイルに対する保護 enable_anomalous_attachment_protection ブール値
操作を選択 anomalous_attachment_protection_consequence 列挙型:
  • WARNING
  • SPAM_FOLDER
  • QUARANTINE
検疫を選択する anomalous_attachment_protection_quarantine_id integer
次の一般的でないファイル形式を許可リストに登録 allowed_anomalous_attachment_filetypes string[]
今後のおすすめの設定を自動的に適用 apply_future_recommended_settings_automatically ブール値
[ルーティング] > [アドレスリストの管理] gmail.email_address_lists × アドレスリストを管理する email_address_list EmailAddressList[]
[迷惑メール、フィッシング、マルウェア] > [ブロックされている送信者] gmail.blocked_sender_lists × メールアドレスまたはドメインに基づいて特定の送信者をブロック / 承認する blocked_senders BlockedSender[]
[迷惑メール、フィッシング、マルウェア] > [迷惑メール] gmail.spam_override_lists × 迷惑メールフォルダに振り分けられない、承認されている送信者のリストを作成します。 spam_override SpamOverride[]
[コンプライアンス] > [コンテンツ コンプライアンス] gmail.content_compliance × 単語、フレーズ、パターンに基づいて高度なコンテンツ フィルタを構成する content_compliance_rules ContentComplianceRule[]
[コンプライアンス] > [配信を制限] gmail.restrict_delivery × ユーザーにメールの送受信を許可するドメインを制限します。 restrict_delivery_rules RestrictDeliveryRule[]
[コンプライアンス] > [不適切なコンテンツ] gmail.objectionable_content × 単語リストに基づいてコンテンツ フィルタを構成する objectionable_content_rules ObjectionableContentRule[]
[コンプライアンス] > [添付ファイルのコンプライアンス] gmail.attachment_compliance × ファイル形式、ファイル名、メッセージのサイズに基づいて添付ファイル フィルタを設定する attachment_compliance_rules AttachmentComplianceRule[]
[コンプライアンス] > [包括的なメール ストレージ] gmail.comprehensive_mail_storage × 送受信されたすべてのメールのコピーが、関連するユーザーのメールボックスに保存されるようにする rule_id 文字列
なし(すべてのルール) gmail.rule_states × なし rule_states RuleState[]
検疫を管理する gmail.email_quarantines × 検疫を追加 email_quarantines EmailQuarantine[]
[設定] > [ユーザーのメールアドレスのアップロード] gmail.user_email_uploads × Gmail の設定ページに、ウェブメール(Yahoo!、Hotmail、AOL、その他のウェブメール、POP3 アカウントからメールをインポートするオプションを表示します。 enable_mail_and_contacts_import ブール値
[エンドユーザーのアクセス] > [POP と IMAP アクセス] gmail.pop_access × どのユーザーも POP アクセスを使用できるようにする enable_pop_access ブール値
gmail.imap_access × どのユーザーも IMAP アクセスを使用できるようにする enable_imap_access ブール値
任意のメール クライアントの使用を許可します imap_access_restriction.allow_all_mail_clients ブール値
ユーザーに使用を許可するメール クライアントを制限します(OAuth メール クライアントのみ) imap_access_restriction.allowed_oauth_mail_client_list OAuthMailClientList
[エンドユーザーのアクセス] > [Google Workspace Sync] gmail.workspace_sync_for_outlook × ユーザーが Google Workspace Sync for Microsoft Outlook を使用できるようにする enable_google_workspace_sync_for_microsoft_outlook ブール値
[エンドユーザーのアクセス] > [自動転送] gmail.auto_forwarding × 受信メールを別のメールアドレスに自動転送することをユーザーに許可する enable_auto_forwarding ブール値
許可された転送先 allowed_forwarding_destination 列挙型:
  • ANY_ADDRESS
  • INTERNAL_ADDRESSES
[ユーザー設定] > [名前の形式] gmail.name_format × ユーザーにこの設定のカスタマイズを許可する allow_custom_display_names ブール値
名 姓、または姓、名 default_display_name_format 列挙型:
  • FIRSTNAME_LASTNAME
  • LASTNAME_COMMA_FIRSTNAME
[エンドユーザーのアクセス] > [ユーザーごとの送信ゲートウェイの許可] gmail.per_user_outbound_gateway × メールドメイン外でホストされている「送信元」アドレスを設定する際に、ユーザーが外部 SMTP サーバー経由でメールを送信できるようにする allow_users_to_use_external_smtp_servers ブール値
[エンドユーザーのアクセス] > [外部の宛先に関する警告] gmail.external_recipient_warning × 会話内の外部受信者をハイライト表示する。連絡先に登録されていない外部の受信者が含まれるメールに返信する前に、ユーザーに警告します。 有効 ブール値
[エンドユーザーのアクセス] > [画像 URL のプロキシ許可リスト] gmail.email_image_proxy_bypass × 画像 URL パターンを入力します。パターンと一致する URL は画像プロキシを経由しなくなります。 image_proxy_bypass_pattern string[]
なし enable_image_proxy ブール値
ユーザー設定 > メール委任 gmail.mail_delegation × ドメインの他のユーザーにメールボックスへのアクセスを委任できるようにする enable_mail_delegation ブール値
ユーザーにこの設定のカスタマイズを許可する allow_custom_delegate_attribution ブール値
アカウント所有者およびメールを送信した代理人を表示する enable_delegate_attribution ブール値
アカウント所有者のみを表示する
ユーザーが自分のメールボックスへのアクセス権を Google グループに付与できるようにする enable_mailbox_group_delegation ブール値
ユーザー設定 > Gmail ウェブ オフライン gmail.web_offline × Gmail ウェブ オフラインを有効にする 有効 ブール値
Google アカウントからのログアウト時にオフライン データの削除を強制する signout_data_deletion_enforced ブール値

Gmail のサブ設定

この表は、他の Gmail 設定から参照される Gmail のサブ設定を示しています。

Policy API のサブ設定名 管理コンソールのキャプション Policy API のフィールド名 データ型
EmailAddressList なし id 文字列
名前 name 文字列
アドレスリストを追加 address_list AddressList
ブロックするアドレスのリストを追加 blocked_address_list AddressList
AddressList アドレスリストを追加する address AddressListEntry[]
AddressListEntry 住所 address 文字列
認証が必要(受信メールのみ) require_address_verification ブール値
BlockedSender 設定の概要に表示される簡単な説明を入力します。 説明 文字列
自動的にメールを拒否する送信元のアドレスまたはドメインを追加する sender_blocklist StringValue[]
カスタマイズした拒否通知を入力する rejection_response 文字列
これらの承認済み送信者リストに含まれているアドレスまたはドメインから受信したメールにはこの設定を適用しない。 bypass_approved_sender ブール値
なし bypass_approved_sender_allowlist StringValue[]
なし rule_id 文字列
SpamOverride 設定の概要に表示される簡単な説明を入力します。 説明 文字列
積極的に迷惑メールに分類する。 enable_aggressive_filtering ブール値
迷惑メールを管理検疫に移動する add_to_quarantine ブール値
なし quarantine_id integer
送信者が内部ユーザーの場合は迷惑メールフィルタを適用しない。 bypass_internal_senders ブール値
選択したリスト内の送信者またはドメインから受信したメールの場合は迷惑メールフィルタを適用しない。 bypass_selected_senders ブール値
なし bypass_sender_allowlist StringValue[]
選択したリスト内の送信者またはドメインから受信したメールの場合は迷惑メールフィルタを適用せず、警告も非表示にする。 hide_warning_banner_from_selected_senders ブール値
なし hide_warning_banner_sender_allowlist StringValue[]
内部および外部ユーザーから受信したすべてのメールについて、迷惑メールフィルタを適用せず、警告を非表示にする(非推奨)。 hide_warning_banner_for_all ブール値
なし rule_id 文字列
ContentComplianceRule 設定の概要に表示される簡単な説明を入力します。 説明 文字列
影響を受けるメール condition RuleConditions
各メッセージで検索するコンテンツを表す表現を追加する match_expressions MatchExpression[]
次の一部がメールに一致する場合 match_any_expression ブール値
上記の表現が一致する場合は、次の処理を行います 対処 RuleConsequences
なし rule_id 文字列
RestrictDeliveryRule 必須: 設定の概要に表示される短い説明を入力します。 説明 文字列
許可するアドレスまたはドメインを追加する allowed_addresses StringValue[]
他のアドレスやドメインとの間で送受信したメールはすべて拒否されます。これらのメールに適用するデフォルトの拒否通知を編集してください。 rejection_notice_message 文字列
内部メッセージにはこの設定を適用しない internal_messages_rule_bypass_allowed ブール値
なし rule_id 文字列
ObjectionableContentRule 設定の概要に表示される簡単な説明を入力します。 説明 文字列
影響を受けるメール condition RuleConditions
不適切な単語のカスタムリスト objectionable_content_defined ブール値
単語を入力 objectionable_words string[]
上記の表現が一致する場合は、次の処理を行います 対処 RuleConsequences
なし rule_id 文字列
AttachmentComplianceRule 設定の概要に表示される簡単な説明を入力します。 説明 文字列
影響を受けるメール condition RuleConditions
各メッセージで検索するコンテンツを表す表現を追加する match_expressions MatchExpression[]
次の一部がメールに一致する場合 match_any_expression ブール値
上記の表現が一致する場合は、次の処理を行います 対処 RuleConsequences
なし rule_id 文字列
RuleState なし(すべてのルール) 有効 ブール値
rule_id 文字列
RuleConditions 影響を受けるメール 受信メッセージ affect_inbound_messages ブール値
送信メッセージ affect_outbound_messages ブール値
内部送信メッセージ affect_internal_sending_messages ブール値
内部のインバウンド メッセージ affect_internal_receiving_messages ブール値
アドレスリスト アドレスリストを使用して、この設定を適用するアプリケーションを除外、制御する address_list_option 列挙型:
  • NO_EFFECT
  • EXCLUDED
  • REQUIRED
特定のアドレスまたはドメインにはこの設定を適用しない
特定のアドレスまたはドメインにのみ、この設定を適用する
既存のリストを使用 / リストを作成または編集 address_lists StringValue[]
影響を受けるアカウントの種類 ユーザー account_type_user ブール値
グループ account_type_group ブール値
不明 / キャッチオール account_type_unrecognized ブール値
エンベロープ フィルタ 特定のエンベロープ送信者のみに適用する envelope_sender_filter AddressMatcher
特定のエンベロープ受信者のみに適用する envelope_recipient_filter AddressMatcher
AddressMatcher 特定のエンベロープ送信者のみに適用する / 特定のエンベロープ受信者のみに適用する 有効 ブール値
単一のメールアドレス なし address_match_type 列挙型: EXACT
メールアドレス exact_address_match_value 文字列
パターン一致 なし address_match_type 列挙型: REGEXP
Regexp regexp_match_value 文字列
グループ メンバー(送信済みメールのみ)/ グループ メンバー(受信メールのみ) なし address_match_type 列挙型: GROUP_MEMBERSHIP
グループを選択する group_ids string[]
MatchExpression シンプルなコンテンツ マッチ なし match_expression_type 列挙型: SIMPLE_CONTENT
コンテンツ match_content 文字列
高精度コンテンツ マッチ なし match_expression_type 列挙型: ADVANCED_CONTENT
コンテンツ / 正規表現 match_content 文字列
なし advanced_content_match AdvancedContentMatch
メタデータの一致 match_expression_type 列挙型: METADATA
metadata_match MetadataMatch
事前定義されたコンテンツの一致 match_expression_type 列挙型: PREDEFINED_CONTENT
predefined_content_match PredefinedContentMatch
ファイル形式 match_expression_type 列挙型: FILE_TYPE
file_type_match FileTypeMatch
ファイル名 なし match_expression_type 列挙型: FILE_NAME
添付ファイル名に次の文字列が含まれる file_name 文字列
メッセージ サイズ なし match_expression_type 列挙型: MESSAGE_SIZE
メール全体(本文 + 添付ファイル)が次のサイズより大きい(MB) message_size_threshold_in_megabytes integer
AdvancedContentMatch 場所 ヘッダー + 本文 advanced_content_match_location 列挙型: HEADERS_AND_BODY
完全なヘッダー 列挙型: FULL_HEADERS
本文 列挙型: BODY
件名 列挙型: SUBJECT
送信者のヘッダー 列挙型: SENDER_HEADER
受信者のヘッダー 列挙型: RECIPIENTS_HEADER
エンベロープ送信者 列挙型: ENVELOPE_SENDER
任意のエンベロープ受信者 列挙型: ANY_ENVELOPE_RECIPIENT
メッセージのソース 列挙型: RAW_MESSAGE
マッチタイプ 前方一致 advanced_content_match_type 列挙型: STARTS_WITH
次で終わる 列挙型: ENDS_WITH
テキストを含む 列挙型: CONTAINS_TEXT
テキストを含まない 列挙型: NOT_CONTAINS_TEXT
Equals enum: <code< code="" dir="ltr" translate="no">EQUALS </code<>
空白である 列挙型: IS_EMPTY
正規表現に一致 列挙型: MATCHES_REGEXP
正規表現に一致しない 列挙型: NOT_MATCHES_REGEXP
いずれかの単語に一致する 列挙型: MATCH_ANY_WORD
すべての単語が一致する 列挙型: MATCH_ALL_WORDS
なし regexp_match RegexpMatch
RegexpMatch 正規表現の説明 説明 文字列
最小一致数 min_match_count integer
MetadataMatch 属性 メール認証 metadata_match_attribute 列挙型: MESSAGE_AUTHENTICATION
送信元 IP 列挙型: SOURCE_IP
セキュアなトランスポート(TLS) 列挙型: TLS
メッセージ サイズ 列挙型: MESSAGE_SIZE
S/MIME 暗号化 列挙型: SMIME_ENCRYPTED
S/MIME 署名済み 列挙型: SMIME_SIGNED
Gmail 情報保護モード 列挙型: CONFIDENTIAL_MODE
スパム 列挙型: SPAM
マッチタイプ 次の範囲 source_ip_range 文字列
次の値(MB) message_size_in_megabytes integer
メッセージが認証されている metadata_match_type 列挙型: MESSAGE_AUTHENTICATED
メッセージが認証されていない 列挙型: MESSAGE_NOT_AUTHENTICATED
送信元 IP が次の範囲内にある 列挙型: SOURCE_IP_IN_RANGE
送信元 IP が範囲外 列挙型: SOURCE_IP_NOT_IN_RANGE
接続が TLS で暗号化されている 列挙型: TLS_ENCRYPTED
接続が TLS で暗号化されていない 列挙型: TLS_NOT_ENCRYPTED
メールのサイズが次の値より大きい 列挙型: MESSAGE_SIZE_GREATER_THAN
メールサイズが次の値より小さい 列挙型: MESSAGE_SIZE_LESS_THAN
メッセージが S/MIME で暗号化されている 列挙型: MESSAGE_IS_SMIME_ENCRYPTED
メッセージが S/MIME で暗号化されていない 列挙型: MESSAGE_IS_NOT_SMIME_ENCRYPTED
メッセージが S/MIME で署名されている 列挙型: MESSAGE_IS_SMIME_SIGNED
メッセージが S/MIME で署名されていない 列挙型: MESSAGE_IS_NOT_SMIME_SIGNED
メッセージが Gmail 情報保護モードである 列挙型: MESSAGE_IS_IN_CONFIDENTIAL_MODE
メッセージが Gmail 情報保護モードではない 列挙型: MESSAGE_IS_NOT_IN_CONFIDENTIAL_MODE
セキュリティ サンドボックスで検出されたマルウェアである 列挙型: MALWARE_DETECTED_FROM_SECURITY_SANDBOX
PredefinedContentMatch なし(定義済みコンテンツ一致セレクタ) predefined_content_match_name 文字列
最小一致数 min_match_count integer
信頼度のしきい値 confidence_threshold 列挙型:
  • MEDIUM
  • HIGH
FileTypeMatch 暗号化された Office ドキュメント encrypted_office_documents ブール値
暗号化されていない Office ドキュメント unencrypted_office_documents ブール値
動画とマルチメディア 動画 ブール値
音楽とサウンド 音楽 ブール値
画像検索 画像 ブール値
暗号化された圧縮ファイルとアーカイブ compressed_encrypted_files ブール値
暗号化されていない圧縮ファイルとアーカイブ compressed_unencrypted_files ブール値
カスタム ファイル形式 - ファイル名の拡張子で照合 custom_file_extensions string[]
ファイル形式に基づいてファイルを照合する match_file_format ブール値
RuleConsequences メッセージを変更 なし rule_consequence_type 列挙型: MODIFY_MESSAGE
なし primary_delivery 配信
受信者を追加する deliver_to_additional_recipients ブール値
受信者 bcc_deliveries Delivery[]
配信 X-Gm-Original-To ヘッダーを追加 add_x_gm_original_to_header ブール値
X-Gm-Spam ヘッダーと X-Gm-Phishy ヘッダーを追加 add_x_gm_spam_header ブール値
カスタム ヘッダーを追加する add_custom_headers ブール値
カスタム ヘッダー custom_headers string[]
件名の先頭に追加するカスタム テキスト prepend_custom_subject ブール値
新しい件名のプレフィックスを入力します custom_subject 文字列
ルートを変更する change_default_route ブール値
迷惑メールのルートも変更する reroute_spam ブール値
この受信者からのバウンスメールを送信元に送信しない suppress_bounces_from_recipient ブール値
該当なし(ルーティング セレクタ) normal_routing ブール値
エンベロープ受信者を変更 なし change_envelope_recipient ブール値
受信者を変更する replace_envelope_recipient_type 列挙型: REPLACE_ADDRESS
recipient_address 文字列
ユーザー名を置き換える replace_envelope_recipient_type 列挙型: REPLACE_USER
recipient_user 文字列
ドメインを置き換える replace_envelope_recipient_type 列挙型: REPLACE_DOMAIN
recipient_domain 文字列
このメッセージには迷惑メールフィルタを適用しない bypass_spam_filter ブール値
メッセージから添付ファイルを削除 remove_attachments ブール値
添付ファイルが削除されたことを受信者に通知するテキストを追加する attachment_removal_notice 文字列
セキュアなトランスポート(TLS)を使用する require_tls ブール値
メールを暗号化しない場合は暗号化(S/MIME) encrypt_outgoing_messages ブール値
署名と暗号化ができない場合はバウンスメールを送信する bounce_unencrypted_messages ブール値
この受信者に迷惑メールを送信しない do_not_deliver_spam_to_recipient ブール値
OAuthMailClientList ユーザーに使用を許可するメール クライアントを制限します(OAuth メール クライアントのみ) oauth_mail_client OAuthMailClient[]
OAuthMailClient なし oauth_mail_client_id 文字列
EmailQuarantine なし quarantine_id integer
名前 name 文字列
説明 説明 文字列
受信拒否の結果 inbound_denial_consequence enum:
  • DENIAL_CONSEQUENCE_UNSPECIFIED
  • DROP
  • REJECT
送信拒否の結果 outbound_denial_consequence enum:
  • DENIAL_CONSEQUENCE_UNSPECIFIED
  • DROP
  • REJECT
メールが検疫されたときに定期的に通知する send_notifications ブール値
検疫確認を行うグループ quarantine_acl_group_ids string[]

ビジネス向け Google グループの設定

管理コンソールのページ 管理コンソールの特定の設定 Policy API の設定タイプ 変更に対応 管理コンソールのキャプション Policy API のフィールド名 データ型
ビジネス向け Google グループ [共有設定] > [共有オプション] groups_for_business.groups_sharing × グループの共有設定を変更する場合のポリシーを設定します collaborationCapability 列挙型:
  • ANYONE_CAN_ACCESS
  • DOMAIN_USERS_ONLY
グループの作成 createGroupsAccessLevel 列挙型:
  • ADMIN_ONLY
  • USERS_IN_DOMAIN
  • ANYONE_CAN_CREATE
グループ オーナーは外部メンバーを許可できる ownersCanAllowExternalMembers ブール値
グループ オーナーは組織外からのメールの受信を許可できる ownersCanAllowIncomingMailFromPublic ブール値
スレッドのデフォルトの閲覧権限 viewTopicsDefaultAccessLevel 列挙型:
  • OWNERS
  • MANAGERS
  • GROUP_MEMBERS
  • DOMAIN_USERS
  • ANYONE_CAN_VIEW_TOPICS
グループ オーナーはグループをディレクトリに表示しないようにできる ownersCanHideGroups ブール値
新たに作成されたグループをディレクトリに表示しない newGroupsAreHidden ブール値
管理コンソールのページ 管理コンソールの特定の設定 Policy API の設定タイプ 変更に対応 管理コンソールのキャプション Policy API のフィールド名 データ型
アカウント設定 共有オプション cloud_sharing_options.cloud_data_sharing × Google Cloud Platform の共有オプション sharingOptions 列挙型:
  • UNSUPPORTED
  • ENABLED
  • DISABLED

Marketplace の設定

管理コンソールのページ 管理コンソールの特定の設定 Policy API の設定タイプ 変更に対応 管理コンソールのキャプション Policy API のフィールド名 データ型
アプリのリスト アプリのリスト workspace_marketplace.apps_allowlist × すべての組織部門のユーザーのアプリを表示しています アプリ AppsAllowlistSetting[]
設定 アプリへのアクセスを管理する > Google Workspace Marketplace の許可リストへのアクセスを管理する workspace_marketplace.apps_access_options × ユーザーに実行とインストールを許可する Marketplace アプリを選択します。 access_level 列挙型:
  • ALLOW_ALL
  • ALLOW_LISTED_APPS
  • ALLOW_NONE

Marketplace のサブ設定

Policy API のサブ設定名 管理コンソールのキャプション Policy API のフィールド名 データ型
AppsAllowlistSetting なし application_id 文字列
なし アクセス 列挙型:
  • ALLOWED
  • BLOCKED

API レスポンスの workspace_marketplace.apps_allowlist 設定では、application_name ではなく Marketplace の application_id が公開されます。次の Python スクリプトを使用すると、コマンドラインで指定された 1 つ以上の application_id を application_name に変換できます。

import re
import requests
import sys

output = {}
app_ids = sys.argv[1:]

for id in app_ids:
  url = f"https://workspace.google.com/marketplace/app/_/{id}"
  response = requests.get(url, allow_redirects=False)
  final_url = response.headers['Location']
  pattern = f"^https://workspace.google.com/marketplace/app/(.*)/{id}$"
  a = re.search(pattern, final_url)
  output[id] = a.group(1)

# Output application name captured from returned URL
print(output)

Meet の設定

管理コンソールのページ 管理コンソールの特定の設定 Policy API の設定タイプ 変更に対応 管理コンソールのキャプション Policy API のフィールド名 データ型
Google Meet [Meet の動画設定] > [録画] meet.video_recording × ユーザーに会議の録画を許可します。 enable_recording ブール値
[Meet の動画設定] > [自動文字起こし] meet.automatic_transcription × 会議の発言をデフォルトで文字起こしする 有効 ブール値
[Meet の動画設定] > [自動録画] meet.automatic_recording × 会議をデフォルトで録画する 有効 ブール値
[Meet の安全に関する設定] > [ドメイン] meet.safety_domain × 組織内で作成された会議に参加できるユーザー。 users_allowed_to_join 列挙型:
  • SAME_ORGANIZATION_ONLY
  • LOGGED_IN
  • ALL
[Meet の安全に関する設定] > [アクセス] meet.safety_access × 組織内のユーザーが参加できる会議または通話。[着信制限] を使うと、ユーザーによる通話の着信をより詳細に制限できます。 meetings_allowed_to_join 列挙型:
  • SAME_ORGANIZATION_ONLY
  • ANY_WORKSPACE_ORGANIZATION
  • ALL
[Meet の安全に関する設定] > [主催者向けの管理機能] meet.safety_host_management × 主催者向けのデフォルトの管理機能 enable_host_management ブール値
[Meet の安全に関する設定] > [外部の参加者に関する警告] meet.safety_external_participants × 「組織」の外部にいるか、身元が確認されていない参加者を示します。 enable_external_label ブール値
[Meet の安全に関する設定] > [参加] meet.joining × 会議のアクセスタイプ([ドメイン] で設定された制限が適用されます) allowed_audience 列挙型:
  • ALLOWED_AUDIENCE_UNSPECIFIED
  • OPEN
  • TRUSTED
  • RESTRICTED
[Meet の安全に関する設定] > [チャット] meet.messaging × 会議中にチャット メッセージを送信できるユーザー 有効 ブール値
[Meet の安全に関する設定] > [画面を共有] meet.presenting × 会議中に画面を共有できるユーザー。 有効 ブール値
[Meet の安全に関する設定] > [Q&A] meet.questions × 会議中に Q&A に参加できるユーザー 有効 ブール値
[Meet の安全に関する設定] > [アンケート] meet.polls × 会議中にアンケートに参加できるユーザー 有効 ブール値
[Meet の安全に関する設定] > [着信制限] meet.meet_incoming_call_restrictions × この設定は Meet の通話にのみ適用されます。以前のサービスや Google Chat の通話には適用されません。[アクセス] で制限を設定すれば、ユーザーが受けることのできる通話をさらに制限できます。 allowed_callers 列挙型:
  • ALLOWED_CALLERS_UNSPECIFIED
  • ALL
  • CONTACTS_AND_ORGANIZATION_ONLY
  • NONE

プロビジョニングの設定

管理コンソールのページ 管理コンソールの特定の設定 Policy API の設定タイプ v1beta1 でサポートされている mutate 管理コンソールのキャプション Policy API のフィールド名 データ型
アカウント設定 競合するアカウントの管理 provisioning.conflicting_accounts_management × 競合するアカウントを管理する方法を選択する オプション 列挙型:
  • OPTION_UNSPECIFIED
  • AUTOMATICALLY_SEND_INVITATIONS
  • REPLACE_CONFLICTING_ACCOUNT
  • PRESERVE_CONFLICTING_ACCOUNT
(指定した)日数、フォローアップ メールを毎日送信する automatic_invitations.invitation_count integer
選択したフォローアップ期間内にユーザーが招待を承諾しなかった場合 automatic_invitations.unaccepted_invitation_resolution_option 列挙型:
  • UNACCEPTED_INVITATION_RESOLUTION_OPTION_UNSPECIFIED
  • REPLACE_CONFLICTING_ACCOUNT_ON_NEXT_CREATION
  • PRESERVE_CONFLICTING_ACCOUNT_ON_NEXT_CREATION

ルールと検出機能の設定

このセクションでは、ルールと検出機能の設定について説明します。

データ保護ルールの設定

サポートされているアプリケーションのデータ保護ルールと検出機能を作成する方法の概要については、データ保護ルールを作成するをご覧ください。

管理コンソールのページ 管理コンソールの特定の設定 Policy API の設定タイプ 変更に対応 管理コンソールのキャプション Policy API のフィールド名 データ型
データ保護 [セキュリティ] > [アクセスとデータ管理] > [データ保護] > [ルールを管理] rule.dlp ○ 名前 display_name 文字列
説明 説明 文字列
アプリ トリガー string[] - アプリケーション固有のトリガー文字列のリスト。モニタリングするトリガーを 1 つ以上指定します。指定されたトリガーのいずれかが発生すると、ルールが評価されます。使用可能な値については、トリガーのセクションをご覧ください。
条件 condition 文字列 - ルールがスキャンするデータ条件の Common Expression Language(CEL)式。CEL 構文と一般的な例については、次の条件セクションをご覧ください。
操作 action Struct - 条件が満たされたときに実行するアプリ固有のアクションを表すネストされたオブジェクト。アプリトリガーごとに使用可能なアクションについては、次の「アクション」セクションをご覧ください。
状態 状態 列挙型:
  • ACTIVE
  • INACTIVE
作成済み create_time タイムスタンプ
最終更新 update_time タイムスタンプ
ルールタイプ固有のメタデータ rule_type_metadata 構造体 - ルールタイプ固有のメタデータを表すネストされたオブジェクト。データ保護ルールの場合、トリガーされたイベントの重大度が含まれます。

トリガー

次の表に、利用可能なプラットフォーム、アプリケーション、トリガーの一覧を示します。

プラットフォーム アプリケーション トリガー API 値
Google Workspace Gmail メッセージを送信しました google.workspace.gmail.email.v1.send
メッセージを受信しました google.workspace.gmail.email.v1.receive
Google ドライブ ドライブのファイル google.workspace.drive.file.v1.share
Google Chat メッセージを送信しました google.workspace.chat.message.v1.send
ファイルがアップロードされました google.workspace.chat.attachment.v1.upload
Chrome Chrome ファイルがアップロードされました google.workspace.chrome.file.v1.upload
ファイルをダウンロードしました google.workspace.chrome.file.v1.download
コンテンツを貼り付けました google.workspace.chrome.web_content.v1.upload
印刷されたコンテンツ google.workspace.chrome.page.v1.print
アクセスした URL google.workspace.chrome.url.v1.navigation
ChromeOS ChromeOS ファイル転送の制限 google.workspace.chromeos.file.v1.transfer

条件

データ条件を表すために、API は Common Expressions Language(CEL)式を使用します。各条件は {match source}.{content to scan for}({additional scan parameters}) のパターンに従います。たとえば、all_content.contains('apple') は、スキャンされたコンテンツ(ドライブのドキュメント、チャット メッセージなど)のいずれかに部分文字列 apple が含まれている場合に一致するデータ条件を表します。

一致ソース

管理コンソールで同じ名前の一致する設定に対応する、利用可能な一致ソースのリスト。

  • access_levels
  • all_content
  • all_headers
  • body
  • destination_type
  • destination_url
  • drive_enterprise_metadata
  • encryption_state
  • envelope_from
  • file_size_in_bytes
  • file_type
  • from_header
  • message_security_status
  • request_attributes
  • sender_header
  • source_chrome_context
  • source_url
  • source_url_category
  • subject
  • suggestion
  • target_user
  • title
  • to_header_recipients
  • url
  • url_category
スキャンするコンテンツ

管理コンソールで同じ名前の一致する設定に対応する、スキャン可能なコンテンツのリスト。

  • contains({string})
  • starts_with({string})
  • ends_with({string})
  • equals({string})
  • matches_dlp_detector({detector name}, {likelihood}, {minimum_match_count: {count}, minimum_unique_match_count: {count}})
    • 管理コンソールの [事前定義されたデータ型と一致する] オプションに対応しています。
    • {detector name} は、スキャン対象の事前定義されたデータ型を表します。これは、Sensitive Data Protection でサポートされている組み込みの infotype のいずれかです(https://cloud.google.com/sensitive-data-protection/docs/infotypes-reference、例: CREDIT_CARD_NUMBER、US_SOCIAL_SECURITY_NUMBER)。一部の新しい検出機能タイプは、この API ではサポートされておらず、指定するとエラーが返されます。
    • {likelihood} は、一致の可能性のしきい値を表します。たとえば、google.privacy.dlp.v2.Likelihood.LIKELY は、管理コンソールの [高] のしきい値に対応します。
  • matches_regex_detector({detector name}, {minimum_match_count: {count}})
    • 管理コンソールの [正規表現と一致する] オプションに対応しています。
    • {detector name} は、正規表現検出機能を表すポリシーのリソース名です。API で検出機能ポリシーをクエリする方法については、データ保護検出機能のセクションをご覧ください。
  • matches_word_list({detector name}, {minimum_match_count: {count}, minimum_unique_match_count: {count}})
    • 管理コンソールの [単語リスト内の単語に一致する] オプションに対応しています。
    • {detector name} は、単語リスト検出機能を表すポリシーのリソース名です。API で検出機能ポリシーをクエリする方法については、データ保護検出機能のセクションをご覧ください。
  • matches_web_category({category})
    • Chrome の [アクセスした URL] トリガーの管理コンソールの [URL のカテゴリが一致する] オプションに対応しています。
    • {category} は、管理コンソールの構成でサポートされている URL カテゴリを示します。使用可能なカテゴリとその API 表現の一覧については、URL カテゴリをご覧ください。
  • contains_word({string})
    • コンテンツに {string} が単語全体として含まれている場合に一致します。
  • matches_file_extension({extension})
    • ファイル拡張子が {extension} の場合に一致します。
  • matches_mime_types({categories}, {custom_types})
    • ファイルの MIME タイプが、指定された {categories} または {custom_types} のいずれかに属している場合に一致します。
  • matches_metadata({metadata_criteria})
    • ドライブのラベルで定義された {metadata_criteria} に基づいてドライブのファイルを照合します。
  • matches_enum({enum_value})
    • 列挙型ベースのフィールドを {enum_value} と照合します。例: encryption_state.matches_enum('ENCRYPTED')
  • matches_url_list({url_list_id})
    • URL が指定された URL リスト {url_list_id} に存在する場合に一致します。
  • matches_url_risk_level({risk_level})
    • URL のリスクレベルが {risk_level} の場合に一致します。
  • matches_address({email})
    • メールアドレスが {email} の場合に一致します。
  • matches_address_domain_name({domain})
    • メールアドレスのドメインが {domain} の場合に一致します。
  • matches_address_regex({regex})
    • メールアドレスが正規表現 {regex} と一致する場合に一致します。
複合条件

複数の基本条件を AND(&&)、OR(||)、NOT(!)演算子と組み合わせて、複合条件を形成できます。たとえば、"all_content.contains('apple') && all_content.contains('banana')" は、スキャンされたコンテンツのいずれかに「apple」と「banana」の両方の部分文字列が含まれている場合に一致する条件を表します。

ルールの CEL 式の構文

ルールのロジックを定義する Common Expression Language(CEL)式は、Rule リソースの condition フィールドにあります。このフィールドは通常、google.type.Expr メッセージで、CEL 式は expression フィールドまたは cel_expression フィールドにあります。

有効なルールを作成するには、ターゲットとする特定のアプリケーション、トリガー イベント、一致ソースでサポートされている CEL 関数を使用する必要があります。

次の表に、データ保護(DLP)ルールの各アプリケーションとトリガーで使用可能な一致ソースと条件関数を示します。

アプリケーション トリガー イベント 一致元 使用可能な CEL 条件関数
Gmail メッセージを送信しました
メッセージを受信しました
all_content、body、subject、all_headers contains({string})
contains_word({string})
matches_regex_detector({detector name}, {minimum_match_count: {count}})
matches_dlp_detector({detector name}, {likelihood}, {minimum_match_count: {count}, minimum_unique_match_count: {count}})
matches_word_list({detector name}, {minimum_match_count: {count}, minimum_unique_match_count: {count}})
file_name contains({string})
contains_word({string})
file_extension matches_file_extension({extension})
file_type matches_mime_types({categories}, {custom_types})
drive_enterprise_metadata matches_metadata({metadata_criteria})
message_security_status matches_enum({enum_value})(例: 'CONFIDENTIAL_MODE_ENABLED')
ドライブ ドライブのファイル all_content、body contains({string})
matches_regex_detector({detector name}, {minimum_match_count: {count}})
matches_dlp_detector({detector name}, {likelihood}, {minimum_match_count: {count}, minimum_unique_match_count: {count}})
matches_word_list({detector name}, {minimum_match_count: {count}, minimum_unique_match_count: {count}})
title contains({string})
contains_word({string})
ends_with({string})
starts_with({string})
matches_regex_detector({detector name}, {minimum_match_count: {count}})
matches_dlp_detector({detector name}, {likelihood}, {minimum_match_count: {count}, minimum_unique_match_count: {count}})
matches_word_list({detector name}, {minimum_match_count: {count}, minimum_unique_match_count: {count}})
suggestion contains({string})
contains_word({string})
matches_regex_detector({detector name}, {minimum_match_count: {count}})
matches_dlp_detector({detector name}, {likelihood}, {minimum_match_count: {count}, minimum_unique_match_count: {count}})
matches_word_list({detector name}, {minimum_match_count: {count}, minimum_unique_match_count: {count}})
file_name contains({string})
contains_word({string})
file_extension matches_file_extension({extension})
file_type matches_mime_types({categories}, {custom_types})
drive_enterprise_metadata matches_metadata({metadata_criteria})
encryption_state matches_enum({enum_value})(例: 'ENCRYPTED')
チャット メッセージを送信しました
ファイルをアップロードしました
all_content contains({string})
matches_regex_detector({detector name}, {minimum_match_count: {count}})
matches_dlp_detector({detector name}, {likelihood}, {minimum_match_count: {count}, minimum_unique_match_count: {count}})
matches_word_list({detector name}, {minimum_match_count: {count}, minimum_unique_match_count: {count}})
ファイルのアップロードのみ file_name contains({string})
contains_word({string})
file_extension matches_file_extension({extension})
file_type matches_mime_types({categories}, {custom_types})
Chrome ファイルのアップロード
ファイルのダウンロード
コンテンツの貼り付け
コンテンツの印刷
all_content、body contains({string})
contains_word({string})
matches_regex_detector({detector name}, {minimum_match_count: {count}})
matches_dlp_detector({detector name}, {likelihood}, {minimum_match_count: {count}, minimum_unique_match_count: {count}})
matches_word_list({detector name}, {minimum_match_count: {count}, minimum_unique_match_count: {count}})
ファイルのアップロード
ファイルのダウンロード
コンテンツの印刷
title contains({string})
contains_word({string})
ends_with({string})
starts_with({string})
matches_regex_detector({detector name}, {minimum_match_count: {count}})
matches_dlp_detector({detector name}, {likelihood}, {minimum_match_count: {count}, minimum_unique_match_count: {count}})
matches_word_list({detector name}, {minimum_match_count: {count}, minimum_unique_match_count: {count}})
すべての Chrome トリガー url、source_url contains({string})
ends_with({string})
starts_with({string})
matches_regex_detector({detector name}, {minimum_match_count: {count}})
matches_word_list({detector name}, {minimum_match_count: {count}, minimum_unique_match_count: {count}})
matches_url_list({url_list_id})
(注: url は matches_url_risk_level({risk_level}) もサポートしています)
url_category、source_url_category matches_web_category({category})
file_type matches_mime_types({categories}, {custom_types})
file_size_in_bytes 標準的な比較演算子(例: all_content.file_size_in_bytes > 1048576)
web_app_signed_in_account、source_web_app_signed_in_account matches_address({email})
matches_address_domain_name({domain})
matches_address_regex({regex})
コンテンツの貼り付けのみ source_chrome_context matches_enum({enum_value})(値: 'CLIPBOARD'、'INCOGNITO'、'OTHER_PROFILE')
ChromeOS ファイル転送の制限 all_content、body contains({string})
contains_word({string})
matches_regex_detector({detector name}, {minimum_match_count: {count}})
matches_dlp_detector({detector name}, {likelihood}, {minimum_match_count: {count}, minimum_unique_match_count: {count}})
matches_word_list({detector name}, {minimum_match_count: {count}, minimum_unique_match_count: {count}})
title contains({string})
contains_word({string})
ends_with({string})
starts_with({string})
matches_regex_detector({detector name}, {minimum_match_count: {count}})
matches_dlp_detector({detector name}, {likelihood}, {minimum_match_count: {count}, minimum_unique_match_count: {count}})
matches_word_list({detector name}, {minimum_match_count: {count}, minimum_unique_match_count: {count}})
file_type matches_mime_types({categories}, {custom_types})
file_size_in_bytes 標準的な比較演算子

操作

各アプリケーションは、ネストされたメッセージでデータ条件が一致した場合に実行するアクションを指定します。たとえば、{ "driveAction" { "warnUser" { } } } は、外部共有時にユーザーに警告するドライブ アクションを表します。アプリケーション固有のアクションは次のとおりです。

アプリケーション アクションキー サブアクション 管理コンソールのキャプション
ドライブ driveAction blockAccess 外部共有をブロック
warnUser 外部との共有を警告する
auditOnly no action
restrictCopyPrintDownload ダウンロード、印刷、コピーの無効化
applyLabels 分類ラベルを適用
Gmail gmailAction blockContent メッセージをブロック
warnUser ユーザーに警告
auditOnly 監査のみ
quarantineMessage メールを検疫
applyLabels 分類ラベルを適用
addFooter カスタムメモ(フッター)を追加
チャット chatAction blockContent メッセージをブロック
warnUser ユーザーに警告
auditOnly 監査のみ
Google Chrome chromeAction blockContent ブロック
warnUser 許可して警告を表示
ChromeOS chromeOsAction blockContent ブロック
warnUser 許可して警告を表示
auditOnly 監査のみ

アクション パラメータ

アクション パラメータは、ルール アクションの追加構成を提供します。使用可能なパラメータはアプリケーションによって異なります。

アクション パラメータの設定例

次の例は、Chrome blockContent アクションのアクション パラメータを指定して、証拠ロッカー(saveContent)を有効にし、透かしメッセージ(watermarkMessage)を設定する方法を示しています。これは、API で使用される一般的な Struct 表現を使用します。

fields {
  key: "action"
  value {
    struct_value {
      fields {
        key: "chromeAction"
        value {
          struct_value {
            fields {
              key: "blockContent"
              value {
                struct_value {
                  fields {
                    key: "actionParams"
                    value {
                      struct_value {
                        fields {
                          key: "saveContent"
                          value {
                            bool_value: true
                          }
                        }
                        fields {
                          key: "watermarkMessage"
                          value {
                            string_value: "CONFIDENTIAL"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}

ドライブ アクション パラメータ

ドライブ アクションは通常、追加のパラメータを受け取りません。ただし、restrictCopyPrintDownload アクションではスコープを指定する必要があります。

パラメータ データ型 説明
restrict_copy_print_download.scope enum ダウンロード、印刷、コピーを無効にするユーザーのスコープを指定します。
  • SCOPE_UNSPECIFIED: スコープが指定されていません。
  • VIEWERS_AND_COMMENTERS: 閲覧者とコメント投稿者に対して無効にします。
  • ALL_COLLABORATORS: すべての共同編集者(閲覧者、コメント投稿者、編集者、オーナー)に対して無効にします。

Gmail アクション パラメータ

パラメータ データ型 説明
apply_internal_messages ブール値 内部メッセージにアクションを適用します。
apply_external_messages ブール値 外部メッセージにアクションを適用します。
apply_to_internal_receive_messages ブール値 内部で受信したメールにアクションを適用します。
apply_to_external_receive_messages ブール値 外部から受信したメールにアクションを適用します。
custom_end_user_message.unsafe_html_message_body 文字列 ルールがトリガーされたときにエンドユーザーに表示する HTML メッセージのコンテンツ。<a> タグのみがサポートされています。
add_footer.footer.title 文字列 カスタムメモのタイトル(最大 50 文字)。
add_footer.footer.unsafe_html_message_body 文字列 カスタムメモの HTML 説明テキスト。<a> タグのみがサポートされています(最大 300 文字)。
add_footer.footer.banner_highlighted ブール値 カスタムメモをバナーでハイライト表示するかどうか。
add_footer.footer.position enum メッセージ内のカスタムメモの位置(TOP または BOTTOM)。
apply_labels.label_delta Struct[] 適用するラベル変更のリスト。各オブジェクトには次のものが含まれます。
  • label_id: 文字列
  • field_delta: 次のフィールドを含む構造体。
    • field_id: 文字列
    • selection: 文字列(単一選択フィールドの場合)
    • selection_list: operation(SET、MERGE)と values(string[])を含む構造体
apply_labels.conflict_resolution_strategy enum 競合を解決するための戦略: SYSTEM_OVERRIDE または ALLOW_USER_OVERRIDE。
apply_labels.custom_end_user_message.unsafe_html_message_body 文字列 ラベル適用アクションがトリガーされたときにエンドユーザーに表示する HTML メッセージの内容。<a> タグのみがサポートされています。
quarantine_message.quarantine_resource_name 文字列 検疫のリソース名。形式は quarantines/obfuscated<id> または quarantines/default です。

チャット アクション パラメータ

パラメータ データ型 説明
apply_internal_direct_messages ブール値 内部の 1 対 1 のダイレクト メッセージを使用して送信されたメッセージにアクションを適用します。
apply_external_direct_messages ブール値 外部の 1 対 1 のダイレクト メッセージを使用して送信されたメッセージにアクションを適用します。
apply_internal_rooms ブール値 内部のルームに送信されたメッセージにアクションを適用します。
apply_external_rooms ブール値 外部のスペースに送信されたメッセージにアクションを適用します。
apply_internal_group_chats ブール値 内部グループ チャットに送信されたメッセージにアクションを適用します。
apply_external_group_chats ブール値 外部グループ チャットに送信されたメッセージにアクションを適用します。
custom_end_user_message.unsafe_html_message_body 文字列 ルールがトリガーされたときにエンドユーザーに表示する HTML メッセージのコンテンツ。<a> タグのみがサポートされています。

Google Chrome のアクション パラメータ

パラメータ データ型 説明
save_content ブール値 このルールをトリガーするコンテンツを安全に保存(Evidence Locker)できるようにします。
watermark_message 文字列 URL ナビゲーション ルールがトリガーされたときに透かしとして表示されるテキスト。
custom_end_user_message.unsafe_html_message_body 文字列 ルールがトリガーされたときにエンドユーザーに表示する HTML メッセージのコンテンツ。<a> タグのみがサポートされています。
block_screenshot ブール値 true に設定すると、スクリーンショットと画面共有がブロックされます。
match_only_download_url ブール値 タブの URL を無視して、ダウンロード URL のみに基づいてルールを評価します。
force_save_to_cloud_sub_action.destination enum ローカル ファイル システムの代わりに強制保存に使用する Cloud Storage の保存先。
  • DESTINATION_UNSPECIFIED: 宛先が指定されていません。
  • GOOGLE_DRIVE_CORP: ファイルを企業の Google ドライブに保存します。
  • ONEDRIVE_CORP: 企業の Microsoft OneDrive にファイルを保存します。
data_masking.regex_detector Struct[] データ マスキングに使用される正規表現検出機能のリスト。1 つ以上の検出機能をオブジェクトのリストとして指定します。各オブジェクトには、次の表に示すフィールドが含まれます。
data_masking.regex_detector[].mask_type enum 正規表現が一致した場合に適用するマスキングのタイプ。
  • MASK_TYPE_LIGHT_OBFUSCATION: マスクされたテキストは、ポインタを合わせると表示されます。
  • MASK_TYPE_HARD_OBFUSCATION: マスクされたテキストは、マウスをクリックすると表示されます。
  • MASK_TYPE_REDACT: テキストは完全に置き換えられ、復元できません。
data_masking.regex_detector[].resource_name 文字列 検出機能リソースの ID。
data_masking.regex_detector[].display_name 文字列 トリガーされたときにレポートツール(セキュリティ調査ツールなど)に表示される検出機能の名前。
data_masking.regex_detector[].regex_pattern 文字列 照合に使用される正規表現パターン。このフィールドはシステムによって入力されるため、ユーザーが設定することはできません。

ChromeOS アクション パラメータ

パラメータ データ型 説明
save_content ブール値 このルールをトリガーするコンテンツを安全に保存できるようにします。

ルールタイプ固有のメタデータ

この属性には、ルールタイプに固有のメタデータが含まれます。データ保護ルールの場合、イベントがセキュリティ ダッシュボードとアラート センターで報告されるときのアラート イベントの重大度が含まれます。アラートの重大度が LOW であることを表すメタデータ値の例:

fields {
  key: "ruleTypeMetadata"
  value {
    struct_value {
      fields {
        key: "dlpRuleMetadata"
        value {
          struct_value {
            fields {
              key: "alertSeverity"
              value {
                string_value: "LOW"
              }
            }
          }
        }
      }
    }
  }
}

データ保護検出機能の設定

データ保護ルールと検出機能の概要については、ドライブの DLP ルールとカスタム コンテンツ検出項目を作成するをご覧ください。

管理コンソールのページ 管理コンソールの特定の設定 Policy API の設定タイプ 変更に対応 管理コンソールのキャプション Policy API のフィールド名 データ型
データ保護 [セキュリティ] > [アクセスとデータ管理] > [データ保護] > [検出機能を管理] detector.regular_expression detector.word_list detector.url_list ○ 名前 display_name 文字列
説明 説明 文字列
正規表現 regular_expression Struct - 正規表現文字列が含まれます。検出機能のタイプが detector.regular_expression の場合にのみ設定します。
単語リスト word_list Struct - 単語文字列のリストが含まれます。検出機能のタイプが detector.word_list の場合にのみ設定します。
URL リスト url_list 構造体 - URL 文字列のリストが含まれます。検出機能のタイプが detector.url_list の場合にのみ設定します。
作成済み create_time タイムスタンプ
最終更新 update_time タイムスタンプ

システム定義のアラートルールの設定

このセクションでは、Google Workspace のシステム定義のアラートルールについて説明します。

管理コンソールのページ 管理コンソールの特定の設定 Policy API の設定タイプ 変更に対応 管理コンソールのキャプション Policy API のフィールド名 データ型
データ保護 ルール(「システム定義」ルールタイプの場合) rule.system_defined_alerts × 名前 display_name 文字列
説明 説明 文字列
操作 action Struct - システム定義のアラートがトリガーされたときの通知設定を表すネストされたオブジェクト。詳細については、次の「アクション」セクションをご覧ください。
状態 状態 列挙型:
  • ACTIVE
  • INACTIVE
作成済み create_time タイムスタンプ
最終更新 update_time タイムスタンプ

アクション

システム定義のアラートルールには、アラートの通知設定を示す単一のアクションがあります。

アクションキー サブアクション 管理コンソールのキャプション 説明
alertCenterAction alertCenterConfig アラート センターに送信する アラートの重大度と、アラートをアラート センターに送信するかどうかを構成します。
受信者 メール通知を送信する アラートがトリガーされたときに通知を送信するメールアドレスのリスト。

アクション パラメータ

次の表に、alertCenterAction のパラメータを示します。

パラメータ データ型 説明
alertCenterConfig.severity enum アラートの重大度(LOW、MEDIUM、HIGH など)。
alertCenterConfig.status enum アラートがアラート センターに送信されるかどうか(例: ENABLED、DISABLED)。
recipients string[] メール通知を受信するメールアドレスのリスト。

セキュリティの設定

管理コンソールのページ 管理コンソールの特定の設定 Policy API の設定タイプ 変更に対応 管理コンソールのキャプション Policy API のフィールド名 データ型
アカウント復元 特権管理者アカウントの復元 security.super_admin_account_recovery × 特権管理者が自分でアカウントを復元できるようにする enableAccountRecovery ブール値
ユーザー アカウントの復元 security.user_account_recovery × ユーザーおよび特権管理者ではない管理者が自分でアカウントを復元できるようにする enableAccountRecovery ブール値
パスワードの管理 パスワード マネージャー security.password × 有効期限 expirationDuration 秒 (0 秒は期限なしを意味します)
再利用 allowReuse ブール値
長さと安全度の適用 enforceRequirementsAtLogin ブール値
長さ(最大長) maximumLength integer
長さ(最小長) minimumLength integer
長所 allowedStrength 列挙型:
  • STRONG
  • WEAK
Google セッションの管理 セッション管理 security.session_controls × ウェブ セッション継続期間 webSessionDuration 数秒
安全性の低いアプリ 安全性の低いアプリ security.less_secure_apps × 安全性の低いログイン技術を使用しているためアカウントの危険性を高めているアプリへのユーザー アクセスを制御します。 allowLessSecureApps ブール値
ログイン時の本人確認 ログイン時の本人確認 security.login_challenges × ユーザーのセキュリティ強化のために従業員の ID を使用します enableEmployeeIdChallenge ブール値
パスワードレス パスキーの制限 security.passkeys_restriction × ユーザーがログインに使用できるパスキーのタイプを選択する allowed_passkeys_type 列挙型:
  • ALLOWED_PASSKEYS_TYPE_UNSPECIFIED
  • HARDWARE_SECURITY_KEYS_ONLY
  • ANY_DEVICE_OR_PLATFORM
高度な保護機能プログラム 登録 security.advanced_protection_program × ユーザーのセキュリティ強化のために従業員の ID を使用します enableAdvancedProtectionSelfEnrollment ブール値
セキュリティ コード securityCodeOption 列挙型:
  • ALLOWED_WITH_REMOTE_ACCESS
  • ALLOWED_WITHOUT_REMOTE_ACCESS
  • CODES_NOT_ALLOWED
2 段階認証プロセス Authentication security.two_step_verification_enrollment × ユーザーが 2 段階認証プロセスを有効にできるようにする allowEnrollment ブール値
security.two_step_verification_enforcement 違反措置 enforcedFrom タイムスタンプ
security.two_step_verification_grace_period 新規ユーザーの登録期間 enrollmentGracePeriod 所要時間
security.two_step_verification_device_trust ユーザーがデバイスを信頼することを許可する allowTrustingDevice ブール値
security.two_step_verification_enforcement_factor メソッド allowedSignInFactorSet 列挙型:
  • ALL
  • PASSKEY_ONLY
  • PASSKEY_PLUS_SECURITY_CODE
  • PASSKEY_PLUS_IP_BOUND_SECURITY_CODE
  • NO_TELEPHONY
security.two_step_verification_sign_in_code 2 段階認証プロセスのポリシーの停止猶予期間 backupCodeExceptionPeriod 所要時間
複数の関係者による承認の設定 複数の関係者による承認の設定 multi_party_approval.require_approvals × 複数の関係者による承認権限を持つ管理者が、管理コンソールと Admin API で行われる機密情報に関する操作を承認する必要があるかどうかを選択します。 multi_party_approval_state 列挙型:
  • MULTI_PARTY_APPROVAL_STATE_UNSPECIFIED
  • ENABLED
  • DISABLED
セキュリティ設定の複数の関係者による承認 multi_party_approval.security_actions × 2 段階認証プロセス two_step_verification_multi_party_approval_state
アカウント復元 account_recovery_multi_party_approval_state
Google セッションの管理 session_controls_multi_party_approval_state
高度な保護機能プログラム advanced_protection_program_multi_party_approval_state
ログイン時の本人確認 login_challenges_multi_party_approval_state
パスワードレス passwordless_multi_party_approval_state
ドメイン全体の委任 domain_wide_delegation_multi_party_approval_state
サードパーティの IdP による SSO sso_with_third_party_idps_multi_party_approval_state
コンテキストアウェア アクセス context_aware_access_multi_party_approval_state
セキュリティ設定への API アクセスに関する、複数の関係者による承認 multi_party_approval.security_actions_api_access × サードパーティの IdP による SSO sso_with_third_party_idps_multi_party_approval_state
カレンダー設定に対する複数の関係者による承認 multi_party_approval.calendar_actions × カレンダーの共有 calendar_sharing_multi_party_approval_state
カレンダーの全般設定 general_calendar_settings_multi_party_approval_state
カレンダーのサードパーティによるアーカイブの設定 third_party_archiving_settings_multi_party_approval_state
グループ設定に対する複数の関係者による承認 multi_party_approval.groups_actions × グループの共有 groups_sharing_multi_party_approval_state
ドメイン管理者設定に対する複数の関係者による承認 multi_party_approval.domains_actions × Domains API domains_api_multi_party_approval_state

サービス ステータスの設定

service_status 設定には、特定の OrgUnit または Group でサービスが有効になっているかどうかを示すブール値が含まれています。

Policy API は、管理コンソールに表示される Google Workspace、その他の Google サービス、生成 AI サービスのサービス ステータス設定をサポートしています。

Google Workspace

管理コンソールでのサービス名 Policy API のサービス名
AppSheet appsheet
カレンダー カレンダー
Cloud Search cloud_search
ドライブとドキュメント drive_and_docs
Gmail gmail
Google Chat チャット
Google Meet meet
Google Vault Vault
Google Voice 音声
ビジネス向け Google グループ groups_for_business
Keep keep
Google サイト Google サイト
ToDo リスト ToDo リスト

その他の Google サービス

管理コンソールでのサービス名 Policy API のサービス名
AI Studio ai_studio
応用デジタルスキル applied_digital_skills
割り当て 割り当て
Blogger blogger
ブランド アカウント brand_accounts
キャンペーン マネージャー 360 campaign_manager
Chrome 描画キャンバス chrome_canvas
Chrome 手書きメモ chrome_cursive
Chrome リモート デスクトップ chrome_remote_desktop
Chrome ウェブストア chrome_web_store
Classroom classroom
CS First cs_first
Currents currents
早期アクセスアプリ early_access_apps
試験運用版アプリ experimental_apps
FeedBurner feedburner
Google アド マネージャー ad_manager
Google 広告 広告
Google AdSense adsense
Google アラート アラート
Google アナリティクス 分析
Google Arts & Culture arts_and_culture
Google ブックマーク bookmarks
Google ブックス ブックス
Google Chrome 同期 chrome_sync
Google Cloud cloud
Google クラウド プリント cloud_print
Google Colab Colab
Google Developers デベロッパー
Google Domains ドメイン
Google Earth earth
Google Fi fi
Google グループ グループ
Google マップ マップ
Google メッセージ 新しいメッセージを投稿できます。
Google マイビジネス my_business
Google マイマップ my_maps
Google ニュース ニュース
Google Pay pay
Google フォト photos
Google Play play
Google Play Console play_console
Google 公共データ エクスプローラ public_data
Google Read Along read_along
Google Search Console search_console
Google データ エクスポート データ エクスポート
Google 翻訳 translate
Google Trips 旅行
Jamboard jamboard
ロケーション履歴 location_history
データポータル data_studio
managed Google Play managed_play
Material Gallery material_gallery
Merchant Center merchant_center
Partner Dash partner_dash
Pinpoint pinpoint
Google Play ブックス パートナー センター play_books_partner_center
プログラム可能検索エンジン programmable_search_engine
QuestionHub question_hub
Scholar プロフィール scholar_profiles
検索広告 360 search_ads_360
検索とアシスタント search_and_assistant
Socratic socratic
スタジオ スタジオ
サードパーティ製アプリのバックアップ third_party_app_backups
ツアー クリエイター tour_creator
ワーク インサイト work_insights
YouTube youtube

生成 AI

管理コンソールでのサービス名 Policy API のサービス名
Gemini アプリ gemini_app
NotebookLM notebooklm

サイト設定

管理コンソールのページ 管理コンソールの特定の設定 Policy API の設定タイプ 変更に対応 管理コンソールのキャプション Policy API のフィールド名 データ型
Google サイト 新しい Google サイト > サイトの作成と編集 sites.sites_creation_and_modification × ユーザーに新しいサイトの作成を許可する allowSitesCreation ブール値
ユーザーがサイトを編集できる/できない allowSitesModification ブール値

UserTakeout の設定

管理コンソールのページ 管理コンソールの特定の設定 Policy API の設定タイプ 変更に対応 管理コンソールのキャプション Policy API のフィールド名 データ型
データ [データのインポートとエクスポート] > [Google データ エクスポート] > [Google サービスでのデータ エクスポートへのユーザー アクセス]
  • blogger.user_takeout
  • books.user_takeout
  • maps.user_takeout
  • pay.user_takeout
  • photos.user_takeout
  • play.user_takeout
  • play_console.user_takeout
  • location_history.user_takeout
  • youtube.user_takeout
× Google サービスにおけるデータ エクスポートへのユーザー アクセスを管理 takeout_status 列挙型:
  • TAKEOUT_STATUS_UNSPECIFIED
  • ENABLED
  • DISABLED