Method: users.history.list

string

عنوان البريد الإلكتروني للمستخدم يمكن استخدام القيمة الخاصة me للإشارة إلى المستخدم الذي تمت مصادقته.

integer (uint32 format)

الحد الأقصى لعدد سجلات السجلّ المطلوب عرضها. القيمة التلقائية لهذا الحقل هي 100. الحد الأقصى المسموح به للقيمة في هذا الحقل هو 500.

string

الرمز المميز للصفحة لاسترداد صفحة محدّدة من النتائج في القائمة

string

مطلوبة. لعرض سجلات السجل بعد startHistoryId المحددة. يجب الحصول على سمة startHistoryId المقدَّمة من خلال historyId لرسالة أو سلسلة محادثات أو ردّ list سابق. تزيد أرقام تعريف السجلّ حسب التسلسل الزمني، ولكنّها لا تتداخل مع الفجوات العشوائية بين أرقام التعريف الصالحة. يؤدي تقديم قيمة startHistoryId غير صالحة أو قديمة في العادة إلى عرض رمز الخطأ HTTP 404. تصلح historyId عادةً لمدة أسبوع على الأقل، ولكن في بعض الحالات النادرة قد تكون صالحة لبضع ساعات فقط. إذا تلقيت استجابة للخطأ HTTP 404، من المفترض أن يجري تطبيقك مزامنة كاملة. إذا لم تتلقَّ nextPageToken في الردّ، هذا يعني أنّه ليس هناك أي تعديلات لاستردادها ويمكنك تخزين historyId التي تم إرجاعها لطلبك في المستقبل.

string

لا تعرض سوى الرسائل التي تحمل تصنيفًا يطابق رقم التعريف.

enum (HistoryType)

أنواع السجلّات التي تعرضها الدالة

{
  "id": string,
  "messages": [
    {
      object (Message)
    }
  ],
  "messagesAdded": [
    {
      object (MessageAdded)
    }
  ],
  "messagesDeleted": [
    {
      object (MessageDeleted)
    }
  ],
  "labelsAdded": [
    {
      object (LabelAdded)
    }
  ],
  "labelsRemoved": [
    {
      object (LabelRemoved)
    }
  ]
}

string

رقم تعريف تسلسل صندوق البريد الإلكتروني.

object (Message)

تعرض قائمة الرسائل التي تم تغييرها في سجلّ السجلّ هذا. قد تؤدي حقول أنواع تغييرات معيّنة، مثل messagesAdded، إلى تكرار الرسائل في هذا الحقل. نوصي باستخدام حقول نوع التغيير المحددة بدلاً من ذلك.

object (MessageAdded)

الرسائل التي تمت إضافتها إلى صندوق البريد في سجلّ السجلّ هذا

object (MessageDeleted)

الرسائل المحذوفة (وليست في المهملات) من صندوق البريد في سجل السجل هذا.

object (LabelAdded)

التصنيفات التي تمت إضافتها إلى الرسائل في سجلّ السجلّ هذا

object (LabelRemoved)

تمت إزالة التصنيفات من الرسائل في سجلّ السجلّ هذا.

{
  "message": {
    object (Message)
  }
}

object (Message)

{
  "message": {
    object (Message)
  }
}

object (Message)

{
  "message": {
    object (Message)
  },
  "labelIds": [
    string
  ]
}

object (Message)

string

تمت إضافة أرقام تعريف التصنيفات إلى الرسالة.

{
  "message": {
    object (Message)
  },
  "labelIds": [
    string
  ]
}

object (Message)

string

تمت إزالة أرقام تعريف التصنيفات من الرسالة.