快速入门:设置 Natural Language API

本指南介绍了开始使用 Natural Language 所需的所有设置步骤。

Google Cloud Console 简介

Google Cloud Console 是一个网页界面,用于预配、配置、管理和监控使用 Google Cloud 产品的系统。您可以使用 Google Cloud Console 设置和管理 Natural Language 资源。

创建项目

如需使用 Google Cloud 提供的服务,您必须创建一个项目

项目用于组织您的所有 Google Cloud 资源。 项目由以下部分组成:

  • 一组协作者
  • 已启用的 API(以及其他资源)
  • 监控工具
  • 结算信息
  • 身份验证和访问权限控制

您可以创建一个项目,也可以创建多个项目,并使用这些项目按资源层次结构组织 Google Cloud 资源。如需详细了解项目,请参阅 Resource Manager 文档

在 Google Cloud Console 中的项目选择器页面上,选择或创建一个 Google Cloud 项目

转到“项目选择器”

启用结算功能

结算账号用于定义一组给定资源的付款方,并且可以关联到一个或多个项目。项目的资源使用费将记在关联的结算账号名下。在大多数情况下,您应在创建项目时配置结算信息。如需了解详情,请参阅结算文档

确保您的 Google Cloud 项目已启用结算功能

启用 API

您必须为项目启用 Cloud Natural Language API。 如需详细了解如何启用 API,请参阅 Service Usage 文档

启用 Cloud Natural Language API。

启用 API

安装并初始化 gcloud CLI

如果您计划使用 Natural Language API,则需要安装并初始化 gcloud CLI。gcloud CLI 是一组工具,可用于管理 Google Cloud 上托管的资源和应用。这包括 gcloud CLI。以下链接提供了相关说明:

安装 Google Cloud CLI,然后通过运行以下命令初始化 Google Cloud CLI:

gcloud init

设置身份验证

任何使用 API 的客户端应用都必须经过身份验证,并且拥有所请求资源的访问权限。如何设置身份验证取决于您是在本地开发环境中工作还是设置生产环境。如需了解详情,请参阅设置应用默认凭据

选择标签页以了解您打算如何访问 API:

gcloud

安装 Google Cloud CLI,然后通过运行以下命令初始化 Google Cloud CLI:

gcloud init

C#

如需从本地开发环境使用本页面上的 .NET 示例,请安装并初始化 gcloud CLI,然后使用用户凭据设置应用默认凭据。

  1. 安装 Google Cloud CLI。
  2. 如需初始化 gcloud CLI,请运行以下命令:

    gcloud init
  3. 为您的 Google 账号创建本地身份验证凭据:

    gcloud auth application-default login

如需了解详情,请参阅 Google Cloud 身份验证文档中的为本地开发环境设置身份验证

Go

如需从本地开发环境使用本页面上的 Go 示例,请安装并初始化 gcloud CLI,然后使用用户凭据设置应用默认凭据。

  1. 安装 Google Cloud CLI。
  2. 如需初始化 gcloud CLI,请运行以下命令:

    gcloud init
  3. 为您的 Google 账号创建本地身份验证凭据:

    gcloud auth application-default login

如需了解详情,请参阅 Google Cloud 身份验证文档中的为本地开发环境设置身份验证

Java

如需从本地开发环境使用本页面上的 Java 示例,请安装并初始化 gcloud CLI,然后使用用户凭据设置应用默认凭据。

  1. 安装 Google Cloud CLI。
  2. 如需初始化 gcloud CLI,请运行以下命令:

    gcloud init
  3. 为您的 Google 账号创建本地身份验证凭据:

    gcloud auth application-default login

如需了解详情,请参阅 Google Cloud 身份验证文档中的为本地开发环境设置身份验证

Node.js

如需从本地开发环境使用本页面上的 Node.js 示例,请安装并初始化 gcloud CLI,然后使用用户凭据设置应用默认凭据。

  1. 安装 Google Cloud CLI。
  2. 如需初始化 gcloud CLI,请运行以下命令:

    gcloud init
  3. 为您的 Google 账号创建本地身份验证凭据:

    gcloud auth application-default login

如需了解详情,请参阅 Google Cloud 身份验证文档中的为本地开发环境设置身份验证

PHP

如需从本地开发环境使用本页面上的 PHP 示例,请安装并初始化 gcloud CLI,然后使用用户凭据设置应用默认凭据。

  1. 安装 Google Cloud CLI。
  2. 如需初始化 gcloud CLI,请运行以下命令:

    gcloud init
  3. 为您的 Google 账号创建本地身份验证凭据:

    gcloud auth application-default login

如需了解详情,请参阅 Google Cloud 身份验证文档中的为本地开发环境设置身份验证

Python

如需从本地开发环境使用本页面上的 Python 示例,请安装并初始化 gcloud CLI,然后使用用户凭据设置应用默认凭据。

  1. 安装 Google Cloud CLI。
  2. 如需初始化 gcloud CLI,请运行以下命令:

    gcloud init
  3. 为您的 Google 账号创建本地身份验证凭据:

    gcloud auth application-default login

如需了解详情,请参阅 Google Cloud 身份验证文档中的为本地开发环境设置身份验证

Ruby

如需从本地开发环境使用本页面上的 Ruby 示例,请安装并初始化 gcloud CLI,然后使用用户凭据设置应用默认凭据。

  1. 安装 Google Cloud CLI。
  2. 如需初始化 gcloud CLI,请运行以下命令:

    gcloud init
  3. 为您的 Google 账号创建本地身份验证凭据:

    gcloud auth application-default login

如需了解详情,请参阅 Google Cloud 身份验证文档中的为本地开发环境设置身份验证

REST

如需在本地开发环境中使用本页面上的 REST API 示例,请使用您提供给 gcloud CLI 的凭据。

    安装 Google Cloud CLI,然后通过运行以下命令初始化 Google Cloud CLI:

    gcloud init

如需了解如何为生产环境设置身份验证,请参阅 为在 Google Cloud 上运行的代码设置应用默认凭据

安装 Natural Language API 客户端库

您可以通过以下三种方式调用 Natural Language API:

客户端库支持多种主流语言。如需了解如何安装客户端库,请参阅 Cloud Natural Language 客户端库

角色简介

访问 Cloud Natural Language API 不需要角色。通过身份验证的用户或应用无论具有什么权限,都可以调用该 API。