REST Resource: projects.locations.phraseSets

Risorsa: PhraseSet

Fornisce al riconoscimento vocale "suggerimenti" che privilegiano parole e frasi specifiche nei risultati.

Rappresentazione JSON 
{
  "name": string,
  "phrases": [
    {
      object (Phrase)
    }
  ],
  "boost": number,
  "kmsKeyName": string,
  "kmsKeyVersionName": string,
  "uid": string,
  "displayName": string,
  "state": enum (State),
  "deleteTime": string,
  "expireTime": string,
  "annotations": {
    string: string,
    ...
  },
  "etag": string,
  "reconciling": boolean
}
Campi
name

string

Il nome della risorsa del set di frasi.
phrases[]

object (Phrase)

Un elenco di parole e frasi.
boost

number

Suggerimento potenziato. Un valore positivo aumenterà la probabilità che una frase specifica venga riconosciuta rispetto ad altre frasi dal suono simile. Più alto è l'incremento, maggiore è la probabilità di un falso positivo. I valori di boosting negativi corrispondono all'anti-bias. L'anti-bias non è attivato, quindi il boost negativo verrà semplicemente ignorato. Sebbene boost possa accettare un'ampia gamma di valori positivi, la maggior parte dei casi d'uso è meglio servita con valori compresi tra 0 (escluso) e 20. Ti consigliamo di utilizzare un approccio di ricerca binaria per trovare il valore ottimale per il tuo caso d'uso, nonché di aggiungere frasi con e senza boost alle tue richieste.
kmsKeyName

string

Solo output. Il nome della chiave KMS con cui viene criptato il contenuto di PhraseSet. Il formato previsto è projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}.
kmsKeyVersionName

string

Solo output. Il nome della versione della chiave KMS con cui viene criptato il contenuto di PhraseSet. Il formato previsto è projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}/cryptoKeyVersions/{crypto_key_version}.
uid

string

Solo output. Identificatore univoco assegnato dal sistema per il PhraseSet. Questo campo non viene utilizzato.
displayName

string

Solo output. Nome leggibile e impostabile dall'utente per il PhraseSet. Deve contenere al massimo 63 caratteri. Questo campo non viene utilizzato.
state

enum (State)

Solo output. Lo stato del ciclo di vita di CustomClass. Questo campo non viene utilizzato.
deleteTime

string (Timestamp format)

Solo output. L'ora in cui è stata richiesta l'eliminazione di questa risorsa. Questo campo non viene utilizzato.

Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
expireTime

string (Timestamp format)

Solo output. L'ora in cui verrà eliminata questa risorsa. Questo campo non viene utilizzato.

Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
annotations

map (key: string, value: string)

Solo output. Consente agli utenti di memorizzare piccole quantità di dati arbitrari. Sia la chiave che il valore devono contenere al massimo 63 caratteri ciascuno. Al massimo 100 annotazioni. Questo campo non viene utilizzato.

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }
etag

string

Solo output. Questo checksum viene calcolato dal server in base al valore di altri campi. Questo valore può essere inviato nelle richieste di aggiornamento, ripristino ed eliminazione per garantire che il client disponga di un valore aggiornato prima di procedere. Questo campo non viene utilizzato.
reconciling

boolean

Solo output. Indica se questo PhraseSet è in fase di aggiornamento. Questo campo non viene utilizzato.

Frase

Una frase contenente "suggerimenti" di parole e frasi, in modo che il riconoscimento vocale abbia più probabilità di riconoscerle. Può essere utilizzata per migliorare l'accuratezza di parole e frasi specifiche, ad esempio se l'utente pronuncia in genere comandi specifici. Può essere utilizzato anche per aggiungere altre parole al vocabolario del sistema di riconoscimento. Vedi i limiti di utilizzo.

Gli elementi dell'elenco possono includere anche classi predefinite o personalizzate contenenti gruppi di parole che rappresentano concetti comuni che si verificano nel linguaggio naturale. Ad esempio, anziché fornire un suggerimento di frase per ogni mese dell'anno (ad es. "i was born in january", "i was born in febuary"...), l'utilizzo della classe $MONTH predefinita aumenta la probabilità di trascrivere correttamente l'audio che include i mesi (ad es. "i was born in $month"). Per fare riferimento alle classi predefinite, utilizza il simbolo della classe preceduto da $, ad esempio $MONTH. Per fare riferimento alle classi personalizzate definite inline nella richiesta, imposta customClassId della classe su una stringa univoca per tutte le risorse della classe e le classi inline. Poi utilizza l'ID della classe racchiuso tra ${...}, ad es. "${my-months}". Per fare riferimento alle risorse delle classi personalizzate, utilizza l'ID della classe racchiuso tra ${} (ad es. ${my-months}).

Speech-to-Text supporta tre località: global, us (Nord America) e eu (Europa). Se chiami l'endpoint speech.googleapis.com, utilizza la posizione global. Per specificare una regione, utilizza un endpoint regionale con un valore di località us o eu corrispondente.

Rappresentazione JSON 
{
  "value": string,
  "boost": number
}
Campi
value

string

La frase stessa.
boost

number

Suggerimento potenziato. Sostituisce il boost impostato a livello di set di frasi. Un valore positivo aumenterà la probabilità che una frase specifica venga riconosciuta rispetto ad altre frasi dal suono simile. Più alto è l'incremento, maggiore è la probabilità di un falso positivo. Il boosting negativo verrà semplicemente ignorato. Sebbene boost possa accettare un'ampia gamma di valori positivi, la maggior parte dei casi d'uso è meglio servita con valori compresi tra 0 e 20. Ti consigliamo di utilizzare un approccio di ricerca binaria per trovare il valore ottimale per il tuo caso d'uso, nonché di aggiungere frasi con e senza boost alle tue richieste.

Stato

Insieme di stati che definiscono il ciclo di vita di una CustomClass.

Enum
STATE_UNSPECIFIED Stato non specificato. Questo valore viene utilizzato/è utile solo per distinguere i valori non impostati.
ACTIVE Lo stato normale e attivo.
DELETED Questa CustomClass è stata eliminata.

Metodi

create

 Crea un insieme di suggerimenti per le frasi.

delete

 Elimina un set di frasi.

get

 Ottieni un set di frasi.

list

 Elenca i set di frasi.

patch

 Aggiornare un set di frasi.