REST Resource: users.messages

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

ईमेल मैसेज.

JSON के काेड में दिखाना
{
  "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)

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

payload

object (MessagePart)

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

sizeEstimate

integer

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

raw

string (bytes format)

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

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

MessagePart

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

JSON के काेड में दिखाना
{
  "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)

इस हिस्से के लिए मैसेज का मुख्य हिस्सा, जो कंटेनर एमआईएम मैसेज के हिस्सों के लिए खाली हो सकता है.

parts[]

object (MessagePart)

इस हिस्से के चाइल्ड एमआईएम मैसेज के हिस्से. यह सिर्फ़ कंटेनर MIME मैसेज के हिस्सों पर लागू होता है, जैसे कि multipart/*. text/plain जैसे, कंटेनर MIME मैसेज के हिस्सों के लिए, यह फ़ील्ड खाली होता है. ज़्यादा जानकारी के लिए, आरएफ़सी 1521 देखें.

JSON के काेड में दिखाना
{
  "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

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