REST Resource: users.messages

Ressource: Message

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 appartient le message. Pour ajouter un message ou un brouillon à un fil de discussion, les critères suivants doivent être remplis:

  1. L'élément threadId demandé doit être spécifié dans l'élément Message ou Draft.Message que vous fournissez avec votre demande.
  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 de libellés appliqués à ce message.

snippet

string

Brève partie du texte du message.

historyId

string

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

internalDate

string (int64 format)

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

payload

object (MessagePart)

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

sizeEstimate

integer

Taille estimée du message, en octets.

raw

string (bytes format)

E-mail complet dans une chaîne au format RFC 2822 et encodée en base64url. Est 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 du message MIME.

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

string

Identifiant immuable de la partie du message.

mimeType

string

Type MIME de la partie du message.

filename

string

Nom de fichier de la pièce jointe. Uniquement présente si la partie du message représente une pièce jointe.

headers[]

object (Header)

Liste des en-têtes de cette partie du message. Pour la partie de premier niveau du message, qui représente l'intégralité de la charge utile du message, elle contiendra les en-têtes d'e-mails RFC 2822 standards tels que To, From et Subject.

body

object (MessagePartBody)

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

parts[]

object (MessagePart)

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 message MIME non-conteneurs, tels que text/plain, ce champ est vide. Pour plus d'informations, consultez le document 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 en fonction de leur ID.

batchModify

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

delete

Le message spécifié est supprimé immédiatement et de manière définitive.

get

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

import

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

insert

Insère directement un message dans la boîte aux lettres de cet utilisateur, comme dans IMAP APPEND, en contournant la plupart des analyses et des classifications.

list

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

modify

Modifie les libellés associés au message spécifié.

send

Envoie le message spécifié aux destinataires figurant 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.