REST Resource: projects.locations.phraseSets

리소스: PhraseSet

음성 인식에 편향을 적용할 PhraseSet입니다. PhraseSet는 결과에 특정 단어 및 구문이 표시되도록 음성 인식기에 '힌트'를 제공하는 데 사용됩니다.

JSON 표현 
{
  "name": string,
  "uid": string,
  "phrases": [
    {
      object (Phrase)
    }
  ],
  "boost": number,
  "displayName": string,
  "state": enum (State),
  "createTime": string,
  "updateTime": string,
  "deleteTime": string,
  "expireTime": string,
  "annotations": {
    string: string,
    ...
  },
  "etag": string,
  "reconciling": boolean,
  "kmsKeyName": string,
  "kmsKeyVersionName": string
}
필드
name

string

출력 전용입니다. 식별자. PhraseSet의 리소스 이름입니다. 형식은 projects/{project}/locations/{location}/phraseSets/{phraseSet}입니다.
uid

string

출력 전용입니다. PhraseSet에 대해 시스템에서 할당된 고유 식별자입니다.
phrases[]

object (Phrase)

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

number

힌트 부스트. 양수 값을 사용하면 특정 구문이 발음이 유사한 다른 구문보다 인식될 가능성이 높아집니다. 부스트가 높을수록 거짓양성을 인식할 가능성도 높아집니다. 유효한 boost 값은 0 초과 20 이하입니다. 바이너리 검색 방식을 사용하여 사용 사례의 최적값을 찾고 요청에 부스트 유무에 관계없이 구문을 추가하는 것이 좋습니다.
displayName

string

사용자가 설정할 수 있고 인간이 읽을 수 있는 PhraseSet 이름입니다. 63자(영문 기준) 이하여야 합니다.
state

enum (State)

출력 전용입니다. PhraseSet 수명 주기 상태입니다.
createTime

string (Timestamp format)

출력 전용입니다. 생성 시간입니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.
updateTime

string (Timestamp format)

출력 전용입니다. 이 리소스가 수정된 가장 최근 시간입니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.
deleteTime

string (Timestamp format)

출력 전용입니다. 이 리소스 삭제가 요청된 시간입니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.
expireTime

string (Timestamp format)

출력 전용입니다. 이 리소스가 삭제될 시간입니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.
annotations

map (key: string, value: string)

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

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

string

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

boolean

출력 전용입니다. 이 PhraseSet가 업데이트되는 중인지 여부입니다.
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}입니다.

구문

구문에는 단어 및 구문 '힌트'가 포함되므로 음성 인식에서 이를 인식할 가능성이 높아집니다. 예를 들어 사용자가 특정 명령을 자주 사용하는 경우 해당 단어와 구문의 정확성을 높이는 데 사용할 수 있습니다. 인식기의 어휘에 단어를 추가하는 데 사용할 수도 있습니다.

목록 항목에는 자연어에서 발생하는 일반적인 개념을 나타내는 단어 그룹이 포함된 CustomClass 참조도 포함될 수 있습니다.

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

string

구문 자체입니다.
boost

number

힌트 부스트. 구문 집합 수준에서 부스트 집합을 재정의합니다. 양수 값을 사용하면 특정 구문이 발음이 유사한 다른 구문보다 인식될 가능성이 높아집니다. 부스트가 높을수록 거짓양성을 인식할 가능성도 높아집니다. 음수 부스트 값은 편향 방지에 해당합니다. 편향 방지가 사용 설정되어 있지 않으므로 음수 부스트 값은 오류를 반환합니다. 부스트 값은 0~20 사이여야 합니다. 이 범위를 벗어나는 값은 오류를 반환합니다. 바이너리 검색 방식을 사용하여 사용 사례의 최적값을 찾고 요청에 부스트 유무에 관계없이 구문을 추가하는 것이 좋습니다.

상태

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

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

방법

create

 PhraseSet를 만듭니다.

delete

 PhraseSet를 삭제합니다.

get

 요청된 PhraseSet를 반환합니다.

list

 PhraseSets를 나열합니다.

patch

 PhraseSet를 업데이트합니다.

undelete

 PhraseSet를 삭제 취소합니다.