REST Resource: projects.locations.phraseSets

Ressource : PhraseSet

Fournit des "indices" à l'outil de reconnaissance vocale pour privilégier certains mots et expressions dans les résultats.

Représentation 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
}
Champs
name

string

Nom de ressource de l'ensemble de phrases.

phrases[]

object (Phrase)

Une liste de mots et d'expressions.

boost

number

Boost d'indices Une valeur positive augmentera la probabilité qu'une expression spécifique soit reconnue par rapport à d'autres expressions similaires. Plus le boost est élevé, plus le risque de faux positif est élevé. Les valeurs de boost négatives correspondent à l'anti-biais. L'anti-biais n'est pas activé. Le boost négatif sera donc ignoré. Bien que boost puisse accepter un large éventail de valeurs positives, la plupart des cas d'utilisation sont mieux adaptés aux valeurs comprises entre 0 (exclus) et 20. Nous vous recommandons d'utiliser une approche de recherche binaire pour trouver la valeur optimale pour votre cas d'utilisation, ainsi que d'ajouter des expressions avec et sans boost à vos requêtes.

kmsKeyName

string

Uniquement en sortie. Nom de la clé KMS avec laquelle le contenu de PhraseSet est chiffré. Le format attendu est projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}.

kmsKeyVersionName

string

Uniquement en sortie. Nom de la version de clé KMS avec laquelle le contenu de PhraseSet est chiffré. Le format attendu est projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}/cryptoKeyVersions/{crypto_key_version}.

uid

string

Uniquement en sortie. Identifiant unique attribué par le système pour le PhraseSet. Ce champ n'est pas utilisé.

displayName

string

Uniquement en sortie. Nom lisible et défini par l'utilisateur pour l'objet PhraseSet. L'ID ne doit pas contenir plus de 63 caractères Ce champ n'est pas utilisé.

state

enum (State)

Uniquement en sortie. État du cycle de vie de l'objet CustomClass. Ce champ n'est pas utilisé.

deleteTime

string (Timestamp format)

Uniquement en sortie. Heure à laquelle la suppression de cette ressource a été demandée. Ce champ n'est pas utilisé.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

expireTime

string (Timestamp format)

Uniquement en sortie. Heure à laquelle cette ressource sera supprimée. Ce champ n'est pas utilisé.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

annotations

map (key: string, value: string)

Uniquement en sortie. Permet aux utilisateurs de stocker de petites quantités de données arbitraires. La clé et la valeur ne doivent pas comporter plus de 63 caractères chacune. 100 annotations au maximum. Ce champ n'est pas utilisé.

Objet contenant une liste de paires "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.

etag

string

Uniquement en sortie. Cette somme de contrôle est calculée par le serveur en fonction de la valeur des autres champs. Peut être envoyé lors des requêtes de mise à jour, de restauration et de suppression pour s'assurer que le client dispose d'une valeur à jour avant de continuer. Ce champ n'est pas utilisé.

reconciling

boolean

Uniquement en sortie. Indique si cet objet PhraseSet est en cours de mise à jour. Ce champ n'est pas utilisé.

Expression

Phrases contenant des mots et des expressions qui fournissent des indications afin que la reconnaissance vocale soit plus susceptible de les reconnaître. Cette liste permet d'améliorer la précision de certains termes et phrases, notamment dans des commandes spécifiques généralement prononcées par l'utilisateur. Elle offre également la possibilité d'ajouter des mots supplémentaires au vocabulaire de l'outil de reconnaissance. Consultez les limites d'utilisation pour en savoir plus.

Les éléments de liste peuvent également inclure des classes prédéfinies ou personnalisées contenant des groupes de mots qui représentent des concepts courants apparaissant dans le langage naturel. Par exemple, plutôt que de fournir un indice de phrase pour chaque mois de l'année (par exemple, "je suis né en janvier", "je suis né en février", etc.), l'utilisation de la classe $MONTH prédéfinie augmente la probabilité de transcrire correctement les contenus audio comprenant des mois (par exemple, "je suis né en $month"). Pour faire référence à des classes prédéfinies, utilisez le symbole de la classe précédé de $ (par exemple, $MONTH). Pour faire référence à des classes personnalisées définies de manière intégrée dans la requête, définissez le customClassId de la classe sur une chaîne unique pour toutes les ressources de classe et les classes intégrées. Utilisez ensuite l'ID de la classe entre ${...}, par exemple "${my-months}". Pour faire référence à des ressources de classes personnalisées, utilisez l'ID de la classe entre ${} (par exemple, ${my-months}).

Speech-to-Text est compatible avec trois régions : global, us (Amérique du Nord) et eu (Europe). Si vous appelez le point de terminaison speech.googleapis.com, utilisez l'emplacement global. Pour spécifier une région, utilisez un point de terminaison régional avec une valeur d'emplacement us ou eu correspondante.

Représentation JSON
{
  "value": string,
  "boost": number
}
Champs
value

string

L'expression elle-même.

boost

number

Boost d'indices Remplace l'amélioration définie au niveau de l'ensemble d'expressions. Une valeur positive augmentera la probabilité qu'une expression spécifique soit reconnue par rapport à d'autres expressions similaires. Plus le boost est élevé, plus le risque de faux positif est élevé. Le boosting négatif sera simplement ignoré. Bien que boost puisse accepter un large éventail de valeurs positives, la plupart des cas d'utilisation sont mieux adaptés aux valeurs comprises entre 0 et 20. Nous vous recommandons d'utiliser une approche de recherche binaire pour trouver la valeur optimale pour votre cas d'utilisation, ainsi que d'ajouter des expressions avec et sans boost à vos requêtes.

État

Ensemble d'états qui définissent le cycle de vie d'un objet CustomClass.

Enums
STATE_UNSPECIFIED État non spécifié. Cette valeur n'est utilisée/utile que pour distinguer les valeurs non définies.
ACTIVE État normal et actif.
DELETED Cet objet CustomClass a été supprimé.

Méthodes

create

Créez un ensemble d'indices de phrases.

delete

Supprimer un ensemble de phrases

get

Obtenez un ensemble de phrases.

list

Lister les ensembles de phrases.

patch

Mettez à jour un ensemble de phrases.