OperationMetadata

장기 실행 작업의 메타데이터를 나타냅니다.

JSON 표현
{
  "createTime": string,
  "updateTime": string,
  "resource": string,
  "method": string,
  "kmsKeyName": string,
  "kmsKeyVersionName": string,
  "progressPercent": integer,

  // Union field request can be only one of the following:
  "batchRecognizeRequest": {
    object (BatchRecognizeRequest)
  },
  "createRecognizerRequest": {
    object (CreateRecognizerRequest)
  },
  "updateRecognizerRequest": {
    object (UpdateRecognizerRequest)
  },
  "deleteRecognizerRequest": {
    object (DeleteRecognizerRequest)
  },
  "undeleteRecognizerRequest": {
    object (UndeleteRecognizerRequest)
  },
  "createCustomClassRequest": {
    object (CreateCustomClassRequest)
  },
  "updateCustomClassRequest": {
    object (UpdateCustomClassRequest)
  },
  "deleteCustomClassRequest": {
    object (DeleteCustomClassRequest)
  },
  "undeleteCustomClassRequest": {
    object (UndeleteCustomClassRequest)
  },
  "createPhraseSetRequest": {
    object (CreatePhraseSetRequest)
  },
  "updatePhraseSetRequest": {
    object (UpdatePhraseSetRequest)
  },
  "deletePhraseSetRequest": {
    object (DeletePhraseSetRequest)
  },
  "undeletePhraseSetRequest": {
    object (UndeletePhraseSetRequest)
  },
  "updateConfigRequest": {
    object (UpdateConfigRequest)
  }
  // End of list of possible types for union field request.

  // Union field metadata can be only one of the following:
  "batchRecognizeMetadata": {
    object (BatchRecognizeMetadata)
  }
  // End of list of possible types for union field metadata.
}
필드
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"입니다.

resource

string

작업 대상의 리소스 경로입니다.

method

string

작업을 트리거한 메서드입니다.

kmsKeyName

string

작업 콘텐츠가 암호화되는 KMS 키 이름입니다. 예상되는 형식은 projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{crypto_key}입니다.

kmsKeyVersionName

string

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

progressPercent

integer

작업의 진행률입니다. 값 범위는 0~100입니다. 값이 100이면 작업이 완료된 것입니다.

통합 필드 request. 작업을 생성한 요청입니다. request는 다음 중 하나여야 합니다.
batchRecognizeRequest

object (BatchRecognizeRequest)

작업을 생성한 BatchRecognizeRequest입니다.

createRecognizerRequest

object (CreateRecognizerRequest)

작업을 생성한 CreateRecognizerRequest입니다.

updateRecognizerRequest

object (UpdateRecognizerRequest)

작업을 생성한 UpdateRecognizerRequest입니다.

deleteRecognizerRequest

object (DeleteRecognizerRequest)

작업을 생성한 DeleteRecognizerRequest입니다.

undeleteRecognizerRequest

object (UndeleteRecognizerRequest)

작업을 생성한 UndeleteRecognizerRequest입니다.

createCustomClassRequest

object (CreateCustomClassRequest)

작업을 생성한 CreateCustomClassRequest입니다.

updateCustomClassRequest

object (UpdateCustomClassRequest)

작업을 생성한 UpdateCustomClassRequest입니다.

deleteCustomClassRequest

object (DeleteCustomClassRequest)

작업을 생성한 DeleteCustomClassRequest입니다.

undeleteCustomClassRequest

object (UndeleteCustomClassRequest)

작업을 생성한 UndeleteCustomClassRequest입니다.

createPhraseSetRequest

object (CreatePhraseSetRequest)

작업을 생성한 CreatePhraseSetRequest입니다.

updatePhraseSetRequest

object (UpdatePhraseSetRequest)

작업을 생성한 UpdatePhraseSetRequest입니다.

deletePhraseSetRequest

object (DeletePhraseSetRequest)

작업을 생성한 DeletePhraseSetRequest입니다.

undeletePhraseSetRequest

object (UndeletePhraseSetRequest)

작업을 생성한 UndeletePhraseSetRequest입니다.

updateConfigRequest
(deprecated)

object (UpdateConfigRequest)

작업을 생성한 UpdateConfigRequest입니다.

통합 필드 metadata. RPC당 특정 메타데이터입니다. metadata는 다음 중 하나여야 합니다.
batchRecognizeMetadata

object (BatchRecognizeMetadata)

recognizers.batchRecognize 메서드와 관련된 메타데이터입니다.

UpdateConfigRequest

config.update 메서드에 대한 요청 메시지입니다.

JSON 표현
{
  "config": {
    object (Config)
  },
  "updateMask": string
}
필드
config

object (Config)

필수 항목입니다. 업데이트할 구성입니다.

구성의 name 필드는 업데이트할 구성을 식별하는 데 사용됩니다. 예상되는 형식은 projects/{project}/locations/{location}/config입니다.

updateMask

string (FieldMask format)

업데이트할 필드 목록입니다.

정규화된 필드 이름의 쉼표로 구분된 목록입니다. 예: "user.displayName,photo"

CreateCustomClassRequest

CreateCustomClass 메서드에 대한 요청 메시지입니다.

JSON 표현
{
  "customClass": {
    object (CustomClass)
  },
  "validateOnly": boolean,
  "customClassId": string,
  "parent": string
}
필드
customClass

object (CustomClass)

필수 항목입니다. 만들 CustomClass입니다.

validateOnly

boolean

설정한 경우 요청을 검증하고 CustomClass를 미리 봅니다. 하지만 실제로 만들지는 않습니다.

customClassId

string

CustomClass에 사용할 ID이며, CustomClass의 리소스 이름의 마지막 구성 요소가 됩니다.

이 값은 4~63자(영문 기준)여야 하며 유효한 문자는 /[a-z][0-9]-/입니다.

parent

string

필수 항목입니다. 이 CustomClass가 생성될 프로젝트 및 위치입니다. 예상되는 형식은 projects/{project}/locations/{location}입니다.

DeleteCustomClassRequest

DeleteCustomClass 메서드에 대한 요청 메시지입니다.

JSON 표현
{
  "name": string,
  "validateOnly": boolean,
  "allowMissing": boolean,
  "etag": string
}
필드
name

string

필수 항목입니다. 삭제할 CustomClass의 이름입니다. 형식: projects/{project}/locations/{location}/customClasses/{customClass}

validateOnly

boolean

설정한 경우 요청을 검증하고 삭제된 CustomClass를 미리 봅니다. 하지만 실제로 삭제하지는 않습니다.

allowMissing

boolean

true로 설정되어 있고 CustomClass를 찾을 수 없으면 요청이 성공하고 노옵스(no-ops)가 됩니다(이 경우 작업이 기록되지 않음).

etag

string

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

UndeleteCustomClassRequest

customClasses.undelete 메서드에 대한 요청 메시지입니다.

JSON 표현
{
  "name": string,
  "validateOnly": boolean,
  "etag": string
}
필드
name

string

필수 항목입니다. 삭제 취소할 CustomClass의 이름입니다. 형식: projects/{project}/locations/{location}/customClasses/{customClass}

validateOnly

boolean

설정한 경우 요청을 검증하고 삭제 취소된 CustomClass를 미리 봅니다. 그러나 실제로 삭제를 취소하지는 않습니다.

etag

string

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

UpdateCustomClassRequest

UpdateCustomClass 메서드에 대한 요청 메시지입니다.

JSON 표현
{
  "customClass": {
    object (CustomClass)
  },
  "updateMask": string,
  "validateOnly": boolean
}
필드
customClass

object (CustomClass)

필수 항목입니다. 업데이트할 CustomClass입니다.

CustomClass의 name 필드는 업데이트할 CustomClass를 식별하는 데 사용됩니다. 형식은 projects/{project}/locations/{location}/customClasses/{customClass}입니다.

updateMask

string (FieldMask format)

업데이트할 필드 목록입니다. 비어 있으면 모든 필드가 업데이트 대상으로 고려됩니다.

정규화된 필드 이름의 쉼표로 구분된 목록입니다. 예: "user.displayName,photo"

validateOnly

boolean

설정하면 요청을 검증하고 업데이트된 CustomClass를 미리 봅니다. 하지만 실제로 업데이트하지는 않습니다.

CreatePhraseSetRequest

CreatePhraseSet 메서드에 대한 요청 메시지입니다.

JSON 표현
{
  "phraseSet": {
    object (PhraseSet)
  },
  "validateOnly": boolean,
  "phraseSetId": string,
  "parent": string
}
필드
phraseSet

object (PhraseSet)

필수 항목입니다. 만들 PhraseSet입니다.

validateOnly

boolean

설정한 경우 요청을 검증하고 PhraseSet를 미리 봅니다. 하지만 실제로 만들지는 않습니다.

phraseSetId

string

PhraseSet에 사용할 ID이며, PhraseSet의 리소스 이름의 마지막 구성 요소가 됩니다.

이 값은 4~63자(영문 기준)여야 하며 유효한 문자는 /[a-z][0-9]-/입니다.

parent

string

필수 항목입니다. 이 PhraseSet가 생성될 프로젝트 및 위치입니다. 예상되는 형식은 projects/{project}/locations/{location}입니다.

DeletePhraseSetRequest

DeletePhraseSet 메서드에 대한 요청 메시지입니다.

JSON 표현
{
  "name": string,
  "validateOnly": boolean,
  "allowMissing": boolean,
  "etag": string
}
필드
name

string

필수 항목입니다. 삭제할 PhraseSet의 이름입니다. 형식: projects/{project}/locations/{location}/phraseSets/{phraseSet}

validateOnly

boolean

설정한 경우 요청을 검증하고 삭제된 PhraseSet를 미리 봅니다. 하지만 실제로 삭제하지는 않습니다.

allowMissing

boolean

true로 설정되어 있고 PhraseSet를 찾을 수 없으면 요청이 성공하고 노옵스(no-ops)가 됩니다(이 경우 작업이 기록되지 않음).

etag

string

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

UndeletePhraseSetRequest

phraseSets.undelete 메서드에 대한 요청 메시지입니다.

JSON 표현
{
  "name": string,
  "validateOnly": boolean,
  "etag": string
}
필드
name

string

필수 항목입니다. 삭제 취소할 PhraseSet의 이름입니다. 형식: projects/{project}/locations/{location}/phraseSets/{phraseSet}

validateOnly

boolean

설정한 경우 요청을 검증하고 삭제 취소된 PhraseSet를 미리 봅니다. 하지만 실제로 삭제를 취소하지는 않습니다.

etag

string

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

UpdatePhraseSetRequest

UpdatePhraseSet 메서드에 대한 요청 메시지입니다.

JSON 표현
{
  "phraseSet": {
    object (PhraseSet)
  },
  "updateMask": string,
  "validateOnly": boolean
}
필드
phraseSet

object (PhraseSet)

필수 항목입니다. 업데이트할 PhraseSet입니다.

PhraseSet의 name 필드는 업데이트할 PhraseSet를 식별하는 데 사용됩니다. 형식은 projects/{project}/locations/{location}/phraseSets/{phraseSet}입니다.

updateMask

string (FieldMask format)

업데이트할 필드 목록입니다. 비어 있으면 기본값이 아닌 모든 값 필드가 업데이트 대상으로 고려됩니다. *을 사용하여 전체 PhraseSet 리소스를 업데이트합니다.

정규화된 필드 이름의 쉼표로 구분된 목록입니다. 예: "user.displayName,photo"

validateOnly

boolean

설정한 경우 요청을 검증하고 업데이트된 PhraseSet를 미리 봅니다. 하지만 실제로 업데이트하지는 않습니다.

BatchRecognizeRequest

recognizers.batchRecognize 메서드에 대한 요청 메시지입니다.

JSON 표현
{
  "recognizer": string,
  "config": {
    object (RecognitionConfig)
  },
  "configMask": string,
  "files": [
    {
      object (BatchRecognizeFileMetadata)
    }
  ],
  "recognitionOutputConfig": {
    object (RecognitionOutputConfig)
  },
  "processingStrategy": enum (ProcessingStrategy)
}
필드
recognizer

string

필수 항목입니다. 인식 중 사용할 인식기의 이름입니다. 예상되는 형식은 projects/{project}/locations/{location}/recognizers/{recognizer}입니다. 비어 있는 암시적 인식기를 사용하려면 {recognizer} 세그먼트를 _로 설정하여 사용할 수 있습니다.

config

object (RecognitionConfig)

자동 음성 인식에 사용할 특성 및 오디오 메타데이터입니다. 이 필드를 configMask 필드와 함께 사용하여 인식기 리소스의 defaultRecognitionConfig 일부를 재정의할 수 있습니다.

configMask

string (FieldMask format)

이 인식 요청 중에 인식기의 defaultRecognitionConfig에 있는 값을 재정의하는 config의 필드 목록입니다. 마스크를 제공하지 않으면 config에 지정된 모든 필드가 이 인식 요청에 대한 인식기의 값을 재정의합니다. 마스크가 제공되면 마스크에 나열된 필드만 이 인식 요청에 대한 인식기의 구성을 재정의합니다. 와일드 카드(*)가 제공되면 config는 이 인식 요청에 대한 인식기의 구성을 완전히 재정의하고 바꿉니다.

정규화된 필드 이름의 쉼표로 구분된 목록입니다. 예: "user.displayName,photo"

files[]

object (BatchRecognizeFileMetadata)

ASR용 파일 메타데이터가 포함된 오디오 파일. 지정할 수 있는 최대 파일 수는 5개입니다.

recognitionOutputConfig

object (RecognitionOutputConfig)

각 파일의 스크립트를 출력할 위치에 대한 구성 옵션입니다.

processingStrategy

enum (ProcessingStrategy)

이 요청에 사용할 처리 전략입니다.

CreateRecognizerRequest

recognizers.create 메서드에 대한 요청 메시지입니다.

JSON 표현
{
  "recognizer": {
    object (Recognizer)
  },
  "validateOnly": boolean,
  "recognizerId": string,
  "parent": string
}
필드
recognizer

object (Recognizer)

필수 항목입니다. 만들 인식기입니다.

validateOnly

boolean

설정한 경우 요청을 검증하고 인식기를 미리 봅니다. 하지만 실제로 만들지는 않습니다.

recognizerId

string

인식기에 사용할 ID이며, 인식기의 리소스 이름의 마지막 구성 요소가 됩니다.

이 값은 4~63자(영문 기준)여야 하며 유효한 문자는 /[a-z][0-9]-/입니다.

parent

string

필수 항목입니다. 이 인식기가 생성될 프로젝트 및 위치입니다. 예상되는 형식은 projects/{project}/locations/{location}입니다.

DeleteRecognizerRequest

recognizers.delete 메서드에 대한 요청 메시지입니다.

JSON 표현
{
  "name": string,
  "validateOnly": boolean,
  "allowMissing": boolean,
  "etag": string
}
필드
name

string

필수 항목입니다. 삭제할 인식기의 이름입니다. 형식: projects/{project}/locations/{location}/recognizers/{recognizer}

validateOnly

boolean

설정한 경우 요청을 검증하고 삭제된 인식기를 미리 봅니다. 하지만 실제로 삭제하지는 않습니다.

allowMissing

boolean

true로 설정되어 있고 인식기를 찾을 수 없으면 요청이 성공하고 노옵스(no-ops)가 됩니다(이 경우 작업이 기록되지 않음).

etag

string

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

UndeleteRecognizerRequest

recognizers.undelete 메서드에 대한 요청 메시지입니다.

JSON 표현
{
  "name": string,
  "validateOnly": boolean,
  "etag": string
}
필드
name

string

필수 항목입니다. 삭제 취소할 인식기의 이름입니다. 형식: projects/{project}/locations/{location}/recognizers/{recognizer}

validateOnly

boolean

설정한 경우 요청을 검증하고 삭제 취소된 인식기를 미리 봅니다. 그러나 실제로 삭제 취소하지는 않습니다.

etag

string

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

UpdateRecognizerRequest

recognizers.patch 메서드에 대한 요청 메시지입니다.

JSON 표현
{
  "recognizer": {
    object (Recognizer)
  },
  "updateMask": string,
  "validateOnly": boolean
}
필드
recognizer

object (Recognizer)

필수 항목입니다. 업데이트할 인식기입니다.

인식기의 name 필드는 업데이트할 인식기를 식별하는 데 사용됩니다. 형식은 projects/{project}/locations/{location}/recognizers/{recognizer}입니다.

updateMask

string (FieldMask format)

업데이트할 필드 목록입니다. 비어 있으면 기본값이 아닌 모든 값 필드가 업데이트 대상으로 고려됩니다. *를 사용하여 전체 인식기 리소스를 업데이트합니다.

정규화된 필드 이름의 쉼표로 구분된 목록입니다. 예: "user.displayName,photo"

validateOnly

boolean

설정한 경우 요청을 검증하고 업데이트된 인식기를 미리 봅니다. 하지만 실제로 업데이트하지는 않습니다.