Go 的 Google Cloud 客户端库
用于 Google Cloud Platform 服务的 Go 包。
安装
go get cloud.google.com/go/firestore@latest # Replace firestore with the package you want to use.NOTE: 其中一些包正在开发中，可能会偶尔 进行向后不兼容的更改。
支持的 API
要获取我们所有已发布 API 的最新列表，请参阅我们的 参考文档。
支持的 Go 版本
我们的库与最近两个主要 Go 版本兼容，这与 Go 编程语言遵循的相同策略。这意味着当前支持的版本是：
- Go 1.25
- Go 1.26
身份验证
默认情况下，每个客户端库都会使用应用默认凭据 (ADC) 来自动配置调用 API 端点时使用的凭据。 在 Google Cloud Platform 环境（如 Compute Engine、Kubernetes Engine 或 App Engine）中使用这些库时， 无需额外的身份验证步骤。请参阅Google 的身份验证方法 和使用客户端库进行身份验证 以获取更多信息。
client, err := storage.NewClient(ctx)对于在其他位置运行的应用程序，例如您的本地开发环境，
您可以使用 gcloud auth application-default login 命令从
Google Cloud CLI 在
您的本地文件系统中设置用户凭据。Application Default Credentials 将自动检测
这些凭据。请参阅 Set up ADC for a local development
environment
以获取更多信息。
或者，您可能需要提供凭据的显式路径。若要使用
service account
密钥文件进行身份验证，请将 GOOGLE_APPLICATION_CREDENTIALS 环境变量设置为
密钥文件的路径，或以编程方式将
option.WithCredentialsFile
传递给所需包的 NewClient 函数。例如：
client, err := storage.NewClient(ctx, option.WithCredentialsFile("path/to/keyfile.json"))您可以通过使用
credentials 包来
创建 auth.Credentials。
然后将 option.WithAuthCredentials
传递给 NewClient 函数：
creds, err := credentials.DetectDefault(&credentials.DetectOptions{...})
...
client, err := storage.NewClient(ctx, option.WithAuthCredentials(creds))贡献
欢迎贡献。请参阅 CONTRIBUTING 文档以获取详细信息。
请注意，本项目附带贡献者行为准则发布。 参与本项目即表示您同意遵守其条款。 请参阅 Contributor Code of Conduct 以获取更多信息。