برچسب ها را مدیریت کنید

این سند نحوه مدیریت برچسب‌ها روی موضوعات و پیام‌ها با استفاده از API جیمیل را توضیح می‌دهد.

شما می‌توانید از برچسب‌ها برای برچسب‌گذاری، سازماندهی و دسته‌بندی پیام‌ها و رشته‌ها در جیمیل استفاده کنید. یک برچسب رابطه‌ی چند به چند با پیام‌ها و رشته‌ها دارد: می‌توانید چندین برچسب را به یک پیام یا رشته اعمال کنید و یک برچسب را به چندین پیام یا رشته اعمال کنید.

برای اطلاعات در مورد نحوه ایجاد ، دریافت ، فهرست کردن ، به‌روزرسانی یا حذف برچسب‌ها، به منبع labels مراجعه کنید.

برای مدیریت برچسب‌ها، باید از دامنه غیرحساس https://www.googleapis.com/auth/gmail.labels استفاده کنید. برای اطلاعات بیشتر در مورد دامنه‌ها، به Choose Gmail API scopes مراجعه کنید.

انواع برچسب‌ها

برچسب‌ها در دو نوع موجود هستند: برچسب‌های رزرو شده SYSTEM و برچسب‌های سفارشی USER .

برچسب‌های سیستم معمولاً با عناصر از پیش تعریف‌شده در رابط وب جیمیل مانند INBOX مطابقت دارند. نام‌های برچسب سیستم رزرو شده‌اند؛ هیچ برچسب USER نمی‌تواند با نام مشابه برچسب SYSTEM ایجاد شود. جدول زیر چندین مورد از رایج‌ترین برچسب‌های سیستم جیمیل را فهرست می‌کند:

نام قابل اعمال به صورت دستی یادداشت‌ها
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 بله مربوط به پیام‌هایی است که در برگه تبلیغات (Promotions) رابط Gmail نمایش داده می‌شوند.
CATEGORY_UPDATES بله مربوط به پیام‌هایی است که در برگه به‌روزرسانی‌ها در رابط Gmail نمایش داده می‌شوند.
CATEGORY_FORUMS بله مربوط به پیام‌هایی است که در برگه انجمن‌ها (Forums) رابط کاربری جیمیل نمایش داده می‌شوند.

مدیریت برچسب‌ها در موضوعات و پیام‌ها

برچسب‌ها فقط روی پیام‌ها وجود دارند. اگر فهرستی از برچسب‌ها را روی یک رشته بازیابی کنید، فهرستی از برچسب‌ها را دریافت خواهید کرد که روی هر پیامی در آن رشته وجود دارد. ممکن است یک برچسب روی هر پیام درون یک رشته وجود نداشته باشد.

شما نمی‌توانید برای پیام‌های پیش‌نویس برچسب اعمال کنید.

برچسب ها را روی موضوعات اضافه یا حذف کنید

وقتی برچسبی را در یک رشته اضافه یا حذف می‌کنید، برچسب مشخص شده را به تمام پیام‌های موجود در آن رشته اضافه یا حذف می‌کنید.

اگر پس از افزودن برچسب، پیام‌هایی به یک رشته پیام اضافه شوند، پیام‌های جدید برچسب موجود مرتبط با رشته پیام را به ارث نمی‌برند. برای افزودن برچسب به آن پیام‌ها، برچسب را دوباره به رشته پیام اضافه کنید.

برای اضافه کردن یا حذف کردن برچسب‌های مرتبط با یک نخ، از threads.modify استفاده کنید.

افزودن یا حذف برچسب‌ها روی پیام‌ها

وقتی برچسبی به یک پیام اضافه می‌کنید، آن برچسب به آن پیام اضافه می‌شود و با رشته‌ای که پیام به آن تعلق دارد مرتبط می‌شود. این برچسب به پیام‌های دیگر درون رشته اضافه نمی‌شود.

اگر برچسبی را از پیامی حذف کنید و آن تنها پیام در آن رشته پیام با آن برچسب باشد، آن برچسب نیز از آن رشته پیام حذف می‌شود.

برای افزودن یا حذف برچسب‌های اعمال شده به یک پیام، messages.modify استفاده کنید.