شما میتوانید از برچسبها برای برچسبگذاری، سازماندهی و دستهبندی پیامها و رشتهها در جیمیل استفاده کنید. یک برچسب رابطهی چند به چند با پیامها و رشتهها دارد: میتوانید چندین برچسب را به یک پیام یا رشته و یک برچسب را به چندین پیام یا رشته اعمال کنید.
برای اطلاعات در مورد نحوه ایجاد ، دریافت ، فهرست کردن ، بهروزرسانی یا حذف برچسبها، به مرجع برچسبها مراجعه کنید.
برای مدیریت برچسبها، باید از دامنه https://www.googleapis.com/auth/gmail.labels استفاده کنید. برای اطلاعات بیشتر در مورد دامنهها، به اطلاعات مجوز و احراز هویت مخصوص Gmail API مراجعه کنید.
انواع برچسبها
برچسبها در دو نوع ارائه میشوند: برچسبهای رزرو شده SYSTEM و برچسبهای سفارشی USER . برچسبهای سیستم معمولاً با عناصر از پیش تعریف شده در رابط وب جیمیل مانند صندوق ورودی مطابقت دارند. نام برچسبهای سیستم رزرو شده هستند؛ هیچ برچسب 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 استفاده کنید.