快速入门:设置 Natural Language API

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

Google Cloud 控制台简介

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

创建项目

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

项目可以整理您的所有 Google Cloud 资源。 项目由以下部分组成:

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

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

在 Google Cloud 控制台的项目选择器页面上,选择或创建 Google Cloud 项目。

选择或创建项目所需的角色

  • 选择项目:选择项目不需要特定的 IAM 角色,您可以选择已获授角色的任何项目。
  • 创建项目:如需创建项目,您需要拥有 Project Creator 角色 (roles/resourcemanager.projectCreator),该角色包含 resourcemanager.projects.create 权限。了解如何授予角色

转到“项目选择器”

启用结算功能

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

验证是否已为您的 Google Cloud 项目启用结算功能

启用 API

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

启用 Cloud Natural Language API。

启用 API 所需的角色

如需启用 API,您需要拥有 Service Usage Admin IAM 角色 (roles/serviceusage.serviceUsageAdmin),该角色包含 serviceusage.services.enable 权限。了解如何授予角色

启用 API

安装并初始化 gcloud CLI

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

安装 Google Cloud CLI。 安装完成后,运行以下命令来初始化 Google Cloud CLI:

gcloud init

如果您使用的是外部身份提供方 (IdP),则必须先使用联合身份登录 gcloud CLI

设置身份验证

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

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

gcloud

安装 Google Cloud CLI。 安装完成后,运行以下命令来初始化 Google Cloud CLI:

gcloud init

如果您使用的是外部身份提供方 (IdP),则必须先使用联合身份登录 gcloud CLI

客户端库

如需在本地开发环境中使用客户端库,请安装并初始化 gcloud CLI,然后使用您的用户凭证设置应用默认凭证。

  1. 安装 Google Cloud CLI。

  2. 如果您使用的是外部身份提供方 (IdP),则必须先使用联合身份登录 gcloud CLI

  3. 如果您使用的是本地 shell,请为您的用户账号创建本地身份验证凭证:

    gcloud auth application-default login

    如果您使用的是 Cloud Shell,则无需执行此操作。

    如果系统返回身份验证错误,并且您使用的是外部身份提供方 (IdP),请确认您已 使用联合身份登录 gcloud CLI

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

REST

如需在本地开发环境中使用 REST API,请使用您提供给 gcloud CLI 的凭证。

    安装 Google Cloud CLI。

    如果您使用的是外部身份提供方 (IdP),则必须先使用联合身份登录 gcloud CLI

如需了解详情,请参阅 Google Cloud 身份验证文档中的使用 REST 时进行身份验证

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

安装 Natural Language API 客户端库

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

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

IAM 角色

如需获得访问 Cloud Natural Language API 所需的权限,请让您的管理员为您授予配额项目Service Usage Consumer (roles/serviceusage.serviceUsageConsumer) IAM 角色。如需详细了解如何授予角色,请参阅管理对项目、文件夹和组织的访问权限

您也可以通过自定义角色或其他预定义角色来获取所需的权限。