API Mail per servizi in bundle legacy

Le applicazioni App Engine possono inviare messaggi email per conto degli indirizzi email di ricezione dell'applicazione e per conto di alcuni utenti con Account Google. Le app possono ricevere email su vari indirizzi. Le app inviano messaggi tramite il servizio di posta e ricevono messaggi sotto forma di richieste HTTP avviate da App Engine e pubblicate nell'applicazione.

Invio della posta in corso...

Il servizio di 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 contenere file allegati e un insieme limitato di intestazioni.

Per un destinatario puoi utilizzare qualsiasi indirizzo email. Un destinatario può trovarsi nel campo "A" o nel campo "Cc" del messaggio oppure può essere nascosto ai destinatari del messaggio (una "copia per conoscenza nascosta" o "Ccn").

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

Chi può inviare email

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 attualmente 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 API email

Tutti gli indirizzi email nell'elenco dei mittenti autorizzati dell'API Email devono essere account Gmail o di dominio ospitati da Google validi. Gli amministratori di 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 (utente o gruppo) valido.

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

Esiste un limite massimo di 50 mittenti autorizzati.

Posta da Google Workspace

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

Tieni presente che se utilizzi alias configurati per il 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 relativa a spam, virus o altri contenuti dannosi potrebbe non essere accettata per il recapito.

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é nel sistema non esiste un account per quell'indirizzo), è possibile che un messaggio di errore venga inviato via email all'indirizzo del mittente del messaggio. L'applicazione stessa non riceve alcuna notifica sull'esito della consegna.

Per impostazione predefinita, le notifiche di mancato recapito delle email non sono abilitate. Per ricevere notifiche di mancato recapito delle email, devi configurare la tua applicazione. Per ulteriori dettagli, consulta Ricezione della notifica di mancato recapito.

Posta e server di sviluppo

Il server di sviluppo può essere configurato per inviare messaggi email direttamente dal computer quando testi una funzionalità dell'app che invia messaggi. Puoi configurare il server di sviluppo in modo che utilizzi un server SMTP di tua scelta. In alternativa, puoi indicare al server di sviluppo di utilizzare Sendmail, se Sendmail è installato sul tuo computer ed è configurato per l'invio di email.

Se non configuri un server SMTP o non abiliti Sendmail, quando l'app chiama il servizio Mail, il server di sviluppo registrerà i contenuti del messaggio. Il messaggio non verrà effettivamente inviato.

Autenticazione con DKIM (DomainKeys Identified Mail)

Quando invii la posta, 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 sembra provenire da emma@example.com proviene in realtà da example.com. Il destinatario può controllare questa firma; se la firma è corretta, il destinatario sa che il dominio del mittente non è stato oggetto di spoofing.

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

Devi inoltre assicurarti che la tua applicazione utilizzi un dominio personalizzato e che corrisponda al tuo dominio Google Workspace. Tieni inoltre presente che non sono consentiti domini Google Workspace con sottodomini come subdomain.example.com.

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 tale che la parte del dominio dell'indirizzo email consiste solo in lettere minuscole.

Quote e limiti

Per visualizzare l'utilizzo attuale delle quote della tua applicazione, vai alla pagina dei dettagli della quota nella console Google Cloud.

Vai alla pagina dei dettagli della quota

Ogni richiesta di servizio di posta viene conteggiata ai fini della quota di chiamate API Mail. Esistono anche delle quote per il numero di messaggi che puoi inviare, il numero di messaggi di amministrazione 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 di superamento quota. Se devi inviare una quantità maggiore di posta rispetto a quanto consentito 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
Dimensione massima 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