REST Resource: users.messages

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Ressource: Message

Un e-mail.

Représentation JSON 
{
  "id": string,
  "threadId": string,
  "labelIds": [
    string
  ],
  "snippet": string,
  "historyId": string,
  "internalDate": string,
  "payload": {
    object (MessagePart)
  },
  "sizeEstimate": integer,
  "raw": string
}
Champs
id

string

ID immuable du message.
threadId

string

ID du fil de discussion auquel le message appartient. Pour ajouter un message ou un brouillon à un fil de discussion, les critères suivants doivent être respectés:

  1. Le threadId demandé doit être spécifié sur le Message ou le Draft.Message que vous fournissez avec votre requête.
  2. Les en-têtes References et In-Reply-To doivent être définis conformément à la norme RFC 2822.
  3. Les en-têtes Subject doivent correspondre.
labelIds[]

string

Liste des ID des libellés appliqués à ce message.
snippet

string

Partie courte du texte du message.
historyId

string

ID du dernier enregistrement d'historique qui a modifié ce message.
internalDate

string (int64 format)

Horodatage interne de la création du message (epoch ms), qui détermine l'ordre dans la boîte de réception. Pour les e-mails reçus normalement par SMTP, il s'agit de l'heure à laquelle le message a été initialement accepté par Google, ce qui est plus fiable que l'en-tête Date. Toutefois, pour les messages migrés par l'API, il peut être configuré par le client afin qu'il soit basé sur l'en-tête Date.
payload

object (MessagePart)

Structure de l'e-mail analysé dans les parties du message
sizeEstimate

integer

Taille estimée en octets du message.
raw

string (bytes format)

E-mail complet dans une chaîne au format RFC 2822 et encodée en base64url. Renvoyé dans les réponses messages.get et drafts.get lorsque le paramètre format=RAW est fourni.

Chaîne encodée en base64.

Partie du message

Partie d'un message MIME unique.

Représentation JSON 
{
  "partId": string,
  "mimeType": string,
  "filename": string,
  "headers": [
    {
      object (Header)
    }
  ],
  "body": {
    object (MessagePartBody)
  },
  "parts": [
    {
      object (MessagePart)
    }
  ]
}
Champs
partId

string

ID immuable de la partie message.
mimeType

string

Type MIME de la partie du message.
filename

string

Nom de fichier de la pièce jointe. Présent uniquement si cette partie du message représente une pièce jointe.
headers[]

object (Header)

Liste des en-têtes dans cette partie du message. Pour la partie supérieure du message, qui représente l'intégralité de la charge utile, il contient les en-têtes RFC 2822 standards tels que To, From et Subject.
body

object (MessagePartBody)

Corps du message, qui peut être vide pour les parties MIME du conteneur.
parts[]

object (MessagePart)

Les parties du message MIME enfant de cette partie. Cela ne s'applique qu'aux parties du message MIME du conteneur, par exemple multipart/*. Pour les types de parties de messages MIME non issus de conteneurs, tels que text/plain, ce champ est vide. Pour en savoir plus, consultez la RFC 1521.
Représentation JSON 
{
  "name": string,
  "value": string
}
Champs
name

string

Nom de l'en-tête avant le séparateur :. Exemple : To.
value

string

Valeur de l'en-tête après le séparateur :. Exemple : someuser@example.com.

Méthodes

batchDelete

 Supprime de nombreux messages par identifiant.

batchModify

 Modifie les libellés des messages spécifiés.

delete

 Supprime immédiatement et définitivement le message spécifié.

get

 Récupère le message spécifié.

import

 Importe un message uniquement dans la boîte aux lettres de cet utilisateur, avec une analyse et une classification des e-mails standards, comme pour la réception via SMTP.

insert

 Insère directement un message uniquement dans la boîte aux lettres de l'utilisateur, comme dans IMAP APPEND. La plupart des analyses et des classifications sont ainsi ignorées.

list

 Liste les messages de la boîte aux lettres de l'utilisateur.

modify

 Modifie les libellés du message spécifié.

send

 Envoie le message spécifié aux destinataires indiqués dans les en-têtes To, Cc et Bcc.

trash

 Permet de placer le message spécifié dans la corbeille.

untrash

 Supprime le message spécifié de la corbeille.