Mail API 總覽

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

傳送郵件

「郵件」服務可傳送電子郵件訊息至一或多位收件者。訊息包含主旨、純文字本文,以及選用的 HTML 本文,也可以包含檔案附件以及一組有限的標頭。

在收件者部分,您可以使用任何電子郵件地址。收件者可以出現在訊息的「收件者」欄位或「副本」欄位,或是從訊息收件者中隱藏 (「密件副本」或「bcc」)。

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

哪些人可以傳送郵件

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

  • 目前登入使用者的 Gmail 或 G Suite 帳戶
  • 格式為 anything@[APP_NAME].appspotmail.comanything@[APP_ALIAS].appspotmail.com 的任何電子郵件地址
  • GCP 主控台的 Email API 已獲授權的寄件者之下所列的任何電子郵件地址

Email 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 網域設定的別名,則無法透過使用該網域別名的電子郵件地址來傳送電子郵件。

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

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

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

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

郵件和開發伺服器

測試應用程式傳送訊息的功能時,您可以將開發伺服器設定為直接從您的電腦傳送電子郵件訊息。您可以將開發伺服器設定為使用您選擇的 SMTP 伺服器。或者,如果電腦有安裝 Sendmail 並已完成傳送電子郵件的設定,則可以指示開發伺服器使用 Sendmail。

如果您並未設定 SMTP 伺服器或啟用 Sendmail,當應用程式呼叫「郵件」服務時,開發伺服器會記錄訊息內容,但實際上並未傳送訊息。

透過 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 主控台中的「配額詳細資料」頁面。

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

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

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

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

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

相關資源

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

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

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