Method: users.messages.batchModify

নির্দিষ্ট বার্তাগুলির লেবেল এবং ক্লাসিফিকেশন লেবেল মান পরিবর্তন করে। প্রশাসকগণ যখন তাদের প্রতিষ্ঠানের ব্যবহারকারীদের জন্য বার্তা পরিবর্তন করেন, তখন অনুরোধগুলির জন্য একটি পরিষেবা অ্যাকাউন্টের মাধ্যমে অনুমোদনের প্রয়োজন হয়, যেটির https://www.googleapis.com/auth/gmail.modify.restricted স্কোপ ব্যবহার করে ব্যবহারকারীদের ছদ্মবেশ ধারণ করার জন্য ডোমেন-ব্যাপী প্রতিনিধি ক্ষমতা রয়েছে।

HTTP অনুরোধ

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

URL-টিতে gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করা হয়েছে।

পথের পরামিতি

প্যারামিটার
userId

string

ব্যবহারকারীর ইমেল ঠিকানা। প্রমাণীকৃত ব্যবহারকারীকে নির্দেশ করতে me বিশেষ মানটি ব্যবহার করা যেতে পারে।

অনুরোধকারী শরীর

অনুরোধের মূল অংশে নিম্নলিখিত কাঠামোসহ ডেটা থাকে:

JSON উপস্থাপনা 
{
  "ids": [
    string
  ],
  "addLabelIds": [
    string
  ],
  "removeLabelIds": [
    string
  ],
  "addClassificationLabels": [
    {
      object (ClassificationLabelValue)
    }
  ],
  "removeClassificationLabelIds": [
    string
  ]
}
ক্ষেত্র
ids[]

string

যে বার্তাগুলো পরিবর্তন করতে হবে, সেগুলোর আইডি। প্রতি অনুরোধে ১০০০টি আইডির সীমা রয়েছে।

addLabelIds[]

string

A list of label IDs to add to messages.

removeLabelIds[]

string

বার্তা থেকে অপসারণ করার জন্য লেবেল আইডিগুলোর একটি তালিকা।

addClassificationLabels[]

object ( ClassificationLabelValue )

যোগ করার জন্য ক্লাসিফিকেশন লেবেল ভ্যালুগুলোর একটি তালিকা। যদি একই লেবেল আইডি সহ একটি ক্লাসিফিকেশন লেবেল ইতিমধ্যেই মেসেজটিতে প্রয়োগ করা থাকে, তাহলে বিদ্যমান ফিল্ড আইডি সহ ফিল্ডগুলো আপডেট করা হবে এবং নতুন ফিল্ড আইডি সহ ফিল্ডগুলো যোগ করা হবে। প্রতি অনুরোধে ক্লাসিফিকেশন লেবেল ভ্যালুর একটি সীমা রয়েছে, যা হলো ২০টি। যদি মেসেজটি ইতিমধ্যেই ক্লাসিফাই করা থাকে এবং ক্লাসিফিকেশন লেবেল ভ্যালুর চূড়ান্ত মোট সংখ্যা প্রতি মেসেজে অনুমোদিত সর্বোচ্চ সংখ্যাকে অতিক্রম করে, তাহলে পরিবর্তনটি ব্যর্থ হবে।

removeClassificationLabelIds[]

string

বার্তা থেকে বাদ দেওয়ার জন্য শ্রেণিবিন্যাস লেবেল মানগুলির একটি তালিকা।

প্রতিক্রিয়া সংস্থা

সফল হলে, প্রতিক্রিয়া অংশটি খালি থাকে।

অনুমোদনের পরিধি

নিম্নলিখিত OAuth স্কোপগুলির মধ্যে একটি প্রয়োজন:

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

আরও তথ্যের জন্য, অনুমোদন নির্দেশিকা দেখুন।