Le applicazioni App Engine possono inviare messaggi email per conto degli indirizzi email di ricezione dell'app e per conto di alcuni utenti con Account Google. Le app possono ricevere email a vari indirizzi. Le app inviano messaggi utilizzando il servizio Mail e ricevono messaggi sotto forma di richieste HTTP avviate da App Engine e pubblicate nell'app.
Invio di email
Il servizio Posta può inviare messaggi email a uno o più destinatari. Un messaggio contiene un oggetto, un corpo in testo non criptato e un corpo HTML facoltativo. Può anche contenere allegati di file e un insieme limitato di intestazioni.
Puoi utilizzare qualsiasi indirizzo email per un destinatario. Un destinatario può trovarsi nel campo "A" del messaggio, nel campo "Cc" o essere nascosto ai destinatari del messaggio (una "copia carbone 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 Posta utilizza procedure standard per contattare il server di posta di ciascun destinatario, consegnare il messaggio e riprovare se il server di posta non può essere contattato.
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 del tipo
anything@[MY_PROJECT_ID].appspotmail.comoanything@[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 chenoreply@[DOMAIN].comsia 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.
Puoi aggiungere fino a un massimo di 50 mittenti autorizzati.
Posta di Google Workspace
Se invii email da un dominio gestito da Google Workspace, devi impostare i record DNS SPF per il tuo dominio in modo da indicare che Google è una fonte attendibile per le tue email. Per istruzioni su come eseguire questa operazione, consulta Record SPF nel Centro assistenza Google Workspace.
Tieni presente che se utilizzi gli alias configurati per il tuo dominio Google Workspace, non puoi inviare email da indirizzi email che utilizzano l'alias del dominio.
Notifiche di ritorno 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 Posta non riesce a consegnare un messaggio o se il server di posta di un destinatario restituisce un avviso di mancato recapito (ad esempio perché non esiste un account per quell'indirizzo nel sistema), un messaggio di errore può essere inviato via email all'indirizzo del 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 le notifiche di ritorno email, devi configurare l'applicazione.
Posta e server di sviluppo
Quando un'applicazione in esecuzione nel server di sviluppo chiama il servizio Mail per inviare un messaggio email, il messaggio viene stampato nei log dell'applicazione. Il server di sviluppo non invia il messaggio email.
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 criptograficamente 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 dagli indirizzi email di Google Workspace, segui 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 l'indirizzo del mittente fa parte di un dominio Google Workspace con DKIM abilitato. Inoltre, l'indirizzo del mittente deve essere formattato in modo che la parte del dominio dell'indirizzo email consista solo di lettere minuscole.
Quote e limiti
Per visualizzare l'utilizzo attuale delle quote della tua applicazione, vai alla pagina dei dettagli delle quote in Google Cloud Console.
Vai alla pagina Dettagli quota
Ogni richiesta di servizio di posta viene conteggiata ai fini della quota delle chiamate API Mail. Esistono inoltre quote per il numero di messaggi che puoi inviare, il numero di messaggi amministrativi che puoi inviare e la quantità di dati e allegati che puoi inviare. Per maggiori dettagli, consulta Quote per la 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.
Oltre alle quote, al servizio Posta si applicano i seguenti limiti:
| Limite | Importo |
|---|---|
| Dimensioni massime dei messaggi di posta in uscita, inclusi gli allegati | 31,5 MB |
| Dimensioni massime dei messaggi di posta in arrivo, inclusi gli allegati | 31,5 MB |
| Dimensione massima del messaggio quando un amministratore è un destinatario | 16 KB |
| Numero massimo di mittenti autorizzati | 50 |
Passaggi successivi
- Leggi le linee guida per la posta inviata in blocco.
- Scopri come inviare e ricevere email con l'API Mail.