用于Go的谷歌云客户端库

423 阅读2分钟

用于Go的谷歌云客户端库

Go Reference

用于Google 云平台服务的 Go 包。

import "cloud.google.com/go"

要在你的系统上安装这些包,请不要克隆这个 repo。而是。

  1. 改变到你的项目目录:

    cd /my/cloud/project
    
  2. 获取你想使用的包。有些产品有自己的模块,所以最好是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.WithTokenSourceNewClient 函数:snip:# (auth-ts)

tokenSource := ...
client, err := storage.NewClient(ctx, option.WithTokenSource(tokenSource))

贡献

我们欢迎你的贡献,请参阅贡献文件以了解详情。

请注意,本项目发布时有一个贡献者行为准则。通过参与本项目,你同意遵守其条款。更多信息请参见贡献者行为准则

链接