リージョン ID
REGION_ID は、アプリの作成時に選択したリージョンに基づいて Google が割り当てる省略形のコードです。一部のリージョン ID は、一般的に使用されている国や州のコードと類似しているように見える場合がありますが、このコードは国または州に対応するものではありません。2020 年 2 月以降に作成されたアプリの場合、REGION_ID.r が App Engine の URL に含まれています。この日付より前に作成されたアプリの場合、URL のリージョン ID は省略可能です。
詳しくは、リージョン ID をご覧ください。
サポートされている HTTP ヘッダーの詳細、App Engine でのリクエストとレスポンスに関する制限事項の詳細については、このリファレンス ページをご覧ください。App Engine がリクエストを受信して、レスポンスを送信する仕組みの詳細については、リクエストの処理方法をご覧ください。
リクエスト ヘッダー
受信した HTTP リクエストには、クライアントから送信された HTTP ヘッダーが含まれています。セキュリティ上の理由から、一部のヘッダーは、アプリケーションに到達する前に中間プロキシによってサニタイズ、削除または修正されます。
受信リクエストから削除されるヘッダー
クライアントがリクエストを送信すると、次のヘッダーが受信リクエストから削除されます。
X-Google-*パターンに一致する名前を含むヘッダー。この名前のパターンは Google で予約されています。App Engine 固有のヘッダーと一致する名前を含むヘッダー。大文字と小文字を区別しない完全一致のみが削除されます。たとえば、
X-Appengine-CountryまたはX-AppEngine-Countryという名前のヘッダーは削除されますが、X-Appengine-Cntryは削除されません。
Accept-EncodingConnectionKeep-AliveProxy-AuthorizationTETrailerTransfer-Encoding
たとえば、サーバーが Accept-Encoding リクエスト ヘッダーの値に応じて、gzip 圧縮されたレスポンスを自動的に送信する場合があります。アプリケーション自体は、クライアントがどのコンテンツ エンコードを受け付け可能かを認識している必要はありません。
App Engine 固有のヘッダー
アプリに対するサービスとして、App Engine は、以下のヘッダーをすべてのリクエストに追加します。
X-Appengine-Country- リクエスト送信元の国を表す ISO 3166-1 alpha-2 国コード。App Engine は、クライアントの IP アドレスからこのコードを決定します。国情報は WHOIS データベースから導出されるものではないことに注意してください。ある IP アドレスの国情報が WHOIS データベースには存在していても、
X-Appengine-Countryヘッダーに国情報が含まれていないということもあります。アプリケーションは、特別な国コードZZ（不明な国）を処理できるようにしておく必要があります。 X-Appengine-Region- リクエスト送信元のリージョンの名前。この値は、
X -Appengine-Countryの国のコンテキストでのみ意味があります。たとえば、国が「US」でリージョンが「ca」の場合は、この「ca」はカナダではなく「カリフォルニア州」を意味します。有効なリージョン値の一覧については、ISO-3166-2 規格をご覧ください。 X-Appengine-City- リクエスト送信元の都市の名前。たとえば、リクエストの送信元がマウンテン ビューという都市の場合は、ヘッダー値が
mountain viewとなります。このヘッダーに有効な値の正式な一覧はありません。 X-Appengine-CityLatLong- リクエスト送信元の都市の緯度と経度。米国のマウンテンビューからのリクエストの場合は、この文字列が「37.386051,-122.083851」のようになります。
X-Cloud-Trace-Context- Cloud Trace と Cloud Logging に使用されるリクエスト用の一意の ID。App Engine スタンダード環境上のすべてのアプリはトレースが自動的に行われるため、このヘッダーを無効にすることや、トレースのサンプリング レートを選択することはできません。
X-Forwarded-For: [CLIENT_IP(s)], [global forwarding rule IP]クライアント リクエストがルーティングされた際に経由した IP アドレスからなるカンマ区切りリスト。このリストの最初の IP アドレスは、通常は、そのリクエストを作成したクライアントの IP アドレスです。それ以降の IP アドレスには、このリクエストがアプリケーション サーバーに到達するまでに経由した各プロキシ サーバーに関する情報が含まれます。次に例を示します。
X-Forwarded-For: clientIp, proxy1Ip, proxy2IpX-Forwarded-Proto [http | https]クライアントでアプリケーションに接続するために使用されたプロトコルに基づいて、
httpまたはhttpsが表示されます。Google Cloud ロードバランサですべての
https接続が終了され、httpを介して App Engine インスタンスにトラフィックが転送されます。たとえば、ユーザーがhttps://PROJECT_ID.REGION_ID.r.appspot.comを介してサイトへのアクセスをリクエストする場合、X-Forwarded-Proto ヘッダーの値はhttpsになります。
さらに、App Engine は内部で使用する以下のヘッダーを設定できます。
X-Appengine-HttpsX-Appengine-User-IPX-Appengine-Api-TicketX-Appengine-Request-Log-IdX-Appengine-Default-Version-HostnameX-Appengine-Timeout-Ms
app.yamlで指定されたlogin:adminハンドラまたはlogin:requiredハンドラの場合、App Engine は次の一連のヘッダーを追加します。X-Appengine-User-Email（ヘッダー例:「ange@example.com」）X-Appengine-Auth-Domain（ヘッダー例:「example.com」）X-Appengine-User-ID（ヘッダー例:「100979712376541954724」）X-Appengine-User-Nickname（ヘッダー例:「ange」）X-Appengine-User-Organization（ヘッダー例:「example.com」）X-Appengine-User-Is-Admin（ヘッダー例:「1」）
タスクキュー サービスは、リクエスト内のタスクの詳細とタスクが関連付けられているキューの詳細を提供する追加ヘッダーをリクエストに追加します。
cron サービスからのリクエストにより、次のヘッダーが追加されます。
X-Appengine-Cron: true詳しくは、cron の URL を保護するをご覧ください。
他の App Engine アプリケーションから送信されたリクエストには、リクエスト元のアプリが URL 取得サービスを使用している場合、リクエストを発行したアプリを識別するヘッダーが含まれています。
X-Appengine-Inbound-Appid詳細については、App Identity のドキュメントをご覧ください。
リクエストのレスポンス
この HTTP ヘッダーに関するドキュメントは、インバウンド HTTP リクエストに対するレスポンスにのみ適用されます。レスポンスは、クライアントに返される前に変更されることがあります。App Engine コードから送信されるアウトバウンド リクエストに関連する HTTP ヘッダーについては、URL 取得のヘッダー ドキュメントをご覧ください。
削除されるヘッダー
以下のヘッダーは無視され、レスポンスから削除されます。
ConnectionContent-Encoding*Content-LengthDateKeep-AliveProxy-AuthenticateServerTrailerTransfer-EncodingUpgrade
* App Engine がレスポンスを圧縮する場合には、再度追加されることがあります。
名前または値に非 ASCII 文字を含むヘッダーも削除されます。
追加または置換されるヘッダー
レスポンス内で、以下のヘッダーが追加または置換されます。
Cache-Control、Expires、Varyこれらのヘッダーでは、中間ウェブプロキシ（Google フロントエンド、インターネット サービス プロバイダなど）やブラウザに対するキャッシング ポリシーを指定します。アプリによってこれらのレスポンス ヘッダーが設定された場合、通常は変更されませんが、アプリによって
Set-Cookieヘッダーも設定された場合、またはそのレスポンスの対象のユーザーが管理者アカウントを使用してログインした場合は除きます。アプリによって
Set-Cookieレスポンス ヘッダーが設定された場合、Cache-Controlヘッダーはprivateに（まだ制限されていない場合）、Expiresヘッダーは現在の日付（まだ過去になっていない場合）に設定されます。一般的に、これでブラウザがレスポンスをキャッシュに保存できますが、中間プロキシ サーバーではキャッシュに保存できません。これはセキュリティ上の理由からです。仮にレスポンスが一般公開された状態でキャッシュに保存されたとすると、その後で別のユーザーが同じリソースをリクエストして、最初のユーザーの Cookie を取得できてしまう可能性があります。アプリによって
Cache-Controlレスポンス ヘッダーが設定されていない場合、サーバーはこのヘッダーをprivateに設定してVary: Accept-Encodingヘッダーを追加することがあります。Google フロントエンドでサポートされている
Vary値のリストなど、キャッシュ保存の詳細については、レスポンスのキャッシュ保存をご覧ください。Content-Encodingリクエスト ヘッダーとレスポンスの
Content-Typeに応じて、サーバーは前述のようにレスポンスの本文を自動的に圧縮する場合があります。この場合、サーバーはContent-Encoding: gzipヘッダーを追加して本文が圧縮されていることを示します。詳細については、レスポンスの圧縮をご覧ください。Content-LengthまたはTransfer-Encodingサーバーは、アプリケーションから返される
Content-Lengthヘッダーを常に無視します。Content-Lengthを本文の長さに設定するか（圧縮が適用される場合は圧縮後の長さ）、Content-Lengthを削除し、チャンク転送エンコードを使用します（Transfer-Encoding: chunkedヘッダーを追加します）。Content-Typeアプリケーションで指定されていない場合、サーバーはデフォルトの
Content-Type: text/htmlヘッダーを設定します。Date現在の日時に設定します。
ServerGoogle Frontendに設定します。
サイトの動的ページにアクセスするユーザーが管理者アカウントを使用してログインしている場合は、App Engine からのレスポンス ヘッダーにリクエストごとの統計情報が含まれます。
X-Appengine-Resource-Usage- リクエストで使用されるリソース（ミリ秒単位）。サーバー側の時間も含まれます。
リソースの使用統計情報を含むレスポンスはキャッシュに保存できなくなります。
X-Appengine-BlobKey ヘッダーがアプリケーションのレスポンスに含まれている場合は、ヘッダー（および省略可能な X-Appengine-BlobRange ヘッダー）を使用して、本文が blobstore blob のすべてまたは一部のコンテンツに置き換えられます。Content-Type がアプリケーションで指定されていない場合は、blob の MIME タイプに設定されます。範囲がリクエストされている場合は、レスポンス ステータスが 206 Partial Content に変更され、Content-Range ヘッダーが追加されます。X-Appengine-BlobKey ヘッダーと X-Appengine-BlobRange ヘッダーはレスポンスから削除されます。通常、これらのヘッダーは、blobstore_handlers.BlobstoreDownloadHandler クラスで自動的に設定されるため、ご自分で設定する必要はありません。詳細については、blob を提供するをご覧ください。
アプリケーションの構成に含まれるレスポンス ヘッダー
カスタム HTTP レスポンス ヘッダーを、アプリケーションの構成ファイル内の動的または静的パスの URL ごとに設定できます。詳しくは構成ドキュメントの http_headers セクションをご覧ください。