API で使用可能な設定

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

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

セキュリティの設定

管理コンソールのページ 管理コンソールの特定の設定 Policy API の設定タイプ 管理コンソールのキャプション Policy API のフィールド名 Data Type
アカウント復元 特権管理者アカウントの復元 security.super_admin_account_recovery 特権管理者が自分でアカウントを復元できるようにする enableAccountRecovery ブール値
ユーザー アカウントの復元 security.user_account_recovery ユーザーおよび特権管理者ではない管理者が自分でアカウントを復元できるようにする enableAccountRecovery ブール値
パスワードの管理 パスワードの管理 security.password 有効期限 expirationDuration 秒 (0 秒は期限なしを意味します)
再利用 allowReuse ブール値
長さと安全度の適用 enforceRequirementsAtLogin ブール値
長さ(最大長) maximumLength 整数
長さ(最小長) minimumLength 整数
長所 allowedStrength 列挙型:
  • STRONG
  • WEAK
Google セッションの管理 セッション管理 security.session_controls ウェブ セッション継続期間 webSessionDuration 数秒
安全性の低いアプリ 安全性の低いアプリ security.less_secure_apps 安全性の低いログイン技術を使用しているためアカウントの危険性を高めているアプリへのユーザー アクセスを制御します。 allowLessSecureApps ブール値
ログイン時の本人確認 ログイン時の本人確認 security.login_challenges ユーザーのセキュリティ強化のために従業員の ID を使用します enableEmployeeIdChallenge ブール値
高度な保護機能プログラム 登録 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 所要時間

UserTakeout の設定

管理コンソールのページ 管理コンソールの特定の設定 Policy API の設定タイプ 管理コンソールのキャプション Policy API のフィールド名 Data Type
データ [データのインポートとエクスポート] > [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

Marketplace の設定

管理コンソールのページ 管理コンソールの特定の設定 Policy API の設定タイプ 管理コンソールのキャプション Policy API のフィールド名 Data Type
アプリのリスト アプリのリスト workspace_marketplace.apps_allowlist すべての組織部門のユーザーのアプリを表示しています アプリ application_id とアクセス ステータス(許可またはブロック)を含むアプリのリスト。
設定 [アプリへのアクセスを管理] > [Google Workspace Marketplace の許可リストへのアクセスを管理] workspace_marketplace.apps_access_options ユーザーに実行とインストールを許可する Marketplace アプリを選択します。 access_level 列挙型:
  • ALLOW_ALL
  • ALLOW_LISTED_APPS
  • ALLOW_NONE

API レスポンスの設定 workspace_marketplace.apps_allowlist は、application_name ではなくマーケットプレイス application_id を公開します。次の Python スクリプトを使用すると、コマンドラインで指定された 1 つ以上の application_idapplication_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)

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

service_status 設定には、特定の OrgUnit または Group でサービスが有効であることを示すブール値が含まれます。

Policy API は、管理コンソールの [アプリ] に表示される Workspace サービスとその他のサービスの両方のサービス ステータスの設定をサポートしています。

管理コンソールのサービス名 Policy API のサービス名
カレンダー カレンダー
Cloud Search cloud_search
ドライブとドキュメント drive_and_editors
Currents currents
ビジネス向け Google グループ groups_for_business
Jamboard jamboard
Keep keep
Google Chat チャット
Google Meet meet
Google Voice 音声
Google サイト Google サイト
ToDo リスト ToDo リスト
Vault Vault
ワーク インサイト work_insights
AppSheet appsheet
応用デジタルスキル applied_digital_skills
割り当て 割り当て
Blogger blogger
ブランド アカウント brand_accounts
キャンペーン マネージャー 360 campaign_manager
Chrome 描画キャンバス chrome_canvas
Chrome リモート デスクトップ chrome_remote_desktop
Chrome ウェブストア chrome_web_store
Classroom classroom
CS First cs_first
試験運用版アプリ 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 旅行
ロケーション履歴 location_history
Looker Studio 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
YouTube youtube
追加サービス(個別のコントロールなし) enterprise_service_restrictions
Gemini アプリ gemini
早期アクセス アプリ early_access_apps
AI Studio ai_studio
Chrome 手書きメモ chrome_cursive
NotebookLM notebooklm

Gmail の設定

管理コンソールのページ 管理コンソールの特定の設定 Policy API の設定タイプ 管理コンソールのキャプション Policy API のフィールド名 Data Type
Gmail [ユーザー設定] > [機密モデル] gmail.confidential_mode 情報保護モードを有効にする enable_confidential_mode ブール値
[ユーザー設定] > [S/MIME] gmail.enhanced_smime_encryption 独自証明書のアップロードをユーザーに許可する allow_user_to_upload_certificates ブール値
特定のドメインに関する追加のルート証明書を受け入れてください: custom_root_certificates ルート証明書のリスト、中間 CA 証明書のリスト、制限付きドメイン名のリスト、アドレスの不一致を許可するブール値、さまざまな検証レベルの列挙型を含む CustomRootCertificates のリスト。
[迷惑メール、フィッシング、マルウェア] > [メール配信前のスキャンの強化] 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 整数
従業員名のなりすましに対する保護機能 detect_employee_name_spoofing ブール値
操作を選択 employee_name_spoofing_consequence 列挙型:
  • WARNING
  • SPAM_FOLDER
  • QUARANTINE
  • NO_ACTION
検疫の選択 employee_name_spoofing_quarantine_id 整数
受信メールによるドメインのなりすましに対する保護機能 detect_domain_spoofing_from_unauthenticated_senders ブール値
操作を選択 domain_spoofing_consequence 列挙型:
  • WARNING
  • SPAM_FOLDER
  • QUARANTINE
  • NO_ACTION
検疫の選択 domain_spoofing_quarantine_id 整数
未認証メールに対する保護機能 detect_unauthenticated_emails ブール値
操作を選択 unauthenticated_email_consequence 列挙型:
  • WARNING
  • SPAM_FOLDER
  • QUARANTINE
  • NO_ACTION
検疫の選択 unauthenticated_email_quarantine_id 整数
受信メールによるドメインのなりすましから 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 整数
今後のおすすめの設定を自動的に適用 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 整数
信頼できない送信者から送られる、スクリプトを含む添付ファイルに対する保護機能 enable_attachment_with_scripts_protection ブール値
操作を選択 attachment_with_scripts_protection_consequence 列挙型:
  • WARNING
  • SPAM_FOLDER
  • QUARANTINE
検疫の選択 attachment_with_scripts_protection_quarantine_id 整数
異常な種類の添付ファイルに対する保護 enable_anomalous_attachment_protection ブール値
操作を選択 anomalous_attachment_protection_consequence 列挙型:
  • WARNING
  • SPAM_FOLDER
  • QUARANTINE
検疫の選択 anomalous_attachment_protection_quarantine_id 整数
次の一般的でないファイル形式を許可リストに登録する 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.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.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 同期] gmail.workspace_sync_for_outlook ユーザーが Google Workspace Sync for Microsoft Outlook を使用できるようにする enable_google_workspace_sync_for_microsoft_outlook ブール値
[エンドユーザーのアクセス] > [自動転送] gmail.auto_forwarding 受信メールを別のメールアドレスに自動転送することをユーザーに許可する enable_auto_forwarding ブール値
[ユーザー設定] > [名前の形式] 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 ブール値
[エンドユーザー アクセス] > [画像 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 設定で参照される Gmail のサブ設定を示します。

Policy API のサブ設定名 管理コンソールのキャプション Policy API のフィールド名 Data Type
EmailAddressList なし id 文字列
名前 name 文字列
アドレスリストを追加 address_list AddressList
ブロックするアドレスのリストを追加 blocked_address_list AddressList
AddressList アドレスリストを追加する 住所 AddressListEntry[]
AddressListEntry 住所 住所 文字列
認証が必須(受信メールのみ) 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 整数
送信者が内部ユーザーの場合は迷惑メールフィルタを適用しない。 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 ブール値
上記の表現が一致する場合は、次の処理を行います consequence RuleConsequences
なし rule_id 文字列
ObjectionableContentRule 設定の概要に表示される短い説明を入力します 説明 文字列
影響を受けるメール condition RuleConditions
独自の不適切な単語 objectionable_content_defined ブール値
単語を入力する objectionable_words string[]
上記の表現が一致する場合は、次の処理を行います consequence RuleConsequences
なし rule_id 文字列
AttachmentComplianceRule 設定の概要に表示される短い説明を入力します 説明 文字列
影響を受けるメール condition RuleConditions
各メッセージで検索するコンテンツを表す表現を追加する match_expressions MatchExpression[]
次の一部がメールに一致する場合 match_any_expression ブール値
上記の表現が一致する場合は、次の処理を行います consequence 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_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
File name なし match_expression_type 列挙型: FILE_NAME
添付ファイル名に次を含む file_name 文字列
メッセージ サイズ なし match_expression_type 列挙型: MESSAGE_SIZE
メール全体(本文と添付ファイル)のサイズが次のサイズ(MB)より大きい message_size_threshold_in_megabytes 整数
AdvancedContentMatch 場所 ヘッダーと本文 advanced_content_match_location 列挙型: HEADERS_AND_BODY
完全なヘッダー 列挙型: FULL_HEADERS
本文 列挙型: BODY
Subject 列挙型: 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
等しい 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 整数
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 整数
メールが認証されている 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 整数
信頼度のしきい値 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 配送[]
配信 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 文字列

チャットの設定

管理コンソールのページ 管理コンソールの特定の設定 Policy API の設定タイプ 管理コンソールのキャプション Policy API のフィールド名 Data Type
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 ブール値

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

管理コンソールのページ 管理コンソールの特定の設定 Policy API の設定タイプ 管理コンソールのキャプション Policy API のフィールド名 Data Type
ドライブとドキュメント [共有設定] > [共有オプション] drive_and_docs.external_sharing $CUSTOMER_NAME の外部に許可する最大の共有レベルを選択する external_sharing_mode 列挙型:
  • DISALLOWED
  • ALLOWLISTED_DOMAINS
  • ALLOWED
$ORG_UNIT_NAME のユーザーが $CUSTOMER_NAME 外のユーザーまたは共有ドライブからファイルを受信できるようにする allow_receiving_external_files ブール値
$ORG_UNIT_NAME のユーザーまたは共有ドライブがオーナーとなっているファイルが許可リスト登録済みドメインのユーザーと共有されたときに警告する warn_for_sharing_outside_allowlisted_domains ブール値
許可リスト登録済みドメイン以外のユーザーまたは共有ドライブからのファイル受信を $ORG_UNIT_NAME のユーザーに許可する allow_receiving_files_outside_allowlisted_domains ブール値
$ORG_UNIT_NAME のユーザーまたは共有ドライブが、ビジターとの共有機能を使用して、信頼できるドメイン内の Google アカウントを持たないユーザーとアイテムを共有することを許可する allow_non_google_invites_in_allowlisted_domains ブール値
$ORG_UNIT_NAME のユーザーまたは共有ドライブがオーナーとなっているファイルが $CUSTOMER_NAME の外部で共有されたときに警告する warn_for_external_sharing ブール値
$ORG_UNIT_NAME のユーザーまたは共有ドライブが、Google アカウントを使用していない $CUSTOMER_NAME 外のユーザーとアイテムを共有することを許可する allow_non_google_invites ブール値
$CUSTOMER_NAME の外部との共有が許可されている場合、$ORG_UNIT_NAME 内のユーザーは、リンクを知っているすべてのユーザーに対して、ファイルおよび公開済みのウェブ コンテンツを公開することができます allow_publishing_files ブール値
ユーザーが Google ドキュメントや Google ドライブ以外の Google サービス経由でファイルを共有した場合(例: Gmail にリンクを貼り付ける)、共有相手にファイルへのアクセス権があるかどうかを確認できます。アクセス権が共有相手にない場合、次のユーザーとファイルを共有してよいかどうかの確認を求めるメッセージを表示します(可能な場合) access_checker_suggestions 列挙型:
  • RECIPIENTS_OR_AUDIENCE_OR_PUBLIC
  • RECIPIENTS_OR_AUDIENCE
  • RECIPIENTS_ONLY
$ORG_UNIT_NAME のコンテンツを $CUSTOMER_NAME の外部に送信できるユーザーを選択します。この設定を行うことで、別の組織が所有する共有ドライブにコンテンツをアップロード、移動できるユーザーを制限できます allowed_parties_for_distributing_content 列挙型:
  • ALL_ELIGIBLE_USERS
  • ELIGIBLE_INTERNAL_USERS
  • NONE
[共有設定] > [一般的なアクセスのデフォルト] drive_and_docs.general_access_default $ORG_UNIT_NAME 内のユーザーがアイテムを作成すると、デフォルトのアクセスは次のようになります default_file_access 列挙型:
  • PRIVATE_TO_OWNER
  • PRIMARY_AUDIENCE_WITH_LINK
  • PRIMARY_AUDIENCE_WITH_LINK_OR_SEARCH
[共有設定] > [共有ドライブの作成] drive_and_docs.shared_drive_creation $ORG_UNIT_NAME のユーザーが新しい共有ドライブを作成できないようにする allow_shared_drive_creation ブール値(API レスポンスは UI 値の反対を返します)
$ORG_UNIT_NAME 内のユーザーが作成した共有ドライブは、以下の組織部門に割り当てられます org_unit_for_new_shared_drives 列挙型:
  • CREATOR_ORG_UNIT
  • CUSTOM_ORG_UNIT
選択した組織部門 custom_org_unit String(文字列)
管理者権限を持つユーザーが、以下の設定をオーバーライドできるようになります allow_managers_to_override_settings ブール値
$CUSTOMER_NAME 外のユーザーが共有ドライブ内のファイルにアクセスできるようにする allow_external_user_access ブール値
共有ドライブのメンバー以外のユーザーに、ファイルの追加を許可します allow_non_member_access ブール値
閲覧者およびコメント可の閲覧者がファイルをダウンロード、印刷、コピーできるようになります allowed_parties_for_download_print_copy 列挙型:
  • ALL(UI のチェックボックスがオンの場合)
  • EDITORS_ONLY(UI のチェックボックスがオフの場合)
コンテンツ管理者にフォルダの共有を許可する 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 ブール値

Meet の設定

管理コンソールのページ 管理コンソールの特定の設定 Policy API の設定タイプ 管理コンソールのキャプション Policy API のフィールド名 Data Type
Google Meet [Meet の動画設定] > [録画] meet.video_recording ユーザーに会議の録画を許可します。 enable_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 ブール値

サイト設定

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

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

管理コンソールのページ 管理コンソールの特定の設定 Policy API の設定タイプ 管理コンソールのキャプション Policy API のフィールド名 Data Type
ビジネス向け 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_VIEE_TOPICS
グループ オーナーはグループをディレクトリに表示しないようにできる ownersCanHideGroups ブール値
新たに作成されたグループをディレクトリに表示しない newGroupsAreHidden ブール値
管理コンソールのページ 管理コンソールの特定の設定 Policy API の設定タイプ 管理コンソールのキャプション Policy API のフィールド名 Data Type
アカウント設定 共有オプション cloud_sharing_options.cloud_data_sharing Google Cloud Platform の共有オプション sharingOptions 列挙型:
  • UNSUPPORTED
  • ENABLED
  • DISABLED

Classroom の設定

管理コンソールのページ 管理コンソールの特定の設定 Policy API の設定タイプ 管理コンソールのキャプション Policy API のフィールド名 Data Type
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

カレンダーの設定

管理コンソールのページ 管理コンソールの特定の設定 Policy API の設定タイプ 管理コンソールのキャプション Policy API のフィールド名 Data Type
カレンダー [詳細設定] > [支払いを伴う予約スケジュール] 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

データ保護ルールの設定

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

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

トリガー

使用可能なアプリケーションとそのトリガーのリスト。

  • "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"
  • "google.workspace.chrome.url.v1.navigation"
  • "google.workspace.chromeos.file.v1.transfer"
  • "google.workspace.chat.message.v1.send"
  • "google.workspace.chat.attachment.v1.upload"
  • "google.workspace.drive.file.v1.share"
  • "google.workspace.gmail.email.v1.send"

条件

API は、データ条件を表すために Common Expressions Language(CEL)式を使用します。各条件は {content type}.{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
  • 件名
  • 提案
  • target_user
  • タイトル
  • 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} は、スキャンする事前定義されたデータ型を表します。これは、Cloud DLP でサポートされている組み込み infoType のいずれかです(https://cloud.google.com/sensitive-data-protection/docs/infotypes-reference)。たとえば、CREDIT_CARD_NUMBER や、US_SOCIAL_SECURITY_NUMBER です
    • {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 カテゴリをご覧ください。

複合条件

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

アクション

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

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

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

この属性には、ルールタイプに固有のメタデータが含まれます。データ保護ルールの場合、セキュリティ ダッシュボードとアラート センターでイベントが報告されたときのアラート イベントの重大度が含まれます。アラートの重大度が 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 のフィールド名 Data Type
データの保護 [セキュリティ] > [アクセスとデータ管理] > [データ保護] > [検出機能を管理] detector.regular_expression detector.word_list 名前 display_name String(文字列)
説明 説明 String(文字列)
正規表現 regular_expression 構造体 - 正規表現文字列が含まれます。検出機能のタイプが detector.regular_expression の場合にのみ設定します。
単語リスト word_list 文字列 - 単語文字列のリストが含まれます。検出機能のタイプが detector.word_list の場合にのみ設定します。
作成済み create_time タイムスタンプ
最終更新 update_time タイムスタンプ

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

このセクションでは、Google Workspace のシステム定義のアラートルールについて説明します。API は、管理者がデフォルト値から変更したシステム定義アラートのみ返します。

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

アクション

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

アクションキー サブアクション 管理コンソールのキャプション
alertCenterAction alertCenterConfig アラート センターに送信する
受信者 メール通知を送信する