轻松上手Google Cloud（使用Python与google-cloud-python SDK构建云应用）

什么是 google-cloud-python？

google-cloud-python 是 Google 官方为 Python 开发者提供的客户端库集合，用于访问 Google Cloud Platform（GCP）的各项服务，如 Cloud Storage、BigQuery、Pub/Sub、Firestore 等。每个服务都有独立的包，例如：

• google-cloud-storage：用于操作云存储
• google-cloud-bigquery：用于查询大数据
• google-cloud-firestore：用于 NoSQL 数据库操作

这些库统称为 Google Cloud Python 客户端库，是现代 Python 云开发的核心工具之一。

前置准备

在开始编码前，请确保完成以下步骤：

1. 拥有一个 Google Cloud Platform 账号（新用户可享 $300 赠金）
2. 创建一个 GCP 项目
3. 启用 Cloud Storage API
4. 安装 Python（建议 3.7+）
5. 安装 Google Cloud CLI（原 gcloud CLI）

第1步：安装必要的 Python 包

打开终端，运行以下命令安装 Cloud Storage 的 Python 客户端库：

pip install google-cloud-storage

第2步：设置身份验证

Google Cloud 使用服务账号（Service Account）进行身份验证。请按以下步骤操作：

1. 进入 GCP 控制台 → IAM 和管理 → 服务账号
2. 创建一个新的服务账号，赋予“Storage Admin”角色
3. 生成 JSON 密钥文件并下载到本地（例如：`my-key.json`）

然后设置环境变量（Linux/macOS）：

export GOOGLE_APPLICATION_CREDENTIALS="路径/to/my-key.json"

Windows 用户（PowerShell）：

$env:GOOGLE_APPLICATION_CREDENTIALS="路径\to\my-key.json"

第3步：编写 Python 代码上传文件到 Cloud Storage

现在我们来写一个简单的脚本，将本地文件上传到 GCS 存储桶（Bucket）中。

首先，确保你已创建一个存储桶（在 GCP 控制台或使用 CLI）：

gsutil mb gs://my-unique-bucket-name

然后，创建 Python 文件 upload_to_gcs.py：

from google.cloud import storage# 初始化客户端def upload_blob(bucket_name, source_file_name, destination_blob_name):    """上传文件到 Google Cloud Storage"""    client = storage.Client()    bucket = client.bucket(bucket_name)    blob = bucket.blob(destination_blob_name)    blob.upload_from_filename(source_file_name)    print(f"文件 {source_file_name} 已成功上传为 {destination_blob_name}.")# 示例调用if __name__ == "__main__":    upload_blob(        bucket_name="my-unique-bucket-name",        source_file_name="local-file.txt",        destination_blob_name="uploaded-file.txt"    )

运行该脚本前，请确保当前目录下存在 local-file.txt 文件。运行后，你会看到控制台输出上传成功的消息。

常见问题与调试

• 权限错误：确认服务账号有 Storage Admin 或至少 Storage Object Creator 角色
• 找不到模块：确认已正确安装 google-cloud-storage
• 认证失败：检查 GOOGLE_APPLICATION_CREDENTIALS 路径是否正确

总结

通过本教程，你已经掌握了如何使用 Google Cloud Python SDK（即 google-cloud-python）连接并操作 Google Cloud Storage。这为你后续使用 BigQuery、Firestore 等其他服务打下了坚实基础。无论是构建数据管道、Web 应用还是自动化脚本，Python连接Google Cloud 都是一种高效且简洁的方式。

希望这篇 Google Cloud SDK教程 对你有所帮助！快去尝试更多 Google Cloud 服务吧！