Method: users.messages.list

ব্যবহারকারীর মেলবক্সে থাকা বার্তাগুলি তালিকাভুক্ত করে। উদাহরণস্বরূপ ব্যবহারের জন্য, জিমেইল বার্তাগুলির তালিকা দেখুন।

HTTP অনুরোধ

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

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

পথের পরামিতি

পরামিতি
userId

string

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

কোয়েরি প্যারামিটার

পরামিতি
maxResults

integer ( uint32 format)

সর্বাধিক কতগুলি বার্তা ফেরত পাঠানো যাবে। এই ক্ষেত্রটি ডিফল্টভাবে ১০০-তে নির্ধারিত হয়। এই ক্ষেত্রটির জন্য সর্বাধিক অনুমোদিত মান ৫০০।

pageToken

string

তালিকার ফলাফলের একটি নির্দিষ্ট পৃষ্ঠা পুনরুদ্ধার করার জন্য পৃষ্ঠা টোকেন।

q

string

শুধুমাত্র নির্দিষ্ট কোয়েরির সাথে মিলে যাওয়া বার্তাগুলি ফেরত পাঠায়। Gmail অনুসন্ধান বাক্সের মতো একই কোয়েরি ফর্ম্যাট সমর্থন করে। উদাহরণস্বরূপ, "from:someuser@example.com rfc822msgid:<somemsgid@example.com> is:unread" । gmail.metadata স্কোপ ব্যবহার করে API অ্যাক্সেস করার সময় প্যারামিটার ব্যবহার করা যাবে না।

labelIds[]

string

শুধুমাত্র সেইসব লেবেল সহ বার্তা ফেরত পাঠান যা নির্দিষ্ট সমস্ত লেবেল আইডির সাথে মেলে। একটি থ্রেডে থাকা বার্তাগুলিতে এমন লেবেল থাকতে পারে যা একই থ্রেডে থাকা অন্যান্য বার্তাগুলিতে থাকে না। আরও জানতে, বার্তা এবং থ্রেডে লেবেল পরিচালনা করুন দেখুন।

includeSpamTrash

boolean

ফলাফলে SPAM এবং TRASH থেকে আসা বার্তা অন্তর্ভুক্ত করুন।

অনুরোধের মূল অংশ

অনুরোধের মূল অংশটি অবশ্যই খালি থাকতে হবে।

প্রতিক্রিয়া মূল অংশ

যদি সফল হয়, তাহলে রেসপন্স বডিতে নিম্নলিখিত কাঠামো সহ ডেটা থাকবে:

JSON উপস্থাপনা 
{
  "messages": [
    {
      object (Message)
    }
  ],
  "nextPageToken": string,
  "resultSizeEstimate": integer
}
ক্ষেত্র
messages[]

object ( Message )

বার্তাগুলির তালিকা। মনে রাখবেন যে প্রতিটি বার্তার রিসোর্সে কেবল একটি id এবং একটি threadId থাকে। messages.get পদ্ধতি ব্যবহার করে অতিরিক্ত বার্তার বিবরণ আনা যেতে পারে।

nextPageToken

string

তালিকার পরবর্তী পৃষ্ঠার ফলাফল পুনরুদ্ধারের জন্য টোকেন।

resultSizeEstimate

integer ( uint32 format)

আনুমানিক মোট ফলাফলের সংখ্যা।

অনুমোদনের সুযোগ

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

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

আরও তথ্যের জন্য, দেখুনOAuth 2.0 Overview .