Method: users.messages.insert

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

एचटीटीपी अनुरोध

  • मीडिया अपलोड करने के अनुरोधों के लिए, अपलोड यूआरआई:
    POST https://gmail.googleapis.com/upload/gmail/v1/users/{userId}/messages
  • सिर्फ़ मेटाडेटा के अनुरोधों के लिए मेटाडेटा यूआरआई:
    POST https://gmail.googleapis.com/gmail/v1/users/{userId}/messages

यह यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ पैरामीटर

पैरामीटर
userId

string

उपयोगकर्ता का ईमेल पता. me खास वैल्यू का इस्तेमाल, पुष्टि किए गए उपयोगकर्ता के बारे में बताने के लिए किया जा सकता है.

क्वेरी पैरामीटर

पैरामीटर
internalDateSource

enum (InternalDateSource)

यह मैसेज की तारीख के लिए Gmail का इंटरनल सोर्स है.
deleted

boolean

ईमेल को स्थायी रूप से मिटा दिया जाता है (ट्रैश नहीं किया जाता). साथ ही, यह सिर्फ़ Google Vault में Vault के एडमिन को दिखता है. इसका इस्तेमाल सिर्फ़ Google Workspace खातों के लिए किया जाता है.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य भाग में Message का उदाहरण है.

जवाब का मुख्य भाग

कामयाब रहने पर, जवाब के मुख्य हिस्से में Message का एक इंस्टेंस शामिल किया जाता है.

अनुमति पाने के लिंक

इसके लिए, इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:

  • https://mail.google.com/
  • https://www.googleapis.com/auth/gmail.modify
  • https://www.googleapis.com/auth/gmail.insert

ज़्यादा जानकारी के लिए, OAuth 2.0 Overview देखें.