Sobre o projeto

Este repositório fornece as bibliotecas de cliente oficiais em Go para os serviços do Google Cloud Platform. Cada serviço é exposto como seu próprio pacote importável sob o módulo cloud.google.com/go, para que os desenvolvedores possam incluir apenas as APIs de que precisam. A instalação é feita por meio do sistema de módulos do Go, por exemplo `go get cloud.google.com/go/firestore@latest`, substituindo firestore pelo pacote desejado. O README observa que alguns pacotes ainda estão em desenvolvimento e podem ocasionalmente introduzir mudanças incompatíveis com versões anteriores, portanto, fixar versões é recomendável para uso em produção. Uma lista completa das APIs lançadas é mantida na documentação de referência do projeto. A autenticação depende do Application Default Credentials (ADC). Em ambientes do Google Cloud, como Compute Engine, Kubernetes Engine ou App Engine, nenhuma configuração extra é necessária; os clientes descobrem as credenciais automaticamente. Para desenvolvimento local, o comando `gcloud auth application-default login` da Google Cloud CLI pode preencher as credenciais do usuário. Como alternativa, um arquivo de chave de conta de serviço pode ser referenciado pela variável de ambiente GOOGLE_APPLICATION_CREDENTIALS ou passado programaticamente com `option.WithCredentialsFile`. Para controle mais refinado, o pacote credentials pode construir um valor auth.Credentials que é então fornecido por meio de `option.WithAuthCredentials`. As bibliotecas seguem a política de lançamento do projeto Go e oferecem suporte às duas versões principais mais recentes do Go. Contribuições são aceitas de acordo com o guia de contribuição e o código de conduta do projeto. O README também contém links para material de introdução ao Go no Google Cloud, incluindo quickstarts do App Engine, Cloud Functions e Cloud Run.