Impostazioni disponibili nell'API
Questo documento descrive le impostazioni supportate dall'API Policy.
Se le impostazioni supportate non sono presenti nella risposta dell'API Cloud Identity Policy, consulta Valori predefiniti dei campi. Se l'impostazione mancante non è menzionata in Valori predefiniti dei campi, contatta l'assistenza clienti Google Cloud.
Controlli API
| Pagina nella Console di amministrazione | Impostazione specifica nella Console di amministrazione | Tipo di impostazione dell'API Policy | Mutazione supportata | Didascalia della Console di amministrazione | Nome campo API della policy | Tipo di dati |
| Controlli API | Impostazioni > Messaggio utente personalizzato | api_controls.custom_user_message
|
No | Personalizza il messaggio da mostrare agli utenti quando non possono accedere a un'app a causa delle impostazioni di accesso. | error_text | string |
| Impostazioni > App di terze parti non configurate | api_controls.unconfigured_third_party_apps
|
No | Le app di terze parti non configurate sono app che non sono state configurate con un'impostazione di accesso (ad esempio attendibile, con restrizioni o bloccata). Seleziona cosa succede quando gli utenti tentano di accedere ad app di terze parti non configurate con il proprio account. |
access_level | enum:
|
|
| Impostazioni > App di terze parti non configurate | api_controls.unconfigured_third_party_apps
|
No | Le app di terze parti non configurate sono app che non sono state configurate con un'impostazione di accesso (ad esempio attendibile, con restrizioni o bloccata). Seleziona cosa succede quando gli utenti minori di 18 anni tentano di accedere ad app di terze parti non configurate con il proprio account. |
access_level_under18 | enum:
|
|
| Impostazioni > App interne | api_controls.internal_apps
|
No | Le app interne di proprietà della tua organizzazione vengono configurate automaticamente con accesso attendibile. Queste app possono chiedere l'accesso API a tutti i dati di Google da parte degli utenti. | trust_internal_apps | boolean | |
| Impostazioni > Richieste utente per accedere ad app non configurate | api_controls.app_approval_requests
|
No | Consenti agli utenti di richiedere l'accesso ad app di terze parti non configurate | allowed_for_all | enum:
|
|
| Controllo dell'controllo dell'accesso alle app > Gestisci i servizi Google > Servizi Google | api_controls.google_services
|
No | Seleziona le impostazioni di accesso per le API dei servizi Google per controllare quale tipo di app di terze parti può richiedere l'accesso a questi servizi. | servizi | Service[] |
Impostazioni secondarie dei controlli API
Questa tabella fornisce le impostazioni secondarie di Controlli API a cui fanno riferimento altre impostazioni di Controlli API.
| Nome della sottoimpostazione dell'API Policy | Didascalia della Console di amministrazione | Nome campo API della policy | Tipo di dati |
| Servizio | Accesso | scopes_group | enum:
|
| Con limitazioni/Senza limitazioni | is_enabled | boolean |
Impostazioni calendario
| Pagina nella Console di amministrazione | Impostazione specifica nella Console di amministrazione | Tipo di impostazione dell'API Policy | Mutazione supportata | Didascalia della Console di amministrazione | Nome campo API della policy | Tipo di dati |
| Calendar | Impostazioni avanzate > Programmi degli appuntamenti con pagamenti | calendar.appointment_schedules
|
No | Consenti agli utenti del programma degli appuntamenti di richiedere il pagamento per gli appuntamenti prenotati tramite i propri account fornitore di servizi di pagamento. | enable_payments | boolean |
| Impostazioni di condivisione > Inviti esterni | calendar.external_invitations
|
No | Avvisa gli utenti quando invitano ospiti esterni al dominio ORGANIZATION_UNIT_NAME | warn_on_invite | boolean | |
| Gestione di Calendar Interop > Disponibilità di Exchange in Calendar | calendar.interoperability
|
No | Consenti a Google Calendar di mostrare la disponibilità degli utenti di Exchange | enable_interoperability | boolean | |
| Mostra i dettagli dell'evento | enable_full_event_details | boolean | ||||
| Gestione di Calendar Interop > Prenotazione delle risorse di Exchange | calendar.interoperability
|
No | Abilita Google Calendar a prenotare stanze di Microsoft Exchange | enable_exchange_room_booking | boolean | |
| Impostazioni di condivisione > Opzioni di condivisione esterna per i calendari principali | calendar.primary_calendar_max_allowed_external_sharing
|
No | All'esterno di ORGANIZATION_UNIT_NAME: imposta le funzionalità utente per i calendari principali | max_allowed_external_sharing | enum:
|
|
| Impostazioni di condivisione > Opzioni di condivisione esterna per calendari secondari | calendar.secondary_calendar_max_allowed_external_sharing
|
No | All'esterno di <nome organizzazione>: imposta le funzionalità utente per i calendari secondari | max_allowed_external_sharing | enum:
|
Impostazioni chat
| Pagina nella Console di amministrazione | Impostazione specifica nella Console di amministrazione | Tipo di impostazione dell'API Policy | Mutazione supportata | Didascalia della Console di amministrazione | Nome campo API della policy | Tipo di dati |
| Google Chat | Cronologia per le chat | chat.chat_history
|
No | La cronologia è ATTIVA/DISATTIVATA | history_on_by_default | boolean |
| Permetti agli utenti di modificare le impostazioni della cronologia | allow_user_modification | boolean | ||||
| Condivisione file in Chat | chat.chat_file_sharing
|
No | Condivisione file esterna | external_file_sharing | enum:
|
|
| internal_file_sharing | stesso | |||||
| Cronologia per gli spazi | chat.space_history
|
No | Impostazioni della cronologia delle conversazioni per gli spazi | history_state | enum:
|
|
| Impostazioni chat esterna | chat.external_chat_restriction
|
No | Consenti agli utenti di inviare messaggi all'esterno dell'organizzazione in chat e spazi | allow_external_chat | boolean | |
| external_chat_restriction | enum:
|
|||||
| App di Chat | chat.chat_apps_access
|
No | Consenti agli utenti di installare app di Chat | enable_apps | boolean | |
| Consenti agli utenti di aggiungere e utilizzare i webhook in arrivo | enable_webhooks | boolean | ||||
| Archiviazione di terze parti | chat.third_party_archiving
|
No | Attiva l'archiviazione di terze parti | abilitato | boolean | |
| Specifica un indirizzo email a cui consegnare i contenuti di Chat | destination_email_address | string | ||||
| Specifica la frequenza di invio dei messaggi di archiviazione di Chat (tra 1 e 24 ore) | archival_frequency | Durata | ||||
| Elenco separato da virgole di eventuali intestazioni personalizzate richieste dall'indirizzo di destinazione | custom_headers | string | ||||
| Spazi esterni | chat.external_spaces
|
No | Consenti agli utenti di partecipare a spazi dove sono presenti persone esterne alla loro organizzazione e di crearli | abilitato | boolean | |
| Permetti agli utenti di aggiungere persone solo da domini inclusi nella lista consentita | domain_allowlist_mode | enum:
|
||||
| Impostazioni di condivisione > Valore predefinito per l'accesso a Spazi | chat.space_access_default
|
No | Accesso allo spazio predefinito quando gli utenti creano nuovi spazi. | access_type | enum:
|
|
| Segnalazione dei contenuti | chat.content_reporting
|
No | Consenti agli utenti di segnalare contenuti nei messaggi diretti 1:1 | one_on_one_direct_messages_reporting | enum:
|
|
| Consenti agli utenti di segnalare contenuti nei messaggi di gruppo diretti | group_direct_messages_reporting | stesso | ||||
| Consenti agli utenti di segnalare contenuti in spazi specifici | spaces_reporting | stesso | ||||
| spaces_reporting_type | enum:
|
|||||
| Specifica le categorie che gli utenti possono scegliere quando segnalano contenuti | reporting_categories | oggetto ripetuto:
|
||||
| Specifica un titolo e una descrizione personalizzati per il modulo di segnalazione | reporting_form_customization_enabled | boolean | ||||
| custom_reporting_form_title | string | |||||
| custom_reporting_form_description | string | |||||
| Limitazioni relative a chat e spazi | chat.chat_and_space_restrictions
|
No | Limita la creazione di messaggi, messaggi di gruppo e spazi. Gli utenti con questa limitazione non possono gestire i membri. | restriction_level | enum:
|
Impostazioni di Classroom
| Pagina nella Console di amministrazione | Impostazione specifica nella Console di amministrazione | Tipo di impostazione dell'API Policy | Mutazione supportata | Didascalia della Console di amministrazione | Nome campo API della policy | Tipo di dati |
| Classroom | Impostazioni generali > Autorizzazioni degli insegnanti | classroom.teacher_permissions
|
No | Chi può creare corsi | whoCanCreateClasses | enum:
|
| Impostazioni generali > Accesso per i tutori | classroom.guardian_access
|
No | Consenti a genitori e tutori di accedere alle informazioni di Classroom | allowAccess | boolean | |
| Chi può gestire genitori e tutori | whoCanManageGuardianAccess | enum:
|
||||
| Impostazioni dei corsi > Informazioni sull'iscrizione a corsi | classroom.class_membership
|
No | Utenti che possono partecipare a corsi nel tuo dominio | whoCanJoinClasses | enum:
|
|
| Corsi a cui possono partecipare gli utenti del tuo dominio | whichClassesCanUsersJoin | enum:
|
||||
| Accesso ai dati > API Classroom | classroom.api_data_access
|
No | Gli utenti possono autorizzare le app ad accedere ai propri dati di Google Classroom | enableApiAccess | boolean | |
| Report sull'originalità > Corrispondenze in documenti della scuola | classroom.originality_reports
|
No | Abilita le corrispondenze in documenti della scuola nei report sull'originalità | enableOriginalityReportsSchoolMatches | boolean | |
| Annullamento della registrazione dello studente > Autorizzazioni per l'annullamento della registrazione | classroom.student_unenrollment
|
No | Chi può annullare la registrazione degli studenti ai corsi | whoCanUnenrollStudents | enum
|
|
| Importazione dei roster > Impostazioni | classroom.roster_import
|
No | Importazione elenchi degli studenti | rosterImportOption | enum:
|
|
| Gemini nelle app Workspace | Gemini in Workspace > Accesso alle funzionalità in Classroom > Classroom | classroom.gemini_access
|
No | Scegli se gli utenti possono accedere a Gemini in Classroom | abilitato | boolean |
Impostazioni di conformità dei dati
| Pagina nella Console di amministrazione | Impostazione specifica nella Console di amministrazione | Tipo di impostazione dell'API Policy | Mutazione supportata | Didascalia della Console di amministrazione | Nome campo API della policy | Tipo di dati |
| Gestione degli accessi | Gestione degli accessi > Policy di gestione degli accessi | access_management.user_scoping
|
No | Scegli un criterio di gestione degli accessi per i dati coperti | allowed_audience | enum:
|
| Regioni di dati | Regione > Dati at-rest | data_regions.data_at_rest_region
|
No | Regione per l'archiviazione di dati at-rest | regione | enum:
|
| Regione > Trattamento dati | data_regions.data_processing_region
|
No | Criteri per le regioni di dati ai fini del trattamento dei dati | limit_to_storage_region | boolean | |
| Approvazioni dell'accesso | Access Approvals > Policy di Access Approvals | access_approval.axa_user_scoping
|
No | Imponi al personale Google di richiedere l'approvazione prima di visualizzare i dati necessari per i Servizi di assistenza | requires_customer_approval | boolean |
Impostazioni dei dispositivi
| Pagina nella Console di amministrazione | Impostazione specifica nella Console di amministrazione | Tipo di impostazione dell'API Policy | Mutate supportato in v1beta1 | Didascalia della Console di amministrazione | Nome campo API della policy | Tipo di dati |
| Impostazioni universali | Accesso ai dati > Sincronizzazione Android | devices.android_work_data_sync
|
No | Consenti la sincronizzazione dei dati di lavoro sui dispositivi Android | consentita | boolean |
| Sicurezza > Crittografia | devices.encryption
|
No | Richiedi crittografia dispositivo | device_encryption_option | enum:
|
|
| Sicurezza > Dispositivi compromessi | devices.compromised_devices
|
No | Blocca dispositivi Android compromessi | compromised_android_devices_blocked | boolean | |
| Blocca i dispositivi iOS jailbroken | jailbroken_ios_devices_blocked | boolean | ||||
| Sicurezza > Approvazioni dei dispositivi | devices.activation_approval
|
No | Richiedi approvazione amministratore | admin_approval_required | boolean | |
| Invia le email con la richiesta di approvazione a | approver_email_address | string | ||||
| Impostazioni di Android | App e condivisione dei dati > Condivisione con altri profili | devices.android_work_profile_sharing
|
No | Consenti la condivisione di contenuti dal profilo di lavoro allo spazio personale (solo per dispositivi con profili di lavoro) | consentita | boolean |
| App e condivisione dati > Copia tra profili | devices.android_cross_profile_copy_paste
|
No | Consenti di incollare dati tra il profilo di lavoro e lo spazio personale (solo dispositivo con profilo di lavoro) | abilitato | boolean | |
| App e condivisione dei dati > App private di Google Play | devices.android_google_play_private_apps
|
No | Consenti agli utenti di accedere alle app private di Google Play | access_allowed | boolean | |
| Consenti agli utenti di pubblicare e aggiornare app private di Google Play | publish_and_update_allowed | boolean | ||||
| App e condivisione dei dati > Acquisizione schermo | devices.android_screen_capture
|
No | Consenti acquisizione schermo | consentita | boolean | |
| App e condivisione dei dati > Android Beam | devices.android_beam
|
No | Consenti Beam in uscita | outgoing_beam_allowed | boolean | |
| App e condivisione dei dati > Condivisione della posizione |
devices.android_location_sharing
|
No | Consenti la condivisione della posizione. | consentita | boolean | |
| App e condivisione dei dati > App disponibili | devices.android_available_apps
|
No | Imposta le app che gli utenti possono installare dal Play Store | playstore_installable_apps | enum:
|
|
| App e condivisione dei dati > Verifica app | devices.android_verify_apps
|
No | Consenti agli utenti di disattivare Google Play Protect (solo per dispositivi di proprietà dell'azienda) | turnoff_google_play_protect_allowed | boolean | |
| App e condivisione dei dati > Opzioni sviluppatore | devices.android_developer_options
|
No | Consenti opzioni sviluppatore | consentita | boolean | |
| Funzionalità della schermata di blocco > Autenticazione periodica con PIN, password o sequenza | devices.android_periodic_secure_authentication
|
No | Richiedi agli utenti che usano lo Sblocco con il Volto o l'Impronta di autenticarsi periodicamente con metodi più sicuri come PIN, password o sequenza | di provisioning. | boolean | |
| Dopo il periodo di tempo impostato di seguito, gli utenti devono utilizzare un'autenticazione più sicura al prossimo sblocco del dispositivo | expiration_period | enum:
|
||||
| App e condivisione dei dati > Origini sconosciute |
devices.android_unknown_source_apps
|
No | Impedisci agli utenti di installare app da origini sconosciute nel loro profilo di lavoro. | work_profile_installation_allowed | boolean | |
| Impedisci agli utenti di installare app da origini sconosciute nel loro profilo personale. | personal_profile_installation_allowed | boolean | ||||
| App e condivisione dei dati > Impostazioni app |
devices.android_apps_settings
|
No | Consenti agli utenti di modificare le impostazioni di app (solo per dispositivi di proprietà dell'azienda). | modification_allowed | boolean | |
| App e condivisione dei dati > Funzionalità della schermata di blocco |
devices.android_trust_agents
|
No | Consenti Smart Lock per mantenere sbloccato un dispositivo. | smart_lock_allowed | boolean | |
| App e condivisione dei dati > Funzionalità della schermata di blocco |
devices.android_lock_screen_notifications
|
No | Consenti notifiche sulla schermata di blocco. | consentita | boolean | |
| App e condivisione dei dati > Funzionalità della schermata di blocco |
devices.android_lock_screen_notification_details
|
No | Consenti dettagli notifiche. | consentita | boolean | |
| Impostazioni iOS | Sicurezza avanzata > Apple Watch | devices.ios_apple_watch
|
No | Consenti l'utilizzo di Apple Watch senza rilevamento del polso | no_wrist_detection_usage_allowed | boolean |
| Sicurezza avanzata > Siri | devices.ios_siri
|
No | Consenti Siri | consentita | boolean | |
| Consenti Siri sulla schermata di blocco | allowed_on_lock_screen | boolean | ||||
| Sicurezza avanzata > Handoff | devices.ios_handoff
|
No | Consenti Handoff (solo dispositivi supervisionati e registrati) | consentita | boolean | |
| Condivisione dei dati > Spazio di archiviazione iCloud |
devices.ios_icloud_storage
|
No | Consenti alle app gestite di archiviare dati in iCloud | managed_apps_sync_allowed | boolean | |
| Sicurezza avanzata > Acquisizione schermo |
devices.ios_screen_capture
|
No | Consenti screenshot e registrazione dello schermo | consentita | boolean | |
| Backup e sincronizzazione su iCloud > Backup su iCloud | devices.ios_icloud_backup
|
No | Consenti all'utente di eseguire il backup del dispositivo con iCloud (solo dispositivi supervisionati) | consentita | boolean | |
| Backup e sincronizzazione su iCloud > Backup crittografato | devices.ios_backup_encryption
|
No | Richiedi crittografia per i backup | di provisioning. | boolean | |
| Schermata di blocco > Centro di controllo | devices.ios_lock_screen_control_center
|
No | Consenti il Centro di controllo sulla schermata di blocco | consentita | boolean | |
| App e servizi > App File | devices.ios_files_app
|
No | Consenti agli utenti di connettersi a unità USB nell'app File (iOS 13.1 e versioni successive, solo dispositivi supervisionati) | usb_drives_connection_allowed | boolean | |
| Consenti agli utenti di connettersi a unità di rete nell'app File (iOS 13.1 e versioni successive, solo dispositivi supervisionati) | network_drives_connection_allowed | boolean | ||||
| Funzionalità del dispositivo > Data e ora | devices.ios_date_time
|
No | Forza data e ora automatiche (iOS 12 e versioni successive, solo dispositivi supervisionati) | automatic_date_time_enforced | boolean | |
| Schermata di blocco > Visualizzazione notifiche | devices.ios_lock_screen_notifications_view
|
No | Consenti visualizzazione Notifiche sulla schermata di blocco | consentita | boolean | |
| Condivisione dei dati > Azioni sui dati | devices.ios_data_actions
|
No | Seleziona le azioni che gli utenti possono eseguire con i dati di Google Workspace idonei sui dispositivi iOS | external_data_sharing_allowed | boolean | |
| Consenti di copiare e incollare i dati di lavoro negli account e nelle app personali | work_data_operation_type.non_workspace_apps_copy_paste_allowed | boolean | ||||
| Consenti l'invio di dati di lavoro alle app personali, comprese le app che non fanno parte di Google Workspace, sul foglio di condivisione di iOS | work_data_operation_type.non_workspace_apps_sharing_allowed | boolean | ||||
| Consenti la condivisione dei dati di lavoro su account personali o su Mail per iOS con il foglio di condivisione di iOS | work_data_operation_type.personal_accounts_sharing_allowed | boolean | ||||
| Consenti la condivisione dei dati di lavoro su AirDrop con il foglio di condivisione di iOS | work_data_operation_type.airdrop_sharing_allowed | boolean | ||||
| Consenti la stampa dei file di lavoro | work_data_operation_type.files_printing_allowed | boolean | ||||
| Consenti il salvataggio dei dati di lavoro su File con il foglio di condivisione di iOS e accedi ai dati di lavoro direttamente da File | work_data_operation_type.files_access_allowed | boolean | ||||
| Consenti di salvare immagini e video di lavoro nelle foto iOS | work_data_operation_type.images_videos_saving_allowed | boolean | ||||
| Consenti di assegnare elementi ai contatti con il foglio di condivisione di iOS | work_data_operation_type.contacts_items_assignment_allowed | boolean | ||||
| Safari > Navigazione sicura | devices.ios_safari_secure_browsing
|
No | Imponi l'avviso sui siti web fraudolenti di Safari | fraudulent_website_warning_enforced | boolean | |
| Condivisione dei dati > Apple Intelligence | devices.ios_apple_intelligence
|
No | Consenti agli utenti di utilizzare gli strumenti di scrittura di Apple Intelligence all'interno delle app di Google Workspace sui dispositivi iOS | writing_tools_allowed | boolean | |
| Backup e sincronizzazione su iCloud > Sincronizzazione portachiavi |
devices.ios_keychain_sync
|
No | Consenti agli utenti di sincronizzare i portachiavi con iCloud (solo dispositivi supervisionati). | icloud_sync_allowed | boolean | |
| Backup e sincronizzazione su iCloud > Sincronizzazione documenti |
devices.ios_document_sync
|
No | Consenti agli utenti di sincronizzare documenti e dati con iCloud. | icloud_data_sync_allowed | boolean |
Impostazioni della directory
| Pagina nella Console di amministrazione | Impostazione specifica nella Console di amministrazione | Tipo di impostazione dell'API Policy | Mutazione supportata | Didascalia della Console di amministrazione | Nome campo API della policy | Tipo di dati |
| Impostazioni directory | Impostazioni di condivisione > Condivisione esterna directory | directory.external_directory_sharing
|
No | N/A | sharing_option | enum:
|
Impostazioni di Drive e Documenti
| Pagina nella Console di amministrazione | Impostazione specifica nella Console di amministrazione | Tipo di impostazione dell'API Policy | Mutazione supportata | Didascalia della Console di amministrazione | Nome campo API della policy | Tipo di dati |
| Drive e Documenti | Impostazioni di condivisione > Opzioni di condivisione | drive_and_docs.external_sharing
|
No | Seleziona il livello di condivisione più elevato che vuoi consentire all'esterno di CUSTOMER_NAME | external_sharing_mode | enum:
|
| Consenti agli utenti di ORGANIZATION_UNIT_NAME di ricevere file da utenti o Drive condivisi all'esterno di CUSTOMER_NAME | allow_receiving_external_files | boolean | ||||
| Avvisa quando i file di proprietà degli utenti o dei Drive condivisi di ORGANIZATION_UNIT_NAME vengono condivisi con utenti dei domini inclusi nella lista consentita | warn_for_sharing_outside_allowlisted_domains | boolean | ||||
| Consenti agli utenti di ORGANIZATION_UNIT_NAME di ricevere file da utenti o Drive condivisi all'esterno dei domini inclusi nella lista consentita | allow_receiving_files_outside_allowlisted_domains | boolean | ||||
| Consenti agli utenti o ai Drive condivisi di ORGANIZATION_UNIT_NAME di condividere elementi con utenti non Google appartenenti a domini attendibili utilizzando la condivisione con i visitatori | allow_non_google_invites_in_allowlisted_domains | boolean | ||||
| Avvisa quando i file di proprietà degli utenti o dei Drive condivisi di ORGANIZATION_UNIT_NAME vengono condivisi all'esterno di CUSTOMER_NAME | warn_for_external_sharing | boolean | ||||
| Consenti agli utenti o ai Drive condivisi di ORGANIZATION_UNIT_NAME di condividere elementi con persone esterne al dominio CUSTOMER_NAME che non utilizzano un Account Google | allow_non_google_invites | boolean | ||||
| Quando la condivisione all'esterno di CUSTOMER_NAME è consentita, gli utenti di ORGANIZATION_UNIT_NAME possono rendere visibili, a chiunque abbia il link, file e contenuti web pubblicati | allow_publishing_files | boolean | ||||
| Quando un utente condivide un file mediante un prodotto Google diverso da Documenti o Drive (ad esempio, quando copia e incolla un link in Gmail), Google può verificare se i destinatari possono accedere all'elemento condiviso. Se non possono accedere, Google chiede all'utente, se possibile, di scegliere con chi vuole condividere il file: | access_checker_suggestions | enum:
|
||||
| Seleziona chi deve essere autorizzato a distribuire contenuti in ORGANIZATION_UNIT_NAME al di fuori di CUSTOMER_NAME. Questa impostazione impone delle limitazioni su chi può caricare o spostare contenuti nei Drive condivisi di proprietà di un'altra organizzazione | allowed_parties_for_distributing_content | enum:
|
||||
| Impostazioni di condivisione > Accesso generale predefinito | drive_and_docs.general_access_default
|
No | Seleziona quale sarà l'accesso predefinito agli elementi che vengono creati dagli utenti di ORGANIZATION_UNIT_NAME | default_file_access | enum:
|
|
| Impostazioni di condivisione > Creazione di Drive condivisi | drive_and_docs.shared_drive_creation
|
No | Impedisci agli utenti di ORGANIZATION_UNIT_NAME di creare nuovi Drive condivisi | allow_shared_drive_creation | boolean (la risposta dell'API restituisce l'opposto del valore della UI) | |
| Quando gli utenti di ORGANIZATION_UNIT_NAME creano un Drive condiviso, questo verrà assegnato alla seguente unità organizzativa | org_unit_for_new_shared_drives | enum:
|
||||
| Unità organizzativa selezionata | custom_org_unit | string | ||||
| Consenti ai membri con accesso Gestore di ignorare le impostazioni che seguono | allow_managers_to_override_settings | boolean | ||||
| Consenti agli utenti esterni a CUSTOMER_NAME di accedere ai file nei Drive condivisi | allow_external_user_access | boolean | ||||
| Consenti alle persone che non sono membri del Drive condiviso di essere aggiunti ai file | allow_non_member_access | boolean | ||||
| Il download, la stampa e la copia sono abilitati per | allowed_parties_for_download_print_copy | enum:
|
||||
| Consenti ai gestori dei contenuti di condividere le cartelle | allow_content_managers_to_share_folders | boolean | ||||
| Impostazioni di condivisione > Aggiornamento della sicurezza per i file | drive_and_docs.file_security_update
|
No | L'applicazione di questo aggiornamento renderà più sicuri i link ai file. Per effetto di questa impostazione è possibile che gli utenti ricevano richieste di accesso ai file | security_update | enum:
|
|
| Consenti agli utenti di rimuovere o applicare l'aggiornamento della sicurezza per i file che possiedono o gestiscono | allow_users_to_manage_update | boolean | ||||
| Funzionalità e applicazioni > SDK di Drive | drive_and_docs.drive_sdk
|
No | Consenti agli utenti di accedere a Google Drive con l'API SDK Drive | enable_drive_sdk_api_access | boolean | |
| Google Drive per computer > Attiva Drive per computer | drive_and_docs.drive_for_desktop
|
No | Consenti Google Drive per computer nella tua organizzazione | allow_drive_for_desktop | boolean | |
| Consenti Google Drive per computer solo sui dispositivi autorizzati | restrict_to_authorized_devices | boolean | ||||
| Mostra il link di download di Google Drive per computer | show_download_link | boolean | ||||
| Consenti agli utenti di attivare la presenza in tempo reale in Microsoft Office da Google Drive per computer | allow_real_time_presence | boolean | ||||
| Impostazioni di condivisione > Evidenzia i file esterni | drive_and_docs.external_file_warning
|
No | Contrassegna come "esterni" i file condivisi o di proprietà esterna per indicare che i contenuti potrebbero essere visualizzabili al di fuori della tua organizzazione. Si applica a Drive, Documenti, Fogli, Slides, Disegni e Vids. | highlighting_enabled | boolean |
Impostazioni dell'app Gemini
| Pagina nella Console di amministrazione | Impostazione specifica nella Console di amministrazione | Tipo di impostazione dell'API Policy | Mutazione supportata | Didascalia della Console di amministrazione | Nome campo API della policy | Tipo di dati |
| App Gemini | Accesso utente | gemini_app.unlicensed_user_access
|
No | Consenti a tutti gli utenti di accedere all'app Gemini, indipendentemente dalla licenza | abilitato | boolean |
Impostazioni di Gemini in Workspace
| Pagina nella Console di amministrazione | Impostazione specifica nella Console di amministrazione | Tipo di impostazione dell'API Policy | Mutazione supportata | Didascalia della Console di amministrazione | Nome campo API della policy | Tipo di dati |
| Gemini in Workspace | Funzionalità beta di Gemini > Funzionalità beta | gemini_for_workspace.beta_features
|
No | Attiva l'accesso alle funzionalità beta in Gemini in Google Workspace | abilitato | boolean |
| Consenti a Google di invitare gli utenti dell'unità organizzativa o del gruppo selezionato a partecipare a sondaggi e studi del feedback sull'esperienza utente per migliorare Gemini in Google Workspace | feedback_and_testing_enabled | boolean |
Impostazioni di Gmail
| Pagina nella Console di amministrazione | Impostazione specifica nella Console di amministrazione | Tipo di impostazione dell'API Policy | Mutazione supportata | Didascalia della Console di amministrazione | Nome campo API della policy | Tipo di dati |
| Gmail | Impostazioni utente > Modalità riservata | gmail.confidential_mode
|
No | Attiva la modalità riservata | enable_confidential_mode | boolean |
| Impostazioni utente > S/MIME | gmail.smime_encryption
|
No | Attiva crittografia S/MIME per l'invio e la ricezione di email | enable_smime_encryption | enum:
|
|
| Consenti SHA-1 a livello globale (sconsigliato) | allow_sha1_globally_in_smime_signature | boolean | ||||
gmail.enhanced_smime_encryption
|
No | Consenti agli utenti di caricare i propri certificati | allow_user_to_upload_certificates | boolean | ||
| Accetta questi certificati radice per domini specifici: | custom_root_certificates | Un elenco di CustomRootCertificates che contiene un elenco di certificati radice, un elenco di certificati CA intermedi, un elenco di nomi di dominio con limitazioni, un valore booleano per consentire la mancata corrispondenza degli indirizzi e un enum con diversi livelli di convalida. | ||||
| Spam, phishing e malware > Analisi messaggio pre-consegna avanzata | gmail.enhanced_pre_delivery_message_scanning
|
No | Consente una migliore individuazione di contenuti sospetti prima della consegna | enable_improved_suspicious_content_detection | boolean | |
| Spam, phishing e malware > Lista consentita email | gmail.email_spam_filter_ip_allowlist
|
No | Inserisci gli indirizzi IP per la tua lista consentita email | allowed_ip_addresses | Un elenco di stringhe | |
| Sicurezza > Spoofing e autenticazione | gmail.spoofing_and_authentication
|
No | Protezione dallo spoofing del dominio basato su nomi di dominio simili | detect_domain_name_spoofing | boolean | |
| Scegli un'azione | domain_name_spoofing_consequence | enum:
|
||||
| Scegli una quarantena | domain_name_spoofing_quarantine_id | integer | ||||
| Proteggiti dallo spoofing dei nomi dei dipendenti | detect_employee_name_spoofing | boolean | ||||
| Scegli un'azione | employee_name_spoofing_consequence | enum:
|
||||
| Scegli una quarantena | employee_name_spoofing_quarantine_id | integer | ||||
| Proteggiti dalle email in entrata che eseguono lo spoofing del tuo dominio | detect_domain_spoofing_from_unauthenticated_senders | boolean | ||||
| Scegli un'azione | domain_spoofing_consequence | enum:
|
||||
| Scegli una quarantena | domain_spoofing_quarantine_id | integer | ||||
| Proteggiti dalle email non autenticate | detect_unauthenticated_emails | boolean | ||||
| Scegli un'azione | unauthenticated_email_consequence | enum:
|
||||
| Scegli una quarantena | unauthenticated_email_quarantine_id | integer | ||||
| Proteggi i tuoi gruppi dalle email in entrata che eseguono lo spoofing del tuo dominio | detect_groups_spoofing | boolean | ||||
| Applica questa impostazione a | groups_spoofing_visibility_type | enum:
|
||||
| Scegli un'azione | groups_spoofing_consequence | enum:
|
||||
| Scegli una quarantena | groups_spoofing_quarantine_id | integer | ||||
| Applica automaticamente le future impostazioni consigliate | apply_future_settings_automatically | boolean | ||||
| Sicurezza > Link e immagini esterne | gmail.links_and_external_images
|
No | Identifica i link nascosti dietro URL abbreviati | enable_shortener_scanning | boolean | |
| Esegui la scansione di immagini con link | enable_external_image_scanning | boolean | ||||
| Mostra un avviso per tutti i clic su link a domini non attendibili | enable_aggressive_warnings_on_untrusted_links | boolean | ||||
| Applica automaticamente le future impostazioni consigliate | apply_future_settings_automatically | boolean | ||||
| Sicurezza > Allegati | gmail.email_attachment_safety
|
No | Protezione dagli allegati criptati provenienti da mittenti non attendibili | enable_encrypted_attachment_protection | boolean | |
| Scegli un'azione | encrypted_attachment_protection_consequence | enum:
|
||||
| Scegli una quarantena | encrypted_attachment_protection_quarantine_id | integer | ||||
| Protezione dagli allegati con script provenienti da mittenti non attendibili | enable_attachment_with_scripts_protection | boolean | ||||
| Scegli un'azione | attachment_with_scripts_protection_consequence | enum:
|
||||
| Scegli una quarantena | attachment_with_scripts_protection_quarantine_id | integer | ||||
| Protezione contro i tipi di allegati anomali nelle email | enable_anomalous_attachment_protection | boolean | ||||
| Scegli un'azione | anomalous_attachment_protection_consequence | enum:
|
||||
| Scegli una quarantena | anomalous_attachment_protection_quarantine_id | integer | ||||
| Aggiungi i seguenti tipi di file non comuni alla lista consentita | allowed_anomalous_attachment_filetypes | string[] | ||||
| Applica automaticamente le future impostazioni consigliate | apply_future_recommended_settings_automatically | boolean | ||||
| Routing > Gestisci elenchi indirizzi | gmail.email_address_lists
|
No | Gestisci gli elenchi di indirizzi | email_address_list | EmailAddressList[] | |
| Spam, phishing e malware > Mittenti bloccati | gmail.blocked_sender_lists
|
No | Blocca o approva mittenti specifici in base all'indirizzo email o al dominio | blocked_senders | BlockedSender[] | |
| Spam, phishing e malware > Spam | gmail.spam_override_lists
|
No | Crea elenchi di mittenti approvati che ignorano la cartella Spam. | spam_override | SpamOverride[] | |
| Conformità > Conformità dei contenuti | gmail.content_compliance
|
No | Configura filtri dei contenuti avanzati in base a parole, frasi o pattern | content_compliance_rules | ContentComplianceRule[] | |
| Conformità > Limita il recapito della posta | gmail.restrict_delivery
|
No | Limita i domini con cui gli utenti sono autorizzati a scambiare email. | restrict_delivery_rules | RestrictDeliveryRule[] | |
| Conformità > Contenuti discutibili | gmail.objectionable_content
|
No | Configura i filtri dei contenuti in base agli elenchi di parole | objectionable_content_rules | ObjectionableContentRule[] | |
| Conformità > Conformità degli allegati | gmail.attachment_compliance
|
No | Configura i filtri degli allegati in base al tipo di file, al nome del file e alle dimensioni del messaggio | attachment_compliance_rules | AttachmentComplianceRule[] | |
| Conformità > Archiviazione completa della posta | gmail.comprehensive_mail_storage
|
No | Assicurati che una copia di tutti i messaggi inviati e ricevuti venga archiviata nelle caselle di posta degli utenti associati | rule_id | string | |
| N/A (For all rules) | gmail.rule_states
|
No | N/A | rule_states | RuleState[] | |
| Gestisci le quarantene | gmail.email_quarantines
|
No | Aggiungi quarantena | email_quarantines | EmailQuarantine[] | |
| Configurazione > Caricamenti email degli utenti | gmail.user_email_uploads
|
No | Mostra agli utenti l'opzione per importare la posta e i contatti da Yahoo!, Hotmail, AOL o altri account webmail o POP3 dalla pagina delle impostazioni di Gmail | enable_mail_and_contacts_import | boolean | |
| Accesso utente finale > Accesso POP e IMAP | gmail.pop_access
|
No | Attiva l'accesso POP per tutti gli utenti | enable_pop_access | boolean | |
gmail.imap_access
|
No | Attiva l'accesso IMAP per tutti gli utenti | enable_imap_access | boolean | ||
| Consenti qualsiasi client di posta | imap_access_restriction.allow_all_mail_clients | boolean | ||||
| Limita i client di posta utilizzabili dagli utenti (solo client di posta OAuth) | imap_access_restriction.allowed_oauth_mail_client_list | OAuthMailClientList | ||||
| Accesso utente finale > Google Workspace Sync | gmail.workspace_sync_for_outlook
|
No | Attiva Google Workspace Sync per Microsoft Outlook per i miei utenti | enable_google_workspace_sync_for_microsoft_outlook | boolean | |
| Accesso utente finale > Inoltro automatico | gmail.auto_forwarding
|
No | Consenti agli utenti di inoltrare automaticamente le email in arrivo a un altro indirizzo | enable_auto_forwarding | boolean | |
| Destinazione di inoltro consentita | allowed_forwarding_destination | enum:
|
||||
| Impostazioni utente > Formato nome | gmail.name_format
|
No | Consenti agli utenti di personalizzare questa impostazione | allow_custom_display_names | boolean | |
| Nome Cognome o Cognome, Nome | default_display_name_format | enum:
|
||||
| Accesso utente finale > Consenti l'utilizzo di gateway in uscita per utente | gmail.per_user_outbound_gateway
|
No | Consenti agli utenti di inviare posta tramite un server SMTP esterno quando configurano un indirizzo "da" ospitato al di fuori del tuo dominio email | allow_users_to_use_external_smtp_servers | boolean | |
| Accesso utente finale > Avvisa per destinatari esterni | gmail.external_recipient_warning
|
No | Evidenziare eventuali destinatari esterni in una conversazione. Avvisa gli utenti prima che rispondano a un'email con destinatari esterni che non sono presenti nei loro contatti. | abilitato | boolean | |
| Accesso utente finale > Lista consentita proxy URL immagini | gmail.email_image_proxy_bypass
|
No | Inserisci i pattern URL immagine. Gli URL corrispondenti ignorano il proxy per le immagini. | image_proxy_bypass_pattern | string[] | |
| N/A | enable_image_proxy | boolean | ||||
| Impostazioni utente > Delega posta | gmail.mail_delegation
|
No | Consenti agli utenti di delegare l'accesso alle proprie caselle di posta ad altri utenti del dominio | enable_mail_delegation | boolean | |
| Consenti agli utenti di personalizzare questa impostazione | allow_custom_delegate_attribution | boolean | ||||
| Mostra il proprietario dell'account e il delegato che ha inviato l'email | enable_delegate_attribution | boolean | ||||
| Mostra solo il proprietario dell'account | ||||||
| Consenti agli utenti di concedere l'accesso alle caselle di posta a un gruppo Google | enable_mailbox_group_delegation | boolean | ||||
| Impostazioni utente > Gmail web offline | gmail.web_offline
|
No | Attiva Gmail web offline | abilitato | boolean | |
| Forza l'eliminazione dei dati offline quando l'utente esce dall'Account Google | signout_data_deletion_enforced | boolean |
Impostazioni secondarie di Gmail
Questa tabella fornisce le impostazioni secondarie di Gmail a cui fanno riferimento altre impostazioni di Gmail.
| Nome della sottoimpostazione dell'API Policy | Didascalia della Console di amministrazione | Nome campo API della policy | Tipo di dati | |
| EmailAddressList | N/A | id | string | |
| Nome | nome | string | ||
| AGGIUNGI ELENCO DI INDIRIZZI | address_list | AddressList | ||
| AGGIUNGI LISTA BLOCCATA | blocked_address_list | AddressList | ||
| AddressList | Aggiungi elenco di indirizzi | indirizzo | AddressListEntry[] | |
| AddressListEntry | Indirizzo | indirizzo | string | |
| Autenticazione richiesta (solo posta ricevuta) | require_address_verification | boolean | ||
| BlockedSender | Inserisci una breve descrizione che verrà visualizzata nel riepilogo delle impostazioni. | descrizione | string | |
| Aggiungi indirizzi o domini dai quali vuoi rifiutare automaticamente i messaggi | sender_blocklist | StringValue[] | ||
| Inserisci una notifica di rifiuto personalizzata | rejection_response | string | ||
| Ignora questa impostazione per i messaggi ricevuti da indirizzi o domini inclusi in questi elenchi di mittenti approvati. | bypass_approved_sender | boolean | ||
| N/A | bypass_approved_sender_allowlist | StringValue[] | ||
| N/A | rule_id | string | ||
| SpamOverride | Inserisci una breve descrizione che verrà visualizzata nel riepilogo delle impostazioni. | descrizione | string | |
| Filtra lo spam in modo più aggressivo. | enable_aggressive_filtering | boolean | ||
| Metti spam in quarantena amministrativa | add_to_quarantine | boolean | ||
| N/A | quarantine_id | integer | ||
| Aggira i filtri antispam per i mittenti interni. | bypass_internal_senders | boolean | ||
| Aggira i filtri antispam per i messaggi inviati da mittenti o domini presenti negli elenchi selezionati. | bypass_selected_senders | boolean | ||
| N/A | bypass_sender_allowlist | StringValue[] | ||
| Aggira i filtri antispam e nascondi gli avvisi per i messaggi inviati da mittenti o domini presenti negli elenchi selezionati. | hide_warning_banner_from_selected_senders | boolean | ||
| N/A | hide_warning_banner_sender_allowlist | StringValue[] | ||
| Ignora i filtri antispam e nascondi gli avvisi per tutti i messaggi da mittenti interni ed esterni (opzione non consigliata). | hide_warning_banner_for_all | boolean | ||
| N/A | rule_id | string | ||
| ContentComplianceRule | Inserisci una breve descrizione che verrà visualizzata nel riepilogo delle impostazioni. | descrizione | string | |
| Messaggi email interessati | condizione | RuleConditions | ||
| Aggiungi le espressioni che descrivono i contenuti da cercare in ciascun messaggio | match_expressions | MatchExpression[] | ||
| Se UNO degli elementi che seguono corrisponde al messaggio | match_any_expression | boolean | ||
| Se le espressioni precedenti corrispondono, esegui le seguenti operazioni | conseguenza | RuleConsequences | ||
| N/A | rule_id | string | ||
| RestrictDeliveryRule | Obbligatorio: inserisci una breve descrizione che verrà visualizzata nel riepilogo delle impostazioni | descrizione | string | |
| Aggiungi indirizzi o domini da consentire | allowed_addresses | StringValue[] | ||
| Tutti i messaggi indirizzati ad altri indirizzi e domini, o da essi provenienti, saranno respinti. Modifica l'avviso di rifiuto predefinito per questi messaggi. | rejection_notice_message | string | ||
| Ignora questa impostazione per i messaggi interni | internal_messages_rule_bypass_allowed | boolean | ||
| N/A | rule_id | string | ||
| ObjectionableContentRule | Inserisci una breve descrizione che verrà visualizzata nel riepilogo delle impostazioni. | descrizione | string | |
| Messaggi email interessati | condizione | RuleConditions | ||
| Parole discutibili personalizzate | objectionable_content_defined | boolean | ||
| Inserisci le parole | objectionable_words | string[] | ||
| Se le espressioni precedenti corrispondono, esegui le seguenti operazioni | conseguenza | RuleConsequences | ||
| N/A | rule_id | string | ||
| AttachmentComplianceRule | Inserisci una breve descrizione che verrà visualizzata nel riepilogo delle impostazioni. | descrizione | string | |
| Messaggi email interessati | condizione | RuleConditions | ||
| Aggiungi le espressioni che descrivono i contenuti da cercare in ciascun messaggio | match_expressions | MatchExpression[] | ||
| Se UNO degli elementi che seguono corrisponde al messaggio | match_any_expression | boolean | ||
| Se le espressioni precedenti corrispondono, esegui le seguenti operazioni | conseguenza | RuleConsequences | ||
| N/A | rule_id | string | ||
| RuleState | N/A (For all rules) | abilitato | boolean | |
| rule_id | string | |||
| RuleConditions | Messaggi email interessati | Messaggi in entrata | affect_inbound_messages | boolean |
| Messaggi in uscita | affect_outbound_messages | boolean | ||
| Messaggi in uscita interni | affect_internal_sending_messages | boolean | ||
| Messaggi in entrata interni | affect_internal_receiving_messages | boolean | ||
| Elenchi di indirizzi | Utilizza gli elenchi di indirizzi per ignorare o controllare l'applicazione di questa impostazione | address_list_option | enum:
|
|
| Ignora questa impostazione per indirizzi/domini specifici | ||||
| Applica questa impostazione solo per indirizzi/domini specifici | ||||
| Utilizza elenco esistente/Crea o modifica elenco | address_lists | StringValue[] | ||
| Tipi di account interessati | Utenti | account_type_user | boolean | |
| Gruppi | account_type_group | boolean | ||
| Non riconosciuti/Catch-all | account_type_unrecognized | boolean | ||
| Filtro busta | Viene applicato solo a mittenti della busta specifici | envelope_sender_filter | AddressMatcher | |
| Viene applicato solo a destinatari della busta specifici | envelope_recipient_filter | AddressMatcher | ||
| AddressMatcher | Viene applicato solo a mittenti della busta specifici/Viene applicato solo a destinatari della busta specifici | abilitato | boolean | |
| Indirizzo email singolo | N/A | address_match_type | enum: EXACT
|
|
| Indirizzo email | exact_address_match_value | string | ||
| Corrispondenza pattern | N/A | address_match_type | enum: REGEXP
|
|
| Regexp | regexp_match_value | string | ||
| Iscrizione al gruppo (solo posta inviata) / Iscrizione al gruppo (solo posta ricevuta) | N/A | address_match_type | enum: GROUP_MEMBERSHIP
|
|
| Seleziona gruppi | group_ids | string[] | ||
| MatchExpression | Corrispondenza di contenuti semplice | N/A | match_expression_type | enum: SIMPLE_CONTENT
|
| Contenuti | match_content | string | ||
| Corrispondenza di contenuti avanzata | N/A | match_expression_type | enum: ADVANCED_CONTENT
|
|
| Contenuto/Regex | match_content | string | ||
| N/A | advanced_content_match | AdvancedContentMatch | ||
| Corrispondenza metadati | match_expression_type | enum: METADATA
|
||
| metadata_match | MetadataMatch | |||
| Corrispondenza dei contenuti predefinita | match_expression_type | enum: PREDEFINED_CONTENT
|
||
| predefined_content_match | PredefinedContentMatch | |||
| Tipo di file | match_expression_type | enum: FILE_TYPE
|
||
| file_type_match | FileTypeMatch | |||
| Nome file | N/A | match_expression_type | enum: FILE_NAME
|
|
| Il nome del file allegato contiene | file_name | string | ||
| Dimensioni dei messaggi | N/A | match_expression_type | enum: MESSAGE_SIZE
|
|
| Il messaggio complessivo (corpo + allegato) è superiore alle seguenti (MB) | message_size_threshold_in_megabytes | integer | ||
| AdvancedContentMatch | Località | Intestazioni + Corpo | advanced_content_match_location | enum: HEADERS_AND_BODY
|
| Intestazioni complete | enum: FULL_HEADERS
|
|||
| Body | enum: BODY
|
|||
| Oggetto | enum: SUBJECT
|
|||
| Intestazione mittente | enum: SENDER_HEADER
|
|||
| Intestazione dei destinatari | enum: RECIPIENTS_HEADER
|
|||
| Mittente della busta | enum: ENVELOPE_SENDER
|
|||
| Qualsiasi destinatario sulla busta | enum: ANY_ENVELOPE_RECIPIENT
|
|||
| Messaggio non elaborato | enum: RAW_MESSAGE
|
|||
| Tipo di corrispondenza | Inizia con | advanced_content_match_type | enum: STARTS_WITH
|
|
| Termina con | enum: ENDS_WITH
|
|||
| Contiene testo | enum: CONTAINS_TEXT
|
|||
| Non contiene testo | enum: NOT_CONTAINS_TEXT
|
|||
| È uguale a | enum: <code< code="" dir="ltr" translate="no">EQUALS </code<> | |||
| È vuoto | enum: IS_EMPTY
|
|||
| Corrisponde a regex | enum: MATCHES_REGEXP
|
|||
| Non corrisponde a espressione regolare | enum: NOT_MATCHES_REGEXP
|
|||
| Corrispondenza con qualsiasi parola | enum: MATCH_ANY_WORD
|
|||
| Corrisponde a tutte le parole | enum: MATCH_ALL_WORDS
|
|||
| N/A | regexp_match | RegexpMatch | ||
| RegexpMatch | Descrizione regex | descrizione | string | |
| Numero di corrispondenze minimo | min_match_count | integer | ||
| MetadataMatch | Attributo | Autenticazione dei messaggi | metadata_match_attribute | enum: MESSAGE_AUTHENTICATION
|
| IP di origine | enum: SOURCE_IP
|
|||
| Trasporto sicuro (TLS) | enum: TLS
|
|||
| Dimensioni dei messaggi | enum: MESSAGE_SIZE
|
|||
| Crittografia S/MIME | enum: SMIME_ENCRYPTED
|
|||
| Con firma S/MIME | enum: SMIME_SIGNED
|
|||
| Modalità riservata di Gmail | enum: CONFIDENTIAL_MODE
|
|||
| Spam | enum: SPAM
|
|||
| Tipo di corrispondenza | il seguente intervallo | source_ip_range | string | |
| alle seguenti (MB) | message_size_in_megabytes | integer | ||
| Messaggio autenticato | metadata_match_type | enum: MESSAGE_AUTHENTICATED
|
||
| Messaggio non autenticato | enum: MESSAGE_NOT_AUTHENTICATED
|
|||
| L'IP di origine è compreso in | enum: SOURCE_IP_IN_RANGE
|
|||
| L'IP di origine non è compreso in | enum: SOURCE_IP_NOT_IN_RANGE
|
|||
| La connessione è crittografata con TLS | enum: TLS_ENCRYPTED
|
|||
| La connessione non è criptata con TLS | enum: TLS_NOT_ENCRYPTED
|
|||
| La dimensione del messaggio è maggiore di | enum: MESSAGE_SIZE_GREATER_THAN
|
|||
| La dimensione del messaggio è inferiore a | enum: MESSAGE_SIZE_LESS_THAN
|
|||
| Messaggio criptato con S/MIME | enum: MESSAGE_IS_SMIME_ENCRYPTED
|
|||
| Messaggio non criptato con S/MIME | enum: MESSAGE_IS_NOT_SMIME_ENCRYPTED
|
|||
| Messaggio firmato con S/MIME | enum: MESSAGE_IS_SMIME_SIGNED
|
|||
| Messaggio non firmato con S/MIME | enum: MESSAGE_IS_NOT_SMIME_SIGNED
|
|||
| Messaggio in modalità riservata di Gmail | enum: MESSAGE_IS_IN_CONFIDENTIAL_MODE
|
|||
| Messaggio non in modalità riservata di Gmail | enum: MESSAGE_IS_NOT_IN_CONFIDENTIAL_MODE
|
|||
| Malware rilevato dalla sandbox per la sicurezza | enum: MALWARE_DETECTED_FROM_SECURITY_SANDBOX
|
|||
| PredefinedContentMatch | N/A (Predefined content match selector) | predefined_content_match_name | string | |
| Numero di corrispondenze minimo | min_match_count | integer | ||
| Soglia di confidenza | confidence_threshold | enum:
|
||
| FileTypeMatch | Documenti di Office criptati | encrypted_office_documents | boolean | |
| Documenti di Office non criptati | unencrypted_office_documents | boolean | ||
| Video e multimediale | video | boolean | ||
| Musica e audio | musica | boolean | ||
| Immagini | immagine | boolean | ||
| File e archivi compressi criptati | compressed_encrypted_files | boolean | ||
| File e archivi compressi non criptati | compressed_unencrypted_files | boolean | ||
| Tipi di file personalizzati: trova i file in base all'estensione del nome file | custom_file_extensions | string[] | ||
| Abbina i file anche in base al formato file | match_file_format | boolean | ||
| RuleConsequences | Modifica messaggio | N/A | rule_consequence_type | enum: MODIFY_MESSAGE
|
| N/A | primary_delivery | Pubblicazione | ||
| Aggiungi altri destinatari | deliver_to_additional_recipients | boolean | ||
| Destinatari | bcc_deliveries | Pubblicazione[] | ||
| Pubblicazione | Aggiungi l'intestazione X-Gm-Original-To | add_x_gm_original_to_header | boolean | |
| Aggiungi intestazioni X-Gm-Spam e X-Gm-Phishy | add_x_gm_spam_header | boolean | ||
| Aggiungi intestazioni personalizzate | add_custom_headers | boolean | ||
| Intestazioni personalizzate | custom_headers | string[] | ||
| Anteponi oggetto personalizzato | prepend_custom_subject | boolean | ||
| Inserisci un nuovo prefisso oggetto | custom_subject | string | ||
| Cambia percorso | change_default_route | boolean | ||
| Reindirizza anche lo spam | reroute_spam | boolean | ||
| Ignora i messaggi rispediti al mittente da questo destinatario | suppress_bounces_from_recipient | boolean | ||
| N/A (Routing selector) | normal_routing | boolean | ||
| Cambia il destinatario della busta N/A | change_envelope_recipient | boolean | ||
| Sostituisci destinatario | replace_envelope_recipient_type | enum: REPLACE_ADDRESS
|
||
| recipient_address | string | |||
| Sostituisci il nome utente | replace_envelope_recipient_type | enum: REPLACE_USER
|
||
| recipient_user | string | |||
| Sostituisci dominio | replace_envelope_recipient_type | enum: REPLACE_DOMAIN
|
||
| recipient_domain | string | |||
| Ignora il filtro anti spam per questo messaggio | bypass_spam_filter | boolean | ||
| Rimuovi gli allegati dai messaggi | remove_attachments | boolean | ||
| Aggiungi questo testo per informare i destinatari che gli allegati sono stati rimossi | attachment_removal_notice | string | ||
| Richiedi trasporto sicuro (TLS) | require_tls | boolean | ||
| Cripta il messaggio se non è criptato (S/MIME) | encrypt_outgoing_messages | boolean | ||
| Avviso di mancato recapito del messaggio se non è possibile firmarlo e criptarlo | bounce_unencrypted_messages | boolean | ||
| Non recapitare spam a questo destinatario | do_not_deliver_spam_to_recipient | boolean | ||
| OAuthMailClientList | Limita i client di posta utilizzabili dagli utenti (solo client di posta OAuth) | oauth_mail_client | OAuthMailClient[] | |
| OAuthMailClient | N/A | oauth_mail_client_id | string | |
| EmailQuarantine | N/A | quarantine_id | integer | |
| Nome | nome | string | ||
| Descrizione | descrizione | string | ||
| Effetto rifiuto in entrata | inbound_denial_consequence | enum:
|
||
| Effetto rifiuto in uscita | outbound_denial_consequence | enum:
|
||
| Invia periodicamente notifiche quando i messaggi vengono messi in quarantena | send_notifications | boolean | ||
| Gruppo per revisioni quarantene | quarantine_acl_group_ids | string[] | ||
Impostazioni di Groups for Business
| Pagina nella Console di amministrazione | Impostazione specifica nella Console di amministrazione | Tipo di impostazione dell'API Policy | Mutazione supportata | Didascalia della Console di amministrazione | Nome campo API della policy | Tipo di dati |
| Groups for Business | Impostazioni di condivisione > Opzioni di condivisione | groups_for_business.groups_sharing
|
No | Imposta i criteri per la modifica delle impostazioni di condivisione dei gruppi | collaborationCapability | enum:
|
| Crea gruppi | createGroupsAccessLevel | enum:
|
||||
| I proprietari di gruppi possono autorizzare i membri esterni | ownersCanAllowExternalMembers | boolean | ||||
| I proprietari di gruppi possono consentire la ricezione di posta in arrivo dall'esterno dell'organizzazione | ownersCanAllowIncomingMailFromPublic | boolean | ||||
| Autorizzazione predefinita per visualizzare le conversazioni | viewTopicsDefaultAccessLevel | enum:
|
||||
| I proprietari di gruppi possono nasconderli dalla directory | ownersCanHideGroups | boolean | ||||
| Nascondi i gruppi creati di recente dalla directory | newGroupsAreHidden | boolean |
Aspetti legali e conformità
| Pagina nella Console di amministrazione | Impostazione specifica nella Console di amministrazione | Tipo di impostazione dell'API Policy | Mutazione supportata | Didascalia della Console di amministrazione | Nome campo API della policy | Tipo di dati |
| Impostazioni account | Opzioni di condivisione | cloud_sharing_options.cloud_data_sharing
|
No | Opzioni di condivisione della piattaforma Google Cloud | sharingOptions | enum:
|
Impostazioni Marketplace
| Pagina nella Console di amministrazione | Impostazione specifica nella Console di amministrazione | Tipo di impostazione dell'API Policy | Mutazione supportata | Didascalia della Console di amministrazione | Nome campo API della policy | Tipo di dati |
| Lista di app | Lista di app | workspace_marketplace.apps_allowlist
|
No | Visualizzazione delle app per gli utenti in tutte le unità organizzative | app | AppsAllowlistSetting[] |
| Impostazioni | Gestisci l'accesso alle app > Gestisci accesso alla lista consentita di Google Workspace Marketplace | workspace_marketplace.apps_access_options
|
No | Seleziona le app del Marketplace che gli utenti possono eseguire e installare. | access_level | enum:
|
Impostazioni secondarie di Marketplace
| Nome della sottoimpostazione dell'API Policy | Didascalia della Console di amministrazione | Nome campo API della policy | Tipo di dati |
| AppsAllowlistSetting | N/A | application_id | string |
| N/A | riga | enum:
|
L'impostazione workspace_marketplace.apps_allowlist nella risposta dell'API espone il Marketplace application_id, anziché application_name. Il seguente script Python può essere utilizzato per convertire uno o più application_id specificati nella riga di comando in 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)
Impostazioni di Meet
| Pagina nella Console di amministrazione | Impostazione specifica nella Console di amministrazione | Tipo di impostazione dell'API Policy | Mutazione supportata | Didascalia della Console di amministrazione | Nome campo API della policy | Tipo di dati |
| Google Meet | Impostazioni video per Meet > Registrazione | meet.video_recording
|
No | Consenti agli utenti di registrare le proprie riunioni. | enable_recording | boolean |
| Impostazioni video per Meet > Trascrizione automatica | meet.automatic_transcription
|
No | Le riunioni vengono trascritte per impostazione predefinita | abilitato | boolean | |
| Impostazioni video per Meet > Registrazione automatica | meet.automatic_recording
|
No | Le riunioni vengono registrate per impostazione predefinita | abilitato | boolean | |
| Impostazioni di sicurezza di Meet > Dominio | meet.safety_domain
|
No | Chi può partecipare alle riunioni create dalla tua organizzazione. | users_allowed_to_join | enum:
|
|
| Impostazioni di sicurezza di Meet > Accesso | meet.safety_access
|
No | A quali riunioni o chiamate possono partecipare gli utenti dell'organizzazione. Le "restrizioni delle chiamate in arrivo" possono limitare ulteriormente le chiamate che gli utenti possono ricevere | meetings_allowed_to_join | enum:
|
|
| Impostazioni di sicurezza di Meet > Gestione dell'organizzatore | meet.safety_host_management
|
No | Impostazione predefinita di gestione dell'organizzatore | enable_host_management | boolean | |
| Impostazioni di sicurezza di Meet > Avviso per partecipanti esterni | meet.safety_external_participants
|
No | Indica i partecipanti esterni a "Organizzazione" o le cui identità non sono confermate. | enable_external_label | boolean | |
| Impostazioni di sicurezza di Meet > Accesso | meet.joining
|
No | Tipo di accesso alla riunione (soggetto alle limitazioni impostate in Dominio) | allowed_audience | enum:
|
|
| Impostazioni di sicurezza di Meet > Chat | meet.messaging
|
No | Chi può inviare messaggi chat durante le chiamate | abilitato | boolean | |
| Impostazioni di sicurezza di Meet > Presenta | meet.presenting
|
No | Chi può condividere lo schermo durante le chiamate. | abilitato | boolean | |
| Impostazioni di sicurezza di Meet > Domande e risposte | meet.questions
|
No | Chi può partecipare alle sessioni di domande e risposte durante le chiamate | abilitato | boolean | |
| Impostazioni di sicurezza di Meet > Sondaggi | meet.polls
|
No | Chi può partecipare ai sondaggi durante le chiamate | abilitato | boolean | |
| Impostazioni di sicurezza di Meet > Limitazioni per le chiamate in arrivo | meet.meet_incoming_call_restrictions
|
No | Questa impostazione influisce solo su Chiamate di Meet, non sui servizi legacy o sulle chiamate di Google Chat. Le limitazioni impostate in "Accesso" possono limitare ulteriormente le chiamate che gli utenti possono ricevere. | allowed_callers | enum:
|
Impostazioni di provisioning
| Pagina nella Console di amministrazione | Impostazione specifica nella Console di amministrazione | Tipo di impostazione dell'API Policy | Mutate supportato in v1beta1 | Didascalia della Console di amministrazione | Nome campo API della policy | Tipo di dati |
| Impostazioni account | Gestione degli account in conflitto | provisioning.conflicting_accounts_management
|
No | Scegli come gestire gli account in conflitto | option | enum:
|
| Invia email di follow-up giornaliere per (numero specificato) giorni | automatic_invitations.invitation_count | integer | ||||
| Se un utente non accetta un invito entro il periodo di follow-up selezionato | automatic_invitations.unaccepted_invitation_resolution_option | enum:
|
Impostazioni di regole e rilevatori
Questa sezione descrive le impostazioni per le regole e i rilevatori.
Impostazioni delle regole di protezione dei dati
Per una panoramica su come creare regole e rilevatori di protezione dei dati per le applicazioni supportate, vedi Crea regole di protezione dei dati.
| Pagina nella Console di amministrazione | Impostazione specifica nella Console di amministrazione | Tipo di impostazione dell'API Policy | Mutazione supportata | Didascalia della Console di amministrazione | Nome campo API della policy | Tipo di dati |
| Protezione dei dati | Sicurezza > Accesso e controlli relativi ai dati > Protezione dei dati > Gestisci regole | rule.dlp
|
Sì | Nome | display_name | string |
| Descrizione | descrizione | string | ||||
| App | trigger | string[]: un elenco di stringhe di attivazione specifiche dell'applicazione. Specifica uno o più trigger da monitorare. La regola viene valutata quando si verifica uno degli attivatori specificati. Per i valori disponibili, consulta la sezione Trigger. | ||||
| Condizioni | condizione | stringa: espressione Common Expression Language (CEL) delle condizioni dei dati per cui la regola esegue la scansione. La sintassi CEL e alcuni esempi comuni sono forniti nella sezione Condizioni di seguito. | ||||
| Azioni | azione | Struct: oggetto nidificato che rappresenta le azioni specifiche dell'app da intraprendere quando le condizioni sono soddisfatte. Le azioni disponibili per ogni attivatore dell'app sono fornite nella sezione Azioni di seguito. | ||||
| Stato | state | enum:
|
||||
| Data creazione | create_time | Timestamp | ||||
| Ultima modifica | update_time | Timestamp | ||||
| Metadati specifici del tipo di regola | rule_type_metadata | Struct: oggetto nidificato che rappresenta i metadati specifici del tipo di regola. Per le regole di protezione dei dati, contiene il livello di gravità degli eventi attivati. |
Trigger
La tabella seguente fornisce l'elenco delle piattaforme, delle applicazioni e degli attivatori disponibili:
| Piattaforma | Applicazione | Trigger | Valore API |
| Google Workspace | Gmail | Messaggio inviato | google.workspace.gmail.email.v1.send
|
| Messaggio ricevuto | google.workspace.gmail.email.v1.receive
|
||
| Google Drive | File di Drive | google.workspace.drive.file.v1.share
|
|
| Google Chat | Messaggio inviato | google.workspace.chat.message.v1.send
|
|
| File caricato | google.workspace.chat.attachment.v1.upload
|
||
| Chrome | Chrome | File caricato | google.workspace.chrome.file.v1.upload
|
| File scaricato | google.workspace.chrome.file.v1.download
|
||
| Contenuti incollati | google.workspace.chrome.web_content.v1.upload
|
||
| Contenuti stampati | google.workspace.chrome.page.v1.print
|
||
| URL visitato | google.workspace.chrome.url.v1.navigation
|
||
| ChromeOS | ChromeOS | Limitazioni al trasferimento di file | google.workspace.chromeos.file.v1.transfer
|
Condizioni
Per rappresentare le condizioni dei dati, l'API utilizza espressioni Common Expression Language (CEL). Ogni condizione segue il pattern {match source}.{content to scan for}({additional scan parameters}). Ad esempio, all_content.contains('apple') rappresenta una condizione dei dati che corrisponde se uno qualsiasi dei contenuti analizzati (ad es. documento di Drive, messaggio chat e così via) contiene la sottostringa apple.
Origini delle corrispondenze
L'elenco delle origini di corrispondenza disponibili, corrispondenti alle configurazioni di corrispondenza con gli stessi nomi nella Console di amministrazione.
access_levelsall_contentall_headersbodydestination_typedestination_urldrive_enterprise_metadataencryption_stateenvelope_fromfile_size_in_bytesfile_typefrom_headermessage_security_statusrequest_attributessender_headersource_chrome_contextsource_urlsource_url_categorysubjectsuggestiontarget_usertitleto_header_recipientsurlurl_category
Contenuti da cercare
L'elenco dei contenuti disponibili da analizzare, corrispondente alle configurazioni di corrispondenza con gli stessi nomi nella Console di amministrazione.
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}})- Corrisponde all'opzione Corrisponde al tipo di dati predefinito nella Console di amministrazione.
{detector name}indica il tipo di dati predefinito da analizzare, che può essere uno degli infotype integrati supportati da Sensitive Data Protection: https://cloud.google.com/sensitive-data-protection/docs/infotypes-reference (ad esempio,CREDIT_CARD_NUMBERoUS_SOCIAL_SECURITY_NUMBER). Alcuni tipi di rilevatori più recenti non sono supportati in questa API e restituiscono un errore se specificati.{likelihood}indica la soglia di probabilità della corrispondenza. Ad esempio, google.privacy.dlp.v2.Likelihood.LIKELY corrisponde alla soglia Alta nella Console di amministrazione.
matches_regex_detector({detector name}, {minimum_match_count: {count}})- Corrisponde all'opzione Corrisponde all'espressione regolare nella Console di amministrazione.
{detector name}è il nome della risorsa della policy che rappresenta il rilevatore di espressioni regolari. Consulta la sezione Rilevatore di protezione dei dati per scoprire come eseguire query sulle policy dei rilevatori nell'API.
matches_word_list({detector name}, {minimum_match_count: {count}, minimum_unique_match_count: {count}})- Corrisponde all'opzione Corrisponde alle parole incluse nell'elenco della Console di amministrazione.
{detector name}è il nome della risorsa della policy che rappresenta il rilevatore dell'elenco di parole. Consulta la sezione Rilevatore di protezione dei dati per scoprire come eseguire query sulle policy dei rilevatori nell'API.
matches_web_category({category})- Corrisponde all'opzione Corrispondenze di categorie di URL nella Console di amministrazione per l'attivatore URL visitato di Chrome.
{category}indica la categoria di URL supportata dalla configurazione della Console di amministrazione. Per l'elenco delle categorie disponibili e delle relative rappresentazioni API, consulta Categorie URL.
contains_word({string})- Corrisponde se i contenuti contengono
{string}come parola intera.
- Corrisponde se i contenuti contengono
matches_file_extension({extension})- Trova la corrispondenza se l'estensione del file è
{extension}.
- Trova la corrispondenza se l'estensione del file è
matches_mime_types({categories}, {custom_types})- Corrisponde se il tipo MIME del file appartiene a uno dei
{categories}o{custom_types}specificati.
- Corrisponde se il tipo MIME del file appartiene a uno dei
matches_metadata({metadata_criteria})- Trova i file di Drive in base a
{metadata_criteria}definito nelle etichette di Drive.
- Trova i file di Drive in base a
matches_enum({enum_value})- Trova corrispondenze tra i campi basati su enum e
{enum_value}. Ad esempio,encryption_state.matches_enum('ENCRYPTED').
- Trova corrispondenze tra i campi basati su enum e
matches_url_list({url_list_id})- Corrisponde se l'URL è presente nell'elenco di URL specificato
{url_list_id}.
- Corrisponde se l'URL è presente nell'elenco di URL specificato
matches_url_risk_level({risk_level})- Trova la corrispondenza se il livello di rischio dell'URL è
{risk_level}.
- Trova la corrispondenza se il livello di rischio dell'URL è
matches_address({email})- Trova la corrispondenza se l'indirizzo email è
{email}.
- Trova la corrispondenza se l'indirizzo email è
matches_address_domain_name({domain})- Trova la corrispondenza se il dominio dell'indirizzo email è
{domain}.
- Trova la corrispondenza se il dominio dell'indirizzo email è
matches_address_regex({regex})- Corrisponde se l'indirizzo email corrisponde all'espressione regolare
{regex}.
- Corrisponde se l'indirizzo email corrisponde all'espressione regolare
Condizioni composite
Più condizioni di base possono essere combinate con gli operatori AND (&&), OR (||) o NOT (!) per formare una condizione composita. Ad esempio, "all_content.contains('apple') && all_content.contains('banana')" rappresenta una condizione che corrisponde se uno dei contenuti scansionati contiene entrambe le sottostringhe "apple" e "banana".
Sintassi delle espressioni CEL per le regole
L'espressione Common Expression Language (CEL) che definisce la logica di una regola si trova nel campo condition della risorsa Rule. Questo campo è in genere un messaggio google.type.Expr, con l'espressione CEL in un campo expression o cel_expression.
Per creare una regola valida, devi utilizzare le funzioni CEL supportate dall'applicazione, dall'evento di attivazione e dall'origine della corrispondenza specifici che stai scegliendo come target.
La seguente tabella elenca le origini di corrispondenza e le funzioni delle condizioni disponibili per ogni applicazione e attivatore per le regole di protezione dei dati (DLP).
| Applicazione | Evento di trigger | Origine della corrispondenza | Funzioni di condizione CEL disponibili |
|---|---|---|---|
| Gmail | Messaggio inviato Messaggio ricevuto |
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}) (ad es. 'CONFIDENTIAL_MODE_ENABLED') |
||
| Drive | File di 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}) (ad es. 'ENCRYPTED') |
||
| Chat | Messaggio inviato File caricato |
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}}) |
| Solo file caricato | file_name |
contains({string})contains_word({string}) |
|
file_extension |
matches_file_extension({extension}) |
||
file_type |
matches_mime_types({categories}, {custom_types}) |
||
| Chrome | File caricato File scaricato Contenuti incollati Contenuti stampati |
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}}) |
| File caricato File scaricato Contenuti stampati |
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}}) |
|
| Tutti gli attivatori di 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})(Nota: url supporta anche 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 |
Operatori di confronto standard (ad es. 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}) |
||
| Solo contenuti incollati | source_chrome_context |
matches_enum({enum_value}) (valori: 'CLIPBOARD', 'INCOGNITO', 'OTHER_PROFILE') |
|
| ChromeOS | Limitazioni al trasferimento di file | 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 |
Operatori di confronto standard |
Azioni
Ogni applicazione specifica l'azione da intraprendere quando la condizione dei dati corrisponde a un messaggio nidificato. Ad esempio, { "driveAction" { "warnUser" { } } } rappresenta un'azione di Drive che avvisa gli utenti della condivisione esterna. Le azioni specifiche per l'applicazione disponibili sono le seguenti:
| Applicazione | Tasto azione | Subaction | Didascalia della Console di amministrazione |
| Drive | driveAction | blockAccess | Blocca condivisione esterna |
| warnUser | Avviso in caso di condivisione esterna | ||
| auditOnly | nessuna azione | ||
| restrictCopyPrintDownload | Disattiva download, stampa e copia | ||
| applyLabels | Applica etichette di classificazione | ||
| Gmail | gmailAction | blockContent | Blocca messaggio |
| warnUser | Avvisa gli utenti | ||
| auditOnly | Solo controllo | ||
| quarantineMessage | Metti messaggio in quarantena | ||
| applyLabels | Applica etichette di classificazione | ||
| addFooter | Aggiungi nota personalizzata (piè di pagina) | ||
| Chat | chatAction | blockContent | Blocca messaggio |
| warnUser | Avvisa gli utenti | ||
| auditOnly | Solo controllo | ||
| Google Chrome | chromeAction | blockContent | Blocca |
| warnUser | Consenti con avviso | ||
| ChromeOS | chromeOsAction | blockContent | Blocca |
| warnUser | Consenti con avviso | ||
| auditOnly | Solo controllo |
Parametri azione
I parametri delle azioni forniscono una configurazione aggiuntiva per le azioni delle regole. I parametri disponibili dipendono dall'applicazione.
Esempio di impostazione dei parametri azione
L'esempio seguente mostra come specificare i parametri di azione per un'azione Chrome blockContent, attivando l'archivio delle prove (saveContent) e impostando un messaggio di filigrana (watermarkMessage). Viene utilizzata la rappresentazione Struct generica utilizzata dall'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"
}
}
}
}
}
}
}
}
}
}
}
}
}
}
Parametri azione di Drive
In genere, le azioni di Drive non accettano parametri aggiuntivi. Tuttavia, l'azione restrictCopyPrintDownload richiede la specifica di un ambito.
| Parametro | Tipo di dati | Descrizione |
restrict_copy_print_download.scope
|
enum | Specifica l'ambito degli utenti per cui disattivare il download, la stampa e la copia.
|
Parametri delle azioni Gmail
| Parametro | Tipo di dati | Descrizione |
apply_internal_messages
|
boolean | Applica l'azione ai messaggi interni. |
apply_external_messages
|
boolean | Applica l'azione ai messaggi esterni. |
apply_to_internal_receive_messages
|
boolean | Applica l'azione ai messaggi interni ricevuti. |
apply_to_external_receive_messages
|
boolean | Applica l'azione ai messaggi ricevuti dall'esterno. |
custom_end_user_message.unsafe_html_message_body
|
string | Contenuto del messaggio HTML da mostrare all'utente finale quando viene attivata una regola. Sono supportati solo i tag <a>.
|
add_footer.footer.title
|
string | Il titolo della nota personalizzata (massimo 50 caratteri). |
add_footer.footer.unsafe_html_message_body
|
string | Testo della descrizione HTML per la nota personalizzata. Sono supportati solo i tag <a> (massimo 300 caratteri).
|
add_footer.footer.banner_highlighted
|
boolean | Indica se la nota personalizzata deve essere evidenziata in un banner. |
add_footer.footer.position
|
enum | La posizione della nota personalizzata nel messaggio: TOP o BOTTOM.
|
apply_labels.label_delta
|
Struct[] | Elenco delle modifiche alle etichette da applicare. Ogni oggetto contiene:
|
apply_labels.conflict_resolution_strategy
|
enum | Strategia per risolvere i conflitti: SYSTEM_OVERRIDE o ALLOW_USER_OVERRIDE.
|
apply_labels.custom_end_user_message.unsafe_html_message_body
|
string | Contenuto del messaggio HTML da mostrare all'utente finale quando viene attivata l'azione Applica etichette. Sono supportati solo i tag <a>.
|
quarantine_message.quarantine_resource_name
|
string | Il nome della risorsa della quarantena. Segue il formato quarantines/obfuscated<id> o quarantines/default.
|
Parametri delle azioni di Chat
| Parametro | Tipo di dati | Descrizione |
apply_internal_direct_messages
|
boolean | Applica l'azione ai messaggi inviati utilizzando messaggi diretti 1:1 interni. |
apply_external_direct_messages
|
boolean | Applica l'azione ai messaggi inviati utilizzando messaggi diretti 1:1 esterni. |
apply_internal_rooms
|
boolean | Applica l'azione ai messaggi inviati alle stanze virtuali interne. |
apply_external_rooms
|
boolean | Applica l'azione ai messaggi inviati alle stanze esterne. |
apply_internal_group_chats
|
boolean | Applica l'azione ai messaggi inviati alle chat di gruppo interne. |
apply_external_group_chats
|
boolean | Applica l'azione ai messaggi inviati alle chat di gruppo esterne. |
custom_end_user_message.unsafe_html_message_body
|
string | Contenuto del messaggio HTML da mostrare all'utente finale quando viene attivata una regola. Sono supportati solo i tag <a>.
|
Parametri delle azioni di Google Chrome
| Parametro | Tipo di dati | Descrizione |
save_content
|
boolean | Consente di salvare in modo sicuro i contenuti che attivano questa regola (archivio prove). |
watermark_message
|
string | Testo visualizzato come filigrana quando viene attivata una regola di navigazione degli URL. |
custom_end_user_message.unsafe_html_message_body
|
string | Contenuto del messaggio HTML da mostrare all'utente finale quando viene attivata una regola. Sono supportati solo i tag <a>.
|
block_screenshot
|
boolean | Blocca gli screenshot e la condivisione schermo se impostato su true.
|
match_only_download_url
|
boolean | Valuta la regola solo in base all'URL di download, ignorando l'URL della scheda. |
force_save_to_cloud_sub_action.destination
|
enum | Destinazione di archiviazione sul cloud per i salvataggi forzati anziché per il file system locale.
|
data_masking.regex_detector
|
Struct[] | Un elenco di rilevatori di espressioni regolari utilizzati per il mascheramento dei dati. Specifica uno o più rilevatori come elenco di oggetti, ciascuno contenente i campi descritti nella tabella seguente. |
data_masking.regex_detector[].mask_type
|
enum | Tipo di mascheramento da applicare quando l'espressione regolare corrisponde.
|
data_masking.regex_detector[].resource_name
|
string | Identificatore della risorsa del rilevatore. |
data_masking.regex_detector[].display_name
|
string | Nome del rilevatore visualizzato negli strumenti di generazione dei report (ad esempio lo strumento di indagine sulla sicurezza) quando viene attivato. |
data_masking.regex_detector[].regex_pattern
|
string | Il pattern dell'espressione regolare utilizzato per la corrispondenza. Questo campo viene compilato dal sistema e non deve essere impostato dall'utente. |
Parametri delle azioni di ChromeOS
| Parametro | Tipo di dati | Descrizione |
save_content
|
boolean | Consente di salvare in modo sicuro i contenuti che attivano questa regola. |
Metadati specifici del tipo di regola
Questo attributo contiene i metadati specifici del tipo di regola. Per le regole di protezione dei dati, contiene la gravità dell'evento di avviso quando l'evento viene segnalato nella dashboard per la sicurezza e nel Centro avvisi. Un esempio di valore dei metadati che rappresenta la gravità di un avviso BASSA:
fields {
key: "ruleTypeMetadata"
value {
struct_value {
fields {
key: "dlpRuleMetadata"
value {
struct_value {
fields {
key: "alertSeverity"
value {
string_value: "LOW"
}
}
}
}
}
}
}
}
Impostazioni dei rilevatori di protezione dei dati
Per una panoramica delle regole e dei rilevatori di protezione dei dati, consulta Crea regole e rilevatori di contenuti personalizzati di DLP per Drive.
| Pagina nella Console di amministrazione | Impostazione specifica nella Console di amministrazione | Tipo di impostazione dell'API Policy | Mutazione supportata | Didascalia della Console di amministrazione | Nome campo API della policy | Tipo di dati |
| Protezione dei dati | Sicurezza > Accesso e controlli relativi ai dati > Protezione dei dati > Gestisci rilevatori | detector.regular_expression detector.word_list detector.url_list | Sì | Nome | display_name | string |
| Descrizione | descrizione | string | ||||
| Espressione regolare | regular_expression | Struct: contiene la stringa dell'espressione regolare. Impostato solo se il tipo di rilevatore è detector.regular_expression. | ||||
| Elenco di parole | word_list | Struct: contiene l'elenco di stringhe di parole. Impostato solo se il tipo di rilevatore è detector.word_list.
|
||||
| URL List | url_list | Struct: contiene l'elenco di stringhe URL. Impostato solo se il tipo di rilevatore è detector.url_list.
|
||||
| Data creazione | create_time | Timestamp | ||||
| Ultima modifica | update_time | Timestamp |
Impostazioni delle regole di avviso definite dal sistema
Questa sezione descrive le regole di avviso definite dal sistema di Google Workspace.
| Pagina nella Console di amministrazione | Impostazione specifica nella Console di amministrazione | Tipo di impostazione dell'API Policy | Mutazione supportata | Didascalia della Console di amministrazione | Nome campo API della policy | Tipo di dati |
| Protezione dei dati | Regole (per il tipo di regola "definita dal sistema") | rule.system_defined_alerts
|
No | Nome | display_name | string |
| Descrizione | descrizione | string | ||||
| Azioni | azione | Struct: oggetto nidificato che rappresenta le impostazioni di notifica quando viene attivato l'avviso definito dal sistema. I dettagli sono forniti nella sezione Azioni di seguito. | ||||
| Stato | state | enum:
|
||||
| Data creazione | create_time | Timestamp | ||||
| Ultima modifica | update_time | Timestamp |
Azioni
Le regole di avviso definite dal sistema hanno un'unica azione che indica le impostazioni di notifica per l'avviso.
| Tasto azione | Subaction | Didascalia della Console di amministrazione | Descrizione |
| alertCenterAction | alertCenterConfig | Invia al Centro avvisi | Configura la gravità dell'avviso e se l'avviso viene inviato al Centro avvisi. |
| destinatari | Invia notifiche email | Elenco di indirizzi email a cui inviare notifiche quando viene attivato l'avviso. |
Parametri azione
La tabella seguente fornisce i parametri per alertCenterAction:
| Parametro | Tipo di dati | Descrizione |
alertCenterConfig.severity
|
enum | La gravità dell'avviso (ad es. LOW, MEDIUM, HIGH).
|
alertCenterConfig.status
|
enum | Se l'avviso viene inviato al Centro avvisi (ad es. ENABLED, DISABLED).
|
recipients
|
string[] | Un elenco di indirizzi email per la ricezione delle notifiche via email. |
Impostazioni di sicurezza
| Pagina nella Console di amministrazione | Impostazione specifica nella Console di amministrazione | Tipo di impostazione dell'API Policy | Mutazione supportata | Didascalia della Console di amministrazione | Nome campo API della policy | Tipo di dati |
| Recupero dell'account | Recupero dell'account super amministratore | security.super_admin_account_recovery
|
No | Consenti ai super amministratori di recuperare il proprio account | enableAccountRecovery | boolean |
| Recupero dell'account utente | security.user_account_recovery
|
No | Consenti agli utenti e agli amministratori che non dispongono dei privilegi di super amministratore di recuperare il proprio account | enableAccountRecovery | boolean | |
| Gestione delle password | Gestione delle password | security.password
|
No | Scadenza | expirationDuration | Secondi (0 secondi significa che non scade mai) |
| Riutilizzo | allowReuse | boolean | ||||
| Applicazione di complessità e lunghezza | enforceRequirementsAtLogin | boolean | ||||
| Lunghezza (lunghezza massima) | maximumLength | integer | ||||
| Length (Minimum length) | minimumLength | integer | ||||
| Forza | allowedStrength | enum:
|
||||
| Controllo sessione Google | Controllo sessione | security.session_controls
|
No | Durata della sessione web | webSessionDuration | Secondi |
| App meno sicure | App meno sicure | security.less_secure_apps
|
No | Controlla l'accesso degli utenti alle app che utilizzano tecnologie di accesso meno sicure e rendono gli account più vulnerabili. | allowLessSecureApps | boolean |
| Verifiche dell'accesso | Verifiche dell'accesso | security.login_challenges
|
No | Utilizza l'ID dipendente per rafforzare la protezione degli utenti | enableEmployeeIdChallenge | boolean |
| Senza password | Limitazione delle passkey | security.passkeys_restriction
|
No | Scegli i tipi di passkey con cui gli utenti possono accedere | allowed_passkeys_type | enum:
|
| Programma di protezione avanzata | Registrazione | security.advanced_protection_program
|
No | Utilizza l'ID dipendente per rafforzare la protezione degli utenti | enableAdvancedProtectionSelfEnrollment | boolean |
| Codici di sicurezza | securityCodeOption | enum:
|
||||
| Verifica in due passaggi | Autenticazione | security.two_step_verification_enrollment
|
No | Consentire agli utenti di attivare la verifica in due passaggi | allowEnrollment | boolean |
security.two_step_verification_enforcement
|
Applicazione | enforcedFrom | Timestamp | |||
security.two_step_verification_grace_period
|
Periodo di registrazione dei nuovi utenti | enrollmentGracePeriod | Durata | |||
security.two_step_verification_device_trust
|
Consenti all'utente di considerare attendibile il dispositivo | allowTrustingDevice | boolean | |||
security.two_step_verification_enforcement_factor
|
Metodi | allowedSignInFactorSet | enum:
|
|||
security.two_step_verification_sign_in_code
|
Periodo di tolleranza per la sospensione della policy di verifica in due passaggi | backupCodeExceptionPeriod | Durata | |||
| Impostazioni di approvazione da più parti | Impostazioni di approvazione da più parti | multi_party_approval.require_approvals
|
No | Scegli se un amministratore con privilegi di approvazione da più parti deve approvare le azioni sensibili eseguite nella Console di amministrazione e nell'API Admin | multi_party_approval_state | enum:
|
| Approvazione da più parti per le impostazioni di sicurezza | multi_party_approval.security_actions
|
No | Verifica in due passaggi | two_step_verification_multi_party_approval_state | ||
| Recupero dell'account | account_recovery_multi_party_approval_state | |||||
| Controllo sessione Google | session_controls_multi_party_approval_state | |||||
| Programma di protezione avanzata | advanced_protection_program_multi_party_approval_state | |||||
| Verifiche dell'accesso | login_challenges_multi_party_approval_state | |||||
| Senza password | passwordless_multi_party_approval_state | |||||
| Delega a livello di dominio | domain_wide_delegation_multi_party_approval_state | |||||
| SSO con IdP di terze parti | sso_with_third_party_idps_multi_party_approval_state | |||||
| Accesso sensibile al contesto | context_aware_access_multi_party_approval_state | |||||
| Approvazione da più parti per l'accesso API alle impostazioni di sicurezza | multi_party_approval.security_actions_api_access
|
No | SSO con IdP di terze parti | sso_with_third_party_idps_multi_party_approval_state | ||
| Approvazione da più parti per le impostazioni del calendario | multi_party_approval.calendar_actions
|
No | Condivisione del calendario | calendar_sharing_multi_party_approval_state | ||
| Impostazioni generali del calendario | general_calendar_settings_multi_party_approval_state | |||||
| Impostazioni di archiviazione di terze parti in Calendar | third_party_archiving_settings_multi_party_approval_state | |||||
| Approvazione da più parti per le impostazioni dei gruppi | multi_party_approval.groups_actions
|
No | Condivisione con i gruppi | groups_sharing_multi_party_approval_state | ||
| Approvazione da più parti per le impostazioni di amministrazione dei domini | multi_party_approval.domains_actions
|
No | API Domains | domains_api_multi_party_approval_state |
Impostazioni dello stato del servizio
L'impostazione service_status contiene un valore booleano che indica se un servizio è attivato per un determinato OrgUnit o Group.
L'API Policy supporta le impostazioni dello stato del servizio per i servizi Google Workspace, Servizi Google aggiuntivi e AI generativa elencati nella Console di amministrazione.
Google Workspace
| Nome del servizio nella Console di amministrazione | Nome del servizio nell'API Policy |
| AppSheet | appsheet |
| Calendar | calendario |
| Cloud Search | cloud_search |
| Drive e Documenti | drive_and_docs |
| Gmail | gmail |
| Google Chat | chat |
| Google Meet | meet |
| Google Vault | vault |
| Google Voice | voice |
| Groups for Business | groups_for_business |
| Keep | keep |
| Sites | siti |
| Tasks | tasks |
Servizi Google aggiuntivi
| Nome del servizio nella Console di amministrazione | Nome del servizio nell'API Policy |
| AI Studio | ai_studio |
| Applied Digital Skills | applied_digital_skills |
| Assegnazioni | assegnazioni |
| Blogger | blogger |
| Account del brand | brand_accounts |
| Campaign Manager 360 | campaign_manager |
| Chrome Canvas | chrome_canvas |
| Chrome Cursive | chrome_cursive |
| Chrome Remote Desktop | chrome_remote_desktop |
| Chrome Web Store | chrome_web_store |
| Classroom | classroom |
| CS First | cs_first |
| Currents | currents |
| App con accesso in anteprima | early_access_apps |
| Applicazioni sperimentali | experimental_apps |
| FeedBurner | feedburner |
| Google Ad Manager | ad_manager |
| Google Ads | annunci |
| Google AdSense | adsense |
| Google Alert | avvisi |
| Google Analytics | analytics |
| Google Arts & Culture | arts_and_culture |
| Google Segnalibri | bookmarks |
| Google Libri | Libri |
| Sincronizzazione Google Chrome | chrome_sync |
| Google Cloud | cloud |
| Google Cloud Print | cloud_print |
| Google Colab | Colab |
| Google Developers | sviluppatori |
| Google Domains | domini |
| Google Earth | earth |
| Google Fi | fi |
| Google Gruppi | gruppi |
| Google Maps | maps |
| Google Messaggi | messaggi |
| Google My Business | my_business |
| Google My Maps | my_maps |
| Google News | news |
| Google Pay | pay |
| Google Foto | photos |
| Google Play | riproduci |
| Google Play Console | play_console |
| Google Public Data Explorer | public_data |
| Google Read Along | read_along |
| Google Search Console | search_console |
| Google Takeout | takeout |
| Google Traduttore | translate |
| Google Trips | trips |
| Jamboard | jamboard |
| Cronologia delle posizioni | location_history |
| Data Studio | data_studio |
| Versione gestita di Google Play | managed_play |
| Material Gallery | material_gallery |
| Merchant Center | merchant_center |
| Partner Dash | partner_dash |
| Pinpoint | individuare |
| Centro partner di Play Libri | play_books_partner_center |
| Motore di ricerca programmabile | programmable_search_engine |
| Question Hub | question_hub |
| Profili Scholar | scholar_profiles |
| Search Ads 360 | search_ads_360 |
| Ricerca e assistente | search_and_assistant |
| Socratic | socratic |
| Studio | studio |
| Backup di app di terze parti | third_party_app_backups |
| Tour Creator | tour_creator |
| Work Insights | work_insights |
| YouTube | youtube |
AI generativa
| Nome del servizio nella Console di amministrazione | Nome del servizio nell'API Policy |
| App Gemini | gemini_app |
| NotebookLM | notebooklm |
Impostazioni Sites
| Pagina nella Console di amministrazione | Impostazione specifica nella Console di amministrazione | Tipo di impostazione dell'API Policy | Mutazione supportata | Didascalia della Console di amministrazione | Nome campo API della policy | Tipo di dati |
| Sites | Nuova versione di Sites > Creazione e modifica dei siti | sites.sites_creation_and_modification
|
No | Consenti agli utenti di creare siti nella nuova versione di Sites | allowSitesCreation | boolean |
| Gli utenti possono/non possono modificare i siti | allowSitesModification | boolean | ||||
Impostazioni UserTakeout
| Pagina nella Console di amministrazione | Impostazione specifica nella Console di amministrazione | Tipo di impostazione dell'API Policy | Mutazione supportata | Didascalia della Console di amministrazione | Nome campo API della policy | Tipo di dati |
| Dati | Importazione ed esportazione dati > Google Takeout > Accesso utente a Takeout per i servizi Google |
|
No | Gestisci l'accesso utente a Takeout per i servizi Google | takeout_status | enum:
|