Method: users.history.list

প্রদত্ত মেলবক্সে সমস্ত পরিবর্তনের ইতিহাস তালিকাভুক্ত করে। ইতিহাসের ফলাফলগুলি কালানুক্রমিক ক্রমে ফেরত দেওয়া হয় ( historyId বৃদ্ধি করা)।

HTTP অনুরোধ

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

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

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

পরামিতি
userId

string

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

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

পরামিতি
maxResults

integer ( uint32 format)

ইতিহাস রেকর্ডের সর্বোচ্চ সংখ্যা ফেরত দিতে হবে। এই ক্ষেত্রটি ডিফল্ট 100। এই ক্ষেত্রের জন্য সর্বাধিক অনুমোদিত মান হল 500।

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

বার্তা থেকে লেবেল আইডি সরানো হয়েছে।