API 提供的設定

本文說明 Policy API 支援的設定。

如果 Cloud Identity Policy API 回應中缺少支援的設定，請參閱「預設欄位值」。如果「預設欄位值」中未提及缺少的設定，請與 Cloud Customer Care 聯絡。

API 控制項

管理控制台頁面 管理控制台中的特定設定 Policy API 設定類型 支援 Mutate 管理控制台字幕 政策 API 欄位名稱 資料類型
API 控制項 設定 > 自訂使用者訊息 api_controls.custom_user_message 否 自訂訊息，在使用者因存取權設定而無法存取應用程式時向他們顯示。 error_text string
設定 > 未設定的第三方應用程式 api_controls.unconfigured_third_party_apps 否 未設定的第三方應用程式是指尚未完成存取權設定 (例如可信任、受限制或已封鎖) 的應用程式。
選取當使用者嘗試透過帳戶存取未設定的第三方應用程式時，系統要執行什麼動作。 		access_level enum:
  • ACCESS_LEVEL_UNSPECIFIED
  • BLOCK_ALL
  • ALLOW_SIGN_IN_ONLY
設定 > 未設定的第三方應用程式 api_controls.unconfigured_third_party_apps 否 未設定的第三方應用程式是指尚未完成存取權設定 (例如可信任、受限制或已封鎖) 的應用程式。
選取當未滿 18 歲的使用者嘗試透過帳戶存取未設定的第三方應用程式時，系統要執行什麼動作。 		access_level_under18 enum:
  • ACCESS_LEVEL_UNSPECIFIED
  • ALLOW_SIGN_IN_ONLY
設定 > 內部應用程式 api_controls.internal_apps 否 貴機構擁有的內部應用程式會自動設為信任的應用程式。這類應用程式可以要求透過 API 存取使用者所有的 Google 資料。 trust_internal_apps boolean
設定 > 使用者要求存取未設定的應用程式 api_controls.app_approval_requests 否 允許使用者要求存取未設定的第三方應用程式 allowed_for_all enum:
  • OPTION_UNSPECIFIED
  • ENABLED
  • DISABLED
應用程式存取控管 > 管理 Google 服務 > Google 服務 api_controls.google_services 否 選取 Google 服務 API 的存取權設定，藉此控管哪種類型的第三方應用程式可以要求存取這些服務。 services Service[]

API 控制項子設定

這個表格提供其他 API 控制項設定參照的 API 控制項子設定。

Policy API 子設定名稱 管理控制台字幕 政策 API 欄位名稱 資料類型
服務 存取權 scopes_group enum:
  • 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
  • WORKSPACE_STUDIO
  • VOICE
  • GEMINI_NOTEBOOK
受限/不受限 is_enabled boolean

日曆設定

管理控制台頁面 管理控制台中的特定設定 Policy API 設定類型 支援 Mutate 管理控制台字幕 政策 API 欄位名稱 資料類型
日曆 進階設定 > 包含付款資訊的預約時間表 calendar.appointment_schedules 否 允許預約時間表的使用者要求透過自己的付款服務供應商帳戶支付預約款項。 enable_payments boolean
共用設定 > 外部邀請 calendar.external_invitations 否 當使用者邀請網域外的訪客時顯示警告 ORGANIZATION_UNIT_NAME warn_on_invite boolean
日曆協同整合管理 > 在 Google 日曆中顯示 Exchange 有空與否資訊 calendar.interoperability 否 允許 Google 日曆顯示 Exchange 使用者的有空與否資訊 enable_interoperability boolean
顯示活動詳細資料 enable_full_event_details boolean
日曆協同整合管理> Exchange 資源預訂 calendar.interoperability 否 允許透過 Google 日曆預訂 Microsoft Exchange 會議室 enable_exchange_room_booking boolean
共用設定 > 主要日曆的外部共用選項 calendar.primary_calendar_max_allowed_external_sharing 否 ORGANIZATION_UNIT_NAME 之外 - 設定主日曆的使用者權限 max_allowed_external_sharing enum:
  • 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 enum:
  • EXTERNAL_FREE_BUSY_ONLY
  • EXTERNAL_ALL_INFO_READ_ONLY
  • EXTERNAL_ALL_INFO_READ_WRITE
  • EXTERNAL_ALL_INFO_READ_WRITE_MANAGE

即時通訊設定

管理控制台頁面 管理控制台中的特定設定 Policy API 設定類型 支援 Mutate 管理控制台字幕 政策 API 欄位名稱 資料類型
Google Chat 即時通訊記錄 chat.chat_history 否 記錄功能已開啟/關閉 history_on_by_default boolean
允許使用者變更自己的記錄設定 allow_user_modification boolean
Chat 檔案共用 chat.chat_file_sharing 否 對外共用檔案 external_file_sharing enum:
  • ALL_FILES
  • IMAGES_ONLY
  • NO_FILES
  • FILE_SHARING_OPTION_UNSPECIFIED
internal_file_sharing same
聊天室記錄 chat.space_history 否 聊天室的對話記錄設定 history_state enum:
  • DEFAULT_HISTORY_ON
  • DEFAULT_HISTORY_OFF
  • HISTORY_ALWAYS_ON
  • HISTORY_ALWAYS_OFF
  • HISTORY_STATE_UNSPECIFIED
外部即時通訊設定 chat.external_chat_restriction 否 允許使用者在即時通訊和聊天室中向機構外的人士傳送訊息 allow_external_chat boolean
external_chat_restriction enum:
  • NO_RESTRICTION
  • TRUSTED_DOMAINS
  • RESTRICTION_UNSPECIFIED
Chat 擴充應用程式 chat.chat_apps_access 否 允許使用者安裝 Chat 擴充應用程式 enable_apps boolean
允許使用者新增及使用連入的 Webhook enable_webhooks boolean
第三方封存功能 chat.third_party_archiving 否 啟用第三方封存功能 enabled boolean
指定要傳送 Chat 內容的目標電子郵件地址 destination_email_address string
指定 Chat 封存訊息的傳送頻率 (每 1 到 24 小時傳送一次) archival_frequency Duration
以逗號分隔的清單形式輸入目的地地址要求的所有自訂標頭 custom_headers string
外部聊天室 chat.external_spaces 否 允許使用者與組織外的人建立和加入聊天室 enabled boolean
僅允許使用者新增許可網域中的使用者 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 same
允許使用者檢舉指定聊天室中的內容 spaces_reporting same
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 boolean
custom_reporting_form_title string
custom_reporting_form_description string
即時通訊和聊天室限制 chat.chat_and_space_restrictions 否 限制建立訊息、群組訊息和聊天室。具有這項限制的使用者無法管理成員。 restriction_level enum:
  • RESTRICTION_LEVEL_UNSPECIFIED
  • UNRESTRICTED
  • RESTRICTED

Classroom 設定

管理控制台頁面 管理控制台中的特定設定 Policy API 設定類型 支援 Mutate 管理控制台字幕 政策 API 欄位名稱 資料類型
Classroom 一般設定 > 老師權限 classroom.teacher_permissions 否 誰可以建立課程 whoCanCreateClasses enum:
  • ANYONE_IN_DOMAIN
  • ALL_PENDING_AND_VERIFIED_TEACHERS
  • VERIFIED_TEACHERS_ONLY
一般設定 > 監護人存取權 classroom.guardian_access 否 允許家長和監護人存取 Classroom 資訊 allowAccess boolean
誰可以管理家長和監護人 whoCanManageGuardianAccess enum:
  • VERIFIED_TEACHERS_AND_DOMAIN_ADMINS
  • DOMAIN_ADMINS_ONLY
課程設定 > 關於課程成員資格 classroom.class_membership 否 誰可以加入您網域中的課程 whoCanJoinClasses enum:
  • ANYONE_IN_DOMAIN
  • ANYONE_IN_ALLOWLISTED_DOMAINS
  • ANY_GOOGLE_WORKSPACE_USER
  • ANYONE
您網域中的使用者可以加入哪些課程 whichClassesCanUsersJoin enum:
  • CLASSES_IN_DOMAIN
  • CLASSES_IN_ALLOWLISTED_DOMAINS
  • ANY_GOOGLE_WORKSPACE_CLASS
「資料存取權」>「Classroom API」 classroom.api_data_access 否 使用者可以授權應用程式存取自己的 Google Classroom 資料 enableApiAccess boolean
原創性報告 > 校內比對 classroom.originality_reports 否 啟用原創性報告校內比對功能 enableOriginalityReportsSchoolMatches boolean
取消學生註冊資格 > 取消註冊權限 classroom.student_unenrollment 否 誰能取消學生的課程報名資格 whoCanUnenrollStudents enum
  • STUDENTS_AND_TEACHERS
  • TEACHERS_ONLY
「匯入學生名單」>「設定」 classroom.roster_import 否 匯入學生名單 rosterImportOption enum:
  • OFF
  • ON_CLEVER
Gemini in Workspace 應用程式 Gemini for Workspace > Classroom 功能存取權 > Classroom classroom.gemini_access 否 選擇使用者能否使用 Classroom 內建 Gemini enabled boolean

資料法規遵循設定

管理控制台頁面 管理控制台中的特定設定 Policy API 設定類型 支援 Mutate 管理控制台字幕 政策 API 欄位名稱 資料類型
存取權管理 存取權管理 > 存取權管理政策 access_management.user_scoping 否 為涵蓋資料選擇存取權管理政策 allowed_audience enum:
  • PREFERENCE_UNSPECIFIED
  • CJIS_IRS_1075_GOOGLE_STAFF
  • US_GOOGLE_STAFF
  • EU_GOOGLE_STAFF
資料地區 地區 > 靜態資料 data_regions.data_at_rest_region 否 存放靜態資料的地區 region enum:
  • REGION_UNSPECIFIED
  • ANY_REGION
  • US
  • EUROPE
區域> 資料處理 data_regions.data_processing_region 否 資料處理作業的資料地區政策 limit_to_storage_region boolean
Access Approvals 存取權核准 > 存取權核准政策 access_approval.axa_user_scoping 否 要求 Google 員工必須獲得核准才能查看支援服務所需的資料 requires_customer_approval boolean

裝置設定

管理控制台頁面 管理控制台中的特定設定 Policy API 設定類型 Mutate supported in v1beta1 管理控制台字幕 政策 API 欄位名稱 資料類型
通用設定 資料存取權 > Android 同步處理 devices.android_work_data_sync 否 允許在 Android 裝置上同步處理工作資料 allowed boolean
安全性 > 加密 devices.encryption 否 要求加密保護裝置 device_encryption_option enum:
  • ENCRYPTION_OPTION_UNSPECIFIED
  • NOT_REQUIRED
  • REQUIRED
安全性 > 遭入侵的裝置 devices.compromised_devices 否 封鎖遭駭的 Android 裝置 compromised_android_devices_blocked boolean
封鎖已越獄解鎖的 iOS 裝置 jailbroken_ios_devices_blocked boolean
安全性 > 裝置核准 devices.activation_approval 否 必須取得管理員核准 admin_approval_required boolean
將核准要求電子郵件傳送至 approver_email_address string
Android 設定 應用程式與資料共用 > 分享到其他個人資料 devices.android_work_profile_sharing 否 允許將工作資料夾內容分享到個人空間 (僅限裝置) allowed boolean
應用程式與資料分享 > 跨設定檔複製 devices.android_cross_profile_copy_paste 否 允許將工作資料夾中的資料貼到個人空間，反之亦然 (僅限有工作資料夾的裝置) enabled boolean
依序點選「應用程式與資料共用」>「Google Play 私人應用程式」 devices.android_google_play_private_apps 否 允許使用者存取 Google Play 私人應用程式 access_allowed boolean
允許使用者發布及更新 Google Play 私人應用程式 publish_and_update_allowed boolean
應用程式和資料共用 > 螢幕截圖 devices.android_screen_capture 否 允許擷取螢幕畫面 allowed boolean
應用程式與資料共用 > Android Beam devices.android_beam 否 允許使用 Android Beam 向外傳輸 outgoing_beam_allowed boolean
應用程式與資料共用 > 位置資訊分享 devices.android_location_sharing 否 允許分享位置資訊。 allowed boolean
應用程式與資料共用 > 可用的應用程式 devices.android_available_apps 否 設定使用者可透過 Play 商店安裝哪些應用程式 playstore_installable_apps enum:
  • PLAYSTORE_INSTALLABLE_APPS_UNSPECIFIED
  • ALL
  • ALLOWLISTED
應用程式與資料共用 > 驗證應用程式 devices.android_verify_apps 否 允許使用者關閉 Google Play 安全防護 (僅限公司擁有的裝置) turnoff_google_play_protect_allowed boolean
應用程式與資料共用 > 開發人員選項 devices.android_developer_options 否 允許使用開發人員選項 allowed boolean
螢幕鎖定功能 > 定期使用 PIN 碼、密碼或圖案進行驗證 devices.android_periodic_secure_authentication 否 要求使用人臉或指紋解鎖功能的使用者，定期使用 PIN 碼、密碼或圖案等更安全的方式進行驗證 required boolean
下方設定的期限過後，使用者再次解鎖裝置時，必須使用更安全的驗證方式 expiration_period enum:
  • 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 boolean
禁止使用者在個人資料夾中安裝來源不明的應用程式。 personal_profile_installation_allowed boolean
應用程式與資料共用 > 應用程式設定 devices.android_apps_settings 否 允許使用者變更應用程式設定 (僅限公司擁有的裝置)。 modification_allowed boolean
應用程式與資料共用 > 螢幕鎖定功能 devices.android_trust_agents 否 允許 Smart Lock 讓裝置保持解鎖狀態。 smart_lock_allowed boolean
應用程式與資料共用 > 螢幕鎖定功能 devices.android_lock_screen_notifications 否 允許在螢幕鎖定畫面上顯示通知。 allowed boolean
應用程式與資料共用 > 螢幕鎖定功能 devices.android_lock_screen_notification_details 否 允許顯示通知詳細資料。 allowed boolean
iOS 設定 進階安全性 > Apple Watch devices.ios_apple_watch 否 允許在未經手腕偵測狀態下使用 Apple Watch no_wrist_detection_usage_allowed boolean
Advanced Security > Siri devices.ios_siri 否 允許使用 Siri allowed boolean
允許 Siri 在螢幕鎖定狀態下運作 allowed_on_lock_screen boolean
進階安全性 > 轉移 devices.ios_handoff 否 允許使用接力功能 (僅限受監管註冊裝置) allowed boolean
資料共用 > iCloud 儲存空間 devices.ios_icloud_storage 否 允許受管理的應用程式在 iCloud 中儲存資料 managed_apps_sync_allowed boolean
進階安全性 > 螢幕畫面擷取 devices.ios_screen_capture 否 允許擷取及錄製螢幕畫面 allowed boolean
備份和 iCloud 同步處理 > iCloud 備份 devices.ios_icloud_backup 否 允許使用者透過 iCloud 備份裝置資料 (僅限受監管裝置) allowed boolean
備份和 iCloud 同步處理 > 加密備份 devices.ios_backup_encryption 否 必須加密才能進行備份 required boolean
螢幕鎖定 > 控制中心 devices.ios_lock_screen_control_center 否 允許螢幕鎖定畫面顯示控制中心 allowed boolean
應用程式和服務 >「檔案」應用程式 devices.ios_files_app 否 允許使用者透過「檔案」連接 USB 隨身碟 (僅限 iOS 13.1 以上版本的受監護裝置) usb_drives_connection_allowed boolean
允許使用者透過「檔案」連線至網路硬碟 (僅限 iOS 13.1 以上版本的受監護裝置) network_drives_connection_allowed boolean
裝置功能 > 日期和時間 devices.ios_date_time 否 強制自動設定日期與時間 (僅限 iOS 12 以上版本的受監管裝置) automatic_date_time_enforced boolean
螢幕鎖定 > 通知檢視畫面 devices.ios_lock_screen_notifications_view 否 允許螢幕鎖定畫面顯示「通知檢視」畫面 allowed boolean
資料共用 > 資料動作 devices.ios_data_actions 否 選取使用者可以在 iOS 裝置上對適用 Google Workspace 資料執行的動作 external_data_sharing_allowed boolean
允許將工作資料複製並貼到個人帳戶和應用程式中 work_data_operation_type.non_workspace_apps_copy_paste_allowed boolean
允許透過 iOS 分享表單將工作資料傳送到個人應用程式，包括所有非 Google Workspace 應用程式 work_data_operation_type.non_workspace_apps_sharing_allowed boolean
允許透過 iOS 分享表單將工作資料分享到個人帳戶或 iOS 郵件 work_data_operation_type.personal_accounts_sharing_allowed boolean
允許透過 iOS 分享表單使用 AirDrop 分享工作資料 work_data_operation_type.airdrop_sharing_allowed boolean
允許列印工作檔案 work_data_operation_type.files_printing_allowed boolean
允許透過 iOS 分享表單將工作資料儲存到「檔案」應用程式，並直接從該應用程式存取這些資料 work_data_operation_type.files_access_allowed boolean
允許將工作圖片和影片儲存至 iOS「照片」應用程式 work_data_operation_type.images_videos_saving_allowed boolean
允許透過 iOS 分享表單將項目指派給聯絡人 work_data_operation_type.contacts_items_assignment_allowed boolean
Safari > 安全瀏覽 devices.ios_safari_secure_browsing 否 強制啟用 Safari 詐欺網站警告 fraudulent_website_warning_enforced boolean
資料共用 > Apple Intelligence devices.ios_apple_intelligence 否 允許使用者在 iOS 裝置上透過 Google Workspace 應用程式使用 Apple Intelligence 書寫工具 writing_tools_allowed boolean
備份和 iCloud 同步處理 > 鑰匙圈同步 devices.ios_keychain_sync 否 允許使用者透過 iCloud 同步處理鑰匙圈 (僅限受監管的裝置)。 icloud_sync_allowed boolean
備份和 iCloud Sync > 文件同步處理 devices.ios_document_sync 否 允許使用者透過 iCloud 同步處理文件和資料。 icloud_data_sync_allowed boolean

目錄設定

管理控制台頁面 管理控制台中的特定設定 Policy API 設定類型 支援 Mutate 管理控制台字幕 政策 API 欄位名稱 資料類型
目錄設定 共用設定 > 對外共用目錄 directory.external_directory_sharing 否 不適用 sharing_option enum:
  • SHARING_OPTION_UNSPECIFIED
  • REQUESTER_BASIC_PROFILE_ONLY
  • ORGANIZATION_DIRECTORY_DATA
Workspace 資源類型瀏覽權限 > 瀏覽權限 directory.workspace_resource_type_visibility 否 允許使用者查看 Google 網路論壇 google_groups boolean
允許使用者查看網域共用聯絡人 domain_shared_contacts boolean

雲端硬碟與文件設定

管理控制台頁面 管理控制台中的特定設定 Policy API 設定類型 支援 Mutate 管理控制台字幕 政策 API 欄位名稱 資料類型
雲端硬碟與文件 共用設定 > 共用選項 drive_and_docs.external_sharing 否 選取您允許的最高「CUSTOMER_NAME」外部共用層級 external_sharing_mode enum:
  • DISALLOWED
  • ALLOWLISTED_DOMAINS
  • ALLOWED
允許「ORGANIZATION_UNIT_NAME」中的使用者接收 CUSTOMER_NAME 外使用者 (或共用雲端硬碟) 的檔案 allow_receiving_external_files boolean
當「ORGANIZATION_UNIT_NAME」中使用者 (或共用雲端硬碟) 擁有的檔案與許可網域中的使用者共用時，顯示警告訊息 warn_for_sharing_outside_allowlisted_domains boolean
允許「ORGANIZATION_UNIT_NAME」中的使用者接收非許可網域內使用者 (或共用雲端硬碟) 的檔案 allow_receiving_files_outside_allowlisted_domains boolean
允許「ORGANIZATION_UNIT_NAME」中的使用者 (或共用雲端硬碟) 透過協作者共用功能與信任網域中的非 Google 使用者共用項目 allow_non_google_invites_in_allowlisted_domains boolean
當「ORGANIZATION_UNIT_NAME」中使用者 (或共用雲端硬碟) 擁有的檔案與「CUSTOMER_NAME」外的使用者共用時，顯示警告訊息 warn_for_external_sharing boolean
允許「ORGANIZATION_UNIT_NAME」中的使用者 (或共用雲端硬碟) 與「CUSTOMER_NAME」外非使用 Google 帳戶的人士共用項目 allow_non_google_invites boolean
如果允許與「CUSTOMER_NAME」外部的人員共享，「ORGANIZATION_UNIT_NAME」的使用者便可向任何知道連結的使用者公開檔案及已發布的網路內容 allow_publishing_files boolean
當使用者透過文件或雲端硬碟以外的 Google 產品共用檔案時 (例如在 Gmail 中貼上連結)，Google 可以檢查收件者是否擁有存取權。如果沒有的話，Google 會盡可能請使用者選擇是否要與下列對象共用檔案： access_checker_suggestions enum:
  • RECIPIENTS_OR_AUDIENCE_OR_PUBLIC
  • RECIPIENTS_OR_AUDIENCE
  • RECIPIENTS_ONLY
選取哪些人可以在CUSTOMER_NAME以外的ORGANIZATION_UNIT_NAME發布內容。這會限制誰能將內容上傳或移至其他機構擁有的共用雲端硬碟 allowed_parties_for_distributing_content enum:
  • ALL_ELIGIBLE_USERS
  • ELIGIBLE_INTERNAL_USERS
  • NONE
共用設定 > 預設的一般存取權 drive_and_docs.general_access_default 否 在「ORGANIZATION_UNIT_NAME」中的使用者建立項目之後，預設的存取權將會變成 default_file_access enum:
  • 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 enum:
  • CREATOR_ORG_UNIT
  • CUSTOM_ORG_UNIT
所選組織單位 custom_org_unit string
允許擁有管理員權限的成員覆寫下方設定 allow_managers_to_override_settings boolean
允許不屬於「CUSTOMER_NAME」的使用者存取共用雲端硬碟中的檔案 allow_external_user_access boolean
允許共用雲端硬碟成員以外的使用者獲得檔案存取權 allow_non_member_access boolean
已允許下列對象下載、列印及複製內容： allowed_parties_for_download_print_copy enum:
  • ALL
  • EDITORS_ONLY (管理員、協作者和內容管理員)
  • MANAGERS_ONLY
允許內容管理員共用資料夾 allow_content_managers_to_share_folders boolean
共用設定 > 檔案專用安全性更新 drive_and_docs.file_security_update 否 套用這項更新可提升檔案連結的安全性，但使用者可能會因此收到存取檔案的要求 security_update enum:
  • APPLY_TO_IMPACTED_FILES
  • REMOVE_FROM_IMPACTED_FILES
允許使用者針對自己擁有或管理的檔案移除/套用安全性更新 allow_users_to_manage_update boolean
「功能和應用程式」>「Drive SDK」 drive_and_docs.drive_sdk 否 允許使用者透過 Drive SDK API 存取 Google 雲端硬碟 enable_drive_sdk_api_access boolean
Google 雲端硬碟電腦版 > 啟用雲端硬碟電腦版 drive_and_docs.drive_for_desktop 否 允許在貴機構啟用 Google 雲端硬碟電腦版 allow_drive_for_desktop boolean
僅允許授權裝置使用 Google 雲端硬碟電腦版 restrict_to_authorized_devices boolean
顯示 Google 雲端硬碟電腦版的下載連結 show_download_link boolean
允許使用者透過 Google 雲端硬碟電腦版啟用 Microsoft Office 即時狀態功能 allow_real_time_presence boolean
「共用設定」>「醒目顯示外部檔案」 drive_and_docs.external_file_warning 否 將外部人員共用或擁有的檔案標示為「外部」，表明機構外人士可以查看相關內容。適用於 Google 雲端硬碟、文件、試算表、簡報、繪圖和 Vids。 highlighting_enabled boolean

Gemini 應用程式設定

管理控制台頁面 管理控制台中的特定設定 Policy API 設定類型 支援 Mutate 管理控制台字幕 政策 API 欄位名稱 資料類型
Gemini 應用程式 使用者存取權 gemini_app.unlicensed_user_access 否 允許所有使用者存取 Gemini 應用程式，無論是否擁有授權 enabled boolean

Gemini in Workspace 設定

管理控制台頁面 管理控制台中的特定設定 Policy API 設定類型 支援 Mutate 管理控制台字幕 政策 API 欄位名稱 資料類型
Gemini in Workspace Beta 版 Gemini 功能 > Beta 版功能 gemini_for_workspace.beta_features 否 啟用 Gemini for Google Workspace Beta 版功能的存取權 enabled boolean
允許 Google 邀請所選組織單位/群組中的使用者參與問卷調查和使用者體驗意見回饋研究，協助提升 Gemini for Google Workspace 品質 feedback_and_testing_enabled boolean

Gmail 設定

管理控制台頁面 管理控制台中的特定設定 Policy API 設定類型 支援 Mutate 管理控制台字幕 政策 API 欄位名稱 資料類型
Gmail 使用者設定 > 機密模式 gmail.confidential_mode 否 啟用機密模式 enable_confidential_mode boolean
「使用者設定」>「S/MIME」 gmail.smime_encryption 否 允許在收發電子郵件時使用 S/MIME 加密功能 enable_smime_encryption enum:
  • STATUS_UNSPECIFIED
  • STATUS_DISABLED
  • STATUS_ENABLED
允許全域使用 SHA-1 (不建議) allow_sha1_globally_in_smime_signature boolean
gmail.enhanced_smime_encryption 否 允許使用者自行上傳憑證 allow_user_to_upload_certificates boolean
為特定網域接受這些額外根憑證： custom_root_certificates CustomRootCertificates 清單，內含根憑證清單、中繼 CA 憑證清單、受限制網域名稱清單、允許位址不符的布林值，以及具有不同驗證層級的列舉。
垃圾郵件、網路釣魚和惡意軟體 > 加強型送達前掃描郵件功能 gmail.enhanced_pre_delivery_message_scanning 否 啟用更完善的偵測功能，在傳送郵件前掃描可疑內容 enable_improved_suspicious_content_detection boolean
垃圾郵件、網路釣魚和惡意軟體 > 電子郵件許可清單 gmail.email_spam_filter_ip_allowlist 否 輸入電子郵件許可清單的 IP 位址 allowed_ip_addresses 字串清單
安全 > 假冒和驗證 gmail.spoofing_and_authentication 否 防範以相似網域名稱假冒特定網域的行為 detect_domain_name_spoofing boolean
選擇動作 domain_name_spoofing_consequence enum:
  • WARNING
  • SPAM_FOLDER
  • QUARANTINE
  • NO_ACTION
選擇隔離區 domain_name_spoofing_quarantine_id integer
防範假冒員工姓名的行為 detect_employee_name_spoofing boolean
選擇動作 employee_name_spoofing_consequence enum:
  • WARNING
  • SPAM_FOLDER
  • QUARANTINE
  • NO_ACTION
選擇隔離區 employee_name_spoofing_quarantine_id integer
防範假冒您網域的內送電子郵件 detect_domain_spoofing_from_unauthenticated_senders boolean
選擇動作 domain_spoofing_consequence enum:
  • WARNING
  • SPAM_FOLDER
  • QUARANTINE
  • NO_ACTION
選擇隔離區 domain_spoofing_quarantine_id integer
防範所有未經驗證的電子郵件 detect_unauthenticated_emails boolean
選擇動作 unauthenticated_email_consequence enum:
  • WARNING
  • SPAM_FOLDER
  • QUARANTINE
  • NO_ACTION
選擇隔離區 unauthenticated_email_quarantine_id integer
防範網路論壇收到假冒您網域的內送電子郵件 detect_groups_spoofing boolean
將這項設定套用至 groups_spoofing_visibility_type enum:
  • PRIVATE_GROUPS_ONLY
  • ALL_GROUPS
選擇動作 groups_spoofing_consequence enum:
  • WARNING
  • SPAM_FOLDER
  • QUARANTINE
  • NO_ACTION
選擇隔離區 groups_spoofing_quarantine_id integer
自動套用日後建議的設定 apply_future_settings_automatically boolean
安全性 > 連結和不明外部圖片 gmail.links_and_external_images 否 識別隱藏在短網址背後的實際連結 enable_shortener_scanning boolean
掃描連結的圖片 enable_external_image_scanning boolean
在使用者點選不受信任網域的連結時顯示警告訊息 enable_aggressive_warnings_on_untrusted_links boolean
自動套用日後建議的設定 apply_future_settings_automatically boolean
安全性 > 附件 gmail.email_attachment_safety 否 防範來自不受信任寄件者的加密附件 enable_encrypted_attachment_protection boolean
選擇動作 encrypted_attachment_protection_consequence enum:
  • WARNING
  • SPAM_FOLDER
  • QUARANTINE
選擇隔離區 encrypted_attachment_protection_quarantine_id integer
防範來自不受信任寄件者的含指令碼附件 enable_attachment_with_scripts_protection boolean
選擇動作 attachment_with_scripts_protection_consequence enum:
  • WARNING
  • SPAM_FOLDER
  • QUARANTINE
選擇隔離區 attachment_with_scripts_protection_quarantine_id integer
防範電子郵件中的異常附件類型 enable_anomalous_attachment_protection boolean
選擇動作 anomalous_attachment_protection_consequence enum:
  • WARNING
  • SPAM_FOLDER
  • QUARANTINE
選擇隔離區 anomalous_attachment_protection_quarantine_id integer
針對下列不常見的檔案類型設定許可清單 allowed_anomalous_attachment_filetypes string[]
自動套用日後建議的設定 apply_future_recommended_settings_automatically boolean
路由 > 管理地址清單 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 string
不適用 (適用於所有規則) 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 boolean
「使用者存取權」>「POP 與 IMAP 存取功能」 gmail.pop_access 否 為所有使用者啟用 POP 存取功能 enable_pop_access boolean
gmail.imap_access 否 為所有使用者啟用 IMAP 存取功能 enable_imap_access boolean
允許所有郵件用戶端 imap_access_restriction.allow_all_mail_clients boolean
限制使用者可以使用哪些郵件用戶端 (僅限 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 boolean
使用者存取權 > 自動轉寄 gmail.auto_forwarding 否 允許使用者設定自動將來信轉寄至其他地址 enable_auto_forwarding boolean
允許的轉寄目的地 allowed_forwarding_destination enum:
  • ANY_ADDRESS
  • INTERNAL_ADDRESSES
使用者設定 > 名稱格式 gmail.name_format 否 允許使用者自訂這項設定 allow_custom_display_names boolean
First Last 或 Last, First default_display_name_format enum:
  • FIRSTNAME_LASTNAME
  • LASTNAME_COMMA_FIRSTNAME
「使用者存取權」>「允許個別使用者透過外寄郵件閘道傳送郵件」 gmail.per_user_outbound_gateway 否 如果使用者設定的代管「寄件者」地址不屬於您的郵件網域，則允許使用者透過外部 SMTP 伺服器傳送郵件 allow_users_to_use_external_smtp_servers boolean
「使用者存取權」>「外部收件者警告」 gmail.external_recipient_warning 否 醒目顯示對話中的外部收件者。在使用者回覆電子郵件給不在聯絡人清單中的外部收件者前，向使用者顯示警告。 enabled boolean
使用者存取權 > 圖片網址 Proxy 許可清單 gmail.email_image_proxy_bypass 否 輸入圖片網址模式。符合模式的網址會略過圖片 Proxy。 image_proxy_bypass_pattern string[]
不適用 enable_image_proxy boolean
使用者設定 > 郵件委派 gmail.mail_delegation 否 讓使用者將信箱存取權委派給網域中的其他使用者 enable_mail_delegation boolean
允許使用者自訂這項設定 allow_custom_delegate_attribution boolean
顯示帳戶擁有者和協助傳送電子郵件的委派代表 enable_delegate_attribution boolean
僅顯示帳戶擁有者
允許使用者將信箱存取權授予 Google 群組 enable_mailbox_group_delegation boolean
使用者設定 > Gmail 網頁離線版 gmail.web_offline 否 啟用 Gmail 網頁離線版 enabled boolean
登出 Google 帳戶時強制刪除離線資料 signout_data_deletion_enforced boolean

Gmail 子設定

下表列出其他 Gmail 設定會參照的 Gmail 子設定。

Policy API 子設定名稱 管理控制台字幕 政策 API 欄位名稱 資料類型
EmailAddressList 不適用 id string
名稱 name string
新增地址清單 address_list AddressList
新增封鎖清單 blocked_address_list AddressList
AddressList 新增地址清單 address AddressListEntry[]
AddressListEntry 地址 address string
必須通過驗證 (僅限收到的郵件) require_address_verification boolean
BlockedSender 輸入要在設定摘要內顯示的簡短描述 description string
加入您要自動拒絕的郵件來源地址或網域 sender_blocklist StringValue[]
輸入自訂拒絕通知 rejection_response string
如果收到的郵件來自這些核准的寄件者清單中的地址或網域，則略過這項設定。 bypass_approved_sender boolean
不適用 bypass_approved_sender_allowlist StringValue[]
不適用 rule_id string
SpamOverride 輸入要在設定摘要內顯示的簡短描述 description string
更積極過濾垃圾郵件。 enable_aggressive_filtering boolean
將垃圾郵件放入管理隔離區 add_to_quarantine boolean
不適用 quarantine_id integer
讓垃圾郵件篩選器略過內部寄件者。 bypass_internal_senders boolean
讓垃圾郵件篩選器略過所選清單中的寄件者或網域寄來的郵件。 bypass_selected_senders boolean
不適用 bypass_sender_allowlist StringValue[]
讓垃圾郵件篩選器略過所選清單中的寄件者或網域寄來的郵件，並隱藏警告。 hide_warning_banner_from_selected_senders boolean
不適用 hide_warning_banner_sender_allowlist StringValue[]
讓垃圾郵件篩選器略過來自內部與外部寄件者的所有郵件並隱藏警告 (不建議使用)。 hide_warning_banner_for_all boolean
不適用 rule_id string
ContentComplianceRule 輸入要在設定摘要內顯示的簡短描述 description string
受影響的電子郵件訊息 condition RuleConditions
新增運算式，描述您要在所有郵件中搜尋的內容 match_expressions MatchExpression[]
如果郵件符合下列任一條件 match_any_expression boolean
如果符合上述條件運算式，則執行下列動作 consequence RuleConsequences
不適用 rule_id string
RestrictDeliveryRule 必要設定：輸入要在設定摘要內顯示的簡短描述 description string
新增您要允許的地址或網域 allowed_addresses StringValue[]
系統會拒絕所有來自或寄往其他地址和網域的郵件。您可以編輯這些郵件的預設拒絕通知。 rejection_notice_message string
內部郵件可略過這項設定 internal_messages_rule_bypass_allowed boolean
不適用 rule_id string
ObjectionableContentRule 輸入要在設定摘要內顯示的簡短描述 description string
受影響的電子郵件訊息 condition RuleConditions
自訂令人反感的字詞 objectionable_content_defined boolean
輸入字詞 objectionable_words string[]
如果符合上述條件運算式，則執行下列動作 consequence RuleConsequences
不適用 rule_id string
AttachmentComplianceRule 輸入要在設定摘要內顯示的簡短描述 description string
受影響的電子郵件訊息 condition RuleConditions
新增運算式，描述您要在所有郵件中搜尋的內容 match_expressions MatchExpression[]
如果郵件符合下列任一條件 match_any_expression boolean
如果符合上述條件運算式，則執行下列動作 consequence RuleConsequences
不適用 rule_id string
RuleState 不適用 (適用於所有規則) enabled boolean
rule_id string
RuleConditions 受影響的電子郵件訊息 內送郵件 affect_inbound_messages boolean
外寄郵件 affect_outbound_messages boolean
內部外寄郵件 affect_internal_sending_messages boolean
內部內送郵件 affect_internal_receiving_messages boolean
地址清單 使用地址清單略過這項設定，或控制要套用這項設定的地址 address_list_option enum:
  • NO_EFFECT
  • EXCLUDED
  • REQUIRED
讓特定地址/網域略過這項設定
僅針對特定地址/網域套用這項設定
使用現有名單/建立或編輯名單 address_lists StringValue[]
受影響的帳戶類型 使用者 account_type_user boolean
群組 account_type_group boolean
不明/全部接收的地址 account_type_unrecognized boolean
郵件篩選器 僅影響特定郵件寄件者 envelope_sender_filter AddressMatcher
僅影響特定郵件收件者 envelope_recipient_filter AddressMatcher
AddressMatcher 僅影響特定郵件寄件者/僅影響特定郵件收件者 enabled boolean
單一電子郵件地址 不適用 address_match_type enum: EXACT
電子郵件地址 exact_address_match_value string
模式比對 不適用 address_match_type enum: REGEXP
Regexp regexp_match_value string
群組成員 (僅限寄件備份) / 群組成員 (僅限收件匣) 不適用 address_match_type enum: GROUP_MEMBERSHIP
選取群組 group_ids string[]
MatchExpression 簡要內容比對 不適用 match_expression_type enum: SIMPLE_CONTENT
內容 match_content string
進階內容比對 不適用 match_expression_type enum: ADVANCED_CONTENT
內容/規則運算式 match_content string
不適用 advanced_content_match AdvancedContentMatch
中繼資料比對 match_expression_type enum: METADATA
metadata_match MetadataMatch
預先定義的內容比對 match_expression_type enum: PREDEFINED_CONTENT
predefined_content_match PredefinedContentMatch
檔案類型 match_expression_type enum: FILE_TYPE
file_type_match FileTypeMatch
檔案名稱 不適用 match_expression_type enum: FILE_NAME
附件檔案名稱包含 file_name string
訊息大小 不適用 match_expression_type enum: MESSAGE_SIZE
整封郵件 (內文 + 附件) 大於下列大小 (MB) message_size_threshold_in_megabytes integer
AdvancedContentMatch 位置 標頭 + 內文 advanced_content_match_location enum: HEADERS_AND_BODY
完整標頭 enum: FULL_HEADERS
Body enum: BODY
主旨 enum: SUBJECT
寄件者標頭 enum: SENDER_HEADER
收件者標頭 enum: RECIPIENTS_HEADER
郵件寄件者 enum: ENVELOPE_SENDER
任何郵件收件者 enum: ANY_ENVELOPE_RECIPIENT
原始郵件 enum: RAW_MESSAGE
比對類型 開頭是 advanced_content_match_type enum: STARTS_WITH
結尾為 enum: ENDS_WITH
包含文字 enum: CONTAINS_TEXT
不含文字 enum: NOT_CONTAINS_TEXT
等於 enum: <code< code="" dir="ltr" translate="no">EQUALS </code<>
空白 enum: IS_EMPTY
與規則運算式相符 enum: MATCHES_REGEXP
與規則運算式不符 enum: NOT_MATCHES_REGEXP
與任何文字相符 enum: MATCH_ANY_WORD
字詞完全符合 enum: MATCH_ALL_WORDS
不適用 regexp_match RegexpMatch
RegexpMatch 規則運算式說明 description string
相符項目數下限 min_match_count integer
MetadataMatch 屬性 郵件驗證 metadata_match_attribute enum: MESSAGE_AUTHENTICATION
來源 IP enum: SOURCE_IP
安全傳輸 (TLS) enum: TLS
訊息大小 enum: MESSAGE_SIZE
S/MIME 加密 enum: SMIME_ENCRYPTED
S/MIME 簽名 enum: SMIME_SIGNED
Gmail 機密模式 enum: CONFIDENTIAL_MODE
垃圾內容 enum: SPAM
比對類型 下列範圍 source_ip_range string
下列值 (MB) message_size_in_megabytes integer
郵件已經過驗證 metadata_match_type enum: MESSAGE_AUTHENTICATED
郵件未經過驗證 enum: MESSAGE_NOT_AUTHENTICATED
來源 IP 位於 enum: SOURCE_IP_IN_RANGE
來源 IP 不在 enum: SOURCE_IP_NOT_IN_RANGE
連線受到 TLS 加密保護 enum: TLS_ENCRYPTED
連線未受到 TLS 加密保護 enum: TLS_NOT_ENCRYPTED
郵件大小大於 enum: MESSAGE_SIZE_GREATER_THAN
郵件大小小於 enum: MESSAGE_SIZE_LESS_THAN
郵件經 S/MIME 加密 enum: MESSAGE_IS_SMIME_ENCRYPTED
郵件未經 S/MIME 加密 enum: MESSAGE_IS_NOT_SMIME_ENCRYPTED
郵件有 S/MIME 簽名 enum: MESSAGE_IS_SMIME_SIGNED
郵件沒有 S/MIME 簽名 enum: MESSAGE_IS_NOT_SMIME_SIGNED
郵件已套用 Gmail 機密模式 enum: MESSAGE_IS_IN_CONFIDENTIAL_MODE
郵件未套用 Gmail 機密模式 enum: MESSAGE_IS_NOT_IN_CONFIDENTIAL_MODE
在安全沙箱中偵測到惡意軟體 enum: MALWARE_DETECTED_FROM_SECURITY_SANDBOX
PredefinedContentMatch 不適用 (預先定義的內容比對選取器) predefined_content_match_name string
相符項目數下限 min_match_count integer
可信度門檻 confidence_threshold enum:
  • MEDIUM
  • HIGH
FileTypeMatch 經過加密的 Office 文件 encrypted_office_documents boolean
未經加密的 Office 文件 unencrypted_office_documents boolean
影片和多媒體 video boolean
音樂和音效 音樂 boolean
Google 圖片 image boolean
加密的壓縮檔和封存檔 compressed_encrypted_files boolean
未加密的壓縮檔和封存檔 compressed_unencrypted_files boolean
自訂檔案類型 - 根據副檔名比對檔案 custom_file_extensions string[]
也根據檔案格式比對檔案 match_file_format boolean
RuleConsequences 修改郵件 不適用 rule_consequence_type enum: MODIFY_MESSAGE
不適用 primary_delivery 廣告放送
新增其他收件者 deliver_to_additional_recipients boolean
收件者 bcc_deliveries 運送[]
廣告放送 新增 X-Gm-Original-To 標頭 add_x_gm_original_to_header boolean
新增 X-Gm-Spam 和 X-Gm-Phishy 標頭 add_x_gm_spam_header boolean
新增自訂標頭 add_custom_headers boolean
自訂標頭 custom_headers string[]
前置自訂主旨 prepend_custom_subject boolean
輸入新的主旨前置詞 custom_subject string
變更路線 change_default_route boolean
一併重新轉送垃圾郵件 reroute_spam boolean
略過來自這個收件者的退信 suppress_bounces_from_recipient boolean
不適用 (路由選取器) normal_routing boolean
變更郵件收件者 不適用 change_envelope_recipient boolean
取代收件者 replace_envelope_recipient_type enum: REPLACE_ADDRESS
recipient_address string
替換使用者名稱 replace_envelope_recipient_type enum: REPLACE_USER
recipient_user string
取代網域 replace_envelope_recipient_type enum: REPLACE_DOMAIN
recipient_domain string
將這封郵件略過垃圾郵件篩選器 bypass_spam_filter boolean
移除郵件的附件 remove_attachments boolean
附加這段文字，通知收件者附件已移除 attachment_removal_notice string
需要安全傳輸 (TLS) require_tls boolean
加密郵件 (如果未加密) (S/MIME) encrypt_outgoing_messages boolean
如果無法簽署及加密，則退信通知 bounce_unencrypted_messages boolean
不要傳送垃圾郵件給這個收件者 do_not_deliver_spam_to_recipient boolean
OAuthMailClientList 限制使用者可以使用哪些郵件用戶端 (僅限 OAuth 郵件用戶端) oauth_mail_client OAuthMailClient[]
OAuthMailClient 不適用 oauth_mail_client_id string
EmailQuarantine 不適用 quarantine_id integer
名稱 name string
說明 description string
內送郵件遭拒結果 inbound_denial_consequence enum:
  • DENIAL_CONSEQUENCE_UNSPECIFIED
  • DROP
  • REJECT
外寄郵件遭拒結果 outbound_denial_consequence enum:
  • DENIAL_CONSEQUENCE_UNSPECIFIED
  • DROP
  • REJECT
定期通知郵件隔離事件 send_notifications boolean
隔離區檢閱者群組 quarantine_acl_group_ids string[]

網路論壇企業版設定

管理控制台頁面 管理控制台中的特定設定 Policy API 設定類型 支援 Mutate 管理控制台字幕 政策 API 欄位名稱 資料類型
網路論壇企業版 共用設定 > 共用選項 groups_for_business.groups_sharing 否 設定群組共用設定的變更政策 collaborationCapability enum:
  • ANYONE_CAN_ACCESS
  • DOMAIN_USERS_ONLY
建立群組 createGroupsAccessLevel enum:
  • ADMIN_ONLY
  • USERS_IN_DOMAIN
  • ANYONE_CAN_CREATE
版主可以允許外部成員 ownersCanAllowExternalMembers boolean
版主有權允許來自機構以外的電子郵件 ownersCanAllowIncomingMailFromPublic boolean
會話群組的預設查看權限 viewTopicsDefaultAccessLevel enum:
  • OWNERS
  • MANAGERS
  • GROUP_MEMBERS
  • DOMAIN_USERS
  • ANYONE_CAN_VIEW_TOPICS
版主有權隱藏目錄中的群組 ownersCanHideGroups boolean
隱藏新建立的群組，不顯示於目錄 newGroupsAreHidden boolean
管理控制台頁面 管理控制台中的特定設定 Policy API 設定類型 支援 Mutate 管理控制台字幕 政策 API 欄位名稱 資料類型
帳戶設定 共用選項 cloud_sharing_options.cloud_data_sharing 否 Google Cloud Platform 共用選項 sharingOptions enum:
  • UNSUPPORTED
  • ENABLED
  • DISABLED

Marketplace 設定

管理控制台頁面 管理控制台中的特定設定 Policy API 設定類型 支援 Mutate 管理控制台字幕 政策 API 欄位名稱 資料類型
應用程式清單 應用程式清單 workspace_marketplace.apps_allowlist 否 目前顯示所有組織單位內部使用者的應用程式 apps AppsAllowlistSetting[]
設定 管理應用程式存取權 > 管理 Google Workspace Marketplace 許可清單存取權 workspace_marketplace.apps_access_options 否 選取使用者可以執行及安裝哪些 Marketplace 應用程式。 access_level enum:
  • ALLOW_ALL
  • ALLOW_LISTED_APPS
  • ALLOW_NONE

Marketplace 子設定

Policy API 子設定名稱 管理控制台字幕 政策 API 欄位名稱 資料類型
AppsAllowlistSetting 不適用 application_id string
不適用 access enum:
  • ALLOWED
  • BLOCKED

API 回應中的 workspace_marketplace.apps_allowlist 設定會公開市集 application_id，而非 application_name。您可以使用下列 Python 指令碼，將指令列中指定的一或多個 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 設定類型 支援 Mutate 管理控制台字幕 政策 API 欄位名稱 資料類型
Google Meet Meet 視訊設定 > 錄製 meet.video_recording 否 允許使用者錄製會議。 enable_recording boolean
Meet 視訊設定 > 自動語音轉錄 meet.automatic_transcription 否 預設轉錄會議 enabled boolean
Meet 視訊設定 > 自動錄製 meet.automatic_recording 否 預設錄製會議 enabled boolean
Meet 安全設定 > 網域 meet.safety_domain 否 誰可以加入貴機構發起的會議。 users_allowed_to_join enum:
  • SAME_ORGANIZATION_ONLY
  • LOGGED_IN
  • ALL
Meet 安全設定 > 存取權 meet.safety_access 否 機構使用者可以加入哪些會議或通話。「通話接聽限制」可進一步限制使用者能接聽的來電 meetings_allowed_to_join enum:
  • SAME_ORGANIZATION_ONLY
  • ANY_WORKSPACE_ORGANIZATION
  • ALL
Meet 安全設定 > 主辦人管理 meet.safety_host_management 否 預設主辦人管理設定 enable_host_management boolean
Meet 安全性設定 > 外部參與者警告 meet.safety_external_participants 否 代表「機構」以外或身分未經確認的參與者。 enable_external_label boolean
Meet 安全設定 > 加入 meet.joining 否 會議存取權類型 (取決於「網域」中所設限制) allowed_audience enum:
  • ALLOWED_AUDIENCE_UNSPECIFIED
  • OPEN
  • TRUSTED
  • RESTRICTED
Meet 安全性設定 > 即時通訊 meet.messaging 否 哪些人可以在通話中傳送即時通訊訊息 enabled boolean
Meet 安全設定 > 分享螢幕畫面 meet.presenting 否 哪些人可以在通話中分享螢幕畫面。 enabled boolean
Meet 安全設定 > 問與答 meet.questions 否 哪些人可以在通話中參與問與答 enabled boolean
Meet 安全設定 > 意見調查 meet.polls 否 哪些人可以在通話中參與意見調查 enabled boolean
「Meet 安全性設定」>「來電限制」 meet.meet_incoming_call_restrictions 否 這項設定只會影響 Meet 通話，而非 Google Chat 的舊版服務或通話功能。如果在「存取權」中設定限制，可以進一步管制使用者能接聽的來電。 allowed_callers enum:
  • ALLOWED_CALLERS_UNSPECIFIED
  • ALL
  • CONTACTS_AND_ORGANIZATION_ONLY
  • NONE

佈建設定

管理控制台頁面 管理控制台中的特定設定 Policy API 設定類型 Mutate supported in v1beta1 管理控制台字幕 政策 API 欄位名稱 資料類型
帳戶設定 管理相衝突的帳戶 provisioning.conflicting_accounts_management 否 選擇如何管理相衝突的帳戶 option enum:
  • OPTION_UNSPECIFIED
  • AUTOMATICALLY_SEND_INVITATIONS
  • REPLACE_CONFLICTING_ACCOUNT
  • PRESERVE_CONFLICTING_ACCOUNT
連續幾天傳送後續追蹤電子郵件 automatic_invitations.invitation_count integer
如果使用者未在所選後續追蹤期間接受邀請 automatic_invitations.unaccepted_invitation_resolution_option enum:
  • UNACCEPTED_INVITATION_RESOLUTION_OPTION_UNSPECIFIED
  • REPLACE_CONFLICTING_ACCOUNT_ON_NEXT_CREATION
  • PRESERVE_CONFLICTING_ACCOUNT_ON_NEXT_CREATION

規則和偵測工具設定

本節說明規則和偵測工具的設定。

資料保護規則設定

如要概略瞭解如何為支援的應用程式建立資料保護規則和偵測工具，請參閱「建立資料保護規則」。

管理控制台頁面 管理控制台中的特定設定 Policy API 設定類型 支援 Mutate 管理控制台字幕 政策 API 欄位名稱 資料類型
資料保護 「安全性」>「存取權與資料控制項」>「資料保護」>「管理規則」 rule.dlp 是 名稱 display_name string
說明 description string
應用程式 triggers string[] - 應用程式專屬觸發條件字串清單。指定要監控的一或多個觸發條件。只要發生任何指定的觸發條件，系統就會評估規則。如要查看可用值，請參閱「觸發條件」一節。
條件 condition string - 規則掃描的資料條件，以一般運算語言 (CEL) 運算式表示。CEL 語法和一些常見範例請見下方的「條件」一節。
動作 action Struct - 巢狀物件，代表符合條件時要採取的應用程式特定動作。每個應用程式觸發條件可用的動作，請參閱下方的「動作」一節。
State state enum:
  • ACTIVE
  • INACTIVE
建立時間 create_time 時間戳記
上次修改時間 update_time 時間戳記
規則類型專屬中繼資料 rule_type_metadata Struct：代表規則類型專屬中繼資料的巢狀物件。如果是資料保護規則，則會包含觸發事件的嚴重性等級。

觸發條件

下表列出可用的平台、應用程式和觸發條件：

平台 應用程式 觸發條件 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
造訪過的網址 google.workspace.chrome.url.v1.navigation
ChromeOS ChromeOS 檔案傳輸限制 google.workspace.chromeos.file.v1.transfer

條件

API 會使用一般運算語言 (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 支援的內建資訊類型之一：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 網址造訪觸發條件的「網址類別比對」選項。
    • {category} 代表管理控制台設定支援的網址類別。如需可用類別及其 API 表示法的清單，請參閱「網址類別」。
  • 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_list_id} 中，即視為相符。
  • matches_url_risk_level({risk_level})
    • 如果網址風險等級為{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 運算式語法

定義規則邏輯的一般運算語言 (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')
Chat 訊息已傳送
檔案已上傳		 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 不採取任何行動
restrictCopyPrintDownload 停用下載、列印和複製功能
applyLabels 套用分類標籤
Gmail gmailAction blockContent 封鎖訊息
warnUser 警告使用者
auditOnly 僅稽核
quarantineMessage 隔離郵件
applyLabels 套用分類標籤
addFooter 新增自訂附註 (註腳)
Chat chatAction blockContent 封鎖訊息
warnUser 警告使用者
auditOnly 僅稽核
Google Chrome chromeAction blockContent 封鎖
warnUser 允許共用並顯示警告
ChromeOS chromeOsAction blockContent 封鎖
warnUser 允許共用並顯示警告
auditOnly 僅稽核

操作參數

動作參數可為規則動作提供額外設定。可用的參數取決於應用程式。

設定動作參數的範例

以下範例說明如何指定 Chrome blockContent 動作的動作參數，啟用 Evidence Locker (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 boolean 對內部郵件套用動作。
apply_external_messages boolean 對外部郵件套用動作。
apply_to_internal_receive_messages boolean 對內部收到的郵件套用動作。
apply_to_external_receive_messages boolean 對收到的外部郵件套用動作。
custom_end_user_message.unsafe_html_message_body string 規則觸發時，向使用者顯示的 HTML 訊息內容。僅支援 <a> 標記。
add_footer.footer.title string 自訂附註的標題 (最多 50 個半形字元)。
add_footer.footer.unsafe_html_message_body string 自訂附註的 HTML 說明文字。僅支援 <a> 標記 (最多 300 個字元)。
add_footer.footer.banner_highlighted boolean 是否要在橫幅中醒目顯示自訂附註。
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 string 觸發套用標籤動作時，向使用者顯示的 HTML 訊息內容。僅支援 <a> 標記。
quarantine_message.quarantine_resource_name string 隔離區的資源名稱。格式為 quarantines/obfuscated<id> 或 quarantines/default。

Chat 動作參數

參數 資料類型 說明
apply_internal_direct_messages boolean 將動作套用至透過內部 1 對 1 即時訊息傳送的訊息。
apply_external_direct_messages boolean 對透過外部 1 對 1 即時訊息傳送的訊息套用動作。
apply_internal_rooms boolean 對傳送至內部聊天室的訊息套用動作。
apply_external_rooms boolean 對傳送至外部聊天室的訊息套用動作。
apply_internal_group_chats boolean 對傳送至內部群組通訊的訊息套用動作。
apply_external_group_chats boolean 對傳送至外部群組通訊的訊息套用動作。
custom_end_user_message.unsafe_html_message_body string 規則觸發時，向使用者顯示的 HTML 訊息內容。僅支援 <a> 標記。

Google Chrome 動作參數

參數 資料類型 說明
save_content boolean 安全儲存會觸發這項規則的內容 (Evidence Locker)。
watermark_message string 觸發網址導覽規則時，顯示為浮水印的文字。
custom_end_user_message.unsafe_html_message_body string 規則觸發時，向使用者顯示的 HTML 訊息內容。僅支援 <a> 標記。
block_screenshot boolean 設為 true 時，禁止擷取及分享螢幕畫面。
match_only_download_url boolean 僅根據下載網址評估規則，忽略分頁網址。
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[] 用於遮蓋資料的規則運算式偵測工具清單。以物件清單的形式指定一或多個偵測工具，每個物件都包含下表所述的欄位。
data_masking.regex_detector[].mask_type enum 規則運算式相符時要套用的遮蓋類型。
  • MASK_TYPE_LIGHT_OBFUSCATION：將游標懸停在遮罩文字上，即可顯示文字。
  • MASK_TYPE_HARD_OBFUSCATION：點選滑鼠即可顯示遮罩文字。
  • MASK_TYPE_REDACT：文字會完全取代，無法復原。
data_masking.regex_detector[].resource_name string 偵測工具資源的 ID。
data_masking.regex_detector[].display_name string 偵測工具觸發時，在報表工具 (例如安全調查工具) 中顯示的名稱。
data_masking.regex_detector[].regex_pattern string 用於比對的規則運算式模式。這個欄位由系統填入，使用者不應設定。

ChromeOS 動作參數

參數 資料類型 說明
save_content boolean 啟用後，系統會安全儲存觸發這項規則的內容。

規則類型專屬中繼資料

這個屬性包含規則類型專屬的中繼資料。如果是資料保護規則，則包含在安全性資訊主頁和快訊中心回報事件時，快訊事件的嚴重性。代表「低」警示嚴重程度的中繼資料值範例：

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

資料保護偵測工具設定

如要瞭解資料保護規則和偵測工具，請參閱「建立雲端硬碟資料遺失防護規則和自訂內容偵測工具」。

管理控制台頁面 管理控制台中的特定設定 Policy API 設定類型 支援 Mutate 管理控制台字幕 政策 API 欄位名稱 資料類型
資料保護 「安全性」>「存取權與資料控制項」>「資料保護」>「管理偵測工具」 detector.regular_expression detector.word_list detector.url_list 是 名稱 display_name string
說明 description string
規則運算式 regular_expression Struct：包含規則運算式字串。只有在偵測工具類型為 detector.regular_expression 時，才需要設定。
字詞清單 word_list Struct：包含字詞字串清單。只有在偵測工具類型為 detector.word_list 時，才需要設定。
網址清單 url_list Struct：包含網址字串清單。只有在偵測工具類型為 detector.url_list 時，才需要設定。
建立時間 create_time 時間戳記
上次修改時間 update_time 時間戳記

系統定義的警告規則設定

本節說明 Google Workspace 系統定義的警告規則。

管理控制台頁面 管理控制台中的特定設定 Policy API 設定類型 支援 Mutate 管理控制台字幕 政策 API 欄位名稱 資料類型
資料保護 規則 (適用於「系統定義」規則類型) rule.system_defined_alerts 否 名稱 display_name string
說明 description string
動作 action Struct - 巢狀物件，代表系統定義的警告觸發時的通知設定。詳情請參閱下方的「動作」一節。
State state enum:
  • ACTIVE
  • INACTIVE
建立時間 create_time 時間戳記
上次修改時間 update_time 時間戳記

動作

系統定義的警告規則只有一項動作，代表警告的通知設定。

快捷操作鍵 子動作 管理控制台字幕 說明
alertCenterAction alertCenterConfig 傳送到快訊中心 設定快訊嚴重程度，以及是否要將快訊傳送至快訊中心。
接收者 傳送電子郵件通知 觸發快訊時，要傳送通知的電子郵件地址清單。

操作參數

下表列出 alertCenterAction 的參數：

參數 資料類型 說明
alertCenterConfig.severity enum 快訊的嚴重程度 (例如 LOW、MEDIUM、HIGH)。
alertCenterConfig.status enum 是否將快訊傳送至快訊中心 (例如 ENABLED、DISABLED)。
recipients string[] 接收電子郵件通知的電子郵件地址清單。

安全性設定

管理控制台頁面 管理控制台中的特定設定 Policy API 設定類型 支援 Mutate 管理控制台字幕 政策 API 欄位名稱 資料類型
帳戶救援 超級管理員帳戶救援 security.super_admin_account_recovery 否 允許超級管理員復原自己的帳戶 enableAccountRecovery boolean
使用者帳戶救援 security.user_account_recovery 否 允許使用者和非超級管理員復原自己的帳戶 enableAccountRecovery boolean
密碼管理 密碼管理工具 security.password 否 效期 expirationDuration 秒 (0 秒表示無期限)
重複使用 allowReuse boolean
強度和長度強制執行 enforceRequirementsAtLogin boolean
長度 (長度上限) maximumLength integer
長度 (長度下限) minimumLength integer
肌力訓練 allowedStrength enum:
  • STRONG
  • WEAK
Google 工作階段控制設定 工作階段控制項 security.session_controls 否 網路工作階段持續時間 webSessionDuration 秒
低安全性應用程式 低安全性應用程式 security.less_secure_apps 否 控管使用者對應用程式的存取權，避免應用程式採用安全性較低的登入技術，導致帳戶更容易受到攻擊。 allowLessSecureApps boolean
登入身分確認問題 登入身分確認問題 security.login_challenges 否 使用員工 ID，進一步確保我的使用者安全無虞 enableEmployeeIdChallenge boolean
無密碼 密碼金鑰限制 security.passkeys_restriction 否 選擇使用者可用於登入的密碼金鑰類型 allowed_passkeys_type enum:
  • ALLOWED_PASSKEYS_TYPE_UNSPECIFIED
  • HARDWARE_SECURITY_KEYS_ONLY
  • ANY_DEVICE_OR_PLATFORM
進階保護計畫 註冊 security.advanced_protection_program 否 使用員工 ID，進一步確保我的使用者安全無虞 enableAdvancedProtectionSelfEnrollment boolean
安全碼 securityCodeOption enum:
  • ALLOWED_WITH_REMOTE_ACCESS
  • ALLOWED_WITHOUT_REMOTE_ACCESS
  • CODES_NOT_ALLOWED
兩步驟驗證 驗證 security.two_step_verification_enrollment 否 允許使用者開啟兩步驟驗證功能 allowEnrollment boolean
security.two_step_verification_enforcement 違規處置 enforcedFrom 時間戳記
security.two_step_verification_grace_period 新使用者註冊期限 enrollmentGracePeriod Duration
security.two_step_verification_device_trust 允許使用者信任裝置 allowTrustingDevice boolean
security.two_step_verification_enforcement_factor 方法 allowedSignInFactorSet enum:
  • ALL
  • PASSKEY_ONLY
  • PASSKEY_PLUS_SECURITY_CODE
  • PASSKEY_PLUS_IP_BOUND_SECURITY_CODE
  • NO_TELEPHONY
security.two_step_verification_sign_in_code 兩步驟驗證政策停權寬限期 backupCodeExceptionPeriod Duration
多方核准設定 多方核准設定 multi_party_approval.require_approvals 否 選擇在管理控制台和 Admin API 中執行敏感操作時，是否需經具備多方核准權限的管理員核准 multi_party_approval_state enum:
  • MULTI_PARTY_APPROVAL_STATE_UNSPECIFIED
  • ENABLED
  • DISABLED
安全性設定的多方核准措施 multi_party_approval.security_actions 否 兩步驟驗證 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
日曆 calendar
Cloud Search cloud_search
雲端硬碟與文件 drive_and_docs
Gmail gmail
Google Chat chat
Google Meet meet
Google 保管箱 vault
Google Voice voice
網路論壇企業版 groups_for_business
保留 keep
Sites sites
Tasks tasks

額外的 Google 服務

管理控制台中的服務名稱 Policy API 中的服務名稱
AI Studio ai_studio
應用數位技能計畫 applied_digital_skills
Assignments assignments
Blogger blogger
品牌帳戶 brand_accounts
Campaign Manager 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 ad_manager
Google Ads 廣告
Google AdSense adsense
Google 快訊 快訊
Google Analytics 數據分析
Google 藝術與文化 arts_and_culture
Google 書籤 書籤
Google 圖書 books
Google Chrome 同步 chrome_sync
Google Cloud cloud
Google 雲端列印 cloud_print
Google Colab Colab
Google Developer 開發人員
Google Domains 網域
Google 地球 earth
Google Fi fi
Google 網路論壇 groups
Google 地圖 maps
Google 訊息 messages
Google 我的商家 my_business
Google 我的地圖 my_maps
Google 新聞 news
Google Pay pay
Google 相簿 photos
Google Play play
Google Play 管理中心 play_console
Google 公開資料瀏覽器 public_data
Google Read Along read_along
Google Search Console search_console
Google 匯出 takeout
Google 翻譯 translate
Google 旅行 行程
Jamboard jamboard
定位記錄 location_history
數據分析 data_studio
Google Play 管理版 managed_play
Material Gallery material_gallery
Merchant Center merchant_center
Partner Dash partner_dash
Pinpoint pinpoint
Play 圖書合作夥伴中心 play_books_partner_center
程式化搜尋引擎 programmable_search_engine
QuestionHub question_hub
學術搜尋個人資料 scholar_profiles
Search Ads 360 search_ads_360
Google 搜尋與 Google 助理 search_and_assistant
Socratic socratic
Studio studio
第三方應用程式備份 third_party_app_backups
Tour Creator tour_creator
Work Insights work_insights
YouTube youtube

生成式 AI

管理控制台中的服務名稱 Policy API 中的服務名稱
Gemini 應用程式 gemini_app
NotebookLM notebooklm

協作平台設定

管理控制台頁面 管理控制台中的特定設定 Policy API 設定類型 支援 Mutate 管理控制台字幕 政策 API 欄位名稱 資料類型
協作平台 新版協作平台 > 網站建立和編輯 sites.sites_creation_and_modification 否 允許使用者建立新版協作平台 allowSitesCreation boolean
使用者可以/無法編輯網站 allowSitesModification boolean

UserTakeout 設定

管理控制台頁面 管理控制台中的特定設定 Policy API 設定類型 支援 Mutate 管理控制台字幕 政策 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 enum:
  • TAKEOUT_STATUS_UNSPECIFIED
  • ENABLED
  • DISABLED