Paramètres disponibles dans l'API

Ce document décrit les paramètres compatibles avec l'API Policy.

Si les paramètres compatibles ne figurent pas dans la réponse de l'API Cloud Identity Policy, consultez Valeurs de champ par défaut. Si le paramètre manquant n'est pas mentionné dans Valeurs de champ par défaut, contactez Cloud Customer Care.

Commandes des API

Page de la console d'administration Paramètre spécifique dans la console d'administration Type de paramètre de l'API Policy Modification possible Légende de la console d'administration Nom du champ de l'API Policy Type de données
Commandes des API Paramètres > Message utilisateur personnalisé api_controls.custom_user_message Non Personnalisez le message à afficher lorsque les utilisateurs ne peuvent pas accéder à une application en raison des paramètres d'accès. error_text string
Paramètres > Applications tierces non configurées api_controls.unconfigured_third_party_apps Non Les applications tierces non configurées sont celles qui n'ont pas été configurées avec un paramètre d'accès (par exemple, "Approuvée", "Limitée" ou "Bloquée").
Sélectionnez ce qui se passe lorsque les utilisateurs tentent d'accéder avec leur compte à des applications tierces non configurées. 		access_level enum :
  • ACCESS_LEVEL_UNSPECIFIED
  • BLOCK_ALL
  • ALLOW_SIGN_IN_ONLY
Paramètres > Applications tierces non configurées api_controls.unconfigured_third_party_apps Non Les applications tierces non configurées sont celles qui n'ont pas été configurées avec un paramètre d'accès (par exemple, "Approuvée", "Limitée" ou "Bloquée").
Sélectionnez ce qu'il se passe lorsque les utilisateurs de moins de 18 ans tentent d'accéder avec leur compte à des applications tierces non configurées. 		access_level_under18 enum :
  • ACCESS_LEVEL_UNSPECIFIED
  • ALLOW_SIGN_IN_ONLY
Paramètres > Applications internes api_controls.internal_apps Non Les applications internes appartenant à votre organisation sont automatiquement configurées avec un accès approuvé. Ces applications peuvent demander l'accès API à toutes les données Google pour les utilisateurs. trust_internal_apps booléen
Paramètres > Demandes utilisateur d'accès à des applications non configurées api_controls.app_approval_requests Non Autoriser les utilisateurs à demander l'accès à des applications tierces non configurées allowed_for_all enum :
  • OPTION_UNSPECIFIED
  • ENABLED
  • DISABLED
Contrôle des accès aux applications > Gérer les services Google > Services Google api_controls.google_services Non Sélectionnez les paramètres d'accès aux API des services Google pour définir les types d'applications tierces pouvant demander à accéder à ces services. services Service[]

Sous-paramètres des commandes des API

Ce tableau fournit les sous-paramètres des contrôles des API qui sont référencés par d'autres paramètres des contrôles des API.

Nom du sous-paramètre de l'API Policy Légende de la console d'administration Nom du champ de l'API Policy Type de données
Service Accès 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
Restricted/Unrestricted is_enabled booléen

Paramètres de l'agenda

Page de la console d'administration Paramètre spécifique dans la console d'administration Type de paramètre de l'API Policy Modification possible Légende de la console d'administration Nom du champ de l'API Policy Type de données
Agenda Paramètres avancés > Plannings des rendez-vous avec paiements calendar.appointment_schedules Non Autorisez les utilisateurs de plannings des rendez-vous à exiger le paiement des créneaux réservés via leur propre compte de fournisseur de services de paiement. enable_payments booléen
Paramètres de partage > Invitations externes calendar.external_invitations Non Avertir les utilisateurs lorsqu'ils invitent des personnes externes au domaine ORGANIZATION_UNIT_NAME warn_on_invite booléen
Gestion de Calendar Interop > Disponibilités Exchange dans Agenda calendar.interoperability Non Autoriser Google Agenda à afficher la disponibilité des utilisateurs d'Exchange enable_interoperability booléen
Afficher les détails de l'événement enable_full_event_details booléen
Gestion de Calendar Interop > Réservation de ressources Exchange calendar.interoperability Non Autoriser Google Agenda à réserver des salles Microsoft Exchange enable_exchange_room_booking booléen
Paramètres de partage > Options de partage externe pour les agendas principaux calendar.primary_calendar_max_allowed_external_sharing Non Hors de ORGANIZATION_UNIT_NAME : définir les capacités de l'utilisateur pour les agendas principaux 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
Paramètres de partage > Options de partage externe pour les agendas secondaires calendar.secondary_calendar_max_allowed_external_sharing Non Hors de <nom de l'organisation> : définir les capacités de l'utilisateur pour les agendas secondaires 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

Paramètres de chat

Page de la console d'administration Paramètre spécifique dans la console d'administration Type de paramètre de l'API Policy Modification possible Légende de la console d'administration Nom du champ de l'API Policy Type de données
Google Chat Historique des discussions chat.chat_history Non Historique activé/désactivé history_on_by_default booléen
Autoriser les utilisateurs à modifier les paramètres de leur historique allow_user_modification booléen
Partage de fichiers via le chat chat.chat_file_sharing Non Partage de fichiers externe external_file_sharing enum :
  • ALL_FILES
  • IMAGES_ONLY
  • NO_FILES
  • FILE_SHARING_OPTION_UNSPECIFIED
internal_file_sharing identique
Historique des espaces chat.space_history Non Paramètres d'historique des conversations pour les espaces history_state enum :
  • DEFAULT_HISTORY_ON
  • DEFAULT_HISTORY_OFF
  • HISTORY_ALWAYS_ON
  • HISTORY_ALWAYS_OFF
  • HISTORY_STATE_UNSPECIFIED
Paramètres de discussion en externe chat.external_chat_restriction Non Autoriser les utilisateurs à envoyer des messages en dehors de l'organisation dans les discussions et les espaces allow_external_chat booléen
external_chat_restriction enum :
  • NO_RESTRICTION
  • TRUSTED_DOMAINS
  • RESTRICTION_UNSPECIFIED
Applications Chat chat.chat_apps_access Non Autoriser les utilisateurs à installer des applications Chat enable_apps booléen
Autoriser les utilisateurs à ajouter et à utiliser des webhooks entrants enable_webhooks booléen
Archivage tiers chat.third_party_archiving Non Activer l'archivage tiers activé booléen
Indiquez une adresse e-mail à laquelle distribuer les contenus Chat. destination_email_address string
Définir la fréquence d'envoi (entre 1 et 24 heures) des messages d'archivage Chat archival_frequency Durée
Liste des en-têtes personnalisés séparés par une virgule requise par l'adresse de destination custom_headers string
Espaces externes chat.external_spaces Non Autoriser les utilisateurs à créer et à rejoindre des espaces avec des personnes externes à leur organisation activé booléen
Autoriser uniquement les utilisateurs à ajouter des contacts issus des domaines de la liste d'autorisation domain_allowlist_mode enum:
  • DOMAIN_ALLOWLIST_MODE_UNSPECIFIED
  • TRUSTED_DOMAINS
  • ALL_DOMAINS
Paramètres de partage > Accès par défaut à l'espace chat.space_access_default Non Accès par défaut aux espaces lorsque les utilisateurs en créent. access_type enum:
  • ACCESS_TYPE_UNSPECIFIED
  • RESTRICTED
  • PRIMARY_TARGET_AUDIENCE
Signalement de contenu chat.content_reporting Non Autoriser les utilisateurs à signaler du contenu dans les messages privés one_on_one_direct_messages_reporting enum:
  • CONTENT_REPORTING_STATE_UNSPECIFIED
  • ENABLED
  • DISABLED
Autoriser les utilisateurs à signaler du contenu dans les messages privés de groupe group_direct_messages_reporting identique
Autoriser les utilisateurs à signaler du contenu dans des espaces spécifiques spaces_reporting identique
spaces_reporting_type enum:
  • SPACES_REPORTING_TYPE_UNSPECIFIED
  • ALL_SPACES
  • DISCOVERABLE_SPACES_ONLY
Spécifier les catégories que les utilisateurs peuvent choisir lorsqu'ils signalent du contenu reporting_categories objet répété :
  • category (enum) :
    • CATEGORY_UNSPECIFIED
    • HARASSMENT
    • DISCRIMINATION
    • EXPLICIT_CONTENT
    • SPAM
    • CONFIDENTIAL_INFO
    • SENSITIVE_INFO
    • OTHER
Spécifier un titre et une description personnalisés pour le formulaire de signalement reporting_form_customization_enabled booléen
custom_reporting_form_title string
custom_reporting_form_description string
Restrictions concernant le chat et les espaces chat.chat_and_space_restrictions Non Limiter la création de messages, de messages de groupe et d'espaces. Les utilisateurs soumis à cette restriction ne peuvent pas gérer les membres. restriction_level enum:
  • RESTRICTION_LEVEL_UNSPECIFIED
  • UNRESTRICTED
  • RESTRICTED

Paramètres Classroom

Page de la console d'administration Paramètre spécifique dans la console d'administration Type de paramètre de l'API Policy Modification possible Légende de la console d'administration Nom du champ de l'API Policy Type de données
Classroom Paramètres généraux > Autorisations des enseignants classroom.teacher_permissions Non Qui peut créer des cours whoCanCreateClasses enum :
  • ANYONE_IN_DOMAIN
  • ALL_PENDING_AND_VERIFIED_TEACHERS
  • VERIFIED_TEACHERS_ONLY
Paramètres généraux > Accès des représentants légaux classroom.guardian_access Non Autoriser les parents et les représentants légaux à accéder aux informations de Classroom allowAccess booléen
Qui peut gérer les parents et les représentants légaux whoCanManageGuardianAccess enum :
  • VERIFIED_TEACHERS_AND_DOMAIN_ADMINS
  • DOMAIN_ADMINS_ONLY
Paramètres des cours > À propos des inscriptions aux cours classroom.class_membership Non Personnes autorisées à participer aux cours de votre domaine whoCanJoinClasses enum :
  • ANYONE_IN_DOMAIN
  • ANYONE_IN_ALLOWLISTED_DOMAINS
  • ANY_GOOGLE_WORKSPACE_USER
  • ANYONE
Cours auxquels les utilisateurs de votre domaine peuvent participer whichClassesCanUsersJoin enum :
  • CLASSES_IN_DOMAIN
  • CLASSES_IN_ALLOWLISTED_DOMAINS
  • ANY_GOOGLE_WORKSPACE_CLASS
Accès aux données > API Classroom classroom.api_data_access Non Les utilisateurs peuvent autoriser les applications à accéder à leurs données Google Classroom enableApiAccess booléen
Rapports sur le degré d'originalité > Passages communs à plusieurs travaux d'élèves classroom.originality_reports Non Activer les passages communs à plusieurs travaux d'élèves dans les rapports sur le degré d'originalité enableOriginalityReportsSchoolMatches booléen
Désinscription des élèves > Autorisations de désinscription classroom.student_unenrollment Non Qui peut désinscrire les élèves des cours ? whoCanUnenrollStudents enum
  • STUDENTS_AND_TEACHERS
  • TEACHERS_ONLY
Importation de la liste des élèves > Paramètres classroom.roster_import Non Importer les listes d'élèves rosterImportOption enum :
  • OFF
  • ON_CLEVER
Gemini dans les applications Workspace Gemini pour Workspace > Accès aux fonctionnalités dans Classroom > Classroom classroom.gemini_access Non Indiquer si les utilisateurs peuvent accéder à Gemini dans Classroom activé booléen

Paramètres de conformité des données

Page de la console d'administration Paramètre spécifique dans la console d'administration Type de paramètre de l'API Policy Modification possible Légende de la console d'administration Nom du champ de l'API Policy Type de données
Gestion des accès Gestion des accès > Stratégie de gestion des accès access_management.user_scoping Non Choisir une stratégie de gestion des accès pour les données couvertes allowed_audience enum :
  • PREFERENCE_UNSPECIFIED
  • CJIS_IRS_1075_GOOGLE_STAFF
  • US_GOOGLE_STAFF
  • EU_GOOGLE_STAFF
Régions de données Région > Données au repos data_regions.data_at_rest_region Non Région de stockage des données au repos région enum :
  • REGION_UNSPECIFIED
  • ANY_REGION
  • US
  • EUROPE
Région> Traitement des données data_regions.data_processing_region Non Règle pour la région des données lors du traitement des données limit_to_storage_region booléen
Access Approval Access Approval > Stratégie Access Approval access_approval.axa_user_scoping Non Exiger du personnel Google qu'il demande une autorisation pour consulter les données nécessaires à l'assistance requires_customer_approval booléen

Paramètres des appareils

Page de la console d'administration Paramètre spécifique dans la console d'administration Type de paramètre de l'API Policy Mutate compatible avec la version v1beta1 Légende de la console d'administration Nom du champ de l'API Policy Type de données
Paramètres universels Accès aux données > Synchronisation Android devices.android_work_data_sync Non Autoriser la synchronisation des données professionnelles sur les appareils Android Autorisés booléen
Sécurité > Chiffrement devices.encryption Non Exiger le chiffrement de l'appareil device_encryption_option enum:
  • ENCRYPTION_OPTION_UNSPECIFIED
  • NOT_REQUIRED
  • REQUIRED
Sécurité > Appareils compromis devices.compromised_devices Non Bloquer les appareils Android dont la sécurité est compromise compromised_android_devices_blocked booléen
Bloquer les appareils iOS jailbreakés jailbroken_ios_devices_blocked booléen
Sécurité > Approbations d'appareils devices.activation_approval Non Exiger l'approbation de l'administrateur admin_approval_required booléen
Envoyer les e-mails de demande d'approbation à approver_email_address string
Paramètres Android Applications et partage de données > Partage dans d'autres profils devices.android_work_profile_sharing Non Autoriser le partage de contenu entre le profil professionnel et l'espace personnel (appareils avec profil professionnel uniquement) Autorisés booléen
Applications et partage de données > Copie entre profils devices.android_cross_profile_copy_paste Non Autoriser les collages entre le profil professionnel et l'espace personnel (appareils avec profil professionnel uniquement) activé booléen
Applications et partage de données > Applications privées Google Play devices.android_google_play_private_apps Non Autoriser les utilisateurs à accéder aux applications privées Google Play access_allowed booléen
Autoriser les utilisateurs à publier et mettre à jour des applications privées Google Play publish_and_update_allowed booléen
Partage d'applications et de données > Capture d'écran devices.android_screen_capture Non Autoriser les captures d'écran Autorisés booléen
Applications et partage de données > Android Beam devices.android_beam Non Autoriser Beam sortant outgoing_beam_allowed booléen
Applications et partage de données>Partage de position devices.android_location_sharing Non Autorisez le partage de position. Autorisés booléen
Applications et partage de données > Applications disponibles devices.android_available_apps Non Indiquez quelles applications les utilisateurs seront autorisés à installer via le Play Store playstore_installable_apps enum:
  • PLAYSTORE_INSTALLABLE_APPS_UNSPECIFIED
  • ALL
  • ALLOWLISTED
Applications et partage de données > Valider les applications devices.android_verify_apps Non Autoriser les utilisateurs à désactiver Google Play Protect (appareils détenus par l'entreprise uniquement) turnoff_google_play_protect_allowed booléen
Applications et partage de données> Options pour les développeurs devices.android_developer_options Non Autoriser les options pour les développeurs Autorisés booléen
Fonctionnalités de l'écran de verrouillage > Authentification périodique à l'aide d'un code, d'un mot de passe ou d'un schéma devices.android_periodic_secure_authentication Non Obligez les utilisateurs qui utilisent le déverrouillage par reconnaissance faciale ou par empreinte digitale à s'authentifier périodiquement à l'aide d'une méthode plus sûre, comme un code, un mot de passe ou un schéma required booléen
Après le délai défini ci-dessous, les utilisateurs devront utiliser une méthode d'authentification plus sécurisée pour déverrouiller l'appareil 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
Applications et partage de données > Sources inconnues devices.android_unknown_source_apps Non Empêchez les utilisateurs d'installer des applications provenant de sources inconnues dans leur profil professionnel. work_profile_installation_allowed booléen
Empêchez les utilisateurs d'installer des applications provenant de sources inconnues dans leur profil personnel. personal_profile_installation_allowed booléen
Applications et partage de données > Paramètres des applications devices.android_apps_settings Non Autoriser les utilisateurs à modifier les paramètres d'application (appareils détenus par l'entreprise uniquement) modification_allowed booléen
Applications et partage de données > Fonctionnalités de l'écran de verrouillage devices.android_trust_agents Non Autoriser Smart Lock à maintenir un appareil déverrouillé smart_lock_allowed booléen
Applications et partage de données > Fonctionnalités de l'écran de verrouillage devices.android_lock_screen_notifications Non Autoriser les notifications sur l'écran de verrouillage Autorisés booléen
Applications et partage de données > Fonctionnalités de l'écran de verrouillage devices.android_lock_screen_notification_details Non Autoriser les détails de notification. Autorisés booléen
Paramètres iOS Sécurité avancée > Apple Watch devices.ios_apple_watch Non Autoriser l'utilisation d'Apple Watch sans détection du poignet no_wrist_detection_usage_allowed booléen
Sécurité avancée > Siri devices.ios_siri Non Autoriser Siri Autorisés booléen
Autoriser Siri sur l'écran de verrouillage allowed_on_lock_screen booléen
Sécurité avancée > Transfert devices.ios_handoff Non Autoriser Handoff (appareils supervisés et enregistrés uniquement) Autorisés booléen
Partage de données > Stockage iCloud devices.ios_icloud_storage Non Autoriser les applications gérées à stocker des données dans iCloud managed_apps_sync_allowed booléen
Sécurité avancée > Capture d'écran devices.ios_screen_capture Non Autoriser les captures et l'enregistrement d'écran Autorisés booléen
Sauvegarde et synchronisation iCloud > Sauvegarde iCloud devices.ios_icloud_backup Non Autoriser les utilisateurs à sauvegarder leur appareil avec iCloud (appareils supervisés uniquement) Autorisés booléen
Sauvegarde et synchronisation iCloud > Sauvegarde chiffrée devices.ios_backup_encryption Non Exiger le chiffrement des sauvegardes required booléen
Écran de verrouillage > Centre de contrôle devices.ios_lock_screen_control_center Non Autoriser l'affichage du centre de contrôle sur l'écran de verrouillage Autorisés booléen
Applications et services > Application Fichiers devices.ios_files_app Non Autoriser les utilisateurs à se connecter à des clés USB dans Fichiers (iOS 13.1 et versions ultérieures, appareils supervisés uniquement) usb_drives_connection_allowed booléen
Autoriser les utilisateurs à se connecter à des lecteurs réseau dans Fichiers (iOS 13.1 et versions ultérieures, appareils supervisés uniquement) network_drives_connection_allowed booléen
Fonctionnalités de l'appareil > Date et heure devices.ios_date_time Non Forcer la date et l'heure automatiques (iOS 12 et versions ultérieures, appareils supervisés uniquement) automatic_date_time_enforced booléen
Écran de verrouillage > Vue des notifications devices.ios_lock_screen_notifications_view Non Autoriser l'affichage des notifications sur l'écran de verrouillage Autorisés booléen
Partage des données > Actions sur les données devices.ios_data_actions Non Sélectionner les actions que les utilisateurs peuvent effectuer avec les données Google Workspace applicables sur les appareils iOS external_data_sharing_allowed booléen
Autoriser le copier-coller de données professionnelles dans des comptes et applications personnels work_data_operation_type.non_workspace_apps_copy_paste_allowed booléen
Autoriser l'envoi de données professionnelles à des applications personnelles, y compris toutes les applications autres que Google Workspace sur la feuille de partage iOS work_data_operation_type.non_workspace_apps_sharing_allowed booléen
Autoriser le partage de données professionnelles avec des comptes personnels ou avec la messagerie iOS sur la feuille de partage iOS work_data_operation_type.personal_accounts_sharing_allowed booléen
Autoriser le partage de données professionnelles avec AirDrop sur la feuille de partage iOS work_data_operation_type.airdrop_sharing_allowed booléen
Autoriser l'impression de fichiers professionnels work_data_operation_type.files_printing_allowed booléen
Autoriser l'enregistrement de données professionnelles dans Fichiers à l'aide de la feuille de partage iOS et accéder aux données professionnelles directement depuis Fichiers work_data_operation_type.files_access_allowed booléen
Autoriser l'enregistrement d'images et de vidéos professionnelles dans les photos iOS work_data_operation_type.images_videos_saving_allowed booléen
Autoriser l'attribution d'éléments à des contacts à l'aide de la feuille de partage iOS work_data_operation_type.contacts_items_assignment_allowed booléen
Safari > Navigation sécurisée devices.ios_safari_secure_browsing Non Appliquer l'avertissement de site Web frauduleux Safari fraudulent_website_warning_enforced booléen
Partage de données > Apple Intelligence devices.ios_apple_intelligence Non Autoriser les utilisateurs à utiliser les outils d'écriture Apple Intelligence dans les applis Google Workspace sur les appareils iOS writing_tools_allowed booléen
Sauvegarde et synchronisation iCloud > Synchronisation du trousseau devices.ios_keychain_sync Non Autoriser les utilisateurs à synchroniser des trousseaux avec iCloud (appareils supervisés uniquement) icloud_sync_allowed booléen
Sauvegarde et synchronisation iCloud > Synchronisation de documents devices.ios_document_sync Non Autoriser les utilisateurs à synchroniser des documents et des données avec iCloud icloud_data_sync_allowed booléen

Paramètres de l'annuaire

Page de la console d'administration Paramètre spécifique dans la console d'administration Type de paramètre de l'API Policy Modification possible Légende de la console d'administration Nom du champ de l'API Policy Type de données
Paramètres de l'annuaire Paramètres de partage > Partage externe d'annuaire directory.external_directory_sharing Non N/A sharing_option enum:
  • SHARING_OPTION_UNSPECIFIED
  • REQUESTER_BASIC_PROFILE_ONLY
  • ORGANIZATION_DIRECTORY_DATA

Paramètres de Drive et Docs

Page de la console d'administration Paramètre spécifique dans la console d'administration Type de paramètre de l'API Policy Modification possible Légende de la console d'administration Nom du champ de l'API Policy Type de données
Drive et Docs Paramètres de partage > Options de partage drive_and_docs.external_sharing Non Sélectionnez le niveau de partage le plus élevé en dehors de CUSTOMER_NAME que vous souhaitez autoriser external_sharing_mode enum :
  • DISALLOWED
  • ALLOWLISTED_DOMAINS
  • ALLOWED
Autoriser les utilisateurs de ORGANIZATION_UNIT_NAME à recevoir des fichiers provenant d'utilisateurs ou de Drive partagés n'appartenant pas à CUSTOMER_NAME allow_receiving_external_files booléen
Afficher un avertissement lorsque des fichiers appartenant à des utilisateurs ou figurant dans des Drive partagés de ORGANIZATION_UNIT_NAME sont partagés avec des utilisateurs des domaines de la liste d'autorisation warn_for_sharing_outside_allowlisted_domains booléen
Autoriser les utilisateurs de ORGANIZATION_UNIT_NAME à recevoir des fichiers provenant d'utilisateurs ou de Drive partagés n'appartenant pas à des domaines de la liste d'autorisation allow_receiving_files_outside_allowlisted_domains booléen
Autorisez les utilisateurs ou les Drive partagés de ORGANIZATION_UNIT_NAME à partager des éléments avec des utilisateurs sans compte Google dans des domaines de confiance grâce au partage avec des visiteurs. allow_non_google_invites_in_allowlisted_domains booléen
Afficher un avertissement lorsque des fichiers appartenant à des utilisateurs ou figurant dans des Drive partagés de ORGANIZATION_UNIT_NAME sont partagés en dehors de CUSTOMER_NAME warn_for_external_sharing booléen
Autoriser les utilisateurs ou les Drive partagés de ORGANIZATION_UNIT_NAME à partager des éléments avec des personnes externes à CUSTOMER_NAME qui n'utilisent pas de compte Google allow_non_google_invites booléen
Lorsque le partage en dehors de CUSTOMER_NAME est autorisé, les utilisateurs de ORGANIZATION_UNIT_NAME peuvent rendre des fichiers et du contenu Web publié visibles à toute personne disposant du lien allow_publishing_files booléen
Lorsqu'un utilisateur partage un fichier au moyen d'un produit Google autre que Docs ou Drive (par exemple, en collant un lien dans Gmail), Google peut vérifier les droits d'accès des destinataires. Sinon, lorsque cela est possible, Google demande à l'utilisateur d'indiquer avec qui il veut partager le fichier : access_checker_suggestions enum :
  • RECIPIENTS_OR_AUDIENCE_OR_PUBLIC
  • RECIPIENTS_OR_AUDIENCE
  • RECIPIENTS_ONLY
Sélectionnez les personnes autorisées à distribuer du contenu dans ORGANIZATION_UNIT_NAME en dehors de CUSTOMER_NAME. Cette option permet de restreindre l'importation ou le déplacement de contenu dans les Drive partagés détenus par une autre organisation. allowed_parties_for_distributing_content enum :
  • ALL_ELIGIBLE_USERS
  • ELIGIBLE_INTERNAL_USERS
  • NONE
Paramètres de partage > Accès général par défaut drive_and_docs.general_access_default Non Lorsque des utilisateurs de ORGANIZATION_UNIT_NAME créent des éléments, l'accès par défaut est default_file_access enum :
  • PRIVATE_TO_OWNER
  • PRIMARY_AUDIENCE_WITH_LINK
  • PRIMARY_AUDIENCE_WITH_LINK_OR_SEARCH
Paramètres de partage > Création d'un Drive partagé drive_and_docs.shared_drive_creation Non Empêcher les utilisateurs de ORGANIZATION_UNIT_NAME de créer des Drive partagés allow_shared_drive_creation booléen (la réponse de l'API renvoie l'opposé de la valeur de l'UI)
Les Drive partagés créés par des utilisateurs de ORGANIZATION_UNIT_NAME seront associés à l'unité organisationnelle suivante org_unit_for_new_shared_drives enum :
  • CREATOR_ORG_UNIT
  • CUSTOM_ORG_UNIT
Unité organisationnelle sélectionnée custom_org_unit string
Autoriser les membres disposant du rôle d'administrateur à remplacer les paramètres ci-dessous allow_managers_to_override_settings booléen
Autoriser les utilisateurs en dehors de CUSTOMER_NAME à accéder aux fichiers des Drive partagés allow_external_user_access booléen
Autoriser l'accès aux fichiers de personnes n'appartenant pas au Drive partagé allow_non_member_access booléen
Le téléchargement, l'impression et la copie sont activés pour allowed_parties_for_download_print_copy enum :
  • ALL
  • EDITORS_ONLY (administrateurs, contributeurs et gestionnaires de contenu)
  • MANAGERS_ONLY
Autoriser les gestionnaires de contenu à partager des dossiers allow_content_managers_to_share_folders booléen
Paramètres de partage > Mise à jour de sécurité pour les fichiers drive_and_docs.file_security_update Non Une fois appliquée, cette mise à jour renforcera la sécurité des liens de fichiers. Les utilisateurs pourraient alors recevoir des demandes d'accès aux fichiers. security_update enum :
  • APPLY_TO_IMPACTED_FILES
  • REMOVE_FROM_IMPACTED_FILES
Autoriser les utilisateurs à supprimer/appliquer la mise à jour de sécurité aux fichiers dont ils sont propriétaires ou qu'ils gèrent allow_users_to_manage_update booléen
Fonctionnalités et applications > SDK Drive drive_and_docs.drive_sdk Non Autoriser les utilisateurs à accéder à Google Drive avec l'API Drive SDK enable_drive_sdk_api_access booléen
Google Drive pour ordinateur > Activer Drive pour ordinateur drive_and_docs.drive_for_desktop Non Autoriser Google Drive pour ordinateur dans votre organisation allow_drive_for_desktop booléen
Utiliser Google Drive pour ordinateur uniquement sur les appareils autorisés restrict_to_authorized_devices booléen
Afficher le lien de téléchargement de Google Drive pour ordinateur show_download_link booléen
Autoriser les utilisateurs à activer la présence en temps réel dans Microsoft Office depuis Google Drive pour ordinateur allow_real_time_presence booléen
Paramètres de partage > Mettre en évidence les fichiers externes drive_and_docs.external_file_warning Non Marquez les fichiers partagés par des utilisateurs externes ou qui leur appartiennent comme "externes" pour indiquer que le contenu pourrait être consulté en dehors de votre organisation. S'applique à Drive, Docs, Sheets, Slides, Drawings et Vids. highlighting_enabled booléen

Paramètres de l'appli Gemini

Page de la console d'administration Paramètre spécifique dans la console d'administration Type de paramètre de l'API Policy Modification possible Légende de la console d'administration Nom du champ de l'API Policy Type de données
Application Gemini Accès utilisateur gemini_app.unlicensed_user_access Non Autoriser tous les utilisateurs à accéder à l'application Gemini, quelle que soit leur licence activé booléen

Paramètres de Gemini dans Workspace

Page de la console d'administration Paramètre spécifique dans la console d'administration Type de paramètre de l'API Policy Modification possible Légende de la console d'administration Nom du champ de l'API Policy Type de données
Gemini dans Workspace Fonctionnalités Gemini bêta > Fonctionnalités bêta gemini_for_workspace.beta_features Non Activer l'accès aux fonctionnalités bêta dans Gemini pour Google Workspace activé booléen
Autoriser Google à inviter les utilisateurs de l'unité organisationnelle ou du groupe sélectionnés à participer à des enquêtes et à des études sur l'expérience utilisateur afin d'améliorer Gemini pour Google Workspace feedback_and_testing_enabled booléen

Paramètres de Gmail

Page de la console d'administration Paramètre spécifique dans la console d'administration Type de paramètre de l'API Policy Modification possible Légende de la console d'administration Nom du champ de l'API Policy Type de données
Gmail Paramètres utilisateur > Mode confidentiel gmail.confidential_mode Non Activer le mode confidentiel enable_confidential_mode booléen
Paramètres utilisateur > S/MIME gmail.smime_encryption Non Activer le chiffrement S/MIME pour l'envoi et la réception des e-mails enable_smime_encryption enum :
  • STATUS_UNSPECIFIED
  • STATUS_DISABLED
  • STATUS_ENABLED
Autoriser les signatures SHA-1 à l'échelle globale (non recommandé) allow_sha1_globally_in_smime_signature booléen
gmail.enhanced_smime_encryption Non Autoriser les utilisateurs à importer leurs propres certificats allow_user_to_upload_certificates booléen
Acceptez ces autres certificats racine pour des domaines spécifiques : custom_root_certificates Liste de CustomRootCertificates contenant une liste de certificats racine, une liste de certificats CA intermédiaires, une liste de noms de domaine restreints, une valeur booléenne pour autoriser les incohérences d'adresse et une énumération avec différents niveaux de validation.
Spam, hameçonnage et logiciels malveillants > Analyse améliorée des messages avant distribution gmail.enhanced_pre_delivery_message_scanning Non Permet une détection améliorée du contenu suspect avant la distribution enable_improved_suspicious_content_detection booléen
Spam, hameçonnage et logiciels malveillants > Liste d'autorisation de messagerie gmail.email_spam_filter_ip_allowlist Non Saisir les adresses IP pour votre liste d'autorisation de messagerie allowed_ip_addresses Une liste de chaînes
Sécurité > Spoofing et authentification gmail.spoofing_and_authentication Non Protéger contre le spoofing de domaine à partir de noms de domaine similaires detect_domain_name_spoofing booléen
Choisir une action domain_name_spoofing_consequence enum :
  • WARNING
  • SPAM_FOLDER
  • QUARANTINE
  • NO_ACTION
Choisir une zone de quarantaine domain_name_spoofing_quarantine_id entier
Protéger contre l'usurpation des noms d'employés detect_employee_name_spoofing booléen
Choisir une action employee_name_spoofing_consequence enum :
  • WARNING
  • SPAM_FOLDER
  • QUARANTINE
  • NO_ACTION
Choisir une zone de quarantaine employee_name_spoofing_quarantine_id entier
Protéger contre les e-mails entrants usurpant votre domaine detect_domain_spoofing_from_unauthenticated_senders booléen
Choisir une action domain_spoofing_consequence enum :
  • WARNING
  • SPAM_FOLDER
  • QUARANTINE
  • NO_ACTION
Choisir une zone de quarantaine domain_spoofing_quarantine_id entier
Protéger contre les e-mails non authentifiés detect_unauthenticated_emails booléen
Choisir une action unauthenticated_email_consequence enum :
  • WARNING
  • SPAM_FOLDER
  • QUARANTINE
  • NO_ACTION
Choisir une zone de quarantaine unauthenticated_email_quarantine_id entier
Protéger vos groupes contre les e-mails entrants usurpant votre domaine detect_groups_spoofing booléen
Appliquer ce paramètre à groups_spoofing_visibility_type enum :
  • PRIVATE_GROUPS_ONLY
  • ALL_GROUPS
Choisir une action groups_spoofing_consequence enum :
  • WARNING
  • SPAM_FOLDER
  • QUARANTINE
  • NO_ACTION
Choisir une zone de quarantaine groups_spoofing_quarantine_id entier
Appliquer automatiquement les paramètres recommandés ultérieurement apply_future_settings_automatically booléen
Sécurité > Liens et images externes gmail.links_and_external_images Non Identifier les liens derrière les URL raccourcies enable_shortener_scanning booléen
Analyser les images liées enable_external_image_scanning booléen
Afficher l'invite d'avertissement pour tout clic sur les liens vers des domaines non approuvés enable_aggressive_warnings_on_untrusted_links booléen
Appliquer automatiquement les paramètres recommandés ultérieurement apply_future_settings_automatically booléen
Sécurité > Pièces jointes gmail.email_attachment_safety Non Protéger votre messagerie contre les pièces jointes chiffrées envoyées par des expéditeurs non approuvés enable_encrypted_attachment_protection booléen
Choisir une action encrypted_attachment_protection_consequence enum :
  • WARNING
  • SPAM_FOLDER
  • QUARANTINE
Choisir une zone de quarantaine encrypted_attachment_protection_quarantine_id entier
Protéger votre messagerie contre les pièces jointes contenant des scripts et envoyées par des expéditeurs non approuvés enable_attachment_with_scripts_protection booléen
Choisir une action attachment_with_scripts_protection_consequence enum :
  • WARNING
  • SPAM_FOLDER
  • QUARANTINE
Choisir une zone de quarantaine attachment_with_scripts_protection_quarantine_id entier
Protéger votre messagerie contre les types de pièces jointes anormaux dans les e-mails enable_anomalous_attachment_protection booléen
Choisir une action anomalous_attachment_protection_consequence enum :
  • WARNING
  • SPAM_FOLDER
  • QUARANTINE
Choisir une zone de quarantaine anomalous_attachment_protection_quarantine_id entier
Ajouter les types de fichiers inhabituels suivants à la liste d'autorisation allowed_anomalous_attachment_filetypes chaîne[]
Appliquer automatiquement les paramètres recommandés ultérieurement apply_future_recommended_settings_automatically booléen
Routage > Gérer les listes d'adresses gmail.email_address_lists Non Gérer les listes d'adresses email_address_list EmailAddressList[]
Spam, hameçonnage et logiciels malveillants > Expéditeurs bloqués gmail.blocked_sender_lists Non Bloquer ou approuver certains expéditeurs en fonction de leur adresse e-mail ou de leur domaine blocked_senders BlockedSender[]
Spam, hameçonnage et logiciels malveillants > Spam gmail.spam_override_lists Non Créer des listes d'expéditeurs approuvés afin que les messages de ces derniers ne soient pas placés dans le dossier de spam. spam_override SpamOverride[]
Conformité > Conformité du contenu gmail.content_compliance Non Configurer des filtres de contenu avancés basés sur des mots, des expressions ou des modèles content_compliance_rules ContentComplianceRule[]
Conformité > Restreindre la distribution gmail.restrict_delivery Non Limitez les domaines avec lesquels vos utilisateurs sont autorisés à échanger des e-mails. restrict_delivery_rules RestrictDeliveryRule[]
Conformité > Contenu répréhensible gmail.objectionable_content Non Configurer des filtres de contenu basés sur des listes de mots objectionable_content_rules ObjectionableContentRule[]
Conformité > Conformité des pièces jointes gmail.attachment_compliance Non Configurer des filtres de pièces jointes en fonction du type de fichier, du nom de fichier et de la taille du message attachment_compliance_rules AttachmentComplianceRule[]
Conformité > Stockage complet des e-mails gmail.comprehensive_mail_storage Non S'assurer qu'une copie de tous les e-mails envoyés et reçus est stockée dans les boîtes aux lettres des utilisateurs associés rule_id string
N/A (For all rules) gmail.rule_states Non N/A rule_states RuleState[]
Gérer les zones de quarantaine gmail.email_quarantines Non Ajouter une zone de quarantaine email_quarantines EmailQuarantine[]
Configuration > Importations d'adresses e-mail d'utilisateurs gmail.user_email_uploads Non Afficher sur la page "Paramètres" de Gmail l'option d'importation d'e-mails et de contacts depuis un compte Yahoo!, Hotmail, AOL ou tout autre compte POP3 ou de messagerie Web enable_mail_and_contacts_import booléen
Accès des utilisateurs finaux > Accès POP et IMAP gmail.pop_access Non Activer l'accès POP pour tous les utilisateurs enable_pop_access booléen
gmail.imap_access Non Activer l'accès IMAP pour tous les utilisateurs enable_imap_access booléen
Autoriser n'importe quel client de messagerie imap_access_restriction.allow_all_mail_clients booléen
Limiter les clients de messagerie accessibles aux utilisateurs (clients de messagerie OAuth uniquement) imap_access_restriction.allowed_oauth_mail_client_list OAuthMailClientList
Accès des utilisateurs finaux > Google Workspace Sync gmail.workspace_sync_for_outlook Non Activer Google Workspace Sync for Microsoft Outlook pour mes utilisateurs enable_google_workspace_sync_for_microsoft_outlook booléen
Accès des utilisateurs finaux > Transfert automatique gmail.auto_forwarding Non Autoriser les utilisateurs à transférer automatiquement les e-mails entrants vers une autre adresse enable_auto_forwarding booléen
Destination de transfert autorisée allowed_forwarding_destination enum:
  • ANY_ADDRESS
  • INTERNAL_ADDRESSES
Paramètres utilisateur > Format du nom gmail.name_format Non Autoriser les utilisateurs à personnaliser ce paramètre allow_custom_display_names booléen
Prénom Nom ou Nom, Prénom default_display_name_format enum:
  • FIRSTNAME_LASTNAME
  • LASTNAME_COMMA_FIRSTNAME
Accès des utilisateurs finaux > Autoriser les passerelles sortantes au niveau de l'utilisateur gmail.per_user_outbound_gateway Non Autoriser les utilisateurs à envoyer des e-mails grâce à un serveur SMTP externe lors de la configuration d'une adresse d'expéditeur hébergée hors de votre domaine de messagerie allow_users_to_use_external_smtp_servers booléen
Accès des utilisateurs finaux > Signaler les destinataires externes gmail.external_recipient_warning Non Mettre en évidence les destinataires externes dans une conversation Avertir les utilisateurs avant qu'ils ne répondent à un e-mail comportant des destinataires externes qui ne figurent pas dans leurs contacts. activé booléen
Accès des utilisateurs finaux > Liste d'autorisation des URL d'image pour le proxy gmail.email_image_proxy_bypass Non Saisissez les formats d'URL d'image. Les URL correspondant aux formats contournent le proxy d'images. image_proxy_bypass_pattern chaîne[]
N/A enable_image_proxy booléen
Paramètres utilisateur > Délégation de messagerie gmail.mail_delegation Non Autoriser les utilisateurs à déléguer l'accès à leur boîte aux lettres à d'autres utilisateurs appartenant au domaine enable_mail_delegation booléen
Autoriser les utilisateurs à personnaliser ce paramètre allow_custom_delegate_attribution booléen
Afficher le titulaire du compte et le délégué qui a envoyé l'e-mail enable_delegate_attribution booléen
Afficher le titulaire du compte uniquement
Autoriser les utilisateurs à accorder l'accès à leur boîte aux lettres à un groupe Google enable_mailbox_group_delegation booléen
Paramètres utilisateur > Gmail Web hors connexion gmail.web_offline Non Activer Gmail sur le Web hors connexion activé booléen
Forcer la suppression des données hors connexion lors de la déconnexion du compte Google signout_data_deletion_enforced booléen

Sous-paramètres Gmail

Ce tableau fournit les sous-paramètres Gmail référencés par d'autres paramètres Gmail.

Nom du sous-paramètre de l'API Policy Légende de la console d'administration Nom du champ de l'API Policy Type de données
EmailAddressList N/A id string
Nom nom string
AJOUTER UNE LISTE D'ADRESSES address_list AddressList
AJOUTER UNE LISTE D'ADRESSES BLOQUÉES blocked_address_list AddressList
AddressList Ajouter une liste d'adresses address AddressListEntry[]
AddressListEntry Adresse address string
Authentification requise (messages entrants uniquement) require_address_verification booléen
BlockedSender Saisissez une brève description qui apparaîtra dans le résumé du paramètre. description string
Ajouter des adresses ou des domaines à partir desquels vous souhaitez rejeter automatiquement les messages sender_blocklist StringValue[]
Saisir un avis de refus personnalisé rejection_response string
Ignorer ce paramètre pour les messages provenant d'adresses ou de domaines figurant sur la liste des expéditeurs approuvés. bypass_approved_sender booléen
N/A bypass_approved_sender_allowlist StringValue[]
N/A rule_id string
SpamOverride Saisissez une brève description qui apparaîtra dans le résumé du paramètre. description string
Appliquer un filtrage plus strict des spams enable_aggressive_filtering booléen
Placer le spam dans la zone de quarantaine administrative add_to_quarantine booléen
N/A quarantine_id entier
Ignorer les filtres antispam pour les expéditeurs internes bypass_internal_senders booléen
Ignorer les filtres antispam pour les messages provenant d'expéditeurs ou de domaines dans les listes sélectionnées bypass_selected_senders booléen
N/A bypass_sender_allowlist StringValue[]
Ignorer les filtres antispam et masquer les avertissements pour les messages provenant d'expéditeurs ou de domaines dans les listes sélectionnées. hide_warning_banner_from_selected_senders booléen
N/A hide_warning_banner_sender_allowlist StringValue[]
Ignorer les filtres antispam et masquer les avertissements pour tous les messages provenant d'expéditeurs internes et externes (déconseillé). hide_warning_banner_for_all booléen
N/A rule_id string
ContentComplianceRule Saisissez une brève description qui apparaîtra dans le résumé du paramètre. description string
E-mails concernés état RuleConditions
Ajouter les expressions qui décrivent le contenu à rechercher dans chaque message match_expressions MatchExpression[]
Si l'UN des éléments suivants correspond au message match_any_expression booléen
Si les expressions ci-dessus correspondent, procéder comme suit conséquence RuleConsequences
N/A rule_id string
RestrictDeliveryRule Obligatoire : saisissez une brève description qui apparaîtra dans le résumé du paramètre. description string
Ajouter des adresses ou des domaines à autoriser allowed_addresses StringValue[]
Tous les messages à destination ou en provenance d'autres adresses et domaines seront rejetés. Modifier la notification de rejet par défaut pour ces messages. rejection_notice_message string
Ignorer ce paramètre pour les messages internes internal_messages_rule_bypass_allowed booléen
N/A rule_id string
ObjectionableContentRule Saisissez une brève description qui apparaîtra dans le résumé du paramètre. description string
E-mails concernés état RuleConditions
Mots répréhensibles personnalisés objectionable_content_defined booléen
Saisir des mots objectionable_words chaîne[]
Si les expressions ci-dessus correspondent, procéder comme suit conséquence RuleConsequences
N/A rule_id string
AttachmentComplianceRule Saisissez une brève description qui apparaîtra dans le résumé du paramètre. description string
E-mails concernés état RuleConditions
Ajouter les expressions qui décrivent le contenu à rechercher dans chaque message match_expressions MatchExpression[]
Si l'UN des éléments suivants correspond au message match_any_expression booléen
Si les expressions ci-dessus correspondent, procéder comme suit conséquence RuleConsequences
N/A rule_id string
RuleState N/A (For all rules) activé booléen
rule_id string
RuleConditions E-mails concernés Messages entrants affect_inbound_messages booléen
Messages sortants affect_outbound_messages booléen
Messages sortants internes affect_internal_sending_messages booléen
Messages entrants internes affect_internal_receiving_messages booléen
Listes d'adresses Utiliser des listes d'adresses pour ignorer ce paramètre ou contrôler son application address_list_option enum :
  • NO_EFFECT
  • EXCLUDED
  • REQUIRED
Ignorer ce paramètre pour des adresses/domaines spécifiques
Appliquer ce paramètre uniquement à des adresses/domaines spécifiques
Utiliser une liste existante/Créer ou modifier une liste address_lists StringValue[]
Types de compte concernés Utilisateurs account_type_user booléen
Groupes account_type_group booléen
Non reconnu/Générique account_type_unrecognized booléen
Filtre d'enveloppes Appliquer uniquement à des expéditeurs d'enveloppe spécifiques envelope_sender_filter AddressMatcher
Appliquer uniquement à des destinataires d'enveloppe spécifiques envelope_recipient_filter AddressMatcher
AddressMatcher Appliquer uniquement à des expéditeurs d'enveloppe spécifiques / Appliquer uniquement à des destinataires d'enveloppe spécifiques activé booléen
Adresse e-mail unique N/A address_match_type enum : EXACT
Adresse e-mail exact_address_match_value string
Correspondance de schéma N/A address_match_type enum : REGEXP
Regexp regexp_match_value string
Appartenance à un groupe (messages envoyés uniquement) / Appartenance à un groupe (messages reçus uniquement) N/A address_match_type enum : GROUP_MEMBERSHIP
Sélectionner des groupes group_ids chaîne[]
MatchExpression Correspondance de contenu simple N/A match_expression_type enum : SIMPLE_CONTENT
Contenu match_content string
Correspondance de contenu avancée N/A match_expression_type enum : ADVANCED_CONTENT
Contenu/Expression régulière match_content string
N/A advanced_content_match AdvancedContentMatch
Correspondance de métadonnées match_expression_type enum : METADATA
metadata_match MetadataMatch
Correspondance de contenu prédéfinie match_expression_type enum : PREDEFINED_CONTENT
predefined_content_match PredefinedContentMatch
Type de fichier match_expression_type enum : FILE_TYPE
file_type_match FileTypeMatch
Nom de fichier N/A match_expression_type enum : FILE_NAME
Le nom du fichier en pièce jointe contient file_name string
Taille du message N/A match_expression_type enum : MESSAGE_SIZE
La taille totale du message (corps + pièce jointe) est supérieure à (Mo) message_size_threshold_in_megabytes entier
AdvancedContentMatch Emplacement En-têtes + Corps advanced_content_match_location enum : HEADERS_AND_BODY
En-têtes complets enum : FULL_HEADERS
Body enum : BODY
Subject enum : SUBJECT
En-tête de l'expéditeur enum : SENDER_HEADER
En-tête destinataires enum : RECIPIENTS_HEADER
Expéditeur de l'enveloppe enum : ENVELOPE_SENDER
Tout destinataire de l'enveloppe enum : ANY_ENVELOPE_RECIPIENT
Message brut enum : RAW_MESSAGE
Type de correspondance Commence par advanced_content_match_type enum : STARTS_WITH
Se termine par enum : ENDS_WITH
Contient du texte enum : CONTAINS_TEXT
Ne contient pas le texte enum : NOT_CONTAINS_TEXT
Est égal(e) à enum : <code< code="" dir="ltr" translate="no">EQUALS </code<>
Est vide enum : IS_EMPTY
Correspond à l'expression régulière enum : MATCHES_REGEXP
Ne correspond pas à l'expression régulière enum : NOT_MATCHES_REGEXP
Correspond à n'importe quel mot enum : MATCH_ANY_WORD
Correspond à tous les mots enum : MATCH_ALL_WORDS
N/A regexp_match RegexpMatch
RegexpMatch Description de l'expression régulière description string
Nombre minimal de correspondances min_match_count entier
MetadataMatch Attribut Authentification des messages metadata_match_attribute enum : MESSAGE_AUTHENTICATION
Adresse IP source enum : SOURCE_IP
Transport sécurisé (TLS) enum : TLS
Taille du message enum : MESSAGE_SIZE
Chiffrement S/MIME enum : SMIME_ENCRYPTED
Signé S/MIME enum : SMIME_SIGNED
Mode confidentiel de Gmail enum : CONFIDENTIAL_MODE
Spam enum : SPAM
Type de correspondance la plage suivante source_ip_range string
la valeur suivante (Mo) message_size_in_megabytes entier
Le message est authentifié metadata_match_type enum : MESSAGE_AUTHENTICATED
Le message n'est pas authentifié enum : MESSAGE_NOT_AUTHENTICATED
L'adresse IP source se trouve dans enum : SOURCE_IP_IN_RANGE
L'adresse IP source n'est pas comprise dans enum : SOURCE_IP_NOT_IN_RANGE
La connexion est chiffrée par TLS. enum : TLS_ENCRYPTED
La connexion n'est pas chiffrée par TLS. enum : TLS_NOT_ENCRYPTED
La taille du message est supérieure à enum : MESSAGE_SIZE_GREATER_THAN
La taille du message est inférieure à enum : MESSAGE_SIZE_LESS_THAN
Le message est chiffré avec S/MIME enum : MESSAGE_IS_SMIME_ENCRYPTED
Le message n'est pas chiffré avec S/MIME enum : MESSAGE_IS_NOT_SMIME_ENCRYPTED
Le message est signé selon la norme S/MIME enum : MESSAGE_IS_SMIME_SIGNED
Le message n'est pas signé selon la norme S/MIME enum : MESSAGE_IS_NOT_SMIME_SIGNED
Le message est en mode confidentiel de Gmail enum : MESSAGE_IS_IN_CONFIDENTIAL_MODE
Le message n'est pas en mode confidentiel de Gmail enum : MESSAGE_IS_NOT_IN_CONFIDENTIAL_MODE
Logiciel malveillant détecté par le bac à sable de sécurité enum : MALWARE_DETECTED_FROM_SECURITY_SANDBOX
PredefinedContentMatch N/A (Sélecteur de correspondance de contenu prédéfini) predefined_content_match_name string
Nombre minimal de correspondances min_match_count entier
Seuil de confiance confidence_threshold enum:
  • MEDIUM
  • HIGH
FileTypeMatch Documents Office chiffrés encrypted_office_documents booléen
Documents Office non chiffrés unencrypted_office_documents booléen
Vidéo et multimédia vidéo booléen
Musique et audio music booléen
Images image booléen
Fichiers et archives compressés qui sont chiffrés compressed_encrypted_files booléen
Fichiers compressés et archives non chiffrées compressed_unencrypted_files booléen
Types de fichiers personnalisés : faire correspondre les fichiers en fonction de l'extension du nom de fichier custom_file_extensions chaîne[]
Mettre également en correspondance les fichiers en fonction de leur format match_file_format booléen
RuleConsequences Modifier le message N/A rule_consequence_type enum : MODIFY_MESSAGE
N/A primary_delivery Diffusion
Ajouter d'autres destinataires deliver_to_additional_recipients booléen
Destinataires bcc_deliveries Livraison[]
Diffusion Ajouter l'en-tête X-Gm-Original-To add_x_gm_original_to_header booléen
Ajouter les en-têtes X-Gm-Spam et X-Gm-Phishy add_x_gm_spam_header booléen
Ajouter des en-têtes personnalisés add_custom_headers booléen
En-têtes personnalisés custom_headers chaîne[]
Ajouter un préfixe personnalisé à l'objet prepend_custom_subject booléen
Saisissez un nouveau préfixe d'objet custom_subject string
Modifier la route change_default_route booléen
Réacheminer aussi le spam reroute_spam booléen
Supprimer les avis de non-distribution de ce destinataire suppress_bounces_from_recipient booléen
N/A (sélecteur de routage) normal_routing booléen
Modifier le destinataire de l'enveloppe N/A change_envelope_recipient booléen
Remplacer le destinataire replace_envelope_recipient_type enum : REPLACE_ADDRESS
recipient_address string
Remplacer le nom d'utilisateur replace_envelope_recipient_type enum : REPLACE_USER
recipient_user string
Remplacer le domaine replace_envelope_recipient_type enum : REPLACE_DOMAIN
recipient_domain string
Ignorer le filtre anti-spam pour ce message bypass_spam_filter booléen
Supprimer les pièces jointes du message remove_attachments booléen
Ajouter ce texte pour avertir les destinataires que des pièces jointes ont été supprimées attachment_removal_notice string
Exiger l'utilisation du protocole TLS require_tls booléen
Chiffrer le message s'il ne l'est pas déjà (S/MIME) encrypt_outgoing_messages booléen
Message d'erreur automatique si la signature et le chiffrement sont impossibles bounce_unencrypted_messages booléen
Ne pas distribuer de spam à ce destinataire do_not_deliver_spam_to_recipient booléen
OAuthMailClientList Limiter les clients de messagerie accessibles aux utilisateurs (clients de messagerie OAuth uniquement) oauth_mail_client OAuthMailClient[]
OAuthMailClient N/A oauth_mail_client_id string
EmailQuarantine N/A quarantine_id entier
Nom nom string
Description description string
Effet du rejet des messages entrants inbound_denial_consequence enum:
  • DENIAL_CONSEQUENCE_UNSPECIFIED
  • DROP
  • REJECT
Effet du rejet des messages sortants outbound_denial_consequence enum:
  • DENIAL_CONSEQUENCE_UNSPECIFIED
  • DROP
  • REJECT
Notifier régulièrement de la mise en quarantaine des messages send_notifications booléen
Groupe d'examinateurs de la zone de quarantaine quarantine_acl_group_ids chaîne[]

Paramètres de Groups for Business

Page de la console d'administration Paramètre spécifique dans la console d'administration Type de paramètre de l'API Policy Modification possible Légende de la console d'administration Nom du champ de l'API Policy Type de données
Groups for Business Paramètres de partage > Options de partage groups_for_business.groups_sharing Non Définir des règles pour modifier les paramètres de partage des groupes collaborationCapability enum :
  • ANYONE_CAN_ACCESS
  • DOMAIN_USERS_ONLY
Créer un groupe createGroupsAccessLevel enum :
  • ADMIN_ONLY
  • USERS_IN_DOMAIN
  • ANYONE_CAN_CREATE
Les propriétaires de groupe peuvent autoriser les membres extérieurs ownersCanAllowExternalMembers booléen
Les propriétaires de groupe peuvent autoriser la réception d'e-mails provenant de l'extérieur de l'organisation ownersCanAllowIncomingMailFromPublic booléen
Paramètre d'autorisation par défaut pour la consultation des conversations viewTopicsDefaultAccessLevel enum :
  • OWNERS
  • MANAGERS
  • GROUP_MEMBERS
  • DOMAIN_USERS
  • ANYONE_CAN_VIEW_TOPICS
Les propriétaires de groupes peuvent masquer des groupes dans l'annuaire ownersCanHideGroups booléen
Masquer les nouveaux groupes dans l'annuaire newGroupsAreHidden booléen
Page de la console d'administration Paramètre spécifique dans la console d'administration Type de paramètre de l'API Policy Modification possible Légende de la console d'administration Nom du champ de l'API Policy Type de données
Paramètres de compte Options de partage cloud_sharing_options.cloud_data_sharing Non Options de partage de Google Cloud Platform sharingOptions enum:
  • UNSUPPORTED
  • ENABLED
  • DISABLED

Paramètres de Marketplace

Page de la console d'administration Paramètre spécifique dans la console d'administration Type de paramètre de l'API Policy Modification possible Légende de la console d'administration Nom du champ de l'API Policy Type de données
Liste des applis Liste des applications workspace_marketplace.apps_allowlist Non Affichage des applications pour les utilisateurs de toutes les unités organisationnelles Workspace AppsAllowlistSetting[]
Paramètres Gérer l'accès aux applications > Gérer l'accès à la liste d'autorisation Google Workspace Marketplace workspace_marketplace.apps_access_options Non Sélectionnez les applications Marketplace que les utilisateurs peuvent exécuter et installer. access_level enum :
  • ALLOW_ALL
  • ALLOW_LISTED_APPS
  • ALLOW_NONE

Sous-paramètres de Marketplace

Nom du sous-paramètre de l'API Policy Légende de la console d'administration Nom du champ de l'API Policy Type de données
AppsAllowlistSetting N/A application_id string
N/A accès enum :
  • ALLOWED
  • BLOCKED

Le paramètre workspace_marketplace.apps_allowlist de la réponse de l'API expose le application_id Marketplace au lieu de application_name. Le script Python suivant peut être utilisé pour convertir un ou plusieurs application_id spécifiés sur la ligne de commande en 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)

Paramètres Meet

Page de la console d'administration Paramètre spécifique dans la console d'administration Type de paramètre de l'API Policy Modification possible Légende de la console d'administration Nom du champ de l'API Policy Type de données
Google Meet Paramètres vidéo Meet > Enregistrement meet.video_recording Non Autorisez les utilisateurs à enregistrer leurs réunions. enable_recording booléen
Paramètres vidéo Meet > Transcription automatique meet.automatic_transcription Non Les réunions sont transcrites par défaut activé booléen
Paramètres vidéo Meet > Enregistrement automatique meet.automatic_recording Non Les réunions sont enregistrées par défaut activé booléen
Paramètres de sécurité Meet > Domaine meet.safety_domain Non Utilisateurs autorisés à participer aux réunions créées par votre organisation users_allowed_to_join enum :
  • SAME_ORGANIZATION_ONLY
  • LOGGED_IN
  • ALL
Paramètres de sécurité Meet > Accès meet.safety_access Non Réunions ou appels auxquels les utilisateurs de l'organisation ont accès. Il se peut que les restrictions appliquées aux appels entrants limitent davantage les appels que les utilisateurs peuvent recevoir. meetings_allowed_to_join enum :
  • SAME_ORGANIZATION_ONLY
  • ANY_WORKSPACE_ORGANIZATION
  • ALL
Paramètres de sécurité Meet > Gestion par l'organisateur meet.safety_host_management Non Gestion par l'organisateur par défaut enable_host_management booléen
Paramètres de sécurité Meet > Avertissement de participants externes meet.safety_external_participants Non Indique les participants qui ne font pas partie de l'organisation ou dont l'identité n'est pas confirmée. enable_external_label booléen
Paramètres de sécurité Meet > Participation meet.joining Non Type d'accès aux réunions (sous réserve des restrictions définies dans "Domaine") allowed_audience enum :
  • ALLOWED_AUDIENCE_UNSPECIFIED
  • OPEN
  • TRUSTED
  • RESTRICTED
Paramètres de sécurité Meet > Chat meet.messaging Non Qui peut envoyer des messages de chat en cours d'appel activé booléen
Paramètres de sécurité Meet > Présenter meet.presenting Non Qui peut partager son écran en cours d'appel activé booléen
Paramètres de sécurité Meet > Questions/Réponses meet.questions Non Qui peut participer aux questions-réponses dans les appels activé booléen
Paramètres de sécurité Meet > Sondages meet.polls Non Qui peut participer aux sondages dans les appels activé booléen
Paramètres de sécurité Meet > Restrictions des appels entrants meet.meet_incoming_call_restrictions Non Ce paramètre n'affecte que Meet pour les appels, pas les anciens services ni les appels dans Google Chat. Il se peut que les restrictions définies sous "Accès" limitent davantage les appels que les utilisateurs peuvent recevoir. allowed_callers enum :
  • ALLOWED_CALLERS_UNSPECIFIED
  • ALL
  • CONTACTS_AND_ORGANIZATION_ONLY
  • NONE

Paramètres de provisionnement

Page de la console d'administration Paramètre spécifique dans la console d'administration Type de paramètre de l'API Policy Mutate compatible avec la version v1beta1 Légende de la console d'administration Nom du champ de l'API Policy Type de données
Paramètres de compte Gestion des comptes en conflit provisioning.conflicting_accounts_management Non Choisir comment gérer les comptes en conflit option enum :
  • OPTION_UNSPECIFIED
  • AUTOMATICALLY_SEND_INVITATIONS
  • REPLACE_CONFLICTING_ACCOUNT
  • PRESERVE_CONFLICTING_ACCOUNT
Envoyer des e-mails de suivi quotidiens pendant (nombre spécifié) jours automatic_invitations.invitation_count entier
Si un utilisateur n'accepte pas une invitation avant la fin de la période de suivi sélectionnée automatic_invitations.unaccepted_invitation_resolution_option enum :
  • UNACCEPTED_INVITATION_RESOLUTION_OPTION_UNSPECIFIED
  • REPLACE_CONFLICTING_ACCOUNT_ON_NEXT_CREATION
  • PRESERVE_CONFLICTING_ACCOUNT_ON_NEXT_CREATION

Paramètres des règles et des détecteurs

Cette section décrit les paramètres des règles et des détecteurs.

Paramètres des règles de protection des données

Pour savoir comment créer des règles de protection des données et des détecteurs pour les applications compatibles, consultez Créer des règles de protection des données.

Page de la console d'administration Paramètre spécifique dans la console d'administration Type de paramètre de l'API Policy Modification possible Légende de la console d'administration Nom du champ de l'API Policy Type de données
Protection des données Sécurité > Accès et contrôle des données > Protection des données > Gérer les règles rule.dlp Oui Nom display_name string
Description description string
Applications déclencheurs string[] : liste de chaînes de déclenchement spécifiques à l'application. Spécifiez un ou plusieurs déclencheurs à surveiller. La règle est évaluée lorsque l'un des déclencheurs spécifiés se produit. Consultez la section Déclencheurs pour connaître les valeurs disponibles.
Conditions état string : expression CEL (Common Expression Language) des conditions de données recherchées par la règle. La syntaxe CEL et quelques exemples courants sont fournis dans la section "Conditions" ci-dessous.
Actions action Struct : objet imbriqué représentant les actions spécifiques à l'application à effectuer lorsque les conditions sont remplies. Les actions disponibles pour chaque déclencheur d'application sont indiquées dans la section "Actions" ci-dessous.
État state enum :
  • ACTIVE
  • INACTIVE
Création create_time Horodatage
Dernière modification update_time Horodatage
Métadonnées spécifiques au type de règle rule_type_metadata Struct : objet imbriqué représentant les métadonnées spécifiques au type de règle. Pour les règles de protection des données, ce champ contient le niveau de gravité des événements déclenchés.

Déclencheurs

Le tableau suivant fournit la liste des plates-formes, applications et déclencheurs disponibles :

Platform Application Déclencheur Valeur de l'API
Google Workspace Gmail Message envoyé google.workspace.gmail.email.v1.send
Message reçu google.workspace.gmail.email.v1.receive
Google Drive Fichiers Drive google.workspace.drive.file.v1.share
Google Chat Message envoyé google.workspace.chat.message.v1.send
Fichier importé google.workspace.chat.attachment.v1.upload
Chrome Chrome Fichier importé google.workspace.chrome.file.v1.upload
Fichier téléchargé google.workspace.chrome.file.v1.download
Contenu collé google.workspace.chrome.web_content.v1.upload
Contenu imprimé google.workspace.chrome.page.v1.print
URL visitée google.workspace.chrome.url.v1.navigation
ChromeOS ChromeOS Restrictions de transfert de fichier google.workspace.chromeos.file.v1.transfer

Conditions

Pour représenter les conditions de données, l'API utilise des expressions CEL (Common Expression Language). Chaque condition suit le modèle de {match source}.{content to scan for}({additional scan parameters}). Par exemple, all_content.contains('apple') représente une condition de données qui correspond si l'un des contenus analysés (par exemple, un document Drive, un message de chat, etc.) contient la sous-chaîne apple.

Sources de correspondance

Liste des sources de correspondance disponibles, correspondant aux configurations de correspondance du même nom dans la console d'administration.

  • 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
Contenu à rechercher

Liste des contenus disponibles à analyser, correspondant aux configurations correspondantes portant les mêmes noms dans la console d'administration.

  • 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}})
    • Correspond à l'option Correspond à un type de données prédéfini de la console d'administration.
    • {detector name} désigne le type de données prédéfini à rechercher, qui peut être l'un des types d'informations intégrés compatibles avec Sensitive Data Protection : https://cloud.google.com/sensitive-data-protection/docs/infotypes-reference (par exemple, CREDIT_CARD_NUMBER ou US_SOCIAL_SECURITY_NUMBER). Certains types de détecteurs plus récents ne sont pas compatibles avec cette API et renvoient une erreur s'ils sont spécifiés.
    • {likelihood} indique le seuil de probabilité de la correspondance. Par exemple, google.privacy.dlp.v2.Likelihood.LIKELY correspond au seuil Élevé dans la console d'administration.
  • matches_regex_detector({detector name}, {minimum_match_count: {count}})
    • Correspond à l'option Correspond à l'expression régulière de la console d'administration.
    • {detector name} est le nom de ressource de la règle qui représente le détecteur d'expressions régulières. Consultez la section Détecteur de protection des données pour savoir comment interroger les règles de détection dans l'API.
  • matches_word_list({detector name}, {minimum_match_count: {count}, minimum_unique_match_count: {count}})
    • Correspond à l'option Correspond aux mots d'une liste de mots de la console d'administration.
    • {detector name} est le nom de ressource de la règle qui représente le détecteur de liste de mots. Consultez la section Détecteur de protection des données pour savoir comment interroger les règles de détection dans l'API.
  • matches_web_category({category})
    • Correspond à l'option Correspondances de catégories d'URL dans la console d'administration pour le déclencheur "URL visitée" de Chrome.
    • {category} désigne la catégorie d'URL compatible avec la configuration de la console d'administration. Pour obtenir la liste des catégories disponibles et leurs représentations d'API, consultez Catégories d'URL.
  • contains_word({string})
    • Correspond si le contenu contient {string} en tant que mot entier.
  • matches_file_extension({extension})
    • Établit une correspondance si l'extension de fichier est {extension}.
  • matches_mime_types({categories}, {custom_types})
    • Correspond si le type MIME du fichier appartient à l'un des {categories} ou {custom_types} spécifiés.
  • matches_metadata({metadata_criteria})
    • Correspond aux fichiers Drive en fonction de {metadata_criteria} défini dans les libellés Drive.
  • matches_enum({enum_value})
    • Met en correspondance les champs basés sur l'énumération avec {enum_value}. Exemple :encryption_state.matches_enum('ENCRYPTED')
  • matches_url_list({url_list_id})
    • Correspond si l'URL est présente dans la liste d'URL spécifiée {url_list_id}.
  • matches_url_risk_level({risk_level})
    • Établit une correspondance si le niveau de risque de l'URL est {risk_level}.
  • matches_address({email})
    • Établit une correspondance si l'adresse e-mail est {email}.
  • matches_address_domain_name({domain})
    • Établit une correspondance si le domaine de l'adresse e-mail est {domain}.
  • matches_address_regex({regex})
    • Correspond si l'adresse e-mail correspond à l'expression régulière {regex}.
Conditions composites

Plusieurs conditions de base peuvent être combinées avec les opérateurs AND (&&), OR (||) ou NOT (!) pour former une condition composite. Par exemple, "all_content.contains('apple') && all_content.contains('banana')" représente une condition qui correspond si l'un des contenus analysés contient à la fois les sous-chaînes "apple" et "banana".

Syntaxe des expressions CEL pour les règles

L'expression CEL (Common Expression Language) qui définit la logique d'une règle se trouve dans le champ condition de la ressource Rule. Ce champ est généralement un message google.type.Expr, avec l'expression CEL dans un champ expression ou cel_expression.

Pour créer une règle valide, vous devez utiliser des fonctions CEL compatibles avec l'application, l'événement déclencheur et la source de correspondance que vous ciblez.

Le tableau suivant liste les sources de correspondance et les fonctions de condition disponibles pour chaque application et déclencheur des règles de protection des données (DLP).

Application Événement déclencheur Source de la correspondance Fonctions de condition CEL disponibles
Gmail Message envoyé
Message reçu		 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}) (par exemple, 'CONFIDENTIAL_MODE_ENABLED')
Drive Fichiers Drive 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}) (par exemple, 'ENCRYPTED')
Chat Message envoyé
Fichier importé		 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}})
Fichier importé uniquement file_name contains({string})
contains_word({string})
file_extension matches_file_extension({extension})
file_type matches_mime_types({categories}, {custom_types})
Chrome Fichier importé
Fichier téléchargé
Contenu collé
Contenu imprimé		 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}})
Fichier importé
Fichier téléchargé
Contenu imprimé		 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}})
Tous les déclencheurs 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})
(Remarque : url est également compatible avec 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 Opérateurs de comparaison standards (par exemple, 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})
Contenu collé uniquement source_chrome_context matches_enum({enum_value}) (valeurs : 'CLIPBOARD', 'INCOGNITO', 'OTHER_PROFILE')
ChromeOS Restrictions de transfert de fichier 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 Opérateurs de comparaison standards

Actions

Chaque application spécifie l'action à effectuer lorsque la condition de données correspond dans un message imbriqué. Par exemple, { "driveAction" { "warnUser" { } } } représente une action Drive qui avertit les utilisateurs en cas de partage externe. Les actions spécifiques à l'application disponibles sont les suivantes :

Application Touche d'action Sous-action Légende de la console d'administration
Drive driveAction blockAccess Bloquer le partage externe
warnUser Afficher un avertissement en cas de partage externe
auditOnly Aucune action
restrictCopyPrintDownload Désactiver le téléchargement, l'impression et la copie
applyLabels Appliquer des libellés de classification
Gmail gmailAction blockContent Bloquer le message
warnUser Avertir les utilisateurs
auditOnly Audit uniquement
quarantineMessage Mettre le message en quarantaine
applyLabels Appliquer des libellés de classification
addFooter Ajouter une note personnalisée (pied de page)
Chat chatAction blockContent Bloquer le message
warnUser Avertir les utilisateurs
auditOnly Audit uniquement
Google Chrome chromeAction blockContent Bloquer
warnUser Autoriser avec message d'avertissement
ChromeOS chromeOsAction blockContent Bloquer
warnUser Autoriser avec message d'avertissement
auditOnly Audit uniquement

Paramètres d'action

Les paramètres d'action fournissent une configuration supplémentaire pour les actions de règle. Les paramètres disponibles dépendent de l'application.

Exemple de définition des paramètres d'action

L'exemple suivant montre comment spécifier des paramètres d'action pour une action Chrome blockContent, en activant le coffre-fort de preuves (saveContent) et en définissant un message de filigrane (watermarkMessage). Cela utilise la représentation Struct générique utilisée par l'API.

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"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}

Paramètres d'action Drive

Les actions Drive ne nécessitent généralement pas de paramètres supplémentaires. Toutefois, l'action restrictCopyPrintDownload nécessite de spécifier un champ d'application.

Paramètre Type de données Description
restrict_copy_print_download.scope enum Spécifie le champ d'application des utilisateurs pour lesquels désactiver le téléchargement, l'impression et la copie.
  • SCOPE_UNSPECIFIED : champ d'application non spécifié.
  • VIEWERS_AND_COMMENTERS : désactiver pour les lecteurs et les commentateurs.
  • ALL_COLLABORATORS : désactivez l'option pour tous les collaborateurs (lecteurs, commentateurs, rédacteurs, propriétaires).

Paramètres d'action Gmail

Paramètre Type de données Description
apply_internal_messages booléen Applique l'action aux messages internes.
apply_external_messages booléen Applique l'action aux messages externes.
apply_to_internal_receive_messages booléen Applique l'action aux messages internes reçus.
apply_to_external_receive_messages booléen Applique l'action aux messages reçus de l'extérieur.
custom_end_user_message.unsafe_html_message_body string Contenu du message HTML à afficher pour l'utilisateur final lorsqu'une règle se déclenche. Seules les balises <a> sont acceptées.
add_footer.footer.title string Titre de la note personnalisée (50 caractères maximum).
add_footer.footer.unsafe_html_message_body string Texte de description HTML de la note personnalisée. Seules les balises <a> sont acceptées (300 caractères maximum).
add_footer.footer.banner_highlighted booléen Indique si la note personnalisée doit être mise en évidence dans une bannière.
add_footer.footer.position enum Position de la note personnalisée dans le message : TOP ou BOTTOM.
apply_labels.label_delta Struct[] Liste des modifications d'étiquettes à appliquer. Chaque objet contient les éléments suivants :
  • label_id : chaîne
  • field_delta : structure avec les champs suivants :
    • field_id : chaîne
    • selection : chaîne (pour les champs à sélection unique)
    • selection_list : structure avec operation (SET, MERGE) et values (string[])
apply_labels.conflict_resolution_strategy enum Stratégie de résolution des conflits : SYSTEM_OVERRIDE ou ALLOW_USER_OVERRIDE.
apply_labels.custom_end_user_message.unsafe_html_message_body string Contenu du message HTML à afficher à l'utilisateur final lorsque l'action d'application des libellés se déclenche. Seules les balises <a> sont acceptées.
quarantine_message.quarantine_resource_name string Nom de ressource de la zone de quarantaine. Le format est quarantines/obfuscated<id> ou quarantines/default.

Paramètres d'action dans Chat

Paramètre Type de données Description
apply_internal_direct_messages booléen Applique l'action aux messages envoyés via des messages privés internes.
apply_external_direct_messages booléen Applique l'action aux messages envoyés via des messages privés externes.
apply_internal_rooms booléen Applique l'action aux messages envoyés aux salons internes.
apply_external_rooms booléen Applique l'action aux messages envoyés à des espaces externes.
apply_internal_group_chats booléen Applique l'action aux messages envoyés aux chats de groupe internes.
apply_external_group_chats booléen Applique l'action aux messages envoyés à des chats de groupe externes.
custom_end_user_message.unsafe_html_message_body string Contenu du message HTML à afficher pour l'utilisateur final lorsqu'une règle se déclenche. Seules les balises <a> sont acceptées.

Paramètres d'action Google Chrome

Paramètre Type de données Description
save_content booléen Permet d'enregistrer en toute sécurité le contenu qui déclenche cette règle (Evidence Locker).
watermark_message string Texte affiché en filigrane lorsqu'une règle de navigation d'URL se déclenche.
custom_end_user_message.unsafe_html_message_body string Contenu du message HTML à afficher pour l'utilisateur final lorsqu'une règle se déclenche. Seules les balises <a> sont acceptées.
block_screenshot booléen Bloque les captures d'écran et le partage d'écran lorsque la valeur est définie sur true.
match_only_download_url booléen Évalue la règle en fonction de l'URL de téléchargement uniquement, en ignorant l'URL de l'onglet.
force_save_to_cloud_sub_action.destination enum Destination de stockage cloud pour les enregistrements forcés au lieu du système de fichiers local.
  • DESTINATION_UNSPECIFIED : destination non spécifiée.
  • GOOGLE_DRIVE_CORP : enregistre les fichiers dans le Google Drive de l'entreprise.
  • ONEDRIVE_CORP : enregistre les fichiers dans Microsoft OneDrive d'entreprise.
data_masking.regex_detector Struct[] Liste des détecteurs d'expressions régulières utilisés pour le masquage des données. Spécifiez un ou plusieurs détecteurs sous la forme d'une liste d'objets, chacun contenant les champs décrits dans le tableau suivant.
data_masking.regex_detector[].mask_type enum Type de masquage à appliquer lorsque l'expression régulière correspond.
  • MASK_TYPE_LIGHT_OBFUSCATION : le texte masqué peut être révélé lorsque vous pointez dessus.
  • MASK_TYPE_HARD_OBFUSCATION : le texte masqué peut être révélé d'un clic de souris.
  • MASK_TYPE_REDACT : le texte est entièrement remplacé et ne peut pas être récupéré.
data_masking.regex_detector[].resource_name string Identifiant de la ressource de détecteur.
data_masking.regex_detector[].display_name string Nom du détecteur affiché dans les outils de reporting (comme l'outil d'investigation de sécurité) lorsqu'il est déclenché.
data_masking.regex_detector[].regex_pattern string Modèle d'expression régulière utilisé pour la mise en correspondance. Ce champ est renseigné par le système et ne doit pas être défini par l'utilisateur.

Paramètres d'action ChromeOS

Paramètre Type de données Description
save_content booléen Permet d'enregistrer en toute sécurité le contenu qui déclenche cette règle.

Métadonnées spécifiques au type de règle

Cet attribut contient les métadonnées spécifiques au type de règle. Pour les règles de protection des données, il contient la gravité de l'événement d'alerte lorsque l'événement est signalé dans le tableau de bord de sécurité et le centre d'alerte. Exemple de valeur de métadonnées représentant une gravité d'alerte FAIBLE :

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

Paramètres des détecteurs de protection des données

Pour en savoir plus sur les règles et les détecteurs de protection des données, consultez Créer des règles de protection contre la perte de données pour Drive et des détecteurs de contenu personnalisés.

Page de la console d'administration Paramètre spécifique dans la console d'administration Type de paramètre de l'API Policy Modification possible Légende de la console d'administration Nom du champ de l'API Policy Type de données
Protection des données Sécurité > Contrôle des accès et des données > Protection des données > Gérer les détecteurs detector.regular_expression detector.word_list detector.url_list Oui Nom display_name string
Description description string
Expression régulière regular_expression Struct : contient la chaîne d'expression régulière. Défini uniquement si le type de détecteur est "detector.regular_expression".
Liste de mots word_list Struct : contient la liste des chaînes de mots. Défini uniquement si le type de détecteur est detector.word_list.
Liste d'URL url_list Struct : contient la liste des chaînes d'URL. Défini uniquement si le type de détecteur est detector.url_list.
Création create_time Horodatage
Dernière modification update_time Horodatage

Paramètres des règles d'alerte définies par le système

Cette section décrit les règles d'alerte définies par le système Google Workspace.

Page de la console d'administration Paramètre spécifique dans la console d'administration Type de paramètre de l'API Policy Modification possible Légende de la console d'administration Nom du champ de l'API Policy Type de données
Protection des données Règles (pour le type de règle "définie par le système") rule.system_defined_alerts Non Nom display_name string
Description description string
Actions action Struct : objet imbriqué représentant les paramètres de notification lorsque l'alerte définie par le système est déclenchée. Pour en savoir plus, consultez la section "Actions" ci-dessous.
État state enum :
  • ACTIVE
  • INACTIVE
Création create_time Horodatage
Dernière modification update_time Horodatage

Actions

Les règles d'alerte définies par le système n'ont qu'une seule action, qui indique les paramètres de notification de l'alerte.

Touche d'action Sous-action Légende de la console d'administration Description
alertCenterAction alertCenterConfig Envoyer au centre d'alerte Configure la gravité de l'alerte et indique si l'alerte est envoyée au centre d'alerte.
destinataires Envoyer des notifications par e-mail Liste des adresses e-mail auxquelles envoyer des notifications lorsque l'alerte est déclenchée.

Paramètres d'action

Le tableau suivant fournit les paramètres de alertCenterAction :

Paramètre Type de données Description
alertCenterConfig.severity enum Gravité de l'alerte (par exemple, LOW, MEDIUM, HIGH).
alertCenterConfig.status enum Indique si l'alerte est envoyée au centre d'alerte (par exemple, ENABLED, DISABLED).
recipients chaîne[] Liste des adresses e-mail qui recevront les notifications par e-mail.

Paramètres de sécurité

Page de la console d'administration Paramètre spécifique dans la console d'administration Type de paramètre de l'API Policy Modification possible Légende de la console d'administration Nom du champ de l'API Policy Type de données
Récupération de compte Récupération des comptes super-administrateur security.super_admin_account_recovery Non Autoriser les super-administrateurs à récupérer leur compte enableAccountRecovery booléen
Récupération de compte utilisateur security.user_account_recovery Non Autoriser les utilisateurs autres que les super-administrateurs à récupérer leur compte enableAccountRecovery booléen
Gestion des mots de passe Gestion des mots de passe security.password Non Expiration expirationDuration Secondes (0 seconde signifie "N'expire jamais")
Réutiliser allowReuse booléen
Application d'une longueur et d'une sécurité minimales enforceRequirementsAtLogin booléen
Longueur (longueur maximale) maximumLength entier
Longueur (longueur minimale) minimumLength entier
Musculation allowedStrength enum :
  • STRONG
  • WEAK
Contrôle de session Google Contrôle de session security.session_controls Non Durée de la session Web webSessionDuration Secondes
Applications moins sécurisées Applications moins sécurisées security.less_secure_apps Non Contrôlez l'accès des utilisateurs aux applications qui utilisent une technologie de connexion moins sécurisée et rendent les comptes plus vulnérables. allowLessSecureApps booléen
Questions d'authentification à la connexion Questions d'authentification à la connexion security.login_challenges Non Utiliser l'ID des collaborateurs pour renforcer la sécurité des comptes utilisateur enableEmployeeIdChallenge booléen
Sans mot de passe Restriction des clés d'accès security.passkeys_restriction Non Choisir les types de clés d'accès que les utilisateurs peuvent utiliser pour se connecter allowed_passkeys_type enum :
  • ALLOWED_PASSKEYS_TYPE_UNSPECIFIED
  • HARDWARE_SECURITY_KEYS_ONLY
  • ANY_DEVICE_OR_PLATFORM
Programme Protection Avancée Inscription security.advanced_protection_program Non Utiliser l'ID des collaborateurs pour renforcer la sécurité des comptes utilisateur enableAdvancedProtectionSelfEnrollment booléen
Codes de sécurité securityCodeOption enum :
  • ALLOWED_WITH_REMOTE_ACCESS
  • ALLOWED_WITHOUT_REMOTE_ACCESS
  • CODES_NOT_ALLOWED
Validation en deux étapes Authentification security.two_step_verification_enrollment Non Autoriser les utilisateurs à activer la validation en deux étapes allowEnrollment booléen
security.two_step_verification_enforcement Application enforcedFrom Horodatage
security.two_step_verification_grace_period Période d'inscription des nouveaux utilisateurs enrollmentGracePeriod Durée
security.two_step_verification_device_trust Autoriser l'utilisateur à approuver l'appareil allowTrustingDevice booléen
security.two_step_verification_enforcement_factor Méthodes allowedSignInFactorSet enum :
  • ALL
  • PASSKEY_ONLY
  • PASSKEY_PLUS_SECURITY_CODE
  • PASSKEY_PLUS_IP_BOUND_SECURITY_CODE
  • NO_TELEPHONY
security.two_step_verification_sign_in_code Délai de grâce avant suspension de la règle de validation en deux étapes backupCodeExceptionPeriod Durée
Paramètres de l'approbation multipartite Paramètres de l'approbation multipartite multi_party_approval.require_approvals Non Choisissez si un administrateur disposant des droits d'approbation multipartite doit approuver les actions sensibles effectuées dans la console d'administration et l'API Admin. multi_party_approval_state enum :
  • MULTI_PARTY_APPROVAL_STATE_UNSPECIFIED
  • ENABLED
  • DISABLED
Approbation multipartite pour les paramètres de sécurité multi_party_approval.security_actions Non Validation en deux étapes two_step_verification_multi_party_approval_state
Récupération de compte account_recovery_multi_party_approval_state
Contrôle de session Google session_controls_multi_party_approval_state
Programme Protection Avancée advanced_protection_program_multi_party_approval_state
Questions d'authentification à la connexion login_challenges_multi_party_approval_state
Sans mot de passe passwordless_multi_party_approval_state
Délégation au niveau du domaine domain_wide_delegation_multi_party_approval_state
SSO avec des fournisseurs d'identité tiers sso_with_third_party_idps_multi_party_approval_state
Accès contextuel context_aware_access_multi_party_approval_state
Approbation multipartite pour l'accès de l'API aux paramètres de sécurité multi_party_approval.security_actions_api_access Non SSO avec des fournisseurs d'identité tiers sso_with_third_party_idps_multi_party_approval_state
Approbation multipartite pour les paramètres d'agenda multi_party_approval.calendar_actions Non Partage d'agendas calendar_sharing_multi_party_approval_state
Paramètres généraux de l'agenda general_calendar_settings_multi_party_approval_state
Paramètres d'archivage tiers de l'agenda third_party_archiving_settings_multi_party_approval_state
Approbation multipartite pour les paramètres de groupe multi_party_approval.groups_actions Non Partage de groupes groups_sharing_multi_party_approval_state
Approbation multipartite pour les paramètres d'administration des domaines multi_party_approval.domains_actions Non API Domains domains_api_multi_party_approval_state

Paramètres d'état du service

Le paramètre service_status contient une valeur booléenne indiquant si un service est activé pour un certain OrgUnit ou Group.

L'API Policy est compatible avec les paramètres d'état des services Google Workspace, Services Google supplémentaires et IA générative listés dans la console d'administration.

Google Workspace

Nom du service dans la console d'administration Nom du service dans l'API Policy
AppSheet appsheet
Agenda agenda
Cloud Search cloud_search
Drive et Docs drive_and_docs
Gmail gmail
Google Chat chat
Google Meet meet
Google Vault vault
Google Voice voix
Groups for Business groups_for_business
Keep keep
Sites sites
Tâches tasks

Services Google supplémentaires

Nom du service dans la console d'administration Nom du service dans l'API Policy
AI Studio ai_studio
Applied Digital Skills applied_digital_skills
Devoirs devoirs
Blogger blogger
Comptes de marque brand_accounts
Campaign Manager 360 campaign_manager
Chrome Dessin chrome_canvas
Chrome Cursive chrome_cursive
Bureau à distance Chrome chrome_remote_desktop
Chrome Web Store chrome_web_store
Classroom classroom
CS First cs_first
Currents currents
Applications en accès anticipé early_access_apps
Applications expérimentales experimental_apps
FeedBurner feedburner
Google Ad Manager ad_manager
Google Ads ads
Google AdSense adsense
Google Alertes alertes
Google Analytics avancées
Google Arts & Culture arts_and_culture
Google Favoris bookmarks
Google Livres livres
Synchronisation Google Chrome chrome_sync
Google Cloud cloud
Google Cloud Print cloud_print
Google Colab Colab
Google Developers développeurs
Google Domains domaines
Google Earth terre
Google Fi fi
Google Groupes groupes
Google Maps cartes
Google Messages messages
Google My Business my_business
Google My Maps my_maps
Google Actualités news
Google Pay pay
Google Photos photos
Google Play lire
Google Play Console play_console
Google Public Data Explorer public_data
Google Read Along read_along
Google Search Console search_console
Google Takeout vente à emporter
Google Traduction translate
Google Trips trips
Jamboard jamboard
Historique des positions location_history
Data Studio data_studio
Google Play d'entreprise managed_play
Material Gallery material_gallery
Merchant Center merchant_center
Partner Dash partner_dash
Pinpoint pinpoint
Centre des partenaires Play Livres play_books_partner_center
Programmable Search Engine programmable_search_engine
Question Hub question_hub
Profils Google Scholar scholar_profiles
Search Ads 360 search_ads_360
Recherche et Assistant search_and_assistant
Socratic socratic
Studio studio
Sauvegardes d'applications tierces third_party_app_backups
Tour Creator tour_creator
Work Insights work_insights
YouTube youtube

IA générative

Nom du service dans la console d'administration Nom du service dans l'API Policy
Application Gemini gemini_app
NotebookLM notebooklm

Paramètres de Google Sites

Page de la console d'administration Paramètre spécifique dans la console d'administration Type de paramètre de l'API Policy Modification possible Légende de la console d'administration Nom du champ de l'API Policy Type de données
Sites Nouvelle version de Sites > Création et modification de sites sites.sites_creation_and_modification Non Autoriser les utilisateurs à créer des sites allowSitesCreation booléen
Les utilisateurs peuvent/ne peuvent pas modifier les sites allowSitesModification booléen

Paramètres UserTakeout

Page de la console d'administration Paramètre spécifique dans la console d'administration Type de paramètre de l'API Policy Modification possible Légende de la console d'administration Nom du champ de l'API Policy Type de données
Données Importation et exportation de données > Google Takeout > Accès utilisateur à Takeout pour les services 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
 Non Gérer l'accès des utilisateurs à Takeout pour les services Google takeout_status enum :
  • TAKEOUT_STATUS_UNSPECIFIED
  • ENABLED
  • DISABLED