API Mail per servizi in bundle legacy

Le applicazioni App Engine possono inviare messaggi email per conto della posta elettronica dell'app indirizzi di ricezione e per conto di alcuni utenti con Account Google. Le app possono ricevere email a vari indirizzi. Le app inviano messaggi usando il servizio di posta e ricevere messaggi sotto forma di richieste HTTP avviate App Engine e pubblicati sull'app.

Invio di messaggi

Il servizio Posta può inviare messaggi email a uno o più destinatari. Un messaggio contiene un oggetto, un corpo in testo non crittografato e un corpo HTML facoltativo. Può anche contengono allegati di file e un insieme limitato di intestazioni.

Puoi utilizzare qualsiasi indirizzo email come destinatario. Un destinatario può essere in del messaggio "a" nel campo "Cc" campo o nascosto ai destinatari del messaggio (in "copia per conoscenza nascosta" o "Ccn").

Quando un'applicazione chiama il servizio Mail per inviare un messaggio, il messaggio viene messo in coda e la chiamata viene restituita immediatamente. Il servizio di posta utilizza le le procedure per contattare il server di posta di ciascun destinatario, recapitare il messaggio, e riprova se non è possibile contattare il server di posta.

Chi può inviare posta

Per motivi di sicurezza, l'indirizzo del mittente di un messaggio deve essere uno dei seguenti:

  • L'account Gmail o Google Workspace dell'utente che ha eseguito l'accesso
  • Qualsiasi indirizzo email nel modulo anything@[MY_PROJECT_ID].appspotmail.com o anything@[MY_PROJECT_NUMBER].appspotmail.com
  • Qualsiasi indirizzo email elencato nella console Google Cloud in Mittenti autorizzati dell'API Email

Tutti gli indirizzi email nell'elenco Mittenti autorizzati dell'API Email devono essere account Gmail o di domini ospitati da Google validi. Gli amministratori dell'app possono aggiungere i seguenti account all'elenco dei mittenti autorizzati:

  • Il proprio indirizzo email
  • Qualsiasi gruppo di cui è proprietario o gestore
  • Applicazioni ospitate in un dominio Google Workspace: noreply@[DOMAIN].com, a condizione che noreply@[DOMAIN].com sia un account valido (utente o gruppo).

Inoltre, gli amministratori di dominio dei domini gestiti da Google Workspace possono aggiungere qualsiasi utente del proprio dominio all'elenco dei mittenti autorizzati.

Hai un limite massimo di 50 mittenti autorizzati.

Posta da Google Workspace

Se invierai email da un dominio gestito da Google Workspace, devi impostare i record SPF DNS per il tuo dominio per indicare che Google è un una fonte attendibile per la tua email. Per istruzioni su come eseguire questa operazione, consulta Record SPF nel Centro assistenza Google Workspace.

Tieni presente che se utilizzi alias configurati per il tuo dominio Google Workspace, non puoi Inviare email da indirizzi email che utilizzano l'alias di dominio.

Notifiche di mancato recapito quando la posta non viene recapitata

La posta che corrisponde a una firma nota di spam, virus o altri contenuti dannosi potrebbe non essere accettata per la consegna.

Se il servizio di posta non è in grado di recapitare un messaggio o se il server di posta di un destinatario restituisce un avviso di mancato recapito (ad esempio, perché non esiste alcun account per questo indirizzo IP su quel sistema), è possibile inviare un messaggio di errore via email all'indirizzo il mittente del messaggio. L'applicazione stessa non riceve alcuna notifica sull'esito positivo o negativo del recapito.

Per impostazione predefinita, le notifiche di ritorno email non sono attivate. Per ricevere notifiche di mancato recapito delle email, devi configurare la tua applicazione.

Posta e server di sviluppo

Autenticazione con DomainKeys Identified Mail (DKIM)

Quando invii email, App Engine utilizza lo standard DKIM (DomainKeys Identified Mail) per autenticare il dominio. Se la tua applicazione invia messaggi da un indirizzo email che fa parte di un dominio Google Workspace, App Engine può firmare in modo crittografico le email che invia. Questa firma indica che un'email che dichiara di provenire da emma@example.com è stata effettivamente inviata da example.com. Il destinatario può controllare questa firma; se è corretta, il destinatario sa che il dominio del mittente non è stato contraffatto.

Per attivare l'autenticazione DKIM per i messaggi inviati dall'email di Google Workspace indirizzi, seguire queste istruzioni nel Centro assistenza Google Workspace. Tieni presente che possono essere necessarie fino a 48 ore prima che l'autenticazione DKIM sia attiva per il tuo dominio Google Workspace.

Devi anche assicurarti che l'applicazione utilizzi un dominio personalizzato e che sia uguale al tuo dominio Google Workspace. Tieni inoltre presente che i domini Google Workspace con sottodomini come subdomain.example.com non sono consentiti.

App Engine firmerà le email in uscita dell'applicazione se il mittente fa parte di un dominio Google Workspace con DKIM abilitato. Inoltre, l'indirizzo del mittente deve essere formattato in modo tale che la parte del dominio dell'email è composto solo da lettere minuscole.

Quote e limiti

Per visualizzare l'utilizzo attuale della quota da parte dell'applicazione, vai alla pagina Dettagli quota nella console Google Cloud.

Vai alla pagina Dettagli quota

Ogni richiesta di servizio Mail viene conteggiata ai fini della quota Chiamate API Mail. Esistono le quote per il numero di messaggi che è possibile inviare, il numero i messaggi che puoi inviare e la quantità di dati e allegati che puoi inviare. Per Per ulteriori dettagli, consulta l'articolo sulle quote di posta.

La quota viene reimpostata ogni giorno. Se superi la quota giornaliera, riceverai un'eccezione per superamento della quota. Se hai bisogno di inviare più email di quante consentite dalla quota, puoi utilizzare un provider di posta di terze parti, come SendGrid o Mailgun.

Oltre alle quote, al servizio di posta si applicano i seguenti limiti:

Limite Importo
Dimensione massima dei messaggi di posta in uscita, allegati inclusi 31,5 MB
Dimensioni massime dei messaggi di posta in arrivo, allegati inclusi 31,5 MB
Dimensione massima del messaggio quando un amministratore è un destinatario 16 kB
Numero massimo di mittenti autorizzati 50

Passaggi successivi