Stay organized with collections
Save and categorize content based on your preferences.
Settings available in the API
This document describes the settings that the Policy API supports.
Security Settings
Page in Admin Console
Specific Setting in Admin Console
Policy API setting type
Admin Console Caption
Policy API Field Name
Data Type
Account Recovery
Super Admin Account Recovery
security.super_admin_account_recovery
Allow super admins to recover their account
enableAccountRecovery
Boolean
User Account Recovery
security.user_account_recovery
Allow users and non-super admins to recover their account
enableAccountRecovery
Boolean
Password Management
Password Management
security.password
Expiration
expirationDuration
Seconds
(0 seconds means Never Expire)
Reuse
allowReuse
Boolean
Strength and Length enforcement
enforceRequirementsAtLogin
Boolean
Length (Maximum length)
maximumLength
Integer
Length (Minimum length)
minimumLength
Integer
Strength
allowedStrength
Enum:
STRONG
WEAK
Google Session Control
Session Control
security.session_controls
Web session duration
webSessionDuration
Seconds
Less secure apps
Less secure apps
security.less_secure_apps
Control user access to apps that use less secure sign-in technology and make accounts more vulnerable.
allowLessSecureApps
Boolean
Login challenges
Login Challenges
security.login_challenges
Use employee ID to keep my users more secure
enableEmployeeIdChallenge
Boolean
Advanced Protection Program
Enrollment
security.advanced_protection_program
Use employee ID to keep my users more secure
enableAdvancedProtectionSelfEnrollment
Boolean
Security Codes
securityCodeOption
Enum:
ALLOWED_WITH_REMOTE_ACCESS
ALLOWED_WITHOUT_REMOTE_ACCESS
CODES_NOT_ALLOWED
UserTakeout Settings
Page in Admin Console
Specific Setting in Admin Console
Policy API setting type
Admin Console Caption
Policy API Field Name
Data Type
Data
Data import & export > Google Takeout > User access to Takeout for Google services
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
Manage user access to Takeout for Google services
takeout_status
Enum:
TAKEOUT_STATUS_UNSPECIFIED
ENABLED
DISABLED
Marketplace Settings
Page in Admin Console
Specific Setting in Admin Console
Policy API setting type
Admin Console Caption
Policy API Field Name
Data Type
Apps list
Apps list
workspace_marketplace.apps_allowlist
Showing apps for users in all organizational units
apps
List of apps containing application_id and access status as ALLOWED or BLOCKED.
Settings
Manage access to apps > Manage Google Workspace Marketplace allowlist access
workspace_marketplace.apps_access_options
Select which Marketplace apps users can run and install.
access_level
Enum:
ALLOW_ALL
ALLOW_LISTED_APPS
ALLOW_NONE
The Setting workspace_marketplace.apps_allowlist in the API response exposes the Marketplace application_id instead of application_name. The following Python script can be used to convert one or more application_id that are specified on the command line to 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)
Service Status Settings
The service_status setting contains a Boolean value implying a service is enabled for a certain OrgUnit or Group.
The Policy API supports service status settings for both Workspace services and Additional services listed in the Admin Console under Apps.
Service Name in Admin Console
Policy API service name
Calendar
calendar
Cloud Search
cloud_search
Drive and Docs
drive_and_editors
Currents
currents
Groups for Business
groups_for_business
Jamboard
jamboard
Keep
keep
Google Chat
chat
Google Meet
meet
Google Voice
voice
Google Sites
sites
Tasks
tasks
Vault
vault
Work Insights
work_insights
AppSheet
appsheet
Applied Digital Skills
applied_digital_skills
Assignments
assignments
Blogger
blogger
Brand Accounts
brand_accounts
Campaign Manager 360
campaign_manager
Chrome Canvas
chrome_canvas
Chrome Remote Desktop
chrome_remote_desktop
Chrome Web Store
chrome_web_store
Classroom
classroom
CS First
cs_first
Experimental Apps
experimental_apps
FeedBurner
feedburner
Google Ad Manager
ad_manager
Google Ads
ads
Google AdSense
adsense
Google Alerts
alerts
Google Analytics
analytics
Google Arts & Culture
arts_and_culture
Google Bookmarks
bookmarks
Google Books
books
Google Chrome Sync
chrome_sync
Google Cloud
cloud
Google Cloud Print
cloud_print
Google Colab
colab
Google Developer
developers
Google Domains
domains
Google Earth
earth
Google Fi
fi
Google Groups
groups
Google Maps
maps
Google Messages
messages
Google My Business
my_business
Google My Maps
my_maps
Google News
news
Google Pay
pay
Google Photos
photos
Google Play
play
Google Play Console
play_console
Google Public Data Explorer
public_data
Google Read Along
read_along
Google Search Console
search_console
Google Takeout
takeout
Google Translate
translate
Google Trips
trips
Location History
location_history
Looker Studio
data_studio
Managed Google Play
managed_play
Material Gallery
material_gallery
Merchant Center
merchant_center
Partner Dash
partner_dash
Pinpoint
pinpoint
Play Books Partner Center
play_books_partner_center
Programmable Search Engine
programmable_search_engine
QuestionHub
question_hub
Scholar Profiles
scholar_profiles
Search Ads 360
search_ads_360
Search and Assistant
search_and_assistant
Socratic
socratic
Studio
studio
Third-party App Backups
third_party_app_backups
Tour Creator
tour_creator
YouTube
youtube
Additional services without individual control
enterprise_service_restrictions
Gmail Settings
Page in Admin Console
Specific Setting in Admin Console
Policy API setting type
Admin Console Caption
Policy API Field Name
Data Type
Gmail
User Settings > Confidential Model
gmail.confidential_mode
Enable confidential mode
enable_confidential_mode
boolean
User Settings > S/MIME
gmail.enhanced_smime_encryption
Allow users to upload their own certificates
allow_user_to_upload_certificates
boolean
Accept these additional root certificates for specific domains:
custom_root_certificates
A list of CustomRootCertificates which contains a list of root certificates, a list of intermediate CA certificates, a list of restricted domain names, a boolean to allow address mismatch and an enum with different validation levels.
Spam, phishing, and malware > Enhanced pre-delivery message scanning
gmail.enhanced_pre_delivery_message_scanning
Enables improved detection of suspicious content prior to delivery
enable_improved_suspicious_content_detection
boolean
Spam, phishing, and malware > Email allowlist
gmail.email_spam_filter_ip_allowlist
Enter the IP addresses for your email allowlist
allowed_ip_addresses
A list of strings
Safety > Spoofing and authentication
gmail.spoofing_and_authentication
Protect against domain spoofing based on similar domain names
detect_domain_name_spoofing
boolean
Choose an action
domain_name_spoofing_consequence
Enum:
WARNING
SPAM_FOLDER
QUARANTINE
NO_ACTION
Protect against spoofing of employee names
detect_employee_name_spoofing
boolean
Choose an action
employee_name_spoofing_consequences
Enum:
WARNING
SPAM_FOLDER
QUARANTINE
NO_ACTION
Protect against inbound emails spoofing your domain
Protect your Groups from inbound emails spoofing your domain
detect_groups_spoofing
boolean
Apply this setting to
groups_spoofing_group_type
Enum:
PRIVATE_GROUPS_ONLY
ALL_GROUPS
Choose an action
groups_spoofing_consequences
Enum:
WARNING
SPAM_FOLDER
QUARANTINE
NO_ACTION
Apply future recommended settings automatically
apply_future_settings_automatically
boolean
Safety > Links and external images
gmail.links_and_external_images
Identify links behind shortened URLs
enable_shortener_scanning
boolean
Scan linked images
enable_external_image_scanning
boolean
Show warning prompt for any click on links to untrusted domains
enable_aggressive_warnings_on_untrusted_links
boolean
Apply future recommended settings automatically
apply_future_settings_automatically
boolean
Safety > Attachments
gmail.email_attachment_safety
Protect against encrypted attachments from untrusted senders
enable_encrypted_attachment_protection
boolean
Choose an action
encrypted_attachment_protection_consequence
Enum:
WARNING
SPAM_FOLDER
QUARANTINE
Protect against attachments with scripts from untrusted senders
enable_attachment_with_scripts_protection
boolean
Choose an action
attachment_with_scripts_protection_consequence
Enum:
WARNING
SPAM_FOLDER
QUARANTINE
Protect against anomalous attachment types in emails
enable_anomalous_attachment_protection
boolean
Choose an action
anomalous_attachment_protection_consequence
Enum:
WARNING
SPAM_FOLDER
QUARANTINE
Apply future recommended settings automatically
apply_future_recommended_settings_automatically
boolean
Chat Settings
Page in Admin Console
Specific Setting in Admin Console
Policy API setting type
Admin Console Caption
Policy API Field Name
Data Type
Google Chat
History for chats
chat.chat_history
History is ON/OFF
history_on_by_default
boolean
Allow users to change their history setting
allow_user_modification
boolean
Chat File Sharing
chat.chat_file_sharing
External filesharing
external_file_sharing
Enum:
ALL_FILES
IMAGES_ONLY
NO_FILES
FILE_SHARING_OPTION_UNSPECIFIED
internal_file_sharing
same
History for spaces
chat.space_history
Conversation history settings for spaces
history_state
Enum:
DEFAULT_HISTORY_ON
DEFAULT_HISTORY_OFF
HISTORY_ALWAYS_ON
HISTORY_ALWAYS_OFF
HISTORY_STATE_UNSPECIFIED
External Chat Settings
chat.external_chat_restriction
Allow users to send messages outside organization in chats and spaces
allow_external_chat
boolean
external_chat_restriction
Enum:
NO_RESTRICTION
TRUSTED_DOMAINS
RESTRICTION_UNSPECIFIED
Chat apps
chat.chat_apps_access
Allow users to install Chat apps
enable_apps
boolean
Allow users to add and use incoming webhooks
enable_webhooks
boolean
Drive and Docs Settings
Page in Admin Console
Specific Setting in Admin Console
Policy API setting type
Admin Console Caption
Policy API Field Name
Data Type
Drive and Docs
Sharing settings > Sharing options
drive_and_docs.external_sharing
Select the highest level of sharing outside of $CUSTOMER_NAME that you want to allow
external_sharing_mode
Enum:
DISALLOWED
ALLOWLISTED_DOMAINS
ALLOWED
Allow users in $ORG_UNIT_NAME to receive files from users or shared drives outside of $CUSTOMER_NAME
allow_receiving_external_files
Boolean
Warn when files owned by users or shared drives in $ORG_UNIT_NAME are shared with users in allowlisted domains
warn_for_sharing_outside_allowlisted_domains
Boolean
Allow users in $ORG_UNIT_NAME to receive files from users or shared drives outside of allowlisted domains
allow_receiving_files_outside_allowlisted_domains
Boolean
Allow users or shared drives in $ORG_UNIT_NAME to share items with non-Google users in trusted domains using visitor sharing
allow_non_google_invites_in_allowlisted_domains
Boolean
Warn when files owned by users or shared drives in $ORG_UNIT_NAME are shared outside of $CUSTOMER_NAME
warn_for_external_sharing
Boolean
Allow users or shared drives in $ORG_UNIT_NAME to share items with people outside $CUSTOMER_NAME who aren't using a Google Account
allow_non_google_invites
Boolean
When sharing outside of $CUSTOMER_NAME is allowed, users in $ORG_UNIT_NAME can make files and published web content visible to anyone with the link
allow_publishing_files
Boolean
When a user shares a file via a Google product other than Docs or Drive (e.g. by pasting a link in Gmail), Google can check that the recipients have access. If not, when possible, Google will ask the user to pick if they want to share the file to
access_checker_suggestions
Enum:
RECIPIENTS_OR_AUDIENCE_OR_PUBLIC
RECIPIENTS_OR_AUDIENCE
RECIPIENTS_ONLY
Select who should be allowed to distribute content in $ORG_UNIT_NAME outside of $CUSTOMER_NAME. This restricts who can upload or move content to shared drives owned by another organization
allowed_parties_for_distributing_content
Enum:
ALL_ELIGIBLE_USERS
ELIGIBLE_INTERNAL_USERS
NONE
Sharing settings > General access default
drive_and_docs.general_access_default
When users in $ORG_UNIT_NAME create items, the default access will be
default_file_access
Enum:
PRIVATE_TO_OWNER
PRIMARY_AUDIENCE_WITH_LINK
PRIMARY_AUDIENCE_WITH_LINK_OR_SEARCH
Sharing settings > Shared drive creation
drive_and_docs.shared_drive_creation
Prevent users in $ORG_UNIT_NAME from creating new shared drives
allow_shared_drive_creation
Boolean (The API response returns the opposite of the UI value)
When users in $ORG_UNIT_NAME create a shared drive, it will be assigned to the following organizational unit
org_unit_for_new_shared_drives
Enum:
CREATOR_ORG_UNIT
CUSTOM_ORG_UNIT
Selected organizational unit
custom_org_unit
String
Allow members with manager access to override the settings below
allow_managers_to_override_settings
Boolean
Allow users outside $CUSTOMER_NAME to access files in shared drives
allow_external_user_access
Boolean
Allow people who aren't shared drive members to be added to files
allow_non_member_access
Boolean
Allow viewers and commenters to download, print, and copy files
allowed_parties_for_download_print_copy
Enum:
ALL (when the checkbox in the UI is checked)
EDITORS_ONLY (when the checkbox in the UI is unchecked)
Allow content managers to share folders
allow_content_managers_to_share_folders
Boolean
Sharing settings > Security update for files
drive_and_docs.file_security_update
Applying this update will make file links more secure. This may cause users to receive file access requests
security_update
Enum:
APPLY_TO_IMPACTED_FILES
REMOVE_FROM_IMPACTED_FILES
Allow users to remove/apply the security update for files they own or manage
allow_users_to_manage_update
Boolean
Features and Applications > Drive SDK
drive_and_docs.drive_sdk
Allow users to access Google Drive with the Drive SDK API
enable_drive_sdk_api_access
Boolean
Google Drive for desktop > Enable Drive for desktop
drive_and_docs.drive_for_desktop
Allow Google Drive for desktop in your organization
allow_drive_for_desktop
Boolean
Only allow Google Drive for desktop on authorized devices
restrict_to_authorized_devices
Boolean
Show Google Drive for desktop download link
show_download_link
Boolean
Allow users to enable real-time presence in Microsoft Office from Google Drive for desktop
allow_real_time_presence
Boolean
Meet Settings
Page in Admin Console
Specific Setting in Admin Console
Policy API setting type
Admin Console Caption
Policy API Field Name
Data Type
Google Meet
Meet video settings > Recording
meet.video_recording
Let people record their meetings.
enable_recording
boolean
Meet safety settings > Domain
meet.safety_domain
Who can join meetings created by your organization.
users_allowed_to_join
Enum:
SAME_ORGANIZATION_ONLY
LOGGED_IN
ALL
Meet safety settings > Access
meet.safety_access
Which meetings or calls users in the organization can join. "Incoming call restrictions" can further limit the calls that users can receive.
meetings_allowed_to_join
Enum:
SAME_ORGANIZATION_ONLY
ANY_WORKSPACE_ORGANIZATION
ALL
Meet safety settings > Host management
meet.safety_host_management
Default host management
enable_host_management
Boolean
Meet safety settings > Warn for external participants
meet.safety_external_participants
Indicates participants who are outside "Organization" or whose identities are unconfirmed.
enable_external_label
Boolean
Sites Settings
Page in Admin Console
Specific Setting in Admin Console
Policy API setting type
Admin Console Caption
Policy API Field Name
Data Type
Sites
New Sites > Site creation and editing
sites.sites_creation_and_modification
Allow users to create new sites
allowSitesCreation
Boolean
Users can/cannot edit sites
allowSitesModification
Boolean
Groups For Business Settings
Page in Admin Console
Specific Setting in Admin Console
Policy API setting type
Admin Console Caption
Policy API Field Name
Data Type
Groups For Business
Sharing settings > Sharing options
groups_for_business.groups_sharing
Set policies for changing group sharing settings
collaborationCapability
Enum:
ANYONE_CAN_ACCESS
DOMAIN_USERS_ONLY
Creating groups
createGroupsAccessLevel
Enum:
ADMIN_ONLY
USERS_IN_DOMAIN
ANYONE_CAN_CREATE
Group owners can allow external members
ownersCanAllowExternalMembers
Boolean
Group owners can allow incoming email from outside the organization
ownersCanAllowIncomingMailFromPublic
Boolean
Default for permission to view conversations
viewTopicsDefaultAccessLevel
Enum:
OWNERS
MANAGERS
GROUP_MEMBERS
DOMAIN_USERS
ANYONE_CAN_VIEE_TOPICS
Group owners can hide groups from the directory
ownersCanHideGroups
Boolean
Hide newly created groups from the directory
newGroupsAreHidden
Boolean
Classroom Settings
Page in Admin Console
Specific Setting in Admin Console
Policy API setting type
Admin Console Caption
Policy API Field Name
Data Type
Classroom
General Settings > Teacher permissions
classroom.teacher_permissions
Who can create classes
whoCanCreateClasses
Enum:
ANYONE_IN_DOMAIN
ALL_PENDING_AND_VERIFIED_TEACHERS
VERIFIED_TEACHERS_ONLY
General Settings > Guardian access
classroom.guardian_access
Allow parents and guardians to access Classroom information
allowAccess
Boolean
Who can manage parents and guardians
whoCanManageGuardianAccess
Enum:
VERIFIED_TEACHERS_AND_DOMAIN_ADMINS
DOMAIN_ADMINS_ONLY
Class settings > About class membership
classroom.class_membership
Who can join classes in your domain
whoCanJoinClasses
Enum:
ANYONE_IN_DOMAIN
ANYONE_IN_ALLOWLISTED_DOMAINS
ANY_GOOGLE_WORKSPACE_USER
ANYONE
Which classes can users in your domain join
whichClassesCanUsersJoin
Enum:
CLASSES_IN_DOMAIN
CLASSES_IN_ALLOWLISTED_DOMAINS
ANY_GOOGLE_WORKSPACE_CLASS
Data access > Classroom API
classroom.api_data_access
Users can authorize apps to access their Google Classroom data
Security > Access and data control > Data Protection > Manage Rules
rule.dlp
Name
display_name
String
Description
description
String
Apps
triggers
String[] - List of app specific trigger strings. The list of available app triggers is provided in the following Triggers section.
Conditions
condition
String - Common Expression Language (CEL) expression of the data conditions the rule scans for. The CEL syntax and some common examples are provided in the following Conditions section.
Actions
action
Struct - nested object representing app specific actions to take when the conditions are met. The available actions per app trigger are provided in the following Actions section.
State
state
Enum:
ACTIVE
INACTIVE
Created
create_time
Timestamp
Last modified
update_time
Timestamp
Rule type specific metadata
rule_type_metadata
Struct - nested object representing rule type specific metadata. For Data Protection rules, this contains the severity level of the triggered events.
Triggers
The list of available applications and their triggers.
"google.workspace.chrome.file.v1.upload"
"google.workspace.chrome.file.v1.download"
"google.workspace.chrome.web_content.v1.upload"
"google.workspace.chrome.page.v1.print"
"google.workspace.chrome.url.v1.navigation"
"google.workspace.chromeos.file.v1.transfer"
"google.workspace.chat.message.v1.send"
"google.workspace.chat.attachment.v1.upload"
"google.workspace.drive.file.v1.share"
"google.workspace.gmail.email.v1.send"
Conditions
To represent data conditions, the API uses Common Expressions Language (CEL) expressions. Each condition follows the pattern of {content type}.{content to scan for}({additional scan parameters}). For example, all_content.contains('apple') represents a data condition that matches if any of the scanned content (e.g. Drive doc, chat message, etc) contains the substring apple.
Content type
The list of available content types, corresponding to the matching configurations of the same names in the Admin Console.
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
Content to scan for
The list of available content to scan for, corresponding to the matching configurations of the same names in the Admin Console.
Corresponds to the matches predefined data type option in the Admin Console.
{detector name} denotes the predefined data type to scan for, which can be one of the built-in infotypes supported by Cloud DLP: https://cloud.google.com/sensitive-data-protection/docs/infotypes-reference. For example, CREDIT_CARD_NUMBER or US_SOCIAL_SECURITY_NUMBER
{likelihood} denotes the likelihood threshold of the match. For example, google.privacy.dlp.v2.Likelihood.LIKELY corresponds to the High threshold in the Admin Console.
Corresponds to the matches regular expression option in the Admin Console.
{detector name} is the resource name of the policy that represents the regular expression detector. See Data Protection Detector section on how to query detector policies in the API.
Corresponds to the matches words from word list option in the Admin Console.
{detector name} is the resource name of the policy that represents the word list detector. See Data Protection Detector section on how to query detector policies in the API.
matches_web_category({category})
Corresponds to the URL category matches option in the Admin Console for Chrome URL visited trigger.
{category} denotes the URL category supported by the Admin Console configuration. For example ADULT or ONLINE_COMMUNITIES__SOCIAL_NETWORKS.
Composite conditions
Multiple base conditions can be mixed with AND (&&), OR (||), or NOT (!) operators to form a composite condition. For example, "all_content.contains('apple') && all_content.contains('banana')" represents a condition that matches if any of the scanned content contains both 'apple' and 'banana' substrings.
Actions
Each application specifies the action to take when the data condition matches in a nested message. For example, { "driveAction" { "warnUser" { } } } represents a Drive action that warns users on external sharing. The application specific actions available are following:
Application
Action Key
Subaction
Admin Console Caption
Drive
driveAction
blockAccess
Block external sharing
warnUser
Warn on external sharing
auditOnly
no action
restrictCopyPrintDownload
Disable download, print, and copy
applyLabels
Apply Classification labels
Gmail
gmailAction
blockContent
Block message
warnUser
Warn users
auditOnly
Audit only
quarantineMessage
Quarantine message
Chat
chatAction
blockContent
Block message
warnUser
Warn users
auditOnly
Audit only
Chrome
chromeAction
blockContent
Block
warnUser
Allow with warning
Rule type specific metadata
This attribute contains the metadata specific to the rule type. For Data Protection rules, it contains the alerting event severity when the event is reported under the security dashboard and alert center. An example value of the metadata representing LOW alert severity:
Security > Access and data control > Data Protection > Manage Detectors
detector.regular_expressiondetector.word_list
Name
display_name
String
Description
description
String
Regular Expression
regular_expression
Struct - contains the regular expression string. Only set if the detector type is detector.regular_expression.
Word List
word_list
String - contains the list of word strings. Only set if the detector type is detector.word_list.
Created
create_time
Timestamp
Last modified
update_time
Timestamp
System Defined Alert Rules Settings
This section describes Google Workspace system-defined alert rules.
The API returns only system-defined alerts that are modified from the default
value by the administrator.
Page in Admin Console
Specific Setting in Admin Console
Policy API setting type
Admin Console Caption
Policy API Field Name
Data Type
Data Protection
Rules (for "system defined' rule type)
rule.system_defined_alerts
Name
display_name
String
Description
description
String
Actions
action
Struct - nested object representing notification settings when the system defined alert is triggered. Details are provided in the following Actions section.
State
state
Enum:
ACTIVE
INACTIVE
Created
create_time
Timestamp
Last modified
update_time
Timestamp
Actions
System defined alert rules have a single action that denotes the notification settings for the alert.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-11-22 UTC."],[],[]]