appengine パッケージ

import "google.golang.org/appengine"

概要

appengine パッケージは、Google App Engine の基本的な機能を提供します。

Google App Engine の Go アプリを記述する方法の詳細については、https://cloud.google.com/appengine/docs/standard/go/ をご覧ください。

索引

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 は、このアプリケーションのサービス アカウントに代わって、指定したスコープに対する OAuth2 アクセス トークンを生成します。このトークンは、返された時間の経過後に期限切れとなります。

func AppID

func AppID(c context.Context) string

AppID は、現在のアプリケーションのアプリケーション ID を返します。この文字列は、書式なしのアプリケーション ID(「appid」など)であり、カスタム ドメインのデプロイメントに対応したドメイン接頭辞が付きます(「example.com:appid」など)。

func Datacenter

func Datacenter(c context.Context) string

Datacenter は、インスタンスが実行されているデータセンターの識別子を返します。

func DefaultVersionHostname

func DefaultVersionHostname(c context.Context) string

DefaultVersionHostname は、現在のアプリケーションのデフォルトのバージョンの標準ホスト名を返します(「my-app.appspot.com」など)。これは、URL の構築に適しています。

func InstanceID

func InstanceID() string

InstanceID は、このインスタンスのほぼ一意の識別子を返します。

func IsDevAppServer

func IsDevAppServer() bool

IsDevAppServer は、App Engine アプリが開発用アプリサーバーで実行されているかどうかを報告します。

func IsOverQuota

func IsOverQuota(err error) bool

IsOverQuota は、err が割り当て不足による API 呼び出しの失敗を示しているかどうかを報告します。

func IsTimeoutError

func IsTimeoutError(err error) bool

IsTimeoutError は、err がタイムアウト エラーかどうかを報告します。

func ModuleHostname

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

ModuleHostname は、モジュール インスタンスのホスト名を返します。module が空の文字列の場合は、現在のインスタンスのモジュールが参照されます。version が空の場合は、現在のインスタンスのバージョン(有効な場合)、または現在のインスタンスのモジュールのデフォルトのバージョンが参照されます。instance が空の場合は、負荷分散のホスト名が返されます。

func ModuleName

func ModuleName(c context.Context) string

ModuleName は、現在のインスタンスのモジュール名を返します。

func Namespace

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

Namespace は、特定の名前空間内で動作する代替コンテキストを返します。

func NewContext

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

NewContext は、処理中の HTTP リクエストのコンテキストを返します。この関数は低コストで使用できます。

func PublicCertificates

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

PublicCertificates は、アプリの公開証明書を取得します。SignBytes から返された署名を検証する目的で使用できます。

func RequestID

func RequestID(c context.Context) string

RequestID は、リクエストを一意に識別する文字列を返します。

func ServerSoftware

func ServerSoftware() string

ServerSoftware は、App Engine のリリース バージョンを返します。本番環境では、「Google App Engine/X.Y.Z」のようになります。開発用アプリサーバーでは、「Development/X.Y」のようになります。

func ServiceAccount

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

ServiceAccount は、サービス アカウント名を表す文字列をメールアドレスの形式(通常は app_id@appspot.gserviceaccount.com)で返します。

func SignBytes

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

SignBytes は、アプリケーションに固有の秘密鍵を使用してバイトに署名します。

func VersionID

func VersionID(c context.Context) string

VersionID は、現在のアプリケーションのバージョン ID を返します。形式は「X.Y」となり、X は app.yaml で指定します。Y はアプリの各バージョンがアップロードされたときに生成された番号です。モジュール名は含まれていません。

func WithContext

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

WithContext は親コンテキストのコピーを返し、処理中の HTTP リクエストに関連付けます。この関数は低コストで使用できます。

type BlobKey

type BlobKey string

BlobKey は、Blobstore blob のキーです。

概念的には、このデータ型は blobstore パッケージに属するものですが、循環依存関係を回避するために appengine パッケージに格納されています。blobstore は datastore に依存し、datastore は BlobKey 型を参照する必要があります。

type Certificate

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

Certificate は、アプリの公開証明書を表します。

type GeoPoint

type GeoPoint struct {
    Lat, Lng float64
}

GeoPoint は、緯度 / 経度の度数による位置を表します。

func (GeoPoint) Valid

func (g GeoPoint) Valid() bool

Valid は、GeoPoint が緯度 [-90, 90]、経度 [-180, 180] の範囲に収まっているかどうかを返します。

type MultiError

type MultiError []error

MultiError は、特定の要素でエラーが発生している場合に、バッチ オペレーションによって返されます。エラーは入力要素と 1 対 1 で対応しており、成功した要素は nil エントリを持ちます。

func (MultiError) Error

func (m MultiError) Error() string