- Risorsa: PolicySchema
- AdditionalTargetKeyName
- FileDescriptorProto
- DescriptorProto
- FieldDescriptorProto
- Etichetta
- Tipo
- EnumDescriptorProto
- EnumValueDescriptorProto
- OneofDescriptorProto
- PolicySchemaFieldDescription
- PolicySchemaFieldKnownValueDescription
- PolicySchemaFieldDependencies
- PolicySchemaRequiredItems
- FieldConstraints
- NumericRangeConstraint
- UploadedFileConstraints
- ContentType
- PolicySchemaNoticeDescription
- TargetResource
- PolicyApiLifecycle
- PolicyApiLifecycleEnum
- Data
- Piattaforma
- Metodi
Risorsa: PolicySchema
Risorsa che rappresenta uno schema di criteri.
Rappresentazione JSON |
---|
{ "name": string, "policyDescription": string, "additionalTargetKeyNames": [ { object ( |
Campi | |
---|---|
name |
Formato: name=customers/{customer}/policySchemas/{schema_namespace} |
policyDescription |
Solo output. Descrizione dello schema dei criteri per il consumo da parte degli utenti. |
additionalTargetKeyNames[] |
Solo output. Nomi di chiavi aggiuntivi che verranno utilizzati per identificare la destinazione del valore del criterio. Quando specifichi un valore |
definition |
Definizione dello schema mediante descrittore di protocollo. |
fieldDescriptions[] |
Solo output. Descrizione dettagliata di ciascun campo che fa parte dello schema. È consigliabile che i campi vengano visualizzati in base all'ordine all'interno dell'elenco, non in base al numero. |
accessRestrictions[] |
Solo output. Limitazioni di accesso specifiche relative a questo criterio. |
notices[] |
Solo output. Messaggi di avviso speciale relativi all'impostazione di determinati valori in determinati campi dello schema. |
supportUri |
Solo output. URI dell'articolo di assistenza correlato per questo schema. |
schemaName |
Solo output. Il nome completo dello schema dei criteri. Questo valore viene utilizzato per compilare il campo |
validTargetResources[] |
Solo output. Informazioni sulle risorse di destinazione applicabili per il criterio. |
policyApiLifecycle |
Solo output. Informazioni attuali sul ciclo di vita. |
categoryTitle |
Titolo della categoria a cui appartiene un'impostazione. |
supportedPlatforms[] |
Solo output. L'elenco indica che il criterio verrà applicato solo ai dispositivi/utenti su queste piattaforme. |
AdditionalTargetKeyName
Nomi di chiavi aggiuntivi che verranno utilizzati per identificare la destinazione del valore del criterio.
Rappresentazione JSON |
---|
{ "key": string, "keyDescription": string } |
Campi | |
---|---|
key |
Nome chiave. |
keyDescription |
Descrizione della chiave. |
FileDescriptorProto
Descrive un file .proto completo.
Rappresentazione JSON |
---|
{ "name": string, "package": string, "messageType": [ { object ( |
Campi | |
---|---|
name |
nome del file, in relazione alla radice dell'albero di origine |
package |
ad es. "foo", "foo.bar" e così via. |
messageType[] |
Tutte le definizioni di primo livello in questo file. |
enumType[] |
|
syntax |
La sintassi del file proto. I valori supportati sono "proto2", "proto3" ed "editions". Se è presente |
DescriptorProto
Descrive un tipo di messaggio.
Rappresentazione JSON |
---|
{ "name": string, "field": [ { object ( |
Campi | |
---|---|
name |
|
field[] |
|
nestedType[] |
|
enumType[] |
|
oneofDecl[] |
|
FieldDescriptorProto
Descrive un campo all'interno di un messaggio.
Rappresentazione JSON |
---|
{ "name": string, "number": integer, "label": enum ( |
Campi | |
---|---|
name |
|
number |
|
label |
|
type |
Se typeName è impostato, non è necessario impostarlo. Se è impostato sia questo valore che typeName, il valore deve essere TYPE_ENUM, TYPE_MESSAGE o TYPE_GROUP. |
typeName |
Per i tipi di messaggio ed enum, questo è il nome del tipo. Se il nome inizia con un punto ".", è valido. In caso contrario, per trovare il tipo vengono utilizzate regole di ambito di tipo C++ (la ricerca viene eseguita prima nei tipi nidificati all'interno di questo messaggio, poi nell'elemento padre, fino allo spazio dei nomi principale). |
defaultValue |
Per i tipi numerici, contiene la rappresentazione testuale originale del valore. Per i valori booleani, "true" o "false". Per le stringhe, contiene i contenuti di testo predefiniti (senza caratteri di escape). Per i byte, contiene il valore con escape C. Tutti i byte >= 128 sono sottoposti a escape. |
oneofIndex |
Se impostato, restituisce l'indice di un oneof nell'elenco oneofDecl del tipo contenitore. Questo campo fa parte di questo campo. |
jsonName |
Nome JSON di questo campo. Il valore è impostato dal compilatore di protocollo. Se l'utente ha impostato un valore "jsonName" in questo campo, verrà utilizzato il valore di tale opzione. In caso contrario, viene dedotto dal nome del campo convertendolo in camelCase. |
proto3Optional |
Se true, si tratta di un proto3 "facoltativo". Quando un campo proto3 è facoltativo, monitora la presenza indipendentemente dal tipo di campo. Se proto3Optional è true, questo campo deve appartenere a un altro per segnalare ai vecchi client proto3 che la presenza viene monitorata per questo campo. Questa sintetica è nota come "sintetico" unodi e questo campo deve essere il suo unico membro (ogni campo facoltativo proto3 riceve il proprio uno di sintetico). Gli elementi sintetici esistono solo nel descrittore e non generano API. Gli elementi sintetici devono essere ordinati dopo che tutto è "reale" oneofs. Per i campi del messaggio, proto3Optional non crea alcuna modifica semantica, poiché i campi del messaggio non ripetuti tengono sempre traccia della presenza. Tuttavia, indica ancora i dettagli semantici che indicano se l'utente ha scritto "facoltativo" o meno. Questo può essere utile per fare il round trip del file .proto. Per coerenza, forniamo anche ai campi dei messaggi uno sintetico, anche se non è obbligatorio monitorare la presenza. Questo è particolarmente importante perché il parser non è in grado di capire se un campo è un messaggio o un'enumerazione, quindi deve sempre crearne uno sintetico. I campi facoltativi Proto2 non impostano questo flag perché sono già facoltativi con |
Etichetta
Enum | |
---|---|
LABEL_OPTIONAL |
0 è riservato agli errori |
LABEL_REPEATED |
|
LABEL_REQUIRED |
L'etichetta obbligatoria è consentita solo in proto2. In Proto3 e Edition è espressamente vietato. Nelle versioni, è possibile utilizzare la funzionalità fieldPresence per ottenere questo comportamento. |
Tipo
Enum | |
---|---|
TYPE_DOUBLE |
0 è riservato agli errori. L'ordine è strano per motivi storici. |
TYPE_FLOAT |
|
TYPE_INT64 |
Non codificato ZigZag. I numeri negativi richiedono 10 byte. Utilizza TYPE_SINT64 se sono probabili valori negativi. |
TYPE_UINT64 |
|
TYPE_INT32 |
Non codificato ZigZag. I numeri negativi richiedono 10 byte. Utilizza TYPE_SINT32 se sono probabili valori negativi. |
TYPE_FIXED64 |
|
TYPE_FIXED32 |
|
TYPE_BOOL |
|
TYPE_STRING |
|
TYPE_GROUP |
Dati aggregati delimitato da tag. il tipo di gruppo è deprecato e non è supportato dopo proto2. Tuttavia, le implementazioni Proto3 devono comunque essere in grado di analizzare il formato del cavo di gruppo e trattare i campi del gruppo come campi sconosciuti. Nelle versioni, il formato del cavo di gruppo può essere attivato tramite la funzionalità messageEncoding . |
TYPE_MESSAGE |
Dati aggregati delimitato da lunghezza. |
TYPE_BYTES |
Novità della versione 2. |
TYPE_UINT32 |
|
TYPE_ENUM |
|
TYPE_SFIXED32 |
|
TYPE_SFIXED64 |
|
TYPE_SINT32 |
Utilizza la codifica ZigZag. |
TYPE_SINT64 |
Utilizza la codifica ZigZag. |
EnumDescriptorProto
Descrive un tipo di enum.
Rappresentazione JSON |
---|
{
"name": string,
"value": [
{
object ( |
Campi | |
---|---|
name |
|
value[] |
|
EnumValueDescriptorProto
Descrive un valore all'interno di un'enumerazione.
Rappresentazione JSON |
---|
{ "name": string, "number": integer } |
Campi | |
---|---|
name |
|
number |
|
OneofDescriptorProto
Descrive uno di questi elementi.
Rappresentazione JSON |
---|
{ "name": string } |
Campi | |
---|---|
name |
|
PolicySchemaFieldDescription
Fornisce informazioni dettagliate per un determinato campo che fa parte di un PolicySchema.
Rappresentazione JSON |
---|
{ "field": string, "description": string, "inputConstraint": string, "knownValueDescriptions": [ { object ( |
Campi | |
---|---|
field |
Solo output. Il nome del campo per associato a questa descrizione. |
description |
Deprecato. Utilizza invece name e fieldDescription. La descrizione del campo. |
inputConstraint |
Solo output. Eventuali vincoli di input associati ai valori per il campo. |
knownValueDescriptions[] |
Solo output. Se il campo ha un insieme di valori noti, questo campo fornisce una descrizione per questi valori. |
nestedFieldDescriptions[] |
Solo output. Fornisce la descrizione dei campi nidificati in questo campo, se il campo è un tipo di messaggio che definisce più campi. È consigliabile che i campi vengano visualizzati in base all'ordine all'interno dell'elenco, non in base al numero. |
fieldDependencies[] |
Solo output. Fornisce un elenco di campi e valori. Almeno uno dei campi deve contenere il valore corrispondente per poter essere impostato. |
requiredItems[] |
Solo output. Fornisce un elenco di campi che è obbligatorio impostare se questo campo ha un determinato valore. |
defaultValue |
Solo output. Se il criterio non viene configurato, è il valore predefinito del client. |
name |
Solo output. Il nome del campo. |
fieldDescription |
Solo output. La descrizione del campo. |
fieldConstraints |
Solo output. Informazioni su eventuali vincoli di input associati ai valori per il campo. |
PolicySchemaFieldKnownValueDescription
Fornisce informazioni dettagliate su un valore noto consentito per un determinato campo in PolicySchema.
Rappresentazione JSON |
---|
{
"value": string,
"description": string,
"fieldDependencies": [
{
object ( |
Campi | |
---|---|
value |
Solo output. La rappresentazione stringa del valore che è possibile impostare per il campo. |
description |
Solo output. Descrizione aggiuntiva per questo valore. |
fieldDependencies[] |
Solo output. Condizioni dei campi obbligatorie per la validità di questo valore. |
PolicySchemaFieldDependencies
Il campo e il valore che deve avere affinché sia possibile impostare un altro campo.
Rappresentazione JSON |
---|
{ "sourceField": string, "sourceFieldValue": string } |
Campi | |
---|---|
sourceField |
Il campo di origine da cui dipende questo campo. |
sourceFieldValue |
Il valore che deve contenere il campo di origine per consentire l'impostazione di questo campo. |
PolicySchemaRequiredItems
I campi che diventeranno obbligatori in base al valore di questo campo.
Rappresentazione JSON |
---|
{ "fieldConditions": [ string ], "requiredFields": [ string ] } |
Campi | |
---|---|
fieldConditions[] |
I valori del campo che comportano l'applicazione forzata dei campi obbligatori. Un campo Conditions vuoto implica che qualsiasi valore assegnato a questo campo provocherà l'applicazione forzata dei campi obbligatori. |
requiredFields[] |
Campi obbligatori per effetto delle condizioni dei campi. |
FieldConstraints
Informazioni su eventuali vincoli di intervallo.
Rappresentazione JSON |
---|
{ "numericRangeConstraint": { object ( |
Campi | |
---|---|
numericRangeConstraint |
L'intervallo consentito per i campi numerici. |
uploadedFileConstraints |
Vincoli sul file caricato di un criterio del file. Se presente, questo criterio richiede un URL che possa essere recuperato caricando un file con i vincoli specificati in questo protocollo. |
NumericRangeConstraint
Un vincolo ai limiti superiore e/o inferiore, con almeno uno impostato.
Rappresentazione JSON |
---|
{ "minimum": string, "maximum": string } |
Campi | |
---|---|
minimum |
Valore minimo. |
maximum |
Valore massimo. |
UploadedFileConstraints
Vincoli sul file caricato di un criterio del file.
Rappresentazione JSON |
---|
{
"supportedContentTypes": [
enum ( |
Campi | |
---|---|
supportedContentTypes[] |
Tipi di file che possono essere caricati per un'impostazione. |
sizeLimitBytes |
Il limite per le dimensioni dei file caricati per un'impostazione, in byte. |
ContentType
Tipi di file che possono essere caricati per un'impostazione.
Enum | |
---|---|
CONTENT_TYPE_UNSPECIFIED |
Tipo di contenuto non specificato. |
CONTENT_TYPE_PLAIN_TEXT |
Testo normale. |
CONTENT_TYPE_HTML |
HTML. |
CONTENT_TYPE_IMAGE_JPEG |
JPEG. |
CONTENT_TYPE_IMAGE_GIF |
GIF. |
CONTENT_TYPE_IMAGE_PNG |
.PNG. |
CONTENT_TYPE_JSON |
JSON. |
CONTENT_TYPE_ZIP |
ZIP. |
CONTENT_TYPE_GZIP |
GZIP. |
CONTENT_TYPE_CSV |
CSV. |
CONTENT_TYPE_YAML |
YAML. |
CONTENT_TYPE_IMAGE_WEBP |
per WebP |
PolicySchemaNoticeDescription
Fornisce messaggi di avviso speciali relativi a un determinato valore in un campo che fa parte di un PolicySchema.
Rappresentazione JSON |
---|
{ "field": string, "noticeValue": string, "noticeMessage": string, "acknowledgementRequired": boolean } |
Campi | |
---|---|
field |
Solo output. Il nome del campo associato alla notifica. |
noticeValue |
Solo output. Il valore del campo che contiene una notifica. Quando il campo viene impostato su questo valore, all'utente potrebbe essere richiesto di confermare il messaggio di avviso affinché il valore venga impostato. |
noticeMessage |
Solo output. Il messaggio di avviso associato al valore del campo. |
acknowledgementRequired |
Solo output. Indica se l'utente deve confermare il messaggio di avviso prima di poter impostare il valore. |
TargetResource
Tipi di risorse di destinazione
Enum | |
---|---|
TARGET_RESOURCE_UNSPECIFIED |
Risorsa di destinazione non specificata. |
ORG_UNIT |
Risorsa di destinazione dell'unità organizzativa. |
GROUP |
risorsa di destinazione del gruppo. |
PolicyApiLifecycle
Informazioni sul ciclo di vita.
Rappresentazione JSON |
---|
{ "deprecatedInFavorOf": [ string ], "scheduledToDeprecatePolicies": [ string ], "policyApiLifecycleStage": enum ( |
Campi | |
---|---|
deprecatedInFavorOf[] |
Nel caso in cui questo criterio venga ritirato a favore di un altro criterio, lo spazio dei nomi completo o gli spazi dei nomi completi dei nuovi criteri verranno visualizzati in PolicyAPI. Può essere impostato solo se policyApiLifecycleStage è API_DEPRECATED. |
scheduledToDeprecatePolicies[] |
Corrispondenti all'InFavorOf deprecato, uno o più spazi dei nomi completi dei criteri precedenti che verranno ritirati a causa dell'introduzione di questo criterio. |
policyApiLifecycleStage |
Indica la fase attuale del ciclo di vita dell'API dei criteri. |
description |
Descrizione del ciclo di vita attuale. |
endSupport |
Data di fine del supporto per le norme attuali. Il tentativo di modificare un criterio dopo la data di fine del supporto comporterà una richiesta errata (errore 400). Può essere impostato solo se policyApiLifecycleStage è API_DEPRECATED. |
PolicyApiLifecycleEnum
Fase del ciclo di vita dell'API dei criteri.
Enum | |
---|---|
API_UNSPECIFIED |
Il ciclo di vita dell'API dei criteri non è specificato. |
API_PREVIEW |
Le norme non funzionano ancora, ma avvisano gli sviluppatori sul formato. Questa fase può essere trasferita ad API_DEVELOPEMNT o API_CURRENT. |
API_DEVELOPMENT |
Il formato del criterio può essere modificato in un modo incompatibile con le versioni precedenti (modifica effettiva). Questa fase può essere trasferita ad API_CURRENT o API_DEPRECATED. Può essere utilizzato per i criteri lanciati solo per i TT o lanciati per clienti selezionati per l'uso di emergenza. |
API_CURRENT |
Norme in formato ufficiale. Il formato dei criteri può cambiare in modo compatibile con le versioni precedenti (modifica senza interruzioni). Esempio: questo criterio può introdurre un nuovo campo, che è considerato una modifica senza interruzioni, quando le maschere dei campi vengono utilizzate correttamente. Questa fase può essere trasferita ad API_DEPRECATED. |
API_DEPRECATED |
Non usare più questo criterio. Questo criterio è deprecato e potrebbe/verrà rimosso in futuro. Molto probabilmente è stata introdotta una nuova norma per sostituire questa. |
Data
Rappresenta una data di calendario intera o parziale, come un compleanno. L'ora del giorno e il fuso orario sono specificati altrove o non sono significativi. La data è relativa al calendario gregoriano. Può trattarsi di uno dei seguenti valori:
- Una data completa, con valori diversi da zero per anno, mese e giorno.
- Un mese e un giorno con zero anni (ad esempio, un anniversario).
- Un anno a sé stante, con uno zero mese e uno zero-day.
- Un anno e un mese, con zero day (ad esempio, la data di scadenza della carta di credito).
Tipi correlati:
google.type.TimeOfDay
google.type.DateTime
google.protobuf.Timestamp
Rappresentazione JSON |
---|
{ "year": integer, "month": integer, "day": integer } |
Campi | |
---|---|
year |
Anno della data. Il valore deve essere compreso tra 1 e 9999 oppure 0 per specificare una data senza anno. |
month |
Mese dell'anno. Il valore deve essere compreso tra 1 e 12 oppure 0 per specificare un anno senza mese e giorno. |
day |
Giorno di un mese. Deve essere compreso tra 1 e 31 e deve essere valido per l'anno e il mese oppure 0 per specificare un anno da solo o un anno e mese in cui il giorno non è significativo. |
Piattaforma
Questa è un'enumerazione dei diversi gruppi di piattaforme su cui è supportato Chrome.
Enum | |
---|---|
PLATFORM_UNSPECIFIED |
Piattaforma non specificata. |
CHROME_OS |
ChromeOS |
CHROME_BROWSER |
Browser Chrome per OSX/Windows/Linux. |
CHROME_BROWSER_FOR_ANDROID |
Browser Chrome per Android. |
CHROME_BROWSER_FOR_IOS |
Browser Chrome per iOS. |
Metodi |
|
---|---|
|
Ottieni uno schema di criteri specifico per un cliente in base al nome della risorsa. |
|
Restituisce un elenco di schemi di criteri che corrispondono a un valore di filtro specificato per un determinato cliente. |