El paquete de appengine

import "google.golang.org/appengine"

Introducción

El paquete de appengine proporciona una funcionalidad básica para Google App Engine.

A fin de obtener más información sobre cómo escribir aplicaciones de Go para Google App Engine, consulta 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)

AccessToken genera un token de acceso OAuth2 para los alcances especificados en nombre de la cuenta de servicio de esta aplicación. Este token vencerá después del tiempo que se muestra.

func AppID

func AppID(c context.Context) string

AppID muestra el ID de la aplicación para la aplicación actual. La string será un ID de aplicación simple (p. ej., “appid”), con un prefijo de dominio para implementaciones de dominio personalizadas (p. ej., “example.com:appid”).

func Datacenter

func Datacenter(c context.Context) string

Datacenter muestra un identificador para el centro de datos en el que se ejecuta la instancia.

func DefaultVersionHostname

func DefaultVersionHostname(c context.Context) string

DefaultVersionHostname muestra el nombre de host estándar de la versión predeterminada de la aplicación actual (p. ej., “my-app.appspot.com”). Esto es adecuado para construir URL.

func InstanceID

func InstanceID() string

InstanceID muestra un identificador mayormente único para esta instancia.

func IsDevAppServer

func IsDevAppServer() bool

IsDevAppServer informa si la aplicación de App Engine se está ejecutando en el servidor de aplicaciones de desarrollo.

func IsOverQuota

func IsOverQuota(err error) bool

IsOverQuota informa si err representa una falla en la llamada a la API debido a una cuota disponible insuficiente.

func IsTimeoutError

func IsTimeoutError(err error) bool

IsTimeoutError informa si err es un error de tiempo de espera.

func ModuleHostname

func ModuleHostname(c context.Context, module, version, instance string) (string, error)

ModuleHostname muestra un nombre de host de una instancia del módulo. Si el módulo corresponde a la string vacía, se refiere al módulo de la instancia actual. Si la versión está vacía, se refiere a la versión de la instancia actual si es válida, o la versión predeterminada del módulo de la instancia actual. Si la instancia está vacía, ModuleHostname muestra el nombre de host del balanceo de cargas.

func ModuleName

func ModuleName(c context.Context) string

ModuleName muestra el nombre del módulo de la instancia actual.

func Namespace

func Namespace(c context.Context, namespace string) (context.Context, error)

Namespace muestra un contexto de reemplazo que opera dentro del espacio de nombres dado.

func NewContext

func NewContext(req *http.Request) context.Context

NewContext muestra un contexto para una solicitud HTTP en tránsito. Esta función es económica.

func PublicCertificates

func PublicCertificates(c context.Context) ([]Certificate, error)

PublicCertificates recupera los certificados públicos de la aplicación. Se pueden usar para verificar una firma que muestra SignBytes.

func RequestID

func RequestID(c context.Context) string

RequestID muestra una string que identifica la solicitud de forma única.

func ServerSoftware

func ServerSoftware() string

ServerSoftware muestra la versión de lanzamiento de App Engine. En producción, se parece a “Google App Engine/X.Y.Z”. En el servidor de aplicaciones de desarrollo, se ve como “Desarrollo/X.Y”.

func ServiceAccount

func ServiceAccount(c context.Context) (string, error)

ServiceAccount muestra una string que representa el nombre de la cuenta de servicio, en el formato de una dirección de correo electrónico (generalmente, app_id@appspot.gserviceaccount.com).

func SignBytes

func SignBytes(c context.Context, bytes []byte) (keyName string, signature []byte, err error)

SignBytes firma bytes mediante una clave privada única para tu aplicación.

func VersionID

func VersionID(c context.Context) string

VersionID muestra el ID de la versión para la aplicación actual. Tendrá el formato “X.Y”, en el cual X se especifica en app.yaml y en el cual Y es un número generado cuando se sube cada versión de la aplicación. No incluye un nombre de módulo.

func WithContext

func WithContext(parent context.Context, req *http.Request) context.Context

WithContext muestra una copia del contexto superior y lo asocia con una solicitud HTTP en tránsito. Esta función es económica.

type BlobKey

type BlobKey string

BlobKey es una clave para un BLOB de blobstore.

Conceptualmente, este tipo pertenece al paquete de blobstore, pero se aloja en el paquete de appengine para evitar una dependencia circular: blobstore depende de datastore y datastore debe hacer referencia al tipo BlobKey.

type Certificate

type Certificate struct {
    KeyName string
    Data    []byte // PEM-encoded X.509 certificate
}

Certificate representa un certificado público para la aplicación.

type GeoPoint

type GeoPoint struct {
    Lat, Lng float64
}

GeoPoint representa una ubicación como latitud/longitud en grados.

func (GeoPoint) Valid

func (g GeoPoint) Valid() bool

Valid muestra si un GeoPoint está dentro de [-90, 90] de latitud y [-180, 180] de longitud.

type MultiError

type MultiError []error

Las operaciones por lotes muestran MultiError cuando hay errores con elementos específicos. Los errores se producirán en una correspondencia uno a uno con los elementos de entrada. Los elementos exitosos tendrán una entrada nil.

func (MultiError) Error

func (m MultiError) Error() string