Gmail API یک RESTful API است که میتواند برای دسترسی به صندوقهای پستی Gmail و ارسال ایمیل استفاده شود. برای اکثر برنامههای وب، Gmail API بهترین انتخاب برای دسترسی مجاز به دادههای Gmail کاربر است و برای برنامههای مختلفی مانند موارد زیر مناسب است:
- استخراج، فهرستبندی و پشتیبانگیری ایمیلهای فقط خواندنی
- ارسال پیام خودکار یا برنامه ریزی شده
- مهاجرت حساب ایمیل
- سازماندهی ایمیل شامل فیلتر کردن و مرتبسازی پیامها
- استانداردسازی امضاهای ایمیل در سراسر سازمان
در زیر لیستی از اصطلاحات رایج مورد استفاده در API جیمیل آمده است:
- پیام
- یک پیام ایمیل شامل فرستنده، گیرنده، موضوع و متن. پس از ایجاد پیام، نمیتوان آن را تغییر داد. یک پیام توسط یک منبع پیام (message resource) نمایش داده میشود.
- موضوع
- مجموعهای از پیامهای مرتبط که یک مکالمه را تشکیل میدهند. در یک برنامهی ایمیل کلاینت، یک رشته زمانی تشکیل میشود که یک یا چند گیرنده با پیام خود به یک پیام پاسخ دهند.
- برچسب
مکانیزمی برای سازماندهی پیامها و رشتهها. به عنوان مثال، میتوان برچسب "مالیات" را ایجاد کرد و به همه پیامها و رشتههای مربوط به مالیات کاربر اعمال کرد. دو نوع برچسب وجود دارد:
- برچسبهای سیستم
- برچسبهای ایجاد شده داخلی، مانند
INBOX،TRASHیاSPAM. این برچسبها را نمیتوان حذف یا تغییر داد. با این حال، برخی از برچسبهای سیستمی، مانندINBOX، را میتوان روی پیامها و رشتهها اعمال کرد یا از آنها حذف نمود. - برچسبهای کاربر
- برچسبهایی که توسط کاربر ایجاد میشوند. این برچسبها میتوانند توسط کاربر یا برنامه حذف یا اصلاح شوند. یک برچسب کاربر توسط یک منبع برچسب نمایش داده میشود.
- پیش نویس
یک پیام ارسال نشده. پیامی که در پیشنویس وجود دارد میتواند جایگزین شود. ارسال یک پیشنویس به طور خودکار آن را حذف کرده و پیامی با برچسب سیستمی
SENTایجاد میکند. یک پیشنویس توسط یک منبع پیشنویس نمایش داده میشود.
مراحل بعدی
برای کسب اطلاعات بیشتر در مورد توسعه با APIهای Google Workspace، از جمله مدیریت احراز هویت و مجوز، به «شروع به کار به عنوان یک توسعهدهنده Google Workspace» مراجعه کنید.
برای یادگیری نحوه پیکربندی و اجرای یک برنامه ساده Gmail API، نمای کلی Quickstarts را مطالعه کنید.