REST Resource: projects.locations.phraseSets

Ressource: PhraseSet

Liefert dem Spracherkennungsmodul "Hinweise" für bestimmte Wörter und Wendungen, die bei den Ergebnissen zu bevorzugen sind.

JSON-Darstellung 
{
  "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
}
Felder
name

string

Der Ressourcenname des Wortgruppensatzes.
phrases[]

object (Phrase)

Eine Liste mit Wörtern und Wortgruppen.
boost

number

Hinweis-Boost Ein positiver Wert erhöht die Wahrscheinlichkeit, dass eine bestimmte Wortgruppe gegenüber anderen ähnlich klingenden Wortgruppen erkannt wird. Je höher der Boost, desto höher ist auch die Wahrscheinlichkeit einer fälschlichen Erkennung. Negative Boost-Werte entsprechen der Anti-Bias-Funktion. Die Funktion zur Vermeidung von Bias ist nicht aktiviert. Der negative Boost wird daher einfach ignoriert. boost kann zwar eine Vielzahl positiver Werte annehmen, für die meisten Anwendungsfälle sind jedoch Werte zwischen 0 (ausschließlich) und 20 am besten geeignet. Wir empfehlen, den optimalen Wert für Ihren Anwendungsfall mithilfe einer binären Suche zu ermitteln und Ihren Anfragen sowohl Begriffe mit als auch ohne Steigerung hinzuzufügen.
kmsKeyName

string

Nur Ausgabe. Der KMS-Schlüsselname, mit dem der Inhalt des PhraseSets verschlüsselt wird. Das erwartete Format ist projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}.
kmsKeyVersionName

string

Nur Ausgabe. Der Name der KMS-Schlüsselversion, mit der der Inhalt des PhraseSets verschlüsselt wird. Das erwartete Format ist projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}/cryptoKeyVersions/{crypto_key_version}.
uid

string

Nur Ausgabe. Vom System zugewiesene eindeutige Kennung für das PhraseSet. Dieses Feld wird nicht verwendet.
displayName

string

Nur Ausgabe. Vom Nutzer festlegbarer, für Menschen lesbarer Name für den PhraseSet. Darf höchstens 63 Zeichen lang sein. Dieses Feld wird nicht verwendet.
state

enum (State)

Nur Ausgabe. Der Lebenszyklusstatus der CustomClass. Dieses Feld wird nicht verwendet.
deleteTime

string (Timestamp format)

Nur Ausgabe. Der Zeitpunkt, zu dem das Löschen dieser Ressource angefordert wurde. Dieses Feld wird nicht verwendet.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
expireTime

string (Timestamp format)

Nur Ausgabe. Der Zeitpunkt, zu dem diese Ressource gelöscht wird. Dieses Feld wird nicht verwendet.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
annotations

map (key: string, value: string)

Nur Ausgabe. Ermöglicht Nutzern das Speichern kleiner Mengen beliebiger Daten. Sowohl der Schlüssel als auch der Wert dürfen jeweils maximal 63 Zeichen lang sein. Maximal 100 Annotationen. Dieses Feld wird nicht verwendet.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
etag

string

Nur Ausgabe. Diese Prüfsumme wird vom Server auf Grundlage des Werts anderer Felder berechnet. Kann bei Aktualisierungs-, Wiederherstellungs- und Löschanfragen gesendet werden, um sicherzustellen, dass der Client vor dem Fortfahren einen aktuellen Wert hat. Dieses Feld wird nicht verwendet.
reconciling

boolean

Nur Ausgabe. Gibt an, ob dieses PhraseSet gerade aktualisiert wird. Dieses Feld wird nicht verwendet.

Wortgruppe

Eine Liste von Strings, die Wörter und Wortgruppen "Hinweise" enthalten, damit die Spracherkennung sie mit größerer Wahrscheinlichkeit erkennt. Kann zur Verbesserung der Genauigkeit für bestimmte Wörter und Wendungen verwendet werden, z. B. wenn der Nutzer bestimmte Befehle häufig spricht. Lässt sich ebenfalls verwenden, um weitere Wörter zum Vokabular des Erkennungsmoduls hinzuzufügen. Siehe Nutzungsbeschränkungen.

Listenelemente können auch vordefinierte oder benutzerdefinierte Klassen mit Wortgruppen enthalten, die gängige Konzepte in natürlicher Sprache darstellen. Anstatt beispielsweise für jeden Monat des Jahres einen Hinweis auf einen Ausdruck zu geben (z. B. „Ich wurde im Januar geboren“, „Ich wurde im Februar geboren“ usw.), können Sie die vordefinierte Klasse $MONTH verwenden. Dadurch wird die Wahrscheinlichkeit erhöht, dass Audioinhalte, in denen Monate vorkommen (z. B. „Ich wurde im $month geboren“), richtig transkribiert werden. Wenn Sie auf vordefinierte Klassen verweisen möchten, verwenden Sie das Symbol der Klasse mit dem Präfix $, z.B. $MONTH. Wenn Sie auf benutzerdefinierte Klassen verweisen möchten, die inline in der Anfrage definiert wurden, legen Sie customClassId der Klasse auf einen String fest, der für alle Klassenressourcen und Inline-Klassen eindeutig ist. Verwenden Sie dann die ID der Klasse, die in ${...} eingeschlossen ist, z.B. „${my-months}“. Wenn Sie auf benutzerdefinierte Klassenressourcen verweisen möchten, verwenden Sie die ID der Klasse, die in ${} eingeschlossen ist, z.B. ${my-months}.

Speech-to-Text unterstützt drei Standorte: global, us (Nordamerika, USA) und eu (Europa). Wenn Sie den Endpunkt speech.googleapis.com aufrufen, verwenden Sie den Speicherort global. Wenn Sie eine Region angeben möchten, verwenden Sie einen regionalen Endpunkt mit dem entsprechenden us- oder eu-Standortwert.

JSON-Darstellung 
{
  "value": string,
  "boost": number
}
Felder
value

string

Die Wortgruppe selbst.
boost

number

Hinweis-Boost Überschreibt die Optimierung, die auf Wortgruppensatzebene festgelegt ist. Ein positiver Wert erhöht die Wahrscheinlichkeit, dass eine bestimmte Wortgruppe gegenüber anderen ähnlich klingenden Wortgruppen erkannt wird. Je höher der Boost, desto höher ist auch die Wahrscheinlichkeit einer fälschlichen Erkennung. Negatives Boosting wird einfach ignoriert. Für boost kann eine Vielzahl positiver Werte verwendet werden. In den meisten Anwendungsfällen sind jedoch Werte zwischen 0 und 20 am besten geeignet. Wir empfehlen, den optimalen Wert für Ihren Anwendungsfall mithilfe einer binären Suche zu ermitteln und Ihren Anfragen sowohl Begriffe mit als auch ohne Steigerung hinzuzufügen.

Bundesland

Eine Reihe von Status, die den Lebenszyklus einer CustomClass definieren.

Enums
STATE_UNSPECIFIED Nicht angegebener Zustand. Dies wird nur verwendet, um nicht festgelegte Werte zu unterscheiden.
ACTIVE Der normale und der aktive Status.
DELETED Diese CustomClass wurde gelöscht.

Methoden

create

 Erstellen Sie eine Reihe von Wortgruppen-Hinweisen.

delete

 Wortgruppensatz löschen

get

 Wortgruppensatz abrufen.

list

 Wortgruppensätze auflisten

patch

 Wortgruppensatz aktualisieren