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

ईमेल को 'स्थायी रूप से मिटाया गया' के तौर पर मार्क करें, न कि 'ट्रैश' के तौर पर. साथ ही, यह भी सेट करें कि ईमेल सिर्फ़ 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

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