یادآوری ها & اطلاعیه

Calendar API از یادآوری ها و اعلان ها پشتیبانی می کند.

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

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

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

یادآوری ها

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

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

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

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

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

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

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

لغو یادآوری های پیش فرض

برای لغو یادآوری‌های پیش‌فرض هنگام درج یا تغییر رویداد، یادآوری‌ها. useDefault را روی false تنظیم کنید و یادآوری‌ها را با مجموعه یادآوری جدید پر کنید.

"reminders": {
  "useDefault": false,
  # Overrides can be set if and only if useDefault is false.
  "overrides": [
      {
        "method": "reminderMethod",
        "minutes": "reminderMinutes"
      },
      # ...
  ]
}

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

اطلاعیه ها

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

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

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

برای ارسال اعلان‌های ایمیل به شرکت‌کنندگان برای رویدادهایی که از طریق API درج یا به‌روزرسانی شده‌اند، پارامتر sendNotifications را در درخواست درج/به‌روزرسانی روی true تنظیم کنید.

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

روش های تحویل ارائه شده توسط Google Calendar عبارتند از:

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

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

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