快速入门

api Cloud Natural Language API 本页面介绍了如何利用 Google Cloud SDK 开始使用 Cloud Natural Language API。

准备工作

quickstart language.googleapis.com Cloud Natural Language gcloud_init SERVICE_ACCOUNT env_var
  1. 登录您的 Google 帐号。

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

  2. 在 GCP Console 的项目选择器页面上，选择或创建 GCP 项目。

    转到项目选择器页面

  3. 确保您的 Google Cloud Platform 项目已启用结算功能。 了解如何确认您的项目已启用结算功能。

发出实体分析请求

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 删除您不需要的项目。

后续步骤