REST Resource: users.messages

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

ईमेल मैसेज.

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

string

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

string

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

  1. अनुरोध किए गए threadId को उस Message या Draft.Message पर बताया जाना चाहिए जिसे आपने अनुरोध के साथ सबमिट किया है.
  2. References और In-Reply-To हेडर, RFC 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 कोड में बदली गई स्ट्रिंग.
classificationLabelValues[]

object (ClassificationLabelValue)

मैसेज पर क्लासिफ़िकेशन लेबल की वैल्यू. Google Drive Labels API का इस्तेमाल करके, उपलब्ध क्लासिफ़िकेशन लेबल स्कीमा के बारे में क्वेरी की जा सकती है. हर क्लासिफ़िकेशन लेबल आईडी यूनीक होना चाहिए. अगर डुप्लीकेट आईडी दिए जाते हैं, तो सिर्फ़ एक आईडी को रखा जाएगा. साथ ही, यह आईडी किसी भी आईडी को चुना जा सकता है. इसका इस्तेमाल सिर्फ़ Google Workspace खातों के लिए किया जाता है.

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)

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

object (MessagePartBody)

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

object (MessagePart)

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

string

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

string

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

ClassificationLabelValue

ईमेल मैसेज पर लागू किए गए क्लासिफ़िकेशन लेबल. क्लासिफ़िकेशन लेबल, Gmail इनबॉक्स के लेबल से अलग होते हैं. इसका इस्तेमाल सिर्फ़ Google Workspace खातों के लिए किया जाता है. डेटा को अलग-अलग ग्रुप में बांटने वाले लेबल के बारे में ज़्यादा जानें.

JSON के काेड में दिखाना 
{
  "labelId": string,
  "fields": [
    {
      object (ClassificationLabelFieldValue)
    }
  ]
}
फ़ील्ड
labelId

string

ज़रूरी है. कैननिकल या रॉ ऐल्फ़ान्यूमेरिक क्लासिफ़िकेशन लेबल आईडी. यह Google Drive के लेबल संसाधन के आईडी फ़ील्ड से मैप होता है.
fields[]

object (ClassificationLabelFieldValue)

दिए गए क्लासिफ़िकेशन लेबल आईडी के लिए फ़ील्ड की वैल्यू.

ClassificationLabelFieldValue

क्लासिफ़िकेशन लेबल के लिए फ़ील्ड वैल्यू.

JSON के काेड में दिखाना 
{
  "fieldId": string,
  "selection": string
}
फ़ील्ड
fieldId

string

ज़रूरी है. क्लासिफ़िकेशन लेबल की वैल्यू के लिए फ़ील्ड आईडी. यह Google Drive Label.Field ऑब्जेक्ट के आईडी फ़ील्ड से मैप होता है.
selection

string

चुने गए विकल्प के लिए, चुनने के विकल्प का आईडी. इस फ़ील्ड को सिर्फ़ तब सेट किया जाना चाहिए, जब Google Drive Label.Field ऑब्जेक्ट में फ़ील्ड टाइप SELECTION हो. यह Google Drive Label.Field.SelectionOptions संसाधन के id फ़ील्ड पर मैप करता है.

तरीके

batchDelete

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

batchModify

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

delete

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

get

 चुना गया मैसेज मिलता है.

import

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

insert

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

list

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

modify

 इस तरीके का इस्तेमाल करके, किसी मैसेज के लेबल में बदलाव किया जा सकता है.

send

 यह फ़ंक्शन, To, Cc, और Bcc हेडर में मौजूद लोगों को चुना गया मैसेज भेजता है.

trash

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

untrash

 इससे ट्रैश से चुना गया मैसेज हट जाता है.