發出 HTTPS 要求

區域 ID

REGION_ID 是 Google 根據您在建立應用程式時選取的地區所指派的縮寫代碼。此代碼不對應至國家/地區或省份，即使部分區域 ID 可能與常用的國家/地區和省份代碼相似。如果是 2020 年 2 月後建立的應用程式，App Engine 網址會包含 REGION_ID.r。如果是這段時間前建立的現有應用程式，網址可選擇是否包含地區 ID。

進一步瞭解區域 ID。

本頁面說明如何使用網址擷取服務，透過 App Engine 應用程式發出 HTTP(S) 要求 (適用於第二代執行階段)。

建議您先使用語言慣用解決方案發出 HTTP(S) 要求，再使用網址擷取服務。使用網址擷取服務的主要用途是向其他 App Engine 應用程式發出 HTTP(S) 要求，並在該要求中聲明應用程式的身分。

如要進一步瞭解要求大小上限和透過網址擷取要求傳送的標頭，請參閱傳出要求一文。

發出 HTTP 要求

如要使用網址擷取服務發出傳出 HTTP(S) 要求，請

如要發出傳出 HTTP 要求，請使用下列任一程式庫：

為提升程式碼可攜性，請使用 Python 標準程式庫 urllib.request 發出 HTTP 要求。
使用 requests 等第三方程式庫。
明確呼叫 urlfetch 程式庫，並使用 urlfetch.fetch 方法。

urllib.request

匯入 urllib.request 程式庫：

import urllib.request

接著，使用 urllib.request 執行 GET 要求：

url = 'http://www.google.com/humans.txt'
try:
    result = urllib.request.urlopen(url)
    self.response.write(result.read())
except urllib.error.URLError:
    logging.exception('Caught exception fetching url')

urlfetch

下列程式碼片段示範如何使用 urlfetch 執行基本的 HTTP GET 要求。首先，從 App Engine SDK 匯入 urlfetch 程式庫：

from google.appengine.api import urlfetch

使用 urlfetch 執行 GET 要求：

url = 'http://www.google.com/humans.txt'
try:
    result = urlfetch.fetch(url)
    if result.status_code == 200:
        self.response.write(result.content)
    else:
        self.response.status_code = result.status_code
except urlfetch.Error:
    logging.exception('Caught exception fetching url')

下列程式碼片段示範如何執行更進階的要求，透過 HTTP POST 要求使用 urlfetch 從網頁表單提交資料：

try:
    form_data = urllib.urlencode(UrlPostHandler.form_fields)
    headers = {'Content-Type': 'application/x-www-form-urlencoded'}
    result = urlfetch.fetch(
        url='http://localhost:8080/submit_form',
        payload=form_data,
        method=urlfetch.POST,
        headers=headers)
    self.response.write(result.content)
except urlfetch.Error:
    logging.exception('Caught exception fetching url')

設定要求逾時

使用 urlfetch.set_default_fetch_deadline() 函式調整預設截止日期。這個函式會將新的預設期限儲存在執行緒本機變數上，因此必須在例如自訂中介軟體中依照不同要求進行個別設定。

停用重新導向

如果您使用網址擷取服務，預設情況下，基礎網址擷取服務最多會追蹤五次重新導向。這些重新導向可能會將授權標頭等私密資訊轉送至重新導向目的地。如果應用程式不需要 HTTP 重新導向，建議您停用重新導向。

如要禁止網址擷取服務追蹤重新導向連結，請將 fetch 方法的 follow_redirects 參數設為 False。