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

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

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

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

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

یادآوری‌ها

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

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

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

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

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

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

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

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

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

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

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

اعلان‌ها

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

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

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

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

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

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

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

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

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

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

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

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

یادآوری‌ها

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

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

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

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

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

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

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

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

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

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

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

اعلان‌ها

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

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

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

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

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

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

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

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