이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Method: documents.annotateText

HTTP 요청
요청 본문
- JSON 표현
응답 본문
- JSON 표현
승인 범위
기능
- JSON 표현
사용해 보기

analyzeSentiment, analyzeEntities, analyzeSyntax가 제공하는 모든 기능을 한 번에 호출하는 편의 메서드입니다.

HTTP 요청

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

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

요청 본문

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

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

필드

필드
`document`	`object (Document)` 필수 입력란입니다. 문서를 입력합니다.
`features`	`object (Features)` 필수 입력란입니다. 사용 설정된 기능
`encodingType`	`enum (EncodingType)` API에서 오프셋을 계산하는 데 사용하는 인코딩 유형입니다.

document

object (Document)

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

features

object (Features)

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

encodingType

enum (EncodingType)

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

응답 본문

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

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

JSON 표현

JSON 표현
{ "sentences": [ { object (`Sentence`) } ], "tokens": [ { object (`Token`) } ], "entities": [ { object (`Entity`) } ], "documentSentiment": { object (`Sentiment`) }, "language": string, "categories": [ { object (`ClassificationCategory`) } ], "moderationCategories": [ { object (`ClassificationCategory`) } ] }

{
  "sentences": [
    {
      object (Sentence)
    }
  ],
  "tokens": [
    {
      object (Token)
    }
  ],
  "entities": [
    {
      object (Entity)
    }
  ],
  "documentSentiment": {
    object (Sentiment)
  },
  "language": string,
  "categories": [
    {
      object (ClassificationCategory)
    }
  ],
  "moderationCategories": [
    {
      object (ClassificationCategory)
    }
  ]
}

필드
`sentences[]`	`object (Sentence)` 입력 문서의 문장입니다. 사용자가 `AnnotateTextRequest.Features.extract_syntax`를 사용 설정하면 채워집니다.
`tokens[]`	`object (Token)` 입력 문서의 토큰과 문법 정보 사용자가 `AnnotateTextRequest.Features.extract_syntax`를 사용 설정하면 채워집니다.
`entities[]`	`object (Entity)` 입력 문서의 항목과 시맨틱 정보 사용자가 `AnnotateTextRequest.Features.extract_entities`를 사용 설정하면 채워집니다.
`documentSentiment`	`object (Sentiment)` 문서의 전반적인 감정입니다. 사용자가 `AnnotateTextRequest.Features.extract_document_sentiment`를 사용 설정하면 채워집니다.
`language`	`string` 텍스트의 언어입니다. 요청에 지정된 언어와 동일하거나 지정되지 않은 경우에는 자동 감지된 언어입니다. 자세한 내용은 `Document.language` 필드를 참고하세요.
`categories[]`	`object (ClassificationCategory)` 입력 문서에서 식별된 카테고리입니다.
`moderationCategories[]`	`object (ClassificationCategory)` 입력 문서에서 확인된 유해하고 민감한 카테고리입니다.

승인 범위

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

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

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

기능

감정, 문법, 시맨틱 분석에 사용할 수 있는 모든 기능 각각을 true로 설정하면 입력에 대해 해당 분석이 사용 설정됩니다.

JSON 표현

JSON 표현
{ "extractSyntax": boolean, "extractEntities": boolean, "extractDocumentSentiment": boolean, "extractEntitySentiment": boolean, "classifyText": boolean, "moderateText": boolean, "classificationModelOptions": { object (`ClassificationModelOptions`) } }

{
  "extractSyntax": boolean,
  "extractEntities": boolean,
  "extractDocumentSentiment": boolean,
  "extractEntitySentiment": boolean,
  "classifyText": boolean,
  "moderateText": boolean,
  "classificationModelOptions": {
    object (ClassificationModelOptions)
  }
}

필드
`extractSyntax`	`boolean` 문법 정보를 추출합니다.
`extractEntities`	`boolean` 항목 추출
`extractDocumentSentiment`	`boolean` 문서 수준 감정을 추출합니다.
`extractEntitySentiment`	`boolean` 항목과 관련 감정을 추출합니다.
`classifyText`	`boolean` 전체 문서를 카테고리로 분류합니다.
`moderateText`	`boolean` 유해하고 민감한 카테고리의 문서를 검토합니다.
`classificationModelOptions`	`object (ClassificationModelOptions)` 선택사항입니다. 분류에 사용할 모델 옵션입니다. 지정하지 않을 경우 기본값은 v1 옵션입니다. `classifyText`가 true로 설정된 경우에만 사용됩니다.