REST Resource: users.messages

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

Identifiant 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, vous devez respecter les critères suivants:

  1. Le threadId demandé doit être indiqué sur la 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

Brève partie du texte du message.

historyId

string

ID du dernier enregistrement de l'historique qui a modifié ce message.

internalDate

string (int64 format)

Code temporel de création du message interne (epoch ms), qui détermine l'ordre dans la boîte de réception Pour les e-mails SMTP standards, 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 e-mails migrés via l'API, le client peut le configurer pour qu'il soit basé sur l'en-tête Date.

payload

object (MessagePart)

Structure de l'e-mail analysée dans les différentes parties du message.

sizeEstimate

integer

Taille estimée du message, en octets.

raw

string (bytes format)

L'intégralité du message électronique sous forme d'une chaîne au format RFC 2822 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.

MessagePart

Une seule partie de message MIME.

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 d'en-têtes pour cette partie du message. Pour la partie de message de premier niveau, qui représente la totalité de la charge utile du message, elle contiendra les en-têtes d'e-mail RFC 2822 standards tels que To, From et Subject.

body

object (MessagePartBody)

Corps du message pour cette partie, qui peut être vide pour les parties de message MIME du conteneur.

parts[]

object (MessagePart)

Parties des messages MIME enfants de cette partie. Cela ne s'applique qu'aux parties de message MIME du conteneur, par exemple multipart/*. Ce champ est vide pour les types de parties des messages MIME qui ne sont pas des conteneurs, tels que text/plain. Pour plus d'informations, consultez la norme 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 ID.

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 standards de la distribution des e-mails semblables à la réception via SMTP.

insert

Insère directement un message semblable à IMAP APPEND dans la boîte aux lettres de l'utilisateur, évitant ainsi la plupart des processus d'analyse et de classification.

list

Liste les messages dans 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 dans les en-têtes To, Cc et Bcc.

trash

Place le message spécifié dans la corbeille.

untrash

Supprime le message spécifié de la corbeille.