REST Resource: projects.locations.phraseSets

리소스: PhraseSet

결과에서 특정 단어나 구문을 우선시하도록 음성 인식기에 '힌트'를 제공합니다.

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
}
필드
name

string

구문 세트의 리소스 이름입니다.
phrases[]

object (Phrase)

단어 및 구문 목록입니다.
boost

number

힌트 부스트. 양수 값을 사용하면 특정 구문이 발음이 유사한 다른 구문보다 인식될 가능성이 높아집니다. 부스트가 높을수록 거짓양성을 인식할 가능성도 높아집니다. 음수 부스트 값은 편향 방지에 해당합니다. 편향 방지가 사용 설정되어 있지 않으므로 음수 부스트는 무시됩니다. boost는 다양한 양수 값을 허용하지만 대부분의 사용 사례에서는 0 초과 20 이하의 값을 사용하는 것이 가장 좋습니다. 바이너리 검색 방식을 사용하여 사용 사례의 최적값을 찾고 요청에 부스트 유무에 관계없이 구문을 추가하는 것이 좋습니다.
kmsKeyName

string

출력 전용입니다. PhraseSet의 콘텐츠가 암호화되는 KMS 키 이름입니다. 예상되는 형식은 projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}입니다.
kmsKeyVersionName

string

출력 전용입니다. PhraseSet의 콘텐츠가 암호화되는 KMS 키 버전 이름입니다. 예상되는 형식은 projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}/cryptoKeyVersions/{crypto_key_version}입니다.
uid

string

출력 전용입니다. PhraseSet에 대해 시스템에서 할당된 고유 식별자입니다. 이 필드는 사용되지 않습니다.
displayName

string

출력 전용입니다. 사용자가 설정할 수 있고 인간이 읽을 수 있는 PhraseSet 이름입니다. 63자(영문 기준) 이하여야 합니다. 이 필드는 사용되지 않습니다.
state

enum (State)

출력 전용입니다. CustomClass 수명 주기 상태입니다. 이 필드는 사용되지 않습니다.
deleteTime

string (Timestamp format)

출력 전용입니다. 이 리소스 삭제가 요청된 시간입니다. 이 필드는 사용되지 않습니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
expireTime

string (Timestamp format)

출력 전용입니다. 이 리소스가 삭제될 시간입니다. 이 필드는 사용되지 않습니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
annotations

map (key: string, value: string)

출력 전용입니다. 사용자가 소량의 임의 데이터를 저장할 수 있습니다. 키와 값이 각각 63자(영문 기준) 이하여야 합니다. 주석은 최대 100개입니다. 이 필드는 사용되지 않습니다.

"key": value 쌍 목록을 포함하는 객체입니다. 예: { "name": "wrench", "mass": "1.3kg", "count": "3" }
etag

string

출력 전용입니다. 이 체크섬은 다른 필드 값을 기준으로 서버에서 계산됩니다. 진행하기 전 클라이언트에 최신 값이 포함되었는지 확인하기 위해 업데이트, 삭제 취소, 삭제 요청 시에 전송될 수 있습니다. 이 필드는 사용되지 않습니다.
reconciling

boolean

출력 전용입니다. 이 PhraseSet가 업데이트되는 중인지 여부입니다. 이 필드는 사용되지 않습니다.

구문

음성 인식에서 인식할 수 있도록 단어 및 구문 '힌트'가 포함된 구문입니다. 예를 들어 사용자가 특정 명령을 자주 사용하는 경우 해당 단어와 구문의 정확성을 높이는 데 사용할 수 있습니다. 인식기의 어휘에 단어를 추가하는 데 사용할 수도 있습니다. 사용량 한도를 참조하세요.

목록 항목에는 자연어에서 발생하는 일반적인 개념을 나타내는 단어 그룹이 포함된 사전 빌드된 클래스 또는 맞춤 클래스도 포함될 수 있습니다. 예를 들어 연중 각 월에 대한 구문 힌트를 제공하는 대신 (예: 'i was born in january', 'i was born in febuary', ...) 사전 빌드된 $MONTH 클래스를 사용하면 월이 포함된 오디오 (예: 'i was born in $month')를 올바르게 변환할 가능성이 높아집니다. 사전 빌드된 클래스를 참조하려면 $가 앞에 붙은 클래스 기호를 사용하세요(예: $MONTH). 요청에 인라인으로 정의된 맞춤 클래스를 참조하려면 클래스의 customClassId을 모든 클래스 리소스와 인라인 클래스에 고유한 문자열로 설정합니다. 그런 다음 ${...}로 래핑된 클래스의 ID를 사용합니다(예: '${my-months}'). 맞춤 클래스 리소스를 참조하려면 ${}로 래핑된 클래스의 ID를 사용합니다 (예: ${my-months}).

Speech-to-Text는 global, us (미국 북미), eu (유럽)의 세 위치를 지원합니다. speech.googleapis.com 엔드포인트를 호출하는 경우 global 위치를 사용합니다. 리전을 지정하려면 일치하는 us 또는 eu 위치 값이 있는 리전 엔드포인트를 사용하세요.

JSON 표현 
{
  "value": string,
  "boost": number
}
필드
value

string

구문 자체입니다.
boost

number

힌트 부스트. 구문 집합 수준에서 부스트 집합을 재정의합니다. 양수 값을 사용하면 특정 구문이 발음이 유사한 다른 구문보다 인식될 가능성이 높아집니다. 부스트가 높을수록 거짓양성을 인식할 가능성도 높아집니다. 음수 부스팅은 무시됩니다. boost는 다양한 양수 값을 허용하지만 대부분의 사용 사례에서는 0~20 사이의 값을 사용하는 것이 가장 좋습니다. 바이너리 검색 방식을 사용하여 사용 사례의 최적값을 찾고 요청에 부스트 유무에 관계없이 구문을 추가하는 것이 좋습니다.

주

CustomClass의 수명 주기를 정의하는 상태 집합입니다.

열거형
STATE_UNSPECIFIED 지정되지 않은 상태. 설정되지 않은 값을 구별하는 데만 사용되며 유용합니다.
ACTIVE 정상 및 활성 상태.
DELETED 이 CustomClass가 삭제되었습니다.

메서드

create

 구문 힌트 세트를 만듭니다.

delete

 구문 세트를 삭제합니다.

get

 구문 세트를 가져옵니다.

list

 구문 세트를 나열합니다.

patch

 구문 세트를 업데이트합니다.