import "google.golang.org/appengine"
Introdução
No pacote appengine, estão disponíveis funcionalidades básicas para o Google App Engine.
Para mais informações sobre como escrever aplicativos Go para o Google App Engine, acesse: https://cloud.google.com/appengine/docs/standard/go/
Index
- func AccessToken(c context.Context, scopes ...string) (token string, expiry time.Time, err error)
- func AppID(c context.Context) string
- func Datacenter(c context.Context) string
- func DefaultVersionHostname(c context.Context) string
- func InstanceID() string
- func IsDevAppServer() bool
- func IsOverQuota(err error) bool
- func IsTimeoutError(err error) bool
- func ModuleHostname(c context.Context, module, version, instance string) (string, error)
- func ModuleName(c context.Context) string
- func Namespace(c context.Context, namespace string) (context.Context, error)
- func NewContext(req *http.Request) context.Context
- func PublicCertificates(c context.Context) ([]Certificate, error)
- func RequestID(c context.Context) string
- func ServerSoftware() string
- func ServiceAccount(c context.Context) (string, error)
- func SignBytes(c context.Context, bytes []byte) (keyName string, signature []byte, err error)
- func VersionID(c context.Context) string
- func WithContext(parent context.Context, req *http.Request) context.Context
- type BlobKey
- type Certificate
- type GeoPoint
- func (g GeoPoint) Valid() bool
- type MultiError
- func (m MultiError) Error() string
func AccessToken
func AccessToken(c context.Context, scopes ...string) (token string, expiry time.Time, err error)
Um token de acesso OAuth2 é gerado pela função AccessToken para os escopos especificados em nome da conta de serviço deste aplicativo. Este token expirará após o tempo retornado.
func AppID
func AppID(c context.Context) string
Função usada para retornar a ID do aplicativo atual. A string será uma ID de aplicativo simples (por exemplo, "appid"), com um prefixo de domínio para implantações de domínio personalizado (por exemplo, "example.com:appid").
func Datacenter
func Datacenter(c context.Context) string
Função usada para retornar um identificador para o data center em que a instância está sendo executada.
func DefaultVersionHostname
func DefaultVersionHostname(c context.Context) string
Função usada para retornar o nome do host padrão da versão padrão do aplicativo atual (por exemplo, "my-app.appspot.com"). Adequada para uso na construção de URLs.
func InstanceID
func InstanceID() string
Função usada para retornar um identificador essencialmente exclusivo para esta instância.
func IsDevAppServer
func IsDevAppServer() bool
Função usada para informar se o aplicativo do App Engine está sendo executado no servidor de aplicativos de desenvolvimento.
func IsOverQuota
func IsOverQuota(err error) bool
Função usada para relatar se err representa uma falha de chamada de API devido à insuficiência da cota disponível.
func IsTimeoutError
func IsTimeoutError(err error) bool
Função usada para relatar se err é um erro de tempo limite.
func ModuleHostname
func ModuleHostname(c context.Context, module, version, instance string) (string, error)
Função usada para retornar um nome de host de uma instância de módulo. Se o módulo for uma string vazia, ele se refere ao módulo da instância atual. Se a versão estiver vazia, ela se refere à versão da instância atual se esta for válida, ou à versão padrão do módulo da instância atual. Se a instância estiver vazia, o nome do host de balanceamento de carga é retornado pelo ModuleHostname.
func ModuleName
func ModuleName(c context.Context) string
Função usada para retornar o nome do módulo da instância atual.
func Namespace
func Namespace(c context.Context, namespace string) (context.Context, error)
Função usada para retornar um contexto de substituição que opera dentro do namespace fornecido.
func NewContext
func NewContext(req *http.Request) context.Context
Função usada para retornar um contexto para uma solicitação HTTP em trânsito. Esta é uma função simples.
func PublicCertificates
func PublicCertificates(c context.Context) ([]Certificate, error)
PublicCertificates recupera os certificados públicos do aplicativo. Eles podem ser usados para verificar uma assinatura retornada por SignBytes.
func RequestID
func RequestID(c context.Context) string
Função usada para retornar uma string que identifica a solicitação de forma exclusiva.
func ServerSoftware
func ServerSoftware() string
Função usada para retornar a versão do App Engine. Na produção, o formato da versão é "Google App Engine/X.Y.Z". No servidor de desenvolvimento, o formato é: "Desenvolvimento/X.Y".
func ServiceAccount
func ServiceAccount(c context.Context) (string, error)
Função usada para retornar uma string que representa o nome da conta de serviço na forma de um endereço de e-mail (geralmente app_id@appspot.gserviceaccount.com).
func SignBytes
func SignBytes(c context.Context, bytes []byte) (keyName string, signature []byte, err error)
Função usada para assinar bytes usando uma chave particular exclusiva para o aplicativo.
func VersionID
func VersionID(c context.Context) string
Função usada para retornar o código da versão do aplicativo atual. Esse código estará no formato "X.Y", em que X é especificado em app.yaml, e Y é um número gerado quando cada versão do aplicativo é carregada. Não inclui um nome de módulo.
func WithContext
func WithContext(parent context.Context, req *http.Request) context.Context
Função usada para retornar uma cópia do contexto pai e associá-lo a uma solicitação HTTP em trânsito. Esta é uma função simples.
type BlobKey
type BlobKey string
BlobKey é uma chave de um blob do blobstore.
Conceitualmente, esse tipo pertence ao pacote blobstore, mas fica no pacote appengine para evitar uma dependência circular: o blobstore depende do armazenamento de dados, e o tipo BlobKey é consultado pelo armazenamento de dados.
type Certificate
type Certificate struct {
KeyName string
Data []byte // PEM-encoded X.509 certificate
}
Representa um certificado público do aplicativo.
type GeoPoint
type GeoPoint struct {
Lat, Lng float64
}
Representa um local no formato latitude/longitude em graus.
func (GeoPoint) Valid
func (g GeoPoint) Valid() bool
A função Valid é usada para informar se um GeoPoint está dentro da latitude [-90, 90] e longitude [-180, 180].
type MultiError
type MultiError []error
O tipo MultiError é retornado por operações em lote quando há erros em elementos específicos. Os erros estarão em correspondência um para um com os elementos de entrada, e os elementos bem-sucedidos terão uma entrada nula.
func (MultiError) Error
func (m MultiError) Error() string