إدارة التصنيفات

يوضّح هذا المستند كيفية إدارة التصنيفات في سلاسل المحادثات والرسائل باستخدام Gmail API.

يمكنك استخدام التصنيفات لوضع علامات على الرسائل وسلاسل المحادثات وتنظيمها وتصنيفها في Gmail. للتصنيف علاقة أطراف بأطراف مع الرسائل وسلاسل المحادثات، إذ يمكنك تطبيق تصنيفات متعددة على رسالة أو سلسلة محادثات واحدة، وتطبيق تصنيف واحد على رسائل أو سلاسل محادثات متعددة.

للحصول على معلومات حول كيفية إنشاء أو الحصول على أو إدراج أو تعديل أو حذف تصنيفات، يُرجى الاطّلاع على المورد labels.

لإدارة التصنيفات، يجب استخدام https://www.googleapis.com/auth/gmail.labels النطاق غير الحسّاس. لمزيد من المعلومات حول النطاقات، يُرجى الاطّلاع على اختيار نطاقات Gmail API.

أنواع التصنيفات

تتوفّر التصنيفات بنوعَين: تصنيفات SYSTEM محجوزة وتصنيفات USER مخصّصة.

تتطابق تصنيفات النظام عادةً مع العناصر المحدّدة مسبقًا في واجهة الويب الخاصة بـ Gmail، مثل INBOX. أسماء تصنيفات النظام محفوظة، ولا يمكن إنشاء تصنيف USER يحمل الاسم نفسه الذي يحمله أي تصنيف SYSTEM. يسرد الجدول التالي بعض تصنيفات نظام Gmail الأكثر شيوعًا:

الاسم	يمكن تطبيقها يدويًا	ملاحظات
INBOX	نعم
SPAM	نعم
TRASH	نعم
UNREAD	نعم
STARRED	نعم
IMPORTANT	نعم
SENT	لا	يتم تطبيقها تلقائيًا على الرسائل التي: تم إرسالها باستخدام drafts.send أو messages.send. تم إدراجه باستخدام messages.insert وعنوان البريد الإلكتروني للمستخدم في العنوان From. الرسائل التي يرسلها المستخدم من خلال واجهة الويب
DRAFT	لا	يتم تطبيقها تلقائيًا على جميع رسائل draft التي يتم إنشاؤها باستخدام Gmail API أو واجهة Gmail.
CATEGORY_PERSONAL	نعم	يتوافق مع الرسائل التي تظهر في علامة التبويب "شخصي" ضمن واجهة Gmail.
CATEGORY_SOCIAL	نعم	يتوافق مع الرسائل التي يتم عرضها في علامة التبويب "الرسائل الاجتماعية" ضمن واجهة Gmail.
CATEGORY_PROMOTIONS	نعم	تتطابق مع الرسائل المعروضة في علامة التبويب "الرسائل الترويجية" ضمن واجهة Gmail.
CATEGORY_UPDATES	نعم	يتوافق مع الرسائل التي يتم عرضها في علامة التبويب "الإشعارات" ضمن واجهة Gmail.
CATEGORY_FORUMS	نعم	يتوافق مع الرسائل التي يتم عرضها في علامة التبويب "المنتديات" ضمن واجهة Gmail.

إدارة التصنيفات في سلاسل المحادثات والرسائل

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

لا يمكنك تطبيق التصنيفات على الرسائل المحفوظة كمسودّة.

إضافة تصنيفات إلى سلاسل المحادثات أو إزالتها

عند إضافة تصنيف إلى سلسلة محادثات أو إزالته منها، تتم إضافة التصنيف المحدّد أو إزالته من جميع الرسائل الحالية في سلسلة المحادثات.

إذا تمت إضافة رسائل إلى سلسلة محادثات بعد إضافة تصنيف، لن ترث الرسائل الجديدة التصنيف الحالي المرتبط بسلسلة المحادثات. لإضافة التصنيف إلى تلك الرسائل، أضِف التصنيف إلى سلسلة المحادثات مرة أخرى.

لإضافة التصنيفات المرتبطة بسلسلة محادثات أو إزالتها، استخدِم الرمز threads.modify.

إضافة تصنيفات إلى الرسائل أو إزالتها

عند إضافة تصنيف إلى رسالة، تتم إضافة التصنيف إلى تلك الرسالة ويصبح مرتبطًا بسلسلة المحادثات التي تنتمي إليها الرسالة. لا تتم إضافة التصنيف إلى الرسائل الأخرى ضمن سلسلة المحادثات.

إذا أزلت تصنيفًا من رسالة وكانت الرسالة الوحيدة في سلسلة المحادثات التي تتضمّن هذا التصنيف، ستتم إزالة التصنيف أيضًا من سلسلة المحادثات.

لإضافة التصنيفات المطبَّقة على رسالة أو إزالتها، استخدِم messages.modify.