Method: documents.annotateText

한 번의 호출로 모든 기능을 제공하는 편의 메서드입니다.

HTTP 요청

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

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

요청 본문

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

JSON 표현 
{
  "document": {
    object (Document)
  },
  "features": {
    object (Features)
  },
  "encodingType": enum (EncodingType)
}
필드
document

object (Document)

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

object (Features)

필수 입력란입니다. 사용 설정된 기능
encodingType

enum (EncodingType)

API에서 오프셋을 계산하는 데 사용하는 인코딩 유형입니다.

응답 본문

텍스트 주석 응답 메시지입니다.

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

JSON 표현 
{
  "sentences": [
    {
      object (Sentence)
    }
  ],
  "entities": [
    {
      object (Entity)
    }
  ],
  "documentSentiment": {
    object (Sentiment)
  },
  "languageCode": string,
  "categories": [
    {
      object (ClassificationCategory)
    }
  ],
  "moderationCategories": [
    {
      object (ClassificationCategory)
    }
  ],
  "languageSupported": boolean
}
필드
sentences[]

object (Sentence)

입력 문서의 문장입니다. 사용자가 AnnotateTextRequest.Features.extract_document_sentiment를 사용 설정하면 채워집니다.
entities[]

object (Entity)

입력 문서의 항목과 시맨틱 정보 사용자가 AnnotateTextRequest.Features.extract_entities 또는 AnnotateTextRequest.Features.extract_entity_sentiment를 사용 설정하면 채워집니다.
documentSentiment

object (Sentiment)

문서의 전반적인 감정입니다. 사용자가 AnnotateTextRequest.Features.extract_document_sentiment를 사용 설정하면 채워집니다.
languageCode

string

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

object (ClassificationCategory)

입력 문서에서 식별된 카테고리입니다.
moderationCategories[]

object (ClassificationCategory)

입력 문서에서 확인된 유해하고 민감한 카테고리입니다.
languageSupported

boolean

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

승인 범위

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

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

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

기능

사용 가능한 모든 기능 각각을 true로 설정하면 입력에 대해 해당 분석이 사용 설정됩니다.

JSON 표현 
{
  "extractEntities": boolean,
  "extractDocumentSentiment": boolean,
  "classifyText": boolean,
  "moderateText": boolean
}
필드
extractEntities

boolean

선택사항입니다. 항목 추출
extractDocumentSentiment

boolean

선택사항입니다. 문서 수준 감정을 추출합니다.
classifyText

boolean

선택사항입니다. 전체 문서를 카테고리로 분류합니다.
moderateText

boolean

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