用于Go的谷歌云客户端库
用于Google 云平台服务的 Go 包。
import "cloud.google.com/go"
要在你的系统上安装这些包,请不要克隆这个 repo。而是。
-
改变到你的项目目录:
cd /my/cloud/project -
获取你想使用的包。有些产品有自己的模块,所以最好是
go get你想使用的包:$ go get cloud.google.com/go/firestore # Replace with the package you want to use.
注意:其中一些包正在开发中,可能偶尔会做出向后不兼容的改变。
支持的API
关于我们发布的所有API的最新列表,请参见我们的参考文档。
支持的Go版本
我们的库至少与三个最新的、主要的 Go 版本兼容。目前,它们与以下版本兼容。
- Go 1.18
- Go 1.17
- Go 1.16
- Go 1.15
授权
默认情况下,每个API都将使用谷歌应用默认凭证,用于调用API端点的授权凭证。这将使你的应用程序能够在许多环境中运行,而不需要明确的配置。
client, err := storage.NewClient(ctx)
要使用JSON密钥文件进行授权,请将 option.WithCredentialsFile到所需软件包的NewClient 函数,比如说:
client, err := storage.NewClient(ctx, option.WithCredentialsFile("path/to/keyfile.json"))
你可以通过使用软件包创建一个,对授权进行更多的控制。 golang.org/x/oauth2包来创建一个oauth2.TokenSource 。然后将 option.WithTokenSource到NewClient 函数:snip:# (auth-ts)
tokenSource := ...
client, err := storage.NewClient(ctx, option.WithTokenSource(tokenSource))
贡献
我们欢迎你的贡献,请参阅贡献文件以了解详情。
请注意,本项目发布时有一个贡献者行为准则。通过参与本项目,你同意遵守其条款。更多信息请参见贡献者行为准则。