میتوانید از برچسبها برای برچسبگذاری، سازماندهی و دستهبندی پیامها و رشتهها در Gmail استفاده کنید. یک برچسب رابطه چند به چند با پیام ها و رشته ها دارد: می توانید چندین برچسب را به یک پیام یا رشته اعمال کنید و یک برچسب را به چندین پیام یا رشته اعمال کنید.
برای اطلاعات در مورد نحوه ایجاد ، دریافت ، فهرست کردن ، به روز رسانی یا حذف برچسب ها، به مرجع برچسب ها مراجعه کنید.
برای مدیریت برچسبها، باید از https://www.googleapis.com/auth/gmail.labels
دامنه استفاده کنید. برای اطلاعات بیشتر درباره دامنهها، اطلاعات مجوز و احراز هویت مخصوص Gmail API را ببینید.
انواع برچسب
برچسبها در دو نوع هستند: برچسبهای SYSTEM
رزرو شده و برچسبهای USER
سفارشی. برچسب های سیستم معمولاً با عناصر از پیش تعریف شده در رابط وب Gmail مانند صندوق ورودی مطابقت دارند. نام برچسب سیستم محفوظ است. هیچ برچسب USER
نمی توان با همان نام هر برچسب SYSTEM
ایجاد کرد. جدول زیر تعدادی از رایج ترین برچسب های سیستم جیمیل را فهرست می کند:
نام | می توان به صورت دستی اعمال کرد | یادداشت ها |
---|---|---|
INBOX | بله | |
SPAM | بله | |
TRASH | بله | |
UNREAD | بله | |
STARRED | بله | |
IMPORTANT | بله | |
SENT | نه | به طور خودکار برای پیامهایی که با drafts.send یا messages.send ارسال میشوند، با messages.insert و ایمیل کاربر در سرصفحه From درج میشوند یا توسط کاربر از طریق رابط وب ارسال میشوند اعمال میشود. |
DRAFT | نه | به طور خودکار برای همه پیامهای draft ایجاد شده با Gmail API یا رابط Gmail اعمال میشود. |
CATEGORY_PERSONAL | بله | مربوط به پیام هایی است که در برگه Personal رابط کاربری Gmail نمایش داده می شوند. |
CATEGORY_SOCIAL | بله | مربوط به پیام هایی است که در تب Social رابط کاربری Gmail نمایش داده می شوند. |
CATEGORY_PROMOTIONS | بله | مربوط به پیام هایی است که در برگه تبلیغات در رابط Gmail نمایش داده می شوند. |
CATEGORY_UPDATES | بله | مربوط به پیام هایی است که در برگه به روز رسانی رابط Gmail نمایش داده می شوند. |
CATEGORY_FORUMS | بله | مربوط به پیام هایی است که در تب Forums در رابط Gmail نمایش داده می شوند. |
برچسبها را روی پیامها و رشتهها مدیریت کنید
برچسبها فقط روی پیامها وجود دارند. به عنوان مثال، اگر برچسبها را روی یک رشته فهرست کنید، فهرستی از برچسبها را دریافت میکنید که روی هر یک از پیامهای درون رشته وجود دارد. ممکن است یک برچسب روی هر پیامی در یک رشته وجود نداشته باشد. میتوانید چندین برچسب برای پیامها اعمال کنید، اما نمیتوانید برچسبها را برای پیامهای پیشنویس اعمال کنید.
برچسب ها را به رشته ها اضافه یا حذف کنید
هنگامی که برچسبی را به یک رشته اضافه یا حذف می کنید، برچسب مشخص شده را روی همه پیام های موجود در رشته اضافه یا حذف می کنید.
اگر پس از افزودن برچسب، پیامها به رشته اضافه شوند، پیامهای جدید برچسب موجود مرتبط با رشته را به ارث نمیبرند. برای افزودن برچسب به آن پیامها، برچسب را دوباره به رشته اضافه کنید.
برای افزودن یا حذف برچسبهای مرتبط با یک رشته، از threads.modify
استفاده کنید.
برچسبها را به پیامها اضافه یا حذف کنید
هنگامی که یک برچسب به پیام اضافه می کنید، برچسب به آن پیام اضافه می شود و با رشته ای که پیام به آن تعلق دارد مرتبط می شود. این برچسب به پیامهای دیگر درون رشته اضافه نمیشود.
اگر برچسبی را از یک پیام حذف کنید و تنها پیامی در رشته با آن برچسب باشد، برچسب نیز از موضوع حذف میشود.
برای افزودن یا حذف برچسبهای اعمال شده به پیام، از messages.modify
استفاده کنید.