Method: users.messages.import

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

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

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

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

पाथ पैरामीटर

पैरामीटर
userId

string

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

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

पैरामीटर
internalDateSource

enum (InternalDateSource)

Gmail में मैसेज की इंटरनल तारीख का सोर्स.
neverMarkSpam

boolean

Gmail की स्पैम क्लासिफ़ायर सुविधा के फ़ैसले को अनदेखा करें और इस ईमेल को मेलबॉक्स में कभी भी स्पैम के तौर पर मार्क न करें.
processForCalendar

boolean

ईमेल में मौजूद कैलेंडर के न्योतों को प्रोसेस करें और इस उपयोगकर्ता के लिए, निकाली गई मीटिंग को Google Calendar में जोड़ें.
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

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