Method: users.history.list

প্রদত্ত মেইলবক্সের সমস্ত পরিবর্তনের ইতিহাস তালিকাভুক্ত করে। ইতিহাসের ফলাফল কালানুক্রমিকভাবে (ক্রমবর্ধমান historyId ) ফেরত দেওয়া হয়। আরও তথ্যের জন্য, Gmail-এর সাথে ক্লায়েন্ট সিঙ্ক্রোনাইজ করুন দেখুন।

HTTP অনুরোধ

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

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

পথের পরামিতি

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

string

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

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

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

integer ( uint32 format)

ফেরত দেওয়ার জন্য হিস্ট্রি রেকর্ডের সর্বোচ্চ সংখ্যা। এই ফিল্ডটির ডিফল্ট মান হলো ১০০। এই ফিল্ডের জন্য সর্বোচ্চ অনুমোদিত মান হলো ৫০০।

pageToken

string

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

startHistoryId

string

আবশ্যক। নির্দিষ্ট startHistoryId পরের হিস্ট্রি রেকর্ডগুলো ফেরত দেয়। সরবরাহকৃত startHistoryId কোনো মেসেজ, থ্রেড বা পূর্ববর্তী list রেসপন্সের historyId থেকে সংগ্রহ করতে হবে। হিস্ট্রি আইডিগুলো কালানুক্রমিকভাবে বৃদ্ধি পায়, কিন্তু বৈধ আইডিগুলোর মধ্যে এলোমেলো ফাঁক থাকায় এগুলো অবিচ্ছিন্ন থাকে না। একটি অবৈধ বা পুরোনো startHistoryId সরবরাহ করলে সাধারণত একটি HTTP 404 এরর কোড ফেরত আসে। একটি historyId সাধারণত কমপক্ষে এক সপ্তাহের জন্য বৈধ থাকে, কিন্তু কিছু বিরল পরিস্থিতিতে এটি মাত্র কয়েক ঘণ্টার জন্য বৈধ হতে পারে। আপনি যদি একটি HTTP 404 এরর রেসপন্স পান, তবে আপনার অ্যাপ্লিকেশনটির একটি সম্পূর্ণ সিঙ্ক করা উচিত। যদি আপনি রেসপন্সে কোনো nextPageToken না পান, তাহলে পুনরুদ্ধার করার মতো কোনো আপডেট নেই এবং আপনি ভবিষ্যতের কোনো অনুরোধের জন্য ফেরত আসা historyId সংরক্ষণ করতে পারেন।

labelId

string

শুধুমাত্র সেই বার্তাগুলোই ফেরত দিন, যেগুলোর লেবেল আইডির সাথে মেলে।

historyTypes[]

enum ( HistoryType )

ফাংশন দ্বারা ফেরত দেওয়া ইতিহাসের প্রকারভেদ

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

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

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

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

JSON উপস্থাপনা 
{
  "history": [
    {
      object (History)
    }
  ],
  "nextPageToken": string,
  "historyId": string
}
ক্ষেত্র
history[]

object ( History )

হিস্ট্রি রেকর্ডের তালিকা। রেসপন্সে থাকা যেকোনো messages সাধারণত শুধু id এবং threadId ফিল্ডগুলোই পূরণ করা থাকবে।

nextPageToken

string

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

historyId

string

মেইলবক্সটির বর্তমান হিস্ট্রি রেকর্ডের আইডি।

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

নিম্নলিখিত 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

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

ইতিহাসের ধরণ

এনাম
messageAdded
messageDeleted
labelAdded
labelRemoved

ইতিহাস

ব্যবহারকারীর মেইলবক্সে করা পরিবর্তনের একটি রেকর্ড। ইতিহাসের প্রতিটি পরিবর্তন একাধিক বার্তাকে বিভিন্ন উপায়ে প্রভাবিত করতে পারে।

JSON উপস্থাপনা 
{
  "id": string,
  "messages": [
    {
      object (Message)
    }
  ],
  "messagesAdded": [
    {
      object (MessageAdded)
    }
  ],
  "messagesDeleted": [
    {
      object (MessageDeleted)
    }
  ],
  "labelsAdded": [
    {
      object (LabelAdded)
    }
  ],
  "labelsRemoved": [
    {
      object (LabelRemoved)
    }
  ]
}
ক্ষেত্র
id

string

মেইলবক্স ক্রমিক আইডি।

messages[]

object ( Message )

এই হিস্ট্রি রেকর্ডে পরিবর্তিত মেসেজগুলোর তালিকা। নির্দিষ্ট পরিবর্তনের ধরনের জন্য নির্ধারিত ফিল্ড, যেমন messagesAdded এই ফিল্ডে মেসেজের পুনরাবৃত্তি ঘটাতে পারে। আমরা এর পরিবর্তে নির্দিষ্ট পরিবর্তনের ধরনের ফিল্ডগুলো ব্যবহার করার পরামর্শ দিই।

messagesAdded[]

object ( MessageAdded )

এই হিস্ট্রি রেকর্ডে মেইলবক্সে বার্তাগুলো যোগ করা হয়েছে।

messagesDeleted[]

object ( MessageDeleted )

এই হিস্ট্রি রেকর্ডে থাকা মেইলবক্স থেকে মেসেজগুলো ডিলিট করা হয়েছে (ট্র্যাশ করা হয়নি)।

labelsAdded[]

object ( LabelAdded )

এই ইতিহাস রেকর্ডের বার্তাগুলিতে লেবেল যোগ করা হয়েছে।

labelsRemoved[]

object ( LabelRemoved )

এই ইতিহাস রেকর্ডের বার্তাগুলো থেকে লেবেল মুছে ফেলা হয়েছে।

বার্তা যোগ করা হয়েছে

JSON উপস্থাপনা 
{
  "message": {
    object (Message)
  }
}
ক্ষেত্র
message

object ( Message )

বার্তা মুছে ফেলা হয়েছে

JSON উপস্থাপনা 
{
  "message": {
    object (Message)
  }
}
ক্ষেত্র
message

object ( Message )

লেবেল যোগ করা হয়েছে

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

object ( Message )

labelIds[]

string

মেসেজে লেবেল আইডি যোগ করা হয়েছে।

লেবেল সরানো হয়েছে

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

object ( Message )

labelIds[]

string

বার্তা থেকে লেবেল আইডিগুলো মুছে ফেলা হয়েছে।