Message avec en-têtes ou pièces jointes
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Lorsque vous envoyez un message à l'aide de l'API Mail, certaines restrictions s'appliquent aux en-têtes et aux types de fichiers que vous pouvez joindre.
L'en-tête d'un e-mail sortant fournit des informations sur le message, tels que l'expéditeur, le destinataire, la date et l'objet. Chaque en-tête a un nom et une valeur.
Vous pouvez également inclure les en-têtes suivants dans un e-mail sortant. Pour des raisons de sécurité, les autres en-têtes ne sont pas autorisés :
- In-Reply-To
- List-Id
- List-Unsubscribe
- On-Behalf-Of
- Références
- Resent-Date
- Resent-From
- Resent-To
Messages avec pièces jointes
Un e-mail sortant peut contenir des pièces jointes. Chaque pièce jointe a un nom de fichier et des données de fichier. Ces dernières peuvent provenir de toutes sortes de sources, comme un fichier de données de l'application ou le datastore.
Extensions de nom de fichier interdites
Par mesure de sécurité contre les virus, les pièces jointes d'e-mail ne peuvent pas utiliser les extensions de nom de fichier suivantes, ni les contenir dans des fichiers ZIP :
- ade
- adp
- chauve-souris
- chm
- cmd
- com
- cpl
- exe
- hta
- ins
- isp
- jse
- lib
- mde
- msc
- msp
- mst
- pif
- scr
- sct
- shb
- sys
- vb
- vbe
- vbs
- vxd
- wsc
- wsf
- wsh
Pièces jointes et types MIME
Le type MIME d'une pièce jointe est défini à partir de l'extension du fichier. Il identifie le type de contenu en cours d'envoi et peut déterminer le mode de transfert de ces données.
Voici une liste des types MIME et de leurs extensions de nom de fichier correspondantes. Vous n'êtes pas limité à ces extensions, mais si vous utilisez une extension inconnue, App Engine lui attribuera le type MIME application/octet-stream
.
Type MIME |
Extensions de nom de fichier |
application/msword |
doc, docx |
application/pdf |
pdf |
application/rss+xml |
rss |
application/vnd.google-earth.kml+xml |
kml |
application/vnd.google-earth.kmz |
kmz |
application/vnd.ms-excel |
xls, xlsx |
application/vnd.ms-powerpoint |
pps, ppt, pptx |
application/vnd.oasis.opendocument.presentation |
odp |
application/vnd.oasis.opendocument.spreadsheet |
ods |
application/vnd.oasis.opendocument.text |
odt |
application/vnd.sun.xml.calc |
sxc |
application/vnd.sun.xml.writer |
sxw |
application/x-gzip |
gzip |
application/zip |
zip |
audio/basic |
au snd |
audio/flac |
flac |
audio/mid |
mid, rmi |
audio/mp4 |
m4a |
audio/mpeg |
mp3 |
audio/ogg |
oga, ogg |
audio/x-aiff |
aif, aifc, aiff |
audio/x-wav |
wav |
image/gif |
gif |
image/jpeg |
jpeg, jpg, jpe |
image/png |
png |
image/tiff |
tiff, tif |
image/vnd.wap.wbmp |
wbmp |
image/x-ms-bmp |
bmp |
text/calendar |
ics |
text/comma-separated-values |
csv |
text/css |
css |
texte/html |
htm, html |
text/plain |
asc, c, diff, log, patch, pot, text, txt |
text/x-vcard |
vcf |
video/mp4 |
mp4 |
video/mpeg |
mpeg, mpg, mpe |
video/ogg |
ogv |
video/quicktime |
qt, mov |
video/x-msvideo |
avi |
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/09/04 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/09/04 (UTC)."],[[["\u003cp\u003eWhen using the Mail API, specific headers like In-Reply-To, List-Id, and others are allowed, while other headers are restricted for security.\u003c/p\u003e\n"],["\u003cp\u003eOutgoing emails can include file attachments from various sources, with each attachment having a filename and file data.\u003c/p\u003e\n"],["\u003cp\u003eCertain filename extensions, such as .exe, .bat, and .vbs, are prohibited for email attachments and within ZIP files to prevent the spread of viruses.\u003c/p\u003e\n"],["\u003cp\u003eThe Multipurpose Internet Mail Extensions (MIME) type, which is derived from the file extension, defines the content type of an attachment, and when an unknown extension is used it will be given the MIME type of \u003ccode\u003eapplication/octet-stream\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe provided documentation explains which first-generation runtimes can use the Mail API, as well as the migration options to second-generation runtimes.\u003c/p\u003e\n"]]],[],null,["# Mail with Headers or Attachments\n\nWhen you send mail using the [Mail API](/appengine/docs/legacy/standard/java/mail),\nthere are some restrictions on the headers that you can use and the types of\nfiles you can attach.\n| This API is supported for first-generation runtimes and can be used when [upgrading to corresponding second-generation runtimes](/appengine/docs/standard/\n| java-gen2\n|\n| /services/access). If you are updating to the App Engine Java 11/17 runtime, refer to the [migration guide](/appengine/migration-center/standard/migrate-to-second-gen/java-differences) to learn about your migration options for legacy bundled services.\n\nOptional headers you can use\n----------------------------\n\nAn outgoing email has headers that provide details about the message, such as\nthe sender, recipient, date, and subject. Each header has a name and a value.\nYou can also include the following headers in an outgoing email; for security\npurposes, other headers are not allowed:\n\n- In-Reply-To\n- List-Id\n- List-Unsubscribe\n- On-Behalf-Of\n- References\n- Resent-Date\n- Resent-From\n- Resent-To\n\nMail with attachments\n---------------------\n\nAn outgoing email message can have file attachments. Each attachment has a\nfilename and file data. The file data can come from any source, such as an\napplication data file or the datastore.\n\n### Filename extensions that are prohibited\n\nAs a security measure to protect against viruses, email attachments cannot use\nthe following filename extensions, and ZIP files cannot contain files with the\nfollowing filename extensions:\n\n- ade\n- adp\n- bat\n- chm\n- cmd\n- com\n- cpl\n- exe\n- hta\n- ins\n- isp\n- jse\n- lib\n- mde\n- msc\n- msp\n- mst\n- pif\n- scr\n- sct\n- shb\n- sys\n- vb\n- vbe\n- vbs\n- vxd\n- wsc\n- wsf\n- wsh\n\n### Attachments and Multipurpose Internet Mail Extensions (MIME) types\n\nThe MIME type of an attachment is determined from the file's extension. The MIME\ntype identifies the type of content that is being sent, and can determine how\nthat data is transferred.\n\nThe following is a list of MIME types and their corresponding filename\nextensions. You are not limited to these extensions, but if you use an unknown\nextension, App Engine will assign it the MIME type `application/octet-stream`."]]