准备工作
-
登录您的 Google 帐号。
如果您还没有 Google 帐号,请注册新帐号。
-
设置 Cloud Console 项目。
点击即可执行以下操作:
- 创建或选择项目。
- 为该项目启用 Cloud Natural Language API。
- 创建服务帐号。
- 下载 JSON 格式的私钥。
您可以随时在 Cloud Console 中查看和管理这些资源。
-
将环境变量
GOOGLE_APPLICATION_CREDENTIALS
设置为包含您的服务帐号密钥的 JSON 文件的路径。 此变量仅适用于当前的 shell 会话,因此,如果您打开新的会话,请重新设置该变量。 - 安装并初始化 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 基础知识,了解有关形成 Natural Language API 请求和处理响应的概念信息。
- 通读情感分析教程并浏览示例应用。