Method: users.watch

إعداد ساعة الإشعارات الفورية أو تعديلها في صندوق البريد الإلكتروني الخاص بالمستخدم المحدّد

طلب HTTP

POST https://gmail.googleapis.com/gmail/v1/users/{userId}/watch

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

مَعلمات المسار

المعلمات
userId

string

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

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON
{
  "labelIds": [
    string
  ],
  "labelFilterAction": enum (LabelFilterAction),
  "labelFilterBehavior": enum (LabelFilterAction),
  "topicName": string
}
الحقول
labelIds[]

string

قائمة بأرقام تعريف التصنيفات لحظر الإشعارات المتعلقة بها. وبشكلٍ تلقائي، إذا لم يتم تحديد ذلك، يتم دفع جميع التغييرات. في حال تحديدها، يحدِّد ذلك التصنيفات المطلوبة لإنشاء إشعار فوري.

labelFilterAction
(deprecated)

enum (LabelFilterAction)

تم تحديد سلوك الفلترة لـ labelIds list. تم إيقاف هذا الحقل بسبب انتهاكه لسلوك غير صحيح في بعض الحالات، استخدِم labelFilterBehavior بدلاً من ذلك.

labelFilterBehavior

enum (LabelFilterAction)

تم تحديد سلوك الفلترة لـ labelIds list. يحل هذا الحقل محل labelFilterAction؛ وفي حال ضبطها، يتم تجاهل labelFilterAction.

topicName

string

اسم موضوع مؤهل بالكامل في Google Cloud Pub/Sub API لنشر الفعاليات فيه. يجب أن يكون اسم الموضوع هذا متاحًا في Cloud Pub/Sub ويجب أن تكون قد منحت ميزة "النشر" في Gmail من قبل. الحصول على إذن في ذلك. على سبيل المثال، "projects/my-project-identifier/topics/my-topic-name" (باستخدام تنسيق تسمية المواضيع "الإصدار 1" من Cloud Pub/Sub).

تجدر الإشارة إلى أنّ قيمة "my-project-identifier" يجب أن يتطابق الجزء تمامًا مع رقم تعريف مشروع مطوّر برامج Google (الذي ينفّذ طلب المشاهدة هذا).

نص الاستجابة

استجابة الساعة للإشعارات الفورية

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON
{
  "historyId": string,
  "expiration": string
}
الحقول
historyId

string

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

expiration

string (int64 format)

الوقت الذي سيتوقف فيه Gmail عن إرسال إشعارات بشأن تحديثات صندوق البريد الإلكتروني (الحقبة بالمللي ثانية) يُرجى الاتصال بـ "watch" مجددًا قبل هذا الوقت لتجديد الساعة.

نطاقات الأذونات

يتطلب هذا الإعداد أحد نطاقات 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

لمزيد من المعلومات، يُرجى الاطّلاع على دليل التفويض.

LabelFilterAction

تم تحديد سلوك الفلترة لقائمة أرقام تعريف التصنيفات.

عمليات التعداد
include يمكنك تلقّي إشعارات فورية فقط بشأن تغييرات الرسائل ذات الصلة بأرقام تعريف التصنيفات المحدّدة.
exclude تلقّي إشعارات فورية لجميع التغييرات في الرسائل باستثناء تلك المتعلقة بأرقام تعريف التصنيفات المحدَّدة