سرویس پیشرفته جیمیل به شما امکان میدهد از API جیمیل در Apps Script استفاده کنید. این API، بسیار شبیه به سرویس جیمیل داخلی Apps Script، به اسکریپتها اجازه میدهد تا موضوعات، پیامها و برچسبها را در صندوق پستی جیمیل پیدا و تغییر دهند. در بیشتر موارد، استفاده از سرویس داخلی آسانتر است، اما این سرویس پیشرفته چند ویژگی اضافی و دسترسی به اطلاعات دقیقتر در مورد محتوای جیمیل را فراهم میکند.
مرجع
برای اطلاعات دقیق در مورد این سرویس، به مستندات مرجع برای Gmail API مراجعه کنید. مانند تمام سرویسهای پیشرفته در Apps Script، سرویس پیشرفته Gmail از همان اشیاء، متدها و پارامترهای API عمومی استفاده میکند. برای اطلاعات بیشتر، به بخش «نحوه تعیین امضاهای متد» مراجعه کنید.
برای گزارش مشکلات و یافتن پشتیبانیهای دیگر، به راهنمای پشتیبانی Gmail مراجعه کنید.
کد نمونه
کد نمونه زیر از نسخه ۱ این API استفاده میکند.
اطلاعات برچسب فهرست
مثال زیر نحوهی فهرست کردن تمام اطلاعات برچسب کاربر را نشان میدهد. این شامل نام برچسب، نوع، شناسه و تنظیمات نمایش آن میشود.
فهرست کردن اسنیپتهای صندوق ورودی
مثال زیر نحوه فهرست کردن قطعه متنهای مرتبط با هر رشته در صندوق ورودی کاربر را نشان میدهد. به استفاده از توکنهای صفحه برای دسترسی به لیست کامل نتایج توجه کنید.
فهرست کردن تاریخ اخیر
مثال زیر نحوه ثبت تاریخچه فعالیتهای اخیر را نشان میدهد. به طور خاص، این مثال شناسه رکورد تاریخچه مرتبط با آخرین پیام ارسال شده کاربر را بازیابی میکند و سپس شناسههای پیام هر پیامی را که از آن زمان تغییر کرده است، ثبت میکند. هر پیام تغییر یافته فقط یک بار ثبت میشود، مهم نیست که چند رویداد تغییر در رکوردهای تاریخچه وجود داشته باشد. به استفاده از توکنهای صفحه برای دسترسی به لیست کامل نتایج توجه کنید.
لیست کردن پیامها
مثال زیر نحوه فهرست کردن پیامهای خوانده نشده کاربر Gmail را نشان میدهد.