یادآوری‌ها و اعلان‌ها

رابط برنامه‌نویسی کاربردی تقویم گوگل (Google Calendar API) از یادآوری‌ها و اعلان‌ها پشتیبانی می‌کند.

• یادآوری‌ها، هشدارهایی هستند که در زمان مشخصی قبل از شروع یک رویداد فعال می‌شوند.
• اعلان‌ها به کاربران این امکان را می‌دهند که از تغییرات رویدادهای تقویم خود مطلع شوند.

اعلان‌ها را با اعلان‌های فشاری اشتباه نگیرید، که به جای ارسال به کاربر، تغییرات تقویم را به سرور دیگری اطلاع می‌دهند.

برای جزئیات بیشتر در مورد اعلان‌ها در تقویم گوگل، به اصلاح اعلان‌های تقویم گوگل مراجعه کنید.

یادآوری‌ها

یک یادآوری شامل موارد زیر است:

• چه زمانی یادآوری نمایش داده شود، که به صورت دقایقی قبل از زمان شروع رویداد بیان می‌شود.
• روش تحویل مورد استفاده (به مکانیسم‌های تحویل مراجعه کنید).

یادآوری‌ها را می‌توان برای کل تقویم‌ها و برای رویدادهای منفرد مشخص کرد. کاربران می‌توانند برای هر یک از تقویم‌های خود یادآوری‌های پیش‌فرض تنظیم کنند؛ این پیش‌فرض‌ها برای همه رویدادهای درون آن تقویم اعمال می‌شوند. با این حال، کاربران می‌توانند این پیش‌فرض‌ها را برای رویدادهای منفرد نیز لغو کنند و آنها را با مجموعه‌ای متفاوت از یادآوری‌ها جایگزین کنند.

یادآوری‌های پیش‌فرض

یادآوری‌ها اطلاعات خصوصی و مختص یک کاربر احراز هویت شده هستند؛ آنها بین چندین کاربر به اشتراک گذاشته نمی‌شوند . در نتیجه:

• یادآوری‌های پیش‌فرض از طریق مجموعه CalendarList که شامل فراداده‌های تقویم مخصوص کاربر است، دستکاری می‌شوند.
• آنها از طریق مجموعه Calendars که شامل ابرداده‌های سراسری مشترک بین همه کاربران است، قابل دسترسی نیستند .

یادآوری‌های پیش‌فرض هنگام انجام کوئری لیست رویدادها نیز بازگردانده می‌شوند.

نادیده گرفتن یادآوری‌های پیش‌فرض

برای لغو یادآوری‌های پیش‌فرض هنگام ایجاد یا به‌روزرسانی یک رویداد، مقدار reminders.useDefault را روی false تنظیم کنید و reminders.overrides را با مجموعه یادآوری جدید پر کنید. همانطور که در مثال زیر نشان داده شده است، فقط زمانی می‌توان overrideها را تنظیم کرد که useDefault برابر با false باشد:

"reminders": {
  "useDefault": false,
  "overrides": [
    {
      "method": "reminderMethod",
      "minutes": "reminderMinutes"
    }
  ]
}

برای بازگشت به مجموعه پیش‌فرض یادآوری‌ها، تنظیمات reminders.useDefault را به‌روزرسانی کنید و آن را به true برگردانید.

اعلان‌ها

تقویم از انواع اعلان‌های زیر پشتیبانی می‌کند:

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

کاربر می‌تواند تصمیم بگیرد که کدام اعلان‌ها را برای هر تقویم و روش تحویل برای هر نوع اعلان فعال کند. این تنظیمات با سایر کاربران به اشتراک گذاشته نمی‌شوند. مشابه یادآوری‌های پیش‌فرض، از طریق مجموعه CalendarList قابل دسترسی هستند.

برای ارسال اعلان‌های ایمیل به شرکت‌کنندگان برای رویدادهایی که با API درج یا به‌روزرسانی شده‌اند، متدهای insert یا update را فراخوانی کنید و پارامتر sendUpdates را روی "all" یا "externalOnly" تنظیم کنید.

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

مکانیسم‌های تحویل

روش‌های تحویل ارائه شده توسط تقویم گوگل عبارتند از:

• پاپ‌آپ . این موارد در پلتفرم‌های موبایل و کلاینت‌های وب پشتیبانی می‌شوند.
• ایمیل ارسال شده توسط سرور.

جدول زیر متدهای پشتیبانی شده برای هر نوع یادآوری یا اعلان را نشان می‌دهد:

		پاپ آپ	ایمیل
یادآوری‌ها	یادآوری‌های پیش‌فرض	✓	✓
	نادیده گرفتن یادآوری‌ها	✓	✓
اعلان‌ها	ایجاد رویداد	❌	✓
	تغییر رویداد	❌	✓
	لغو رویداد	❌	✓
	پاسخ شرکت‌کنندگان	❌	✓
	دستور کار	❌	✓