快速入门

此页面显示您如何利用 Google Cloud SDK 开始使用 Cloud Natural Language API。

准备工作

1. 登录您的 Google 帐号。

   如果您还没有 Google 帐号，请注册新帐号。

2. 设置 GCP Console 项目。

   设置项目

   点击即可执行以下操作：

   • 创建或选择项目。
   • 启用该项目Cloud Natural Language API。
   • 创建服务帐号。
   • 下载 JSON 格式的私钥。

   您可以随时在 GCP Console 中查看和管理这些资源。

3. 将环境变量 GOOGLE_APPLICATION_CREDENTIALS 设置为包含服务帐号密钥的 JSON 文件的文件路径。此变量仅适用于当前的 shell 会话，因此，如果您打开新的会话，请重新设置该变量。

   示例：Linux 或 macOS

   将 [PATH] 替换为包含服务帐号密钥的 JSON 文件的文件路径。

   export GOOGLE_APPLICATION_CREDENTIALS="[PATH]"

   例如：

   export GOOGLE_APPLICATION_CREDENTIALS="/home/user/Downloads/service-account-file.json"

   示例：Windows

   将 [PATH] 替换为包含服务帐号密钥的 JSON 文件的文件路径，将 [FILE_NAME] 替换为文件名。

   使用 PowerShell：

   $env:GOOGLE_APPLICATION_CREDENTIALS="[PATH]"

   例如：

   $env:GOOGLE_APPLICATION_CREDENTIALS="C:\Users\username\Downloads\[FILE_NAME].json"

   使用命令提示符：

   set GOOGLE_APPLICATION_CREDENTIALS=[PATH]

4. 安装并初始化 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 发送了第一个请求。

您还可以通过向不同的 Cloud Natural Language API 端点发出请求，从而分析文档情感并从文本中提取语法注释。有关更多详情，请参阅 Cloud Natural Language API 基础知识。

清理

为避免产生不必要的 Google Cloud Platform 费用，请使用 GCP Console 删除您不需要的项目。

后续步骤

• 通过使用 Cloud Natural Language 客户端库，开始使用您所选语言的 Natural Language API。
• 查阅 Natural Language 基础知识，了解有关形成 Natural Language API 请求和处理响应的概念信息。
• 通读情感分析教程并浏览示例应用。