API 中提供的设置

本文档介绍了 Policy API 支持的设置。

如果 Cloud Identity Policy API 响应中缺少支持的设置，请参阅默认字段值。如果默认字段值中未提及缺失的设置，请与 Cloud Customer Care 联系。

API 控件

管理控制台中的页面 管理控制台中的特定设置 政策 API 设置类型 支持变异 管理控制台图片说明 政策 API 字段名称 数据类型
API 控制 设置 > 自定义用户消息 api_controls.custom_user_message 否 自定义出错提示，当用户因访问权限设置而无法访问应用时显示。 error_text 字符串
设置 > 未配置的第三方应用 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 布尔值
设置 > 用户请求访问未配置的应用 api_controls.app_approval_requests 否 允许用户请求访问未配置的第三方应用 allowed_for_all enum：
  • OPTION_UNSPECIFIED
  • ENABLED
  • DISABLED
应用访问权限控制 > 管理 Google 服务 > Google 服务 api_controls.google_services 否 选择 Google 服务 API 的访问权限设置，以控制哪些类型的第三方应用可以请求访问这些服务。 服务 服务[]

API 控件子设置

下表列出了其他 API 控制设置所引用的 API 控制子设置。

政策 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
受限/不受限 is_enabled 布尔值

日历设置

管理控制台中的页面 管理控制台中的特定设置 政策 API 设置类型 支持变异 管理控制台图片说明 政策 API 字段名称 数据类型
日历 高级设置 > 包含付款的预约安排 calendar.appointment_schedules 否 允许“预约安排”功能的用户要求通过自己的付款服务机构账号收取预约费用。 enable_payments 布尔值
共享设置 > 外部邀请 calendar.external_invitations 否 当邀请对象是网域以外的人时，向用户发出警告ORGANIZATION_UNIT_NAME warn_on_invite 布尔值
日历互操作工具管理 > Exchange 在 Google 日历中的可用性 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 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

聊天设置

管理控制台中的页面 管理控制台中的特定设置 政策 API 设置类型 支持变异 管理控制台图片说明 政策 API 字段名称 数据类型
Google Chat 聊天记录 chat.chat_history 否 聊天记录功能已开启/关闭 history_on_by_default 布尔值
允许用户更改其聊天记录设置 allow_user_modification 布尔值
在聊天对话中共享文件 chat.chat_file_sharing 否 对外共享文件 external_file_sharing enum：
  • ALL_FILES
  • IMAGES_ONLY
  • NO_FILES
  • FILE_SHARING_OPTION_UNSPECIFIED
internal_file_sharing 相同
聊天室记录 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 布尔值
external_chat_restriction enum：
  • NO_RESTRICTION
  • TRUSTED_DOMAINS
  • RESTRICTION_UNSPECIFIED
聊天应用 chat.chat_apps_access 否 允许用户安装 Chat 应用 enable_apps 布尔值
允许用户添加和使用传入的网络钩子 enable_webhooks 布尔值
第三方归档 chat.third_party_archiving 否 启用第三方归档 已启用 布尔值
指定应将 Chat 内容递送到的电子邮件地址 destination_email_address 字符串
指定 Chat 归档消息的发送频率（1 - 24 小时） archival_frequency 时长
目标地址所需的任何自定义标头的逗号分隔列表 custom_headers 字符串
外部聊天室 chat.external_spaces 否 允许用户创建和加入包含组织外部人员的聊天室 已启用 布尔值
仅允许用户添加列入许可名单的网域中的人员 domain_allowlist_mode 枚举：
  • DOMAIN_ALLOWLIST_MODE_UNSPECIFIED
  • TRUSTED_DOMAINS
  • ALL_DOMAINS
共享设置 > 聊天室访问权限默认设置 chat.space_access_default 否 用户创建新聊天室时的默认聊天室访问权限。 access_type 枚举：
  • ACCESS_TYPE_UNSPECIFIED
  • RESTRICTED
  • PRIMARY_TARGET_AUDIENCE
内容举报 chat.content_reporting 否 允许用户举报 1 对 1 私信中的内容 one_on_one_direct_messages_reporting 枚举：
  • CONTENT_REPORTING_STATE_UNSPECIFIED
  • ENABLED
  • DISABLED
允许用户举报群组私信中的内容 group_direct_messages_reporting 相同
允许用户举报指定聊天室中的内容 spaces_reporting 相同
spaces_reporting_type 枚举：
  • 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 枚举：
  • RESTRICTION_LEVEL_UNSPECIFIED
  • UNRESTRICTED
  • RESTRICTED

课堂设置

管理控制台中的页面 管理控制台中的特定设置 政策 API 设置类型 支持变异 管理控制台图片说明 政策 API 字段名称 数据类型
课堂 常规设置 > 教师权限 classroom.teacher_permissions 否 哪些人可以创建课程 whoCanCreateClasses enum：
  • ANYONE_IN_DOMAIN
  • ALL_PENDING_AND_VERIFIED_TEACHERS
  • VERIFIED_TEACHERS_ONLY
常规设置 > 监护人访问权限 classroom.guardian_access 否 允许家长和监护人查看课堂信息 allowAccess 布尔值
谁可以管理家长和监护人 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 课堂数据 enableApiAccess 布尔值
原创性报告 > 校内匹配 classroom.originality_reports 否 启用原创性报告校内匹配功能 enableOriginalityReportsSchoolMatches 布尔值
学生取消注册> 取消注册权限 classroom.student_unenrollment 否 谁可以为学生取消注册课程 whoCanUnenrollStudents 枚举
  • STUDENTS_AND_TEACHERS
  • TEACHERS_ONLY
名单导入> 设置 classroom.roster_import 否 学生名单导入 rosterImportOption enum：
  • OFF
  • ON_CLEVER
Workspace 应用中的 Gemini Gemini for Workspace > Google 课堂中的功能使用权限 > Google 课堂 classroom.gemini_access 否 选择是否允许用户使用 Google 课堂中的 Gemini 已启用 布尔值

数据合规性设置

管理控制台中的页面 管理控制台中的特定设置 政策 API 设置类型 支持变异 管理控制台图片说明 政策 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 否 用于存储静态数据的区域 区域 enum：
  • REGION_UNSPECIFIED
  • ANY_REGION
  • US
  • EUROPE
区域> 数据处理 data_regions.data_processing_region 否 有关数据处理的数据区域政策 limit_to_storage_region 布尔值
访问权限审批 访问权限审批 > 访问权限审批政策 access_approval.axa_user_scoping 否 Google 员工需要先请求批准，才能查看支持服务所需的数据 requires_customer_approval 布尔值

设备设置

管理控制台中的页面 管理控制台中的特定设置 政策 API 设置类型 v1beta1 中支持的变异 管理控制台图片说明 政策 API 字段名称 数据类型
通用设置 数据访问 > Android 同步 devices.android_work_data_sync 否 允许在 Android 设备上同步工作数据 允许 布尔值
安全性 > 加密 devices.encryption 否 要求加密设备 device_encryption_option 枚举：
  • 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 否 允许将工作资料中的内容共享到个人空间（仅限装有工作资料的设备） 允许 布尔值
应用和数据共享 > Google Play 专用应用 devices.android_google_play_private_apps 否 允许用户使用 Google Play 专用应用 access_allowed 布尔值
允许用户发布和更新 Google Play 专用应用 publish_and_update_allowed 布尔值
应用和数据共享 > 屏幕截图 devices.android_screen_capture 否 允许屏幕截图 允许 布尔值
应用和数据共享 > 位置信息分享 devices.android_location_sharing 否 允许分享位置信息。 允许 布尔值
应用和数据共享 > 可用的应用 devices.android_available_apps 否 设置用户可以从 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 设置 高级安全> Apple Watch devices.ios_apple_watch 否 允许在未检测手腕的情况下使用 Apple Watch no_wrist_detection_usage_allowed 布尔值
高级安全功能 > 交接 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 否 允许用户通过“文件”连接至 U 盘（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 否 选择用户可以在 iOS 设备上使用相关 Google Workspace 数据执行的操作 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 布尔值
允许通过 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 writing_tools_allowed 布尔值
备份和 iCloud 同步 > 钥匙串同步 devices.ios_keychain_sync 否 允许用户通过 iCloud 同步钥匙串（仅限受监督的设备）。 icloud_sync_allowed 布尔值
备份和 iCloud 同步> 文档同步 devices.ios_document_sync 否 允许用户通过 iCloud 同步文档和数据。 icloud_data_sync_allowed 布尔值

目录设置

管理控制台中的页面 管理控制台中的特定设置 政策 API 设置类型 支持变异 管理控制台图片说明 政策 API 字段名称 数据类型
目录设置 共享设置 > 外部目录共享 directory.external_directory_sharing 否 不适用 sharing_option 枚举：
  • SHARING_OPTION_UNSPECIFIED
  • REQUESTER_BASIC_PROFILE_ONLY
  • ORGANIZATION_DIRECTORY_DATA

云端硬盘和文档设置

管理控制台中的页面 管理控制台中的特定设置 政策 API 设置类型 支持变异 管理控制台图片说明 政策 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 布尔值
当 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”中的用户或共享云端硬盘与“CUSTOMER_NAME”以外的非 Google 账号用户共享内容 allow_non_google_invites 布尔值
如果允许与“CUSTOMER_NAME”之外的人员共享内容，则“ORGANIZATION_UNIT_NAME”中的用户可将文件和发布的网络内容向所有知道链接的人公开 allow_publishing_files 布尔值
当用户通过 Google 文档或云端硬盘以外的 Google 产品共享文件时（例如，在 Gmail 中粘贴链接），Google 可以检查收件人是否拥有访问权限。如果没有的话，Google 会尽可能让用户选择是否要与以下对象共享文件 access_checker_suggestions enum：
  • RECIPIENTS_OR_AUDIENCE_OR_PUBLIC
  • RECIPIENTS_OR_AUDIENCE
  • RECIPIENTS_ONLY
选择应允许哪些人在 ORGANIZATION_UNIT_NAME 中分发 CUSTOMER_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 响应返回的值与界面值相反）
ORGANIZATION_UNIT_NAME中的用户创建的共享云端硬盘会分配给以下组织部门 org_unit_for_new_shared_drives enum：
  • 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 enum：
  • ALL
  • EDITORS_ONLY（管理员、贡献者和内容管理员）
  • MANAGERS_ONLY
允许内容管理员共享文件夹 allow_content_managers_to_share_folders 布尔值
共享设置 > 文件的安全更新 drive_and_docs.file_security_update 否 应用此更新可提高文件链接的安全性。此操作可能会导致用户收到文件访问权限请求 security_update enum：
  • APPLY_TO_IMPACTED_FILES
  • REMOVE_FROM_IMPACTED_FILES
允许用户为自己拥有或管理的文件移除/应用安全更新 allow_users_to_manage_update 布尔值
功能和应用 > Drive 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 否 将外部共享或外部拥有的文件标记为“外部”，以指示内容可能对您组织外部的用户可见。适用于云端硬盘、文档、表格、幻灯片、绘图和 Vids。 highlighting_enabled 布尔值

Gemini 应用设置

管理控制台中的页面 管理控制台中的特定设置 政策 API 设置类型 支持变异 管理控制台图片说明 政策 API 字段名称 数据类型
Gemini 应用 用户访问权限 gemini_app.unlicensed_user_access 否 允许所有用户使用 Gemini 应用，无论他们是否拥有许可 已启用 布尔值

Workspace 中的 Gemini 设置

管理控制台中的页面 管理控制台中的特定设置 政策 API 设置类型 支持变异 管理控制台图片说明 政策 API 字段名称 数据类型
Workspace 中的 Gemini Beta 版 Gemini 功能 > Beta 版功能 gemini_for_workspace.beta_features 否 开启 Gemini for Google Workspace 中 Beta 版功能的访问权限 已启用 布尔值
允许 Google 邀请所选组织部门或群组中的用户参与问卷调查和用户体验反馈调研，以改进 Gemini for Google Workspace feedback_and_testing_enabled 布尔值

Gmail 设置

管理控制台中的页面 管理控制台中的特定设置 政策 API 设置类型 支持变异 管理控制台图片说明 政策 API 字段名称 数据类型
Gmail 用户设置 > 机密模式 gmail.confidential_mode 否 启用机密模式 enable_confidential_mode 布尔值
用户设置 > 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 布尔值
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 enum：
  • WARNING
  • SPAM_FOLDER
  • QUARANTINE
  • NO_ACTION
选择隔离区 domain_name_spoofing_quarantine_id 整数
防范冒用员工姓名的欺骗行为 detect_employee_name_spoofing 布尔值
选择操作 employee_name_spoofing_consequence enum：
  • WARNING
  • SPAM_FOLDER
  • QUARANTINE
  • NO_ACTION
选择隔离区 employee_name_spoofing_quarantine_id 整数
防范冒充您网域的入站电子邮件 detect_domain_spoofing_from_unauthenticated_senders 布尔值
选择操作 domain_spoofing_consequence enum：
  • WARNING
  • SPAM_FOLDER
  • QUARANTINE
  • NO_ACTION
选择隔离区 domain_spoofing_quarantine_id 整数
防范所有未经身份验证的电子邮件 detect_unauthenticated_emails 布尔值
选择操作 unauthenticated_email_consequence enum：
  • WARNING
  • SPAM_FOLDER
  • QUARANTINE
  • NO_ACTION
选择隔离区 unauthenticated_email_quarantine_id 整数
防止他人利用您的网域假冒向您的群组发送电子邮件 detect_groups_spoofing 布尔值
将此设置应用于 groups_spoofing_visibility_type enum：
  • PRIVATE_GROUPS_ONLY
  • ALL_GROUPS
选择操作 groups_spoofing_consequence enum：
  • WARNING
  • SPAM_FOLDER
  • QUARANTINE
  • NO_ACTION
选择隔离区 groups_spoofing_quarantine_id 整数
自动应用未来的推荐设置 apply_future_settings_automatically 布尔值
安全 > 链接和外部图片 gmail.links_and_external_images 否 识别缩短网址背后的链接 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 enum：
  • WARNING
  • SPAM_FOLDER
  • QUARANTINE
选择隔离区 encrypted_attachment_protection_quarantine_id 整数
防范来自不可信发件人的含脚本附件 enable_attachment_with_scripts_protection 布尔值
选择操作 attachment_with_scripts_protection_consequence enum：
  • WARNING
  • SPAM_FOLDER
  • QUARANTINE
选择隔离区 attachment_with_scripts_protection_quarantine_id 整数
防范电子邮件中的异常附件类型 enable_anomalous_attachment_protection 布尔值
选择操作 anomalous_attachment_protection_consequence enum：
  • 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.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.user_email_uploads 否 向用户显示从 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 布尔值
First Last 或 Last, First 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 否 突出显示对话中的任何外部收件人。在用户回复包含外部收件人（不在其联系人中）的电子邮件之前，向用户显示警告。 已启用 布尔值
最终用户访问权限 > 图片网址代理许可名单 gmail.email_image_proxy_bypass 否 输入图片网址格式。相匹配的网址将绕过图片代理。 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 Web 离线版 gmail.web_offline 否 启用 Gmail 网页版离线功能 已启用 布尔值
在退出 Google 账号时强制删除离线数据 signout_data_deletion_enforced 布尔值

Gmail 子设置

下表列出了其他 Gmail 设置所引用的 Gmail 子设置。

政策 API 子设置名称 管理控制台图片说明 政策 API 字段名称 数据类型
EmailAddressList 不适用 id 字符串
名称 名称 字符串
添加地址列表 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 输入将显示在设置摘要中的简短说明 说明 字符串
受影响的电子邮件 条件 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 输入将显示在设置摘要中的简短说明 说明 字符串
受影响的电子邮件 条件 RuleConditions
自定义不良字词 objectionable_content_defined 布尔值
输入字词 objectionable_words string[]
如果上述表达式匹配，请执行以下操作 后果 RuleConsequences
不适用 rule_id 字符串
AttachmentComplianceRule 输入将显示在设置摘要中的简短说明 说明 字符串
受影响的电子邮件 条件 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 enum：
  • 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 整数
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
等于 枚举：<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 布尔值
视频和多媒体 视频 布尔值
音乐和声音 音乐 布尔值
Google 图片 图片 布尔值
已加密的压缩文件和归档文件 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 message if unable to sign and encrypt（无法签名和加密时系统退信） bounce_unencrypted_messages 布尔值
不向此收件人递送垃圾邮件 do_not_deliver_spam_to_recipient 布尔值
OAuthMailClientList 限定用户可以使用哪些邮件客户端（仅限 OAuth 邮件客户端） oauth_mail_client OAuthMailClient[]
OAuthMailClient 不适用 oauth_mail_client_id 字符串

Google 群组企业版设置

管理控制台中的页面 管理控制台中的特定设置 政策 API 设置类型 支持变异 管理控制台图片说明 政策 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 布尔值
群组所有者可以允许接收来自组织外部的电子邮件 ownersCanAllowIncomingMailFromPublic 布尔值
会话查看权限的默认设置 viewTopicsDefaultAccessLevel 枚举：
  • OWNERS
  • MANAGERS
  • GROUP_MEMBERS
  • DOMAIN_USERS
  • ANYONE_CAN_VIEW_TOPICS
群组所有者可以在目录中隐藏群组 ownersCanHideGroups 布尔值
隐藏新建的群组，使其不显示在目录中 newGroupsAreHidden 布尔值
管理控制台中的页面 管理控制台中的特定设置 政策 API 设置类型 支持变异 管理控制台图片说明 政策 API 字段名称 数据类型
账号设置 共享选项 cloud_sharing_options.cloud_data_sharing 否 Google Cloud Platform 共享选项 sharingOptions 枚举：
  • UNSUPPORTED
  • ENABLED
  • DISABLED

应用商店设置

管理控制台中的页面 管理控制台中的特定设置 政策 API 设置类型 支持变异 管理控制台图片说明 政策 API 字段名称 数据类型
应用列表 应用列表 workspace_marketplace.apps_allowlist 否 显示所有组织部门中用户的应用 应用 AppsAllowlistSetting[]
设置 管理应用访问权限 > 管理 Google Workspace Marketplace 许可名单的访问权限 workspace_marketplace.apps_access_options 否 选择用户可以运行和安装哪些 Marketplace 应用。 access_level enum：
  • ALLOW_ALL
  • ALLOW_LISTED_APPS
  • ALLOW_NONE

Marketplace 子设置

政策 API 子设置名称 管理控制台图片说明 政策 API 字段名称 数据类型
AppsAllowlistSetting 不适用 application_id 字符串
不适用 访问权限 enum：
  • ALLOWED
  • BLOCKED

API 响应中的 workspace_marketplace.apps_allowlist 设置会公开 Marketplace 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 设置

管理控制台中的页面 管理控制台中的特定设置 政策 API 设置类型 支持变异 管理控制台图片说明 政策 API 字段名称 数据类型
Google Meet Meet 视频设置 > 录制 meet.video_recording 否 允许用户录制会议。 enable_recording 布尔值
Meet 视频设置 > 自动转写 meet.automatic_transcription 否 系统默认转写会议 已启用 布尔值
Meet 视频设置 > 自动录制 meet.automatic_recording 否 系统默认录制会议 已启用 布尔值
满足安全设置> 网域 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 布尔值
Meet 安全设置 > 外部参与者警告 meet.safety_external_participants 否 表示“组织”以外或身份未经确认的参与者。 enable_external_label 布尔值
Meet 安全设置 > 加入 meet.joining 否 会议访问权限类型（受到网域中设置的限制） allowed_audience enum：
  • ALLOWED_AUDIENCE_UNSPECIFIED
  • OPEN
  • TRUSTED
  • RESTRICTED
Meet 安全设置 > 聊天 meet.messaging 否 谁可以在通话期间发送聊天消息 已启用 布尔值
Meet 安全设置 > 演示 meet.presenting 否 谁可以在通话期间共享屏幕。 已启用 布尔值
Meet 安全设置 > 问答 meet.questions 否 谁可以在通话期间参加问答 已启用 布尔值
Meet 安全设置 > 投票 meet.polls 否 谁可以在通话期间参加投票 已启用 布尔值
满足安全设置 > 来电限制 meet.meet_incoming_call_restrictions 否 此设置仅影响 Meet 通话，不影响旧版服务或 Google Chat 中的通话。“访问权限”中设置的限制可以进一步限制用户能够接听的电话。 allowed_callers enum：
  • ALLOWED_CALLERS_UNSPECIFIED
  • ALL
  • CONTACTS_AND_ORGANIZATION_ONLY
  • NONE

配置设置

管理控制台中的页面 管理控制台中的特定设置 政策 API 设置类型 v1beta1 中支持的变异 管理控制台图片说明 政策 API 字段名称 数据类型
账号设置 有冲突的账号管理 provisioning.conflicting_accounts_management 否 选择如何管理有冲突的账号 选项 enum：
  • OPTION_UNSPECIFIED
  • AUTOMATICALLY_SEND_INVITATIONS
  • REPLACE_CONFLICTING_ACCOUNT
  • PRESERVE_CONFLICTING_ACCOUNT
发送每日跟进电子邮件，持续时间为（指定）天 automatic_invitations.invitation_count 整数
如果用户在所选的后续跟进时间段内未接受邀请 automatic_invitations.unaccepted_invitation_resolution_option enum：
  • UNACCEPTED_INVITATION_RESOLUTION_OPTION_UNSPECIFIED
  • REPLACE_CONFLICTING_ACCOUNT_ON_NEXT_CREATION
  • PRESERVE_CONFLICTING_ACCOUNT_ON_NEXT_CREATION

“规则和检测器”设置

本部分介绍了规则和检测器的设置。

数据保护规则设置

如需大致了解如何为受支持的应用创建数据保护规则和检测器，请参阅创建数据保护规则。

管理控制台中的页面 管理控制台中的特定设置 政策 API 设置类型 支持变异 管理控制台图片说明 政策 API 字段名称 数据类型
数据保护 安全性 > 访问权限和数据控件 > 数据保护 > 管理规则 rule.dlp 是 名称 display_name 字符串
说明 说明 字符串
应用 触发器 string[] - 应用特有的触发字符串列表。指定要监控的一个或多个触发器。当发生任何指定的触发条件时，系统会评估规则。如需了解可用的值，请参阅触发器部分。
条件 条件 string - 规则扫描的数据条件的通用表达式语言 (CEL) 表达式。以下“条件”部分提供了 CEL 语法和一些常见示例。
操作 action 结构体 - 嵌套对象，表示满足条件时要采取的应用特定操作。以下“操作”部分提供了每个应用触发器可执行的操作。
State state enum：
  • 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
访问过的网址 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} 表示要扫描的预定义数据类型，可以是 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 网址访问”触发器的网址类别匹配选项。
    • {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 添加自定义备注（页脚）
聊天 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 枚举 指定要针对哪些范围的用户停用下载、打印和复制功能。
  • 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 枚举 自定义备注在邮件中的位置：TOP 或 BOTTOM。
apply_labels.label_delta Struct[] 要应用的标签更改列表。每个对象包含：
  • label_id：字符串
  • field_delta：包含以下字段的结构体：
    • field_id：字符串
    • selection：字符串（适用于单选字段）
    • selection_list：包含 operation（SET、MERGE）和 values（字符串数组）的结构体
apply_labels.conflict_resolution_strategy 枚举 解决冲突的策略：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 字符串 当网址导航规则触发时，以水印形式显示的文字。
custom_end_user_message.unsafe_html_message_body 字符串 规则触发时要向最终用户显示的 HTML 消息内容。仅支持 <a> 标记。
block_screenshot 布尔值 设置为 true 时，会禁止截屏和共享屏幕。
match_only_download_url 布尔值 仅根据下载网址评估规则，忽略标签页网址。
force_save_to_cloud_sub_action.destination 枚举 强制保存的目标云端存储空间，而不是本地文件系统。
  • DESTINATION_UNSPECIFIED：未指定目的地。
  • GOOGLE_DRIVE_CORP：将文件保存到公司 Google 云端硬盘。
  • ONEDRIVE_CORP：将文件保存到公司 Microsoft OneDrive。
data_masking.regex_detector Struct[] 用于数据遮盖的正则表达式检测器列表。以对象列表的形式指定一个或多个检测器，每个对象都包含下表中所述的字段。
data_masking.regex_detector[].mask_type 枚举 当正则表达式匹配时要应用的遮盖类型。
  • MASK_TYPE_LIGHT_OBFUSCATION：将指针悬停在遮盖的文字上时，可以显示这些文字。
  • MASK_TYPE_HARD_OBFUSCATION：在点击鼠标时，可以显示遮盖的文字。
  • MASK_TYPE_REDACT：文本被完全替换，无法恢复。
data_masking.regex_detector[].resource_name 字符串 检测器资源的标识符。
data_masking.regex_detector[].display_name 字符串 检测器触发时在报告工具（例如安全调查工具）中显示的名称。
data_masking.regex_detector[].regex_pattern 字符串 用于匹配的正则表达式模式。此字段由系统填充，不应由用户设置。

ChromeOS 操作参数

参数 数据类型 说明
save_content 布尔值 启用安全地保存触发此规则的内容。

特定于规则类型的元数据

此属性包含特定于规则类型的元数据。对于数据保护规则，此字段包含在安全信息中心和提醒中心报告事件时，提醒事件的严重程度。表示低严重程度提醒的元数据值示例：

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

数据保护检测器设置

如需大致了解数据保护规则和检测器，请参阅创建云端硬盘数据泄露防护规则和自定义内容检测器。

管理控制台中的页面 管理控制台中的特定设置 政策 API 设置类型 支持变异 管理控制台图片说明 政策 API 字段名称 数据类型
数据保护 安全性 > 访问权限和数据控件 > 数据保护 > 管理检测器 detector.regular_expression detector.word_list 是 名称 display_name 字符串
说明 说明 字符串
正则表达式 regular_expression 结构体 - 包含正则表达式字符串。仅当检测器类型为 detector.regular_expression 时才设置。
字词列表 word_list 字符串 - 包含字词字符串列表。仅当检测器类型为 detector.word_list 时才设置。
创建时间 create_time 时间戳
上次修改时间 update_time 时间戳

系统定义的提醒规则设置

本部分介绍了 Google Workspace 系统定义的提醒规则。

管理控制台中的页面 管理控制台中的特定设置 政策 API 设置类型 支持变异 管理控制台图片说明 政策 API 字段名称 数据类型
数据保护 规则（适用于“系统指定”规则类型） rule.system_defined_alerts 否 名称 display_name 字符串
说明 说明 字符串
操作 action 结构体 - 嵌套对象，表示触发系统定义的提醒时的通知设置。详细信息请参阅下文的“操作”部分。
State state enum：
  • ACTIVE
  • INACTIVE
创建时间 create_time 时间戳
上次修改时间 update_time 时间戳

操作

系统定义的提醒规则具有一个操作，用于表示提醒的通知设置。

快捷操作按键 子操作 管理控制台图片说明 说明
alertCenterAction alertCenterConfig 发送到提醒中心 配置提醒严重程度以及是否将提醒发送到提醒中心。
收件人 发送电子邮件通知 触发提醒时要向其发送通知的电子邮件地址列表。

操作参数

下表提供了 alertCenterAction 的参数：

参数 数据类型 说明
alertCenterConfig.severity 枚举 警报的严重程度（例如 LOW、MEDIUM、HIGH）。
alertCenterConfig.status 枚举 提醒是否发送到提醒中心（例如 ENABLED、DISABLED）。
recipients string[] 接收电子邮件通知的电子邮件地址列表。

安全设置

管理控制台中的页面 管理控制台中的特定设置 政策 API 设置类型 支持变异 管理控制台图片说明 政策 API 字段名称 数据类型
账号恢复 超级用户账号恢复 security.super_admin_account_recovery 否 允许超级用户恢复自己的账号 enableAccountRecovery 布尔值
用户账号恢复 security.user_account_recovery 否 允许用户和非超级用户恢复自己的账号 enableAccountRecovery 布尔值
密码管理 密码管理 security.password 否 失效 expirationDuration 秒数 （0 秒表示永不过期）
重复使用 allowReuse 布尔值
强制执行强度和长度要求 enforceRequirementsAtLogin 布尔值
长度（最大长度） maximumLength 整数
长度（最短长度） minimumLength 整数
强度 allowedStrength enum：
  • STRONG
  • WEAK
Google 会话控制 会话控制 security.session_controls 否 网络会话时长 webSessionDuration 秒
安全性较低的应用 安全性较低的应用 security.less_secure_apps 否 控制用户对采用安全性较低的登录技术的应用的访问权限，这类应用会使账号更容易受到攻击。 allowLessSecureApps 布尔值
登录验证 登录验证 security.login_challenges 否 使用员工 ID 以提升用户账号的安全性 enableEmployeeIdChallenge 布尔值
免密码 通行密钥限制 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 布尔值
安全码 securityCodeOption enum：
  • ALLOWED_WITH_REMOTE_ACCESS
  • ALLOWED_WITHOUT_REMOTE_ACCESS
  • CODES_NOT_ALLOWED
两步验证 身份验证 security.two_step_verification_enrollment 否 允许用户启用两步验证 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 enum：
  • ALL
  • PASSKEY_ONLY
  • PASSKEY_PLUS_SECURITY_CODE
  • PASSKEY_PLUS_IP_BOUND_SECURITY_CODE
  • NO_TELEPHONY
security.two_step_verification_sign_in_code 两步验证政策中止宽限期 backupCodeExceptionPeriod 时长
多方审批设置 多方审批设置 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
使用第三方身份提供商的单点登录服务 sso_with_third_party_idps_multi_party_approval_state
情境感知访问权限 context_aware_access_multi_party_approval_state
安全设置的 API 访问权限对应的多方审批 multi_party_approval.security_actions_api_access 否 使用第三方身份提供商的单点登录服务 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
Google 云端硬盘和 Google 文档 drive_and_docs
Gmail Gmail
Google Chat 聊天
Google Meet meet
Google 保险柜 保险柜
Google Voice 语音
群组企业版 groups_for_business
保留 keep
Google 协作平台 网站
任务 任务

附加 Google 服务

管理控制台中的服务名称 Policy API 中的服务名称
AI Studio ai_studio
应用数字技能 applied_digital_skills
分配 作业
Blogger 博主
品牌账号 brand_accounts
Campaign Manager 360 campaign_manager
Chrome 画布 chrome_canvas
Chrome 手写板 chrome_cursive
Chrome 远程桌面 chrome_remote_desktop
Chrome 应用商店 chrome_web_store
Google 课堂 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 图书 图书
Google Chrome 同步 chrome_sync
Google Cloud 云
Google 云打印 cloud_print
Google Colab Colab
Google 开发者 开发者
Google Domains 网域
Google 地球 地球
Google Fi fi
Google 群组 群组
Google 地图 地图
Google 信息 消息
Google 我的商家 my_business
Google My Maps my_maps
Google 新闻 新闻
Google Pay 支付
Google 相册 照片
Google Play 播放
Google Play 管理中心 play_console
Google 公开数据浏览器 public_data
Google Read Along read_along
Google Search Console search_console
Google Takeout 外带
Google 翻译 翻译
Google 旅行 行程
Jamboard jamboard
位置记录 location_history
数据洞察 data_studio
Google Play 企业版 managed_play
Material Gallery material_gallery
Merchant Center merchant_center
Partner Dash partner_dash
Pinpoint 精确定位
Google Play 图书合作伙伴中心 play_books_partner_center
可编程搜索引擎 programmable_search_engine
QuestionHub question_hub
Google 学术搜索个人资料 scholar_profiles
Search Ads 360 search_ads_360
Google 搜索和 Google 助理 search_and_assistant
Socratic socratic
Studio 工作室
第三方应用备份 third_party_app_backups
Tour Creator tour_creator
数字化转型洞察 work_insights
YouTube YouTube

生成式 AI

管理控制台中的服务名称 Policy API 中的服务名称
Gemini 应用 gemini_app
NotebookLM notebooklm

Google 协作平台设置

管理控制台中的页面 管理控制台中的特定设置 政策 API 设置类型 支持变异 管理控制台图片说明 政策 API 字段名称 数据类型
Google 协作平台 新版协作平台 > 协作平台创建和修改 sites.sites_creation_and_modification 否 允许用户新建网站 allowSitesCreation 布尔值
用户可以/无法修改网站 allowSitesModification 布尔值

UserTakeout 设置

管理控制台中的页面 管理控制台中的特定设置 政策 API 设置类型 支持变异 管理控制台图片说明 政策 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