Method: documents.moderateText

유해하고 민감한 카테고리의 문서를 검토합니다.

HTTP 요청

POST https://language.googleapis.com/v2/documents:moderateText

URL은 gRPC 트랜스코딩 구문을 사용합니다.

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "document": {
    object (Document)
  },
  "modelVersion": enum (ModelVersion)
}
필드
document

object (Document)

필수 입력란입니다. 문서를 입력합니다.
modelVersion

enum (ModelVersion)

선택사항입니다. documents.moderateText에 사용할 모델 버전입니다.

응답 본문

문서 검토 응답 메시지입니다.

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현 
{
  "moderationCategories": [
    {
      object (ClassificationCategory)
    }
  ],
  "languageCode": string,
  "languageSupported": boolean
}
필드
moderationCategories[]

object (ClassificationCategory)

입력 문서를 나타내는 유해 및 민감한 카테고리입니다.
languageCode

string

텍스트의 언어입니다. 요청에 지정된 언어와 동일하거나 지정되지 않은 경우에는 자동 감지된 언어와 동일합니다. 자세한 내용은 [Document.language][] 필드를 참고하세요.
languageSupported

boolean

언어가 공식적으로 지원되는지 여부 언어가 지원되지 않는 경우에도 API가 응답을 반환할 수 있지만 최선의 방식으로 제공됩니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/cloud-language
  • https://www.googleapis.com/auth/cloud-platform

자세한 내용은 인증 개요를 참조하세요.

ModelVersion

documents.moderateText에 사용할 모델 버전입니다.

열거형
MODEL_VERSION_UNSPECIFIED 기본 모델 버전입니다.
MODEL_VERSION_1 v1 모델을 사용합니다. 이 모델은 제공되지 않을 때 기본적으로 사용됩니다. v1 모델은 각 카테고리의 확률 (신뢰도) 점수만 반환합니다.
MODEL_VERSION_2 v2 모델을 사용합니다. v2 모델은 각 카테고리의 확률 (신뢰도) 점수만 반환하고 카테고리의 하위 집합에 대한 심각도 점수를 반환합니다.