REST Resource: schemas

Risorsa: schema

Il tipo di risorsa API. Per le risorse dello schema, il valore è sempre admin#directory#schema.

Rappresentazione JSON
{
  "schemaId": string,
  "schemaName": string,
  "fields": [
    {
      object (SchemaFieldSpec)
    }
  ],
  "displayName": string,
  "kind": string,
  "etag": string
}
Campi
schemaId

string

L'identificatore univoco dello schema (sola lettura)

schemaName

string

Il nome dello schema.

Ogni schemaName deve essere univoco all'interno di un cliente. Il riutilizzo di un nome genera un errore 409: Entity already exists.

fields[]

object (SchemaFieldSpec)

Un elenco di campi nello schema.

displayName

string

Nome visualizzato per lo schema.

kind

string

Il tipo di risorsa.

etag

string

L'ETag della risorsa.

SchemaFieldSpec

Puoi utilizzare gli schemi per aggiungere campi personalizzati ai profili utente. Puoi utilizzare questi campi per archiviare informazioni quali i progetti su cui lavorano gli utenti, le loro sedi fisiche, le date di assunzione o qualsiasi altra informazione adatta alle esigenze della tua attività. Per ulteriori informazioni, consulta Campi utente personalizzati.

Rappresentazione JSON
{
  "fieldName": string,
  "fieldId": string,
  "fieldType": string,
  "multiValued": boolean,
  "kind": string,
  "etag": string,
  "indexed": boolean,
  "displayName": string,
  "readAccessType": string,
  "numericIndexingSpec": {
    "minValue": number,
    "maxValue": number
  }
}
Campi
fieldName

string

Il nome del campo.

fieldId

string

L'identificatore univoco del campo (sola lettura)

fieldType

string

Il tipo di campo.

I valori accettabili sono:

  • BOOL: valori booleani.
  • DATE: date in formato ISO-8601.
  • DOUBLE: valori a virgola mobile a precisione doppia.
  • EMAIL: indirizzi email.
  • INT64: valori interi a 64 bit.
  • PHONE: numeri di telefono.
  • STRING: valori di stringa.
multiValued

boolean

Un valore booleano che specifica se si tratta o meno di un campo a più valori. Valore predefinito: false.

kind

string

Il tipo di risorsa è. Per i campi dello schema è sempre admin#directory#schema#fieldspec.

etag

string

L'ETag del campo.

indexed

boolean

Valore booleano che specifica se il campo è indicizzato o meno. Valore predefinito: true.

displayName

string

Nome visualizzato del campo.

readAccessType

string

Specifica chi può visualizzare i valori di questo campo. Per ulteriori informazioni, vedi Recuperare gli utenti come utente non amministratore.

Nota: potrebbero essere necessarie fino a 24 ore prima che le modifiche a questo campo vengano applicate.

I valori accettabili sono:

  • ADMINS_AND_SELF: solo gli amministratori e l'utente associato possono vedere i valori.
  • ALL_DOMAIN_USERS: qualsiasi utente del tuo dominio può vedere i valori.
numericIndexingSpec

object

Specifiche di indicizzazione per un campo numerico. Per impostazione predefinita, per i campi numerici saranno supportate solo le query con corrispondenza esatta. L'impostazione di numericIndexingSpec consente di supportare le query sull'intervallo.

numericIndexingSpec.minValue

number

Valore minimo di questo campo. Questo è indicativo anziché applicato in modo forzato. I valori al di fuori di questo intervallo verranno comunque indicizzati, ma la ricerca potrebbe non essere altrettanto efficace.

numericIndexingSpec.maxValue

number

Valore massimo di questo campo. Questo è indicativo anziché applicato in modo forzato. I valori al di fuori di questo intervallo verranno comunque indicizzati, ma la ricerca potrebbe non essere altrettanto efficace.

Metodi

delete

Consente di eliminare uno schema.

get

Recupera uno schema.

insert

Crea uno schema.

list

Recupera tutti gli schemi per un cliente.

patch

Applica patch a uno schema.

update

Aggiorna uno schema.