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

می‌توانید از برچسب‌ها برای برچسب‌گذاری، سازماندهی و دسته‌بندی پیام‌ها و رشته‌ها در 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 استفاده کنید.