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)

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

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

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

ইতিহাসের ধরণ

এনামস
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

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