시작하기 전에
-
Google 계정으로
로그인합니다.
아직 계정이 없으면 새 계정을 등록하세요.
-
Cloud Console 프로젝트를 설정합니다.
클릭하여 다음을 수행하세요.
- 프로젝트를 만들거나 선택합니다.
- 프로젝트에 Cloud Natural Language API를 사용 설정합니다.
- 서비스 계정을 만듭니다.
- 비공개 키를 JSON으로 다운로드합니다.
언제든지 Cloud Console에서 이 리소스를 보고 관리할 수 있습니다.
-
GOOGLE_APPLICATION_CREDENTIALS
환경 변수를 서비스 계정 키가 포함된 JSON 파일의 경로로 설정합니다. 이 변수는 현재 셸 세션에만 적용되므로, 새 세션을 열 경우, 변수를 다시 설정합니다. - Cloud SDK 설치 및 초기화
항목 분석 요청하기
gcloud
gcloud
명령줄 도구를 사용하여 analyze-entities
명령어를 호출하고 --content
플래그를 사용하여 분석할 텍스트를 지정합니다.
gcloud ml language analyze-entities --content="Michelangelo Caravaggio, Italian painter, is known for 'The Calling of Saint Matthew'."
명령줄
curl
을 사용하여 documents:analyzeEntities
메서드에 POST
요청을 하고 다음 예시와 같이 적절한 요청 본문을 제공합니다.
이 예시에서는 gcloud auth application-default print-access-token
명령어를 사용하여 프로젝트를 설정할 때 만든 서비스 계정에 대한 액세스 토큰을 가져옵니다.
curl -X POST
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token)
-H "Content-Type: application/json; charset=utf-8"
--data "{ 'document':{ 'type':'PLAIN_TEXT', 'content':'Michelangelo Caravaggio, Italian painter, is known for \'The Calling of Saint Matthew\'.' }, 'encodingType':'UTF8' }" "https://language.googleapis.com/v1/documents:analyzeEntities"
다음과 비슷한 응답이 표시됩니다.
{ "entities": [ { "name": "Michelangelo Caravaggio", "type": "PERSON", "metadata": { "wikipedia_url": "http://en.wikipedia.org/wiki/Caravaggio", "mid": "/m/020bg" }, "salience": 0.83047235, "mentions": [ { "text": { "content": "Michelangelo Caravaggio", "beginOffset": 0 }, "type": "PROPER" }, { "text": { "content": "painter", "beginOffset": 33 }, "type": "COMMON" } ] }, { "name": "Italian", "type": "LOCATION", "metadata": { "mid": "/m/03rjj", "wikipedia_url": "http://en.wikipedia.org/wiki/Italy" }, "salience": 0.13870546, "mentions": [ { "text": { "content": "Italian", "beginOffset": 25 }, "type": "PROPER" } ] }, { "name": "The Calling of Saint Matthew", "type": "EVENT", "metadata": { "mid": "/m/085_p7", "wikipedia_url": "http://en.wikipedia.org/wiki/The_Calling_of_St_Matthew_(Caravaggio)" }, "salience": 0.030822212, "mentions": [ { "text": { "content": "The Calling of Saint Matthew", "beginOffset": 69 }, "type": "PROPER" } ] } ], "language": "en" }
축하합니다. 처음으로 요청을 Cloud Natural Language API에 보냈습니다.
삭제
불필요한 Google Cloud Platform 요금을 지출하지 않으려면 Cloud Console을 사용하여 필요하지 않은 프로젝트를 삭제해야 합니다.
다음 단계
- Cloud Natural Language 클라이언트 라이브러리를 사용하여 선택한 언어로 Natural Language API를 시작합니다.
- 자연어 기본사항을 참조하여 Natural Language API 요청 작성 및 응답 처리에 대한 개념 정보를 습득합니다.
- 감정 분석 가이드를 살펴보고 샘플 애플리케이션을 훑어봅니다.