REST Resource: users.messages

संसाधन: मैसेज

ईमेल मैसेज.

जेएसओएन के काेड में दिखाना 
{
  "id": string,
  "threadId": string,
  "labelIds": [
    string
  ],
  "snippet": string,
  "historyId": string,
  "internalDate": string,
  "payload": {
    object (MessagePart)
  },
  "sizeEstimate": integer,
  "raw": string
}
फ़ील्ड
id

string

मैसेज का बदला न जा सकने वाला आईडी.
threadId

string

उस थ्रेड का आईडी जिससे मैसेज जुड़ा है. किसी थ्रेड में मैसेज या ड्राफ़्ट जोड़ने के लिए, इन शर्तों को पूरा करना ज़रूरी है:

  1. अनुरोध किए गए threadId के बारे में, Message या Draft.Message में बताया जाना चाहिए.
  2. References और In-Reply-To हेडर, आरएफ़सी 2822 स्टैंडर्ड के मुताबिक सेट होने चाहिए.
  3. Subject हेडर का मेल खाना ज़रूरी है.
labelIds[]

string

इस मैसेज पर लागू किए गए लेबल के आईडी की सूची.
snippet

string

मैसेज के टेक्स्ट का एक छोटा सा हिस्सा.
historyId

string

पिछले इतिहास रिकॉर्ड का आईडी जिसने इस मैसेज में बदलाव किया.
internalDate

string (int64 format)

इंटरनल मैसेज बनाने का टाइमस्टैंप (epoch ms), जिससे इनबॉक्स में ऑर्डर का क्रम तय किया जाता है. सामान्य एसएमटीपी से मिले ईमेल के लिए, यह उस समय को दिखाता है जब Google ने मूल रूप से मैसेज को स्वीकार किया था. यह Date हेडर से ज़्यादा भरोसेमंद है. हालांकि, एपीआई से माइग्रेट किए गए मेल के लिए, क्लाइंट इसे Date हेडर पर आधारित होने के लिए कॉन्फ़िगर कर सकता है.
payload

object (MessagePart)

मैसेज के हिस्सों में पार्स किए गए ईमेल का स्ट्रक्चर.
sizeEstimate

integer

मैसेज का अनुमानित साइज़, बाइट में.
raw

string (bytes format)

पूरा ईमेल मैसेज, आरएफ़सी 2822 फ़ॉर्मैट में और base64url एन्कोड की गई स्ट्रिंग में हो. format=RAW पैरामीटर दिए जाने पर, messages.get और drafts.get रिस्पॉन्स में दिखाया जाता है.

Base64 कोड में बदली गई स्ट्रिंग.

MessagePart

MIME मैसेज का एक हिस्सा.

जेएसओएन के काेड में दिखाना 
{
  "partId": string,
  "mimeType": string,
  "filename": string,
  "headers": [
    {
      object (Header)
    }
  ],
  "body": {
    object (MessagePartBody)
  },
  "parts": [
    {
      object (MessagePart)
    }
  ]
}
फ़ील्ड
partId

string

मैसेज वाले हिस्से का न बदला जा सकने वाला आईडी.
mimeType

string

मैसेज वाले हिस्से का MIME टाइप.
filename

string

अटैचमेंट का फ़ाइल नाम. यह सिर्फ़ तब मौजूद होता है, जब मैसेज का यह हिस्सा किसी अटैचमेंट को दिखाता है.
headers[]

object (Header)

मैसेज के इस हिस्से में हेडर की सूची. पूरे मैसेज पेलोड को दिखाने वाले टॉप लेवल मैसेज वाले हिस्से के लिए, इसमें स्टैंडर्ड आरएफ़सी 2822 ईमेल हेडर होंगे, जैसे कि To, From, और Subject.
body

object (MessagePartBody)

इस हिस्से के लिए मैसेज का हिस्सा, जो कंटेनर MIME मैसेज वाले हिस्सों के लिए खाली हो सकता है.
parts[]

object (MessagePart)

इस हिस्से के चाइल्ड MIME मैसेज वाले हिस्से. यह सिर्फ़ कंटेनर के MIME मैसेज वाले हिस्सों पर लागू होता है, जैसे कि multipart/*. बिना कंटेनर वाले MIME मैसेज पार्ट टाइप के लिए, जैसे कि text/plain, यह फ़ील्ड खाली होता है. ज़्यादा जानकारी के लिए, आरएफ़सी 1521 देखें.
जेएसओएन के काेड में दिखाना 
{
  "name": string,
  "value": string
}
फ़ील्ड
name

string

: सेपरेटर से पहले के हेडर का नाम. उदाहरण के लिए, To.
value

string

: सेपरेटर के बाद हेडर की वैल्यू. उदाहरण के लिए, someuser@example.com.

तरीके

batchDelete

 मैसेज आईडी के हिसाब से कई मैसेज मिटाता है.

batchModify

 चुने गए मैसेज पर लेबल में बदलाव करता है.

delete

 चुने गए मैसेज को तुरंत और हमेशा के लिए मिटा देता है.

get

 बताया गया मैसेज मिलता है.

import

 एक मैसेज को सिर्फ़ इस उपयोगकर्ता के मेलबॉक्स में इंपोर्ट करता है, जिसमें ईमेल डिलीवरी की स्टैंडर्ड प्रोसेस और एसएमटीपी के ज़रिए मिलने वाली कैटगरी जैसी ही कैटगरी मौजूद होती है.

insert

 ज़्यादातर स्कैनिंग और वर्गीकरण को नज़रअंदाज़ करते हुए, सीधे इस उपयोगकर्ता के सिर्फ़ IMAP APPEND जैसे मेलबॉक्स में एक मैसेज डाला जाता है.

list

 उपयोगकर्ता के मेलबॉक्स में मौजूद मैसेज की सूची बनाता है.

modify

 चुने गए मैसेज पर लेबल में बदलाव करता है.

send

 To, Cc, और Bcc हेडर में मौजूद पाने वालों को खास मैसेज भेजता है.

trash

 चुने गए मैसेज को ट्रैश में ले जाता है.

untrash

 ट्रैश से चुने गए मैसेज को हटाता है.