Mail API 總覽

App Engine 應用程式可代表應用程式的電子郵件訊息接收地址,以及某些 Google 帳戶的使用者傳送電子郵件訊息。應用程式可透過多種郵件地址接收電子郵件。應用程式會透過「郵件」服務傳送郵件,並由 App Engine 發出 HTTP 要求來接收郵件,然後張貼至應用程式。

傳送郵件

「郵件」服務可將電子郵件傳送給一或多名收件者,郵件內容包含主旨和純文字的內文,或者也可選擇 HTML 形式的內文。郵件還可加上檔案附件以及數量有限的標頭。

收件者可以是任何電子郵件地址。收件者可顯示在郵件的「收件者」欄位、「副本」欄位,或是不向其他郵件收件者顯示 (「密件副本」或稱「bcc」)。

當應用程式呼叫「郵件」服務以傳送郵件時,郵件會加入佇列,而呼叫將立即傳回。「郵件」服務會透過標準程序連線至每位收件者的郵件伺服器並傳送訊息,如果無法連線至郵件伺服器,則會重新嘗試連線。

哪些人可以傳送郵件

基於安全理由,郵件的寄件者地址必須是下列其中一項:

  • 目前登入使用者的 Gmail 或 G Suite 帳戶
  • 格式為 anything@[MY_PROJECT_ID].appspotmail.comanything@[MY_PROJECT_NUMBER].appspotmail.com 的任何電子郵件地址
  • GCP 主控台「Email API Authorized Senders」(Mail API 已獲授權的寄件者) 列出的任何電子郵件地址

Mail API 已獲授權的寄件者」清單上的所有電子郵件地址皆必須為有效的 Gmail 或 Google 代管網域帳戶。應用程式的系統管理員可將下列帳戶新增至「已獲授權的寄件者」清單:

  • 系統管理員自己的電子郵件地址
  • 系統管理員在其中擔任「擁有者」或「管理員」的任何群組
  • 在 G Suite 網域中託管的應用程式:noreply@[DOMAIN].com,但 noreply@[DOMAIN].com 必須為有效帳戶 (使用者或群組)

此外,G Suite 代管網域的網域系統管理員,也可將其網域中的任何使用者新增至「已獲授權的寄件者」清單。

已獲授權的寄件者最多以 50 位為限。

從 G Suite 傳送郵件

如果要從 G Suite 代管的網域傳送電子郵件,請為您的網域設定 DNS SPF 記錄,以表示 Google 是可信任的電子郵件來源。如需相關操作說明,請參閱 G Suite 說明文章 SPF 記錄

請注意,如果您使用的是為 G Suite 網域設定的別名,則無法透過使用該網域別名的電子郵件地址來傳送電子郵件。

郵件無法傳送時的退件通知

如果郵件符合垃圾郵件、病毒或其他惡意內容的已知簽名,該郵件可能無法傳送。

如果「郵件」服務無法傳送郵件,或收件者的郵件伺服器傳回退件通知 (例如,無法在對方的系統中找到該地址的帳戶),系統可能會透過電子郵件將錯誤訊息傳送至郵件寄件者的地址。應用程式本身不會收到傳送成功或失敗的任何通知。

根據預設,系統不會啟用電子郵件退件通知;您必須設定應用程式才能接收電子郵件退件通知。 詳情請參閱接收退件通知

郵件和開發伺服器

在開發伺服器中執行的應用程式呼叫「郵件」服務以傳送電子郵件時,該郵件會顯示於應用程式記錄中。開發伺服器並不會傳送電子郵件。

透過 DomainKeys Identified Mail (DKIM) 進行驗證

傳送郵件時,App Engine 會使用 DomainKeys Identified Mail (DKIM) 標準來驗證網域。如果應用程式使用屬於 G Suite 網域的電子郵件地址傳送郵件,App Engine 會為該郵件進行加密簽署。擁有這個簽名,即表示聲稱從 emma@example.com 傳送的電子郵件確實是來自 example.com。收件者可以檢查這個簽名,如果簽名正確,收件者就能確認寄件者的網域並非假冒。

如要針對從 G Suite 電子郵件地址傳送的郵件啟用 DKIM 驗證,請按照 G Suite 說明中心的指示進行操作。請注意,您最多可能需要等待 48 小時,G Suite 網域的 DKIM 驗證功能才會啟用。

您也必須確認應用程式是使用自訂網域,且此網域與您的 G Suite 網域相同。另請注意,系統不接受具有子網域的 G Suite 網域,例如 subdomain.example.com

如果寄件者的地址屬於已啟用 DKIM 的 G Suite 網域,App Engine 會為應用程式的外寄郵件進行簽署。此外,寄件者地址必須採用制式格式,確保電子郵件地址的網域部分僅由小寫字母組成。

配額與限制

如要查看應用程式目前的配額使用量,請前往 Google Cloud Platform 主控台中的「配額詳細資料」頁面。

前往「配額詳細資料」頁面

每個「郵件」服務要求都將計入「郵件 API 呼叫」配額中。不僅如此,您能夠傳送的郵件數、管理員郵件數、資料量與附件數,也都設有配額。詳情請參閱郵件配額

配額會每天重設。如果超出每日配額,您將會收到超過配額的例外狀況。如您需要傳送的郵件超過配額所允許的數量,您可以使用第三方郵件供應商,例如 SendGridMailgun

除了配額以外,「郵件」服務還受到下列限制:

限制 上限
外寄郵件的大小上限 (含附件) 31.5 MB
內送郵件的大小上限 (含附件) 31.5 MB
系統管理者是收件者時的郵件大小上限 16 KB
已獲授權的寄件者人數上限 50

後續步驟

本頁內容對您是否有任何幫助?請提供意見:

傳送您對下列選項的寶貴意見...

這個網頁
Java 適用的 App Engine 標準環境