المرجع: التصنيف
تُستخدَم التصنيفات لتصنيف الرسائل وسلاسل المحادثات داخل صندوق البريد الإلكتروني للمستخدم. الحد الأقصى لعدد التصنيفات المسموح بها لصندوق البريد الإلكتروني للمستخدم هو 10,000.
تمثيل JSON |
---|
{ "id": string, "name": string, "messageListVisibility": enum ( |
الحقول | |
---|---|
id |
رقم تعريف التصنيف غير القابل للتغيير. |
name |
الاسم المعروض للتصنيف. |
messageListVisibility |
مستوى رؤية الرسائل التي تحمل هذا التصنيف في قائمة الرسائل في واجهة ويب Gmail. |
labelListVisibility |
إذن الوصول إلى التصنيف في قائمة التصنيفات في واجهة Gmail على الويب |
type |
نوع مالك التصنيف. يُنشئ المستخدم تصنيفات المستخدم، ويمكن للمستخدم تعديلها وحذفها، ويمكن تطبيقها على أي رسالة أو سلسلة محادثات. يتم إنشاء تصنيفات النظام داخليًا ولا يمكن إضافتها أو تعديلها أو حذفها. في بعض الحالات، يمكن تطبيق تصنيفات النظام على الرسائل وسلاسل المحادثات أو إزالتها منها، ولكن ذلك ليس مضمونًا. على سبيل المثال، يمكن للمستخدمين تطبيق التصنيفات |
messagesTotal |
إجمالي عدد الرسائل ذات التصنيف. |
messagesUnread |
عدد الرسائل غير المقروءة ذات التصنيف. |
threadsTotal |
إجمالي عدد سلاسل المحادثات ذات التصنيف. |
threadsUnread |
عدد سلاسل المحادثات غير المقروءة ذات التصنيف. |
color |
اللون الذي تريد تخصيصه للتصنيف. لا يتوفّر اللون فقط للتصنيفات التي تم ضبط |
MessageListVisibility
عمليات التعداد | |
---|---|
show |
إظهار التصنيف في قائمة الرسائل. |
hide |
عدم إظهار التصنيف في قائمة الرسائل. |
LabelListVisibility
عمليات التعداد | |
---|---|
labelShow |
إظهار التصنيف في قائمة التصنيفات. |
labelShowIfUnread |
إظهار التصنيف إذا كانت هناك أي رسائل غير مقروءة بهذا التصنيف. |
labelHide |
عدم إظهار التصنيف في قائمة التصنيفات. |
النوع
عمليات التعداد | |
---|---|
system |
التصنيفات التي تم إنشاؤها بواسطة Gmail. |
user |
التصنيفات المخصّصة التي أنشأها المستخدم أو التطبيق |
اللون
تمثيل JSON |
---|
{ "textColor": string, "backgroundColor": string } |
الحقول | |
---|---|
textColor |
لون نص التصنيف، ويتم تمثيله كسلسلة سداسية عشرية. هذا الحقل مطلوب لضبط لون التصنيف. ولا يُسمح فقط إلا بمجموعة قيم الألوان المحدَّدة مسبقًا التالية: |
backgroundColor |
لون الخلفية يتم تمثيله كسلسلة سداسية عشرية #RRGGBB (على سبيل المثال #000000). هذا الحقل مطلوب لضبط لون التصنيف. ولا يُسمح فقط إلا بمجموعة قيم الألوان المحدَّدة مسبقًا التالية: |
الطُرق |
|
---|---|
|
لإنشاء تصنيف جديد. |
|
الحذف النهائي والنهائي على الفور للتصنيف المحدّد وإزالته من أي رسائل وسلاسل محادثات تم تطبيقه عليها |
|
الحصول على التصنيف المحدد |
|
يسرد جميع التصنيفات في صندوق بريد المستخدم. |
|
تصحيح التصنيف المحدّد. |
|
لتعديل التصنيف المحدّد. |