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 के एडमिन को Google Vault में दिखाएं. इसका इस्तेमाल सिर्फ़ Google Workspace खातों के लिए किया जाता है.

अनुरोध का मुख्य हिस्सा

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

जवाब का मुख्य हिस्सा

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

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

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

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

ज़्यादा जानकारी के लिए, अनुमति पाने से जुड़ी गाइड देखें.