Copyright 2019 Google LLC
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
https://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.Google Cloud API を REST インタフェースから利用するために、 API Key を利用します。 Google Cloud Console から API Key をコピーしましょう。
In [0]:
import getpass
APIKEY = getpass.getpass()
API Discovery Service を利用して Cloud Natural Language API を発見します。 Cloud Natural Language の REST API 仕様は こちら に解説されています。
In [0]:
from googleapiclient.discovery import build
nl_service = build('language', 'v1beta2', developerKey=APIKEY)
Cloud Natural Language API に入力する情報を定義します。
In [0]:
import textwrap
source_language = "en" #@param ["en", "ja"] {type: "string"}
source_sentence = "Classifying Opinion and Editorials can be time-consuming and difficult work for any data science team, but Cloud Natural Language was able to instantly identify clear topics with a high-level of confidence. This tool has saved me weeks, if not months, of work to achieve a level of accuracy that may not have been possible with our in-house resources." #@param {type:"string"}
document_type = "PLAIN_TEXT" #@param["PLAIN_TEXT", "HTML"] {type: "string"}
encoding_type = "UTF8" #@param["UTF8", "UTF16", "UTF32"] {type: "string"}
textwrap.wrap(source_sentence)
エンティティ分析は、指定されたテキストに既知のエンティティ（著名人、ランドマークなどの固有名詞）が含まれていないかどうかを調べて、それらのエンティティに関する情報を返します。エンティティ分析に関する REST API 仕様はこちらで解説されています。
In [0]:
response = nl_service.documents().analyzeEntities(
body={
'document': {
'type': document_type,
'content': source_sentence,
'language': source_language,
},
'encodingType': encoding_type,
}
).execute()
In [0]:
# Below code is extracting only proper nouns from a response message. If you
# have interest on what information is exactly contained in a response message,
# please try to explore it :D
for entity in response['entities']:
for mention in entity['mentions']:
if mention['type'] == 'PROPER':
print(mention, entity['metadata'])
感情分析は、指定されたテキストを調べて、そのテキストの背景にある感情的な考え方を分析します。具体的には、執筆者の考え方がポジティブか、ネガティブか、ニュートラルかを判断します。感情分析に関する REST API 仕様はこちらで解説されています。
In [0]:
response = nl_service.documents().analyzeSentiment(
body={
'document': {
'type': document_type,
'content': source_sentence,
'language': source_language,
},
'encodingType': encoding_type,
}
).execute()
In [0]:
# This shows you document-level sentiment.
response['documentSentiment']
In [0]:
# This shows you sentence-level sentiment.
for sentence in response['sentences']:
print(sentence['sentiment'], sentence['text']['content'])
コンテンツの分類は、ドキュメントを分析し、ドキュメント内で見つかったテキストに適用されるコンテンツ カテゴリのリストを返します。ドキュメント内のコンテンツを分類するには、classifyText メソッドを呼び出します。
In [0]:
response = nl_service.documents().classifyText(
body={
'document': {
'type': document_type,
'content': source_sentence,
'language': source_language,
},
}
).execute()
In [0]:
response['categories']
構文解析では、指定されたテキストを一連の文とトークン（通常は単語）に分解して、それらのトークンに関する言語情報を提供します。ほとんどの Natural Language API メソッドは、指定されたテキストの内容を分析しますが、analyzeSyntax メソッドは、言語自体の構造を検査します。
In [0]:
response = nl_service.documents().analyzeSyntax(
body={
'document': {
'type': document_type,
'content': source_sentence,
'language': source_language,
},
'encodingType': encoding_type,
}
).execute()
In [0]:
# This shows you output of syntax analysis. To leverage this output, you may
# need domain knowledge on natural language analysis.
response['tokens']
1. エンティティ分析で著名人やランドマークを抽出してみましょう。
2. 感情分析をさまざまな文章に対して実行してみましょう。
API Discovery Service を利用して Cloud Translation API を発見します。 Cloud Natural Language の REST API 仕様はこちらで解説されています。
In [0]:
from googleapiclient.discovery import build
translate_service = build('translate', 'v2', developerKey=APIKEY)
Cloud Translation API に入力する情報を定義します。
In [0]:
import textwrap
source_language = "en" #@param ["en", "ja"] {type: "string"}
target_language = "ja" #@param ["en", "ja"] {type: "string"}
source_sentence = "Classifying Opinion and Editorials can be time-consuming and difficult work for any data science team, but Cloud Natural Language was able to instantly identify clear topics with a high-level of confidence. This tool has saved me weeks, if not months, of work to achieve a level of accuracy that may not have been possible with our in-house resources." #@param {type:"string"}
textwrap.wrap(source_sentence, width=50)
translations リクエストを使えば、入力テキストを、指定した言語に翻訳されたテキストを取得することが出来ます。入力テキストには書式なしテキストまたは HTML を使用できます。Cloud Translation API は入力テキスト内の HTML タグは翻訳せず、タグ間にあるテキストのみを翻訳します。出力では、（未翻訳の）HTML タグは保持されます。タグは翻訳されたテキストに合わせて挿入されますが、ソース言語とターゲット言語には差異があるため、その位置調整は可能な範囲に留まります。出力内の HTML タグの順序は、翻訳による語順変化のため入力テキスト内の順序と異なる場合があります。
In [0]:
# Note that you can change Translation model by changing 'model' parameter.
response = translate_service.translations().list(
source=source_language,
target=target_language,
q=source_sentence,
model='nmt',
format='html').execute()
In [0]:
text = response['translations'][0]['translatedText']
textwrap.wrap(text)
detections リクエストを使えば、入力テキストの言語を特定できます。この機能は使われている言語が不明なテキストを自動的に翻訳するときなどに利用できます。
In [0]:
response = translate_service.detections().list(
q=source_sentence
).execute()
response['detections']
1. 翻訳モデルを NMT から PBT に変更するとどうなるか確かめましょう
2. 次のテキストを英語に翻訳しましょう:
Google Cloud Translation API'nin en iyi gerçek zamanlı çeviri sonuçlarını ve Google'ın da en güvenilir hizmeti sunduğunu gördük. Çeviri araçları Clash of Kings sohbet hizmetiyle de sorunsuz şekilde entegre oldu.