创建 Google Cloud 项目

您需要有一个 Google Cloud 项目，才能使用 Google Workspace API 并构建 Google Workspace 插件或应用。Cloud 项目是创建、启用和使用所有 Google Cloud 服务的基础，包括管理 API、启用结算功能、添加和移除协作者以及管理权限。

注意：除了手动创建云项目之外，您还可以在 Google AI Studio 中使用由 Google 管理的免费新手体验层级项目（适用于符合条件的 Google 账号）或用户管理的云项目来构建 Web 应用。如需了解详情，请参阅在 Google AI Studio 中构建 Web 应用和从 Google AI Studio 部署 Web 应用。

创建 Cloud 项目

Google Cloud 控制台

1. 在 Google Cloud 控制台中，依次点击“菜单” > IAM 和管理 > 创建项目。

   前往“创建项目”

2. 在项目名称字段中，为项目输入一个描述性名称。

   可选：如需修改项目 ID，请点击修改。项目一经创建，便无法更改项目 ID，因此请选择一个在项目生命周期内符合您需求的 ID。

3. 在位置字段中，点击浏览以显示项目的潜在位置。然后，点击选择。
   注意：找不到您的 Google Workspace 组织？
   这意味着您未登录 Google Workspace 账号。Google Workspace 开发者文档中介绍的部分功能仅适用于与组织关联的项目。
4. 点击创建。Google Cloud 控制台会转到“信息中心”页面，您的项目会在几分钟内创建。

gcloud CLI

在以下任一开发环境中，访问 Google Cloud CLI (gcloud)：

• Cloud Shell：如需使用已设置 gcloud CLI 的在线终端，请激活 Cloud Shell。
  激活 Cloud Shell
• 本地 Shell：如需使用本地开发环境，请安装并初始化 gcloud CLI。
  如需创建云项目，请使用 gcloud projects create 命令：

  gcloud projects create PROJECT_ID

  通过设置要创建的项目 ID 来替换 PROJECT_ID。

如需进一步了解云项目，请参阅 Google Cloud 文档中的创建和管理项目。

可选：为 Cloud 项目启用结算功能

根据您要使用的 Google Workspace API 和功能，您可能还需要为云项目启用结算功能：

注意：如果您将用户管理的云项目与 Google AI Studio 搭配使用，则受支持的 Google Workspace API 不需要 Cloud Billing 账号。

如果您无法关联结算账号，则表示您没有进行此更改所需的权限。如需了解详情，请参阅启用结算功能所需的权限。

Google Cloud 控制台

1. 在 Google Cloud 控制台中，前往结算。依次点击菜单 > 结算 > 我的项目。

   转到“我的项目的结算信息”

2. 在选择组织中，选择与您的 Google Cloud 项目关联的组织。
3. 在项目行中，打开操作菜单 ()，点击更改结算信息，然后选择 Cloud Billing 账号。
4. 点击设置账号。

gcloud CLI

1. 如需列出可用的结算账号，请运行以下命令：

   gcloud billing accounts list

2. 将结算账号与 Google Cloud 项目相关联：

   gcloud billing projects link PROJECT_ID --billing-account=BILLING_ACCOUNT_ID

   替换以下内容：

   • PROJECT_ID 是您要为其启用结算功能的云项目的项目 ID。
   • BILLING_ACCOUNT_ID 是要与 Google Cloud 项目关联的结算账号 ID。

如需详细了解结算，请参阅 Google Cloud Billing 文档中的为项目启用、停用或更改结算功能。

下一步

在云项目中启用 Google Workspace API。