Method: users.messages.batchModify

चुने गए मैसेज के लेबल में बदलाव करता है.

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

POST https://gmail.googleapis.com/gmail/v1/users/{userId}/messages/batchModify

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

पाथ पैरामीटर

पैरामीटर
userId

string

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

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

अनुरोध के मुख्य भाग में नीचे दिए गए स्ट्रक्चर वाला डेटा होता है:

JSON के काेड में दिखाना 
{
  "ids": [
    string
  ],
  "addLabelIds": [
    string
  ],
  "removeLabelIds": [
    string
  ]
}
फ़ील्ड
ids[]

string

उन मैसेज के आईडी जिनमें बदलाव करना है. हर अनुरोध में 1,000 आईडी शामिल किए जा सकते हैं.
addLabelIds[]

string

मैसेज में जोड़ने के लिए लेबल आईडी की सूची.
removeLabelIds[]

string

मैसेज से हटाने के लिए, लेबल आईडी की सूची.

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

अगर एपीआई सही से जुड़ जाता है, तो जवाब का मुख्य हिस्सा खाली होता है.

अनुमति के दायरे

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

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

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