نمای کلی 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 ادغام می‌شود. برنامه‌ها می‌توانند یک صندوق پستی را "تحت نظر" داشته باشند و Gmail API هر زمان که تغییری رخ می‌دهد (مانند رسیدن ایمیل جدید) به طور خودکار webhook یا هشدار ارسال می‌کند. این امر نیاز برنامه شما را برای نظرسنجی از سرور برای به‌روزرسانی‌ها از بین می‌برد. برای اطلاعات بیشتر، به Push notifications مراجعه کنید.

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

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

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

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

موضوع

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