Method: users.messages.import

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

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

  • मीडिया अपलोड करने के अनुरोधों के लिए, अपलोड यूआरआई:
    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

ईमेल को स्थायी रूप से मिटा दिया जाता है (ट्रैश नहीं किया जाता). साथ ही, यह सिर्फ़ 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 देखें.