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

ID immuable du message.

threadId

string

ID du thread auquel le message appartient. Pour ajouter un message ou un brouillon à un fil de discussion, vous devez remplir les critères suivants:

  1. Le threadId demandé doit être spécifié dans 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 ayant modifié ce message.

internalDate

string (int64 format)

Code temporel de création du message interne (ms d'epoch), qui détermine l'ordre dans la boîte de réception. Pour les e-mails reçus par SMTP, il s'agit de l'heure à laquelle le message a été accepté par Google à l'origine, 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 en fonction de l'en-tête Date.

payload

object (MessagePart)

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

sizeEstimate

integer

Taille estimée du message en octets.

raw

string (bytes format)

L'intégralité du message d'e-mail dans une chaîne au format RFC 2822 et encodé 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 du message.

mimeType

string

Type MIME de la partie du message.

filename

string

Nom du 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 de cette partie du message. La partie de message de premier niveau, qui représente l'intégralité de la charge utile du message, contient les en-têtes de messagerie 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 de message MIME de conteneur.

parts[]

object (MessagePart)

Les parties du message MIME enfant de cette partie. Cela ne s'applique qu'aux parties de message MIME du conteneur, par exemple multipart/*. Pour les types de parties de message MIME autres que des 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 ID de message.

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 de réception de cet utilisateur, avec une analyse et une classification standard de la distribution des e-mails, semblable à la réception via SMTP.

insert

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

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 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.