시작하기 전에
- Google Cloud 계정에 로그인합니다. Google Cloud를 처음 사용하는 경우 계정을 만들고 Google 제품의 실제 성능을 평가해 보세요. 신규 고객에게는 워크로드를 실행, 테스트, 배포하는 데 사용할 수 있는 $300의 무료 크레딧이 제공됩니다.
-
Google Cloud Console의 프로젝트 선택기 페이지에서 Google Cloud 프로젝트를 선택하거나 만듭니다.
-
Cloud 프로젝트에 결제가 사용 설정되어 있는지 확인합니다. 프로젝트에 결제가 사용 설정되어 있는지 확인하는 방법을 알아보세요.
- Cloud Natural Language API를 사용 설정합니다.
-
서비스 계정을 만듭니다.
-
Cloud Console에서 서비스 계정 만들기 페이지로 이동합니다.
서비스 계정 만들기로 이동 - 프로젝트를 선택합니다.
-
서비스 계정 이름 필드에 이름을 입력합니다. Cloud Console은 이 이름을 기반으로 서비스 계정 ID 필드를 채웁니다.
서비스 계정 설명 필드에 설명을 입력합니다. 예를 들면
Service account for quickstart입니다. -
완료를 클릭하여 서비스 계정 만들기를 마칩니다.
브라우저 창을 닫지 마세요. 다음 단계에서 사용합니다.
-
-
서비스 계정 키 만들기
- Cloud Console에서 만든 서비스 계정의 이메일 주소를 클릭합니다.
- 키를 클릭합니다.
- 키 추가를 클릭한 후 새 키 만들기를 클릭합니다.
- 만들기를 클릭합니다. JSON 키 파일이 컴퓨터에 다운로드됩니다.
- 닫기를 클릭합니다.
-
GOOGLE_APPLICATION_CREDENTIALS환경 변수를 서비스 계정 키가 포함된 JSON 파일의 경로로 설정합니다. 이 변수는 현재 셸 세션에만 적용되므로, 새 세션을 열 경우, 변수를 다시 설정합니다. - Cloud SDK 설치 및 초기화
-
Google Cloud Console의 프로젝트 선택기 페이지에서 Google Cloud 프로젝트를 선택하거나 만듭니다.
-
Cloud 프로젝트에 결제가 사용 설정되어 있는지 확인합니다. 프로젝트에 결제가 사용 설정되어 있는지 확인하는 방법을 알아보세요.
- Cloud Natural Language API를 사용 설정합니다.
-
서비스 계정을 만듭니다.
-
Cloud Console에서 서비스 계정 만들기 페이지로 이동합니다.
서비스 계정 만들기로 이동 - 프로젝트를 선택합니다.
-
서비스 계정 이름 필드에 이름을 입력합니다. Cloud Console은 이 이름을 기반으로 서비스 계정 ID 필드를 채웁니다.
서비스 계정 설명 필드에 설명을 입력합니다. 예를 들면
Service account for quickstart입니다. -
완료를 클릭하여 서비스 계정 만들기를 마칩니다.
브라우저 창을 닫지 마세요. 다음 단계에서 사용합니다.
-
-
서비스 계정 키 만들기
- Cloud Console에서 만든 서비스 계정의 이메일 주소를 클릭합니다.
- 키를 클릭합니다.
- 키 추가를 클릭한 후 새 키 만들기를 클릭합니다.
- 만들기를 클릭합니다. JSON 키 파일이 컴퓨터에 다운로드됩니다.
- 닫기를 클릭합니다.
-
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" \
"https://language.googleapis.com/v1/documents:analyzeEntities" \
--data "{
'document':{
'type':'PLAIN_TEXT',
'content':'Michelangelo Caravaggio, Italian painter, is known for
\'The Calling of Saint Matthew\'.'
},
'encodingType':'UTF8'
}"
다음과 비슷한 응답이 표시됩니다.
{
"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 요청 작성 및 응답 처리에 대한 개념 정보를 습득합니다.
- 감정 분석 가이드를 살펴보고 샘플 애플리케이션을 훑어봅니다.