نمای کلی Gmail API

Gmail API یک RESTful API است که می‌تواند برای دسترسی به صندوق‌های پستی Gmail و ارسال ایمیل استفاده شود. برای اکثر برنامه‌های وب، Gmail API بهترین انتخاب برای دسترسی مجاز به داده‌های Gmail کاربر است و برای برنامه‌های مختلفی مانند موارد زیر مناسب است:

  • استخراج، فهرست‌بندی و پشتیبان‌گیری ایمیل‌های فقط خواندنی
  • ارسال پیام خودکار یا برنامه ریزی شده
  • مهاجرت حساب ایمیل
  • سازماندهی ایمیل شامل فیلتر کردن و مرتب‌سازی پیام‌ها
  • استانداردسازی امضاهای ایمیل در سراسر سازمان

اصطلاحات رایج

در زیر لیستی از اصطلاحات رایج مورد استفاده در این API آمده است:

تفویض کننده و نماینده
نماینده (delegator) یک کاربر جیمیل است که به کاربر دیگری در همان سازمان Google Workspace دسترسی به صندوق پستی را اعطا می‌کند. کاربری که این دسترسی را دریافت می‌کند، نماینده (delegator) نامیده می‌شود. نمایندگان می‌توانند پیام‌ها را بخوانند، ارسال و حذف کنند، و همچنین مخاطبین را از طرف حساب نماینده مشاهده و اضافه کنند. برای اطلاعات بیشتر، به مدیریت نمایندگان مراجعه کنید.
پیش نویس
یک پیام ارسال نشده. پیامی که در پیش‌نویس وجود دارد می‌تواند جایگزین شود. ارسال یک پیش‌نویس، پیش‌نویس را به طور خودکار حذف کرده و پیامی با برچسب سیستمی SENT ایجاد می‌کند. یک پیش‌نویس توسط منبع drafts نمایش داده می‌شود. برای اطلاعات بیشتر، به بخش «کار با پیش‌نویس‌ها» مراجعه کنید.
فیلترها
قوانین پیشرفته‌ای که برای یک حساب کاربری پیکربندی شده‌اند و پیام‌های دریافتی را بر اساس معیارهای تطبیق خاص (مانند فرستنده، موضوع یا اندازه) ارزیابی می‌کنند. هنگامی که یک پیام مطابقت دارد، فیلترها به طور خودکار اقداماتی مانند اضافه کردن یا حذف برچسب‌ها یا ارسال ایمیل به آدرس مشخص شده را انجام می‌دهند. برای اطلاعات بیشتر، به مدیریت فیلترها مراجعه کنید.
آدرس‌های فوروارد شده
آدرس‌های ایمیل خاص و تأیید شده‌ای که برای دریافت پیام‌های ارسال خودکار از حساب کاربری پیکربندی شده‌اند. قبل از اینکه بتوان از یک آدرس در یک قانون یا فیلتر ارسال استفاده کرد، باید رسماً ثبت و تأیید شود تا مالکیت آن اثبات شود. برای اطلاعات بیشتر، به مدیریت ارسال مراجعه کنید.
برچسب

مکانیزمی برای سازماندهی پیام‌ها و رشته‌ها. برای مثال، می‌توان برچسب "مالیات" را ایجاد کرد و به همه پیام‌ها و رشته‌های مربوط به مالیات کاربر اعمال کرد. برای اطلاعات بیشتر، به مدیریت برچسب‌ها مراجعه کنید.

دو نوع برچسب وجود دارد:

برچسب‌های سیستم
برچسب‌های ایجاد شده داخلی، مانند INBOX ، TRASH یا SPAM . این برچسب‌ها را نمی‌توان حذف یا تغییر داد. با این حال، برخی از برچسب‌های سیستمی، مانند INBOX ، را می‌توان روی پیام‌ها و رشته‌ها اعمال کرد یا از آنها حذف نمود.
برچسب‌های کاربر
برچسب‌هایی که توسط کاربر ایجاد می‌شوند. این برچسب‌ها می‌توانند توسط کاربر یا برنامه حذف یا اصلاح شوند. یک برچسب کاربر توسط منبع labels نمایش داده می‌شود.
پیام

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

اعلان‌های فشاری

یک سیستم اعلان سمت سرور که با Google Cloud Pub/Sub ادغام می‌شود. برنامه‌ها می‌توانند یک صندوق پستی را "تحت نظر" داشته باشند و API Gmail هر زمان که تغییری رخ دهد (مانند رسیدن یک ایمیل جدید)، وب‌هوک‌ها یا هشدارهای خودکار ارسال می‌کند و نیاز برنامه را برای نظرسنجی مداوم از سرور برای به‌روزرسانی‌ها از بین می‌برد. برای اطلاعات بیشتر، به Push notifications مراجعه کنید.

گواهی‌های S/MIME

گواهی‌های دیجیتال آپلود شده روی نام‌های مستعار ارسالی خاص که به کاربر اجازه می‌دهد ایمیل‌های رمزگذاری شده و امضا شده دیجیتالی ارسال کند و امنیت پیام و اصالت فرستنده را تضمین کند. برای اطلاعات بیشتر، به مدیریت گواهی‌های S/MIME مراجعه کنید.

ارسال به عنوان نام مستعار

این‌ها نشان دهنده آدرس‌های ایمیل مختلفی هستند که یک حساب کاربری مجاز به ارسال ایمیل از طریق آن‌ها است. هر حساب کاربری حداقل یک نام مستعار دارد که نشان دهنده آدرس ایمیل اصلی است. نام‌های مستعار با ویژگی "ارسال ایمیل به عنوان" در رابط وب Gmail مطابقت دارند و همچنین مبنای پیکربندی امضاهای ایمیل برای هر آدرس هستند. برای اطلاعات بیشتر، به مدیریت نام‌های مستعار مراجعه کنید.

موضوع

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