Events: quickAdd

تُنشئ حدثًا استنادًا إلى سلسلة نصية بسيطة. جرِّب ذلك الآن.

الطلب

طلب HTTP

POST https://www.googleapis.com/calendar/v3/calendars/calendarId/events/quickAdd

المعلمات

اسم المعلَمة القيمة الوصف
مَعلمات المسار
calendarId string معرّف التقويم لاسترداد أرقام تعريف التقاويم، يمكنك استدعاء الطريقة calendarList.list. إذا كنت تريد الوصول إلى التقويم الأساسي للمستخدم الذي سجّل الدخول حاليًا، استخدِم الكلمة الرئيسية "primary".
مَعلمات طلب البحث المطلوبة
text string النص الذي يصف الحدث المطلوب إنشاؤه
مَعلمات طلب البحث الاختيارية
sendNotifications boolean تمّ الإيقاف. يُرجى استخدام sendUpdates بدلاً من ذلك.

يحدد هذا الخيار ما إذا كان سيتم إرسال إشعارات بشأن إنشاء الحدث. يُرجى العِلم أنّه قد يستمر إرسال بعض الرسائل الإلكترونية حتى إذا ضبطت القيمة على false. القيمة التلقائية هي false.
sendUpdates string الضيوف الذين من المفترض أن يتلقّوا إشعارات بشأن إنشاء الحدث الجديد

القِيَم المقبولة هي:
  • "all": يتم إرسال الإشعارات إلى جميع الضيوف.
  • "externalOnly": يتم إرسال الإشعارات إلى المدعوين غير المستخدمين لـ "تقويم Google" فقط.
  • "none": لا يتم إرسال أي إشعارات. بالنسبة إلى مهام نقل بيانات التقويم، ننصحك باستخدام الطريقة Events.import بدلاً من ذلك.

التفويض

يتطلب هذا الطلب تفويضًا بنطاق واحد على الأقل من النطاقات التالية:

النطاق
https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.events
https://www.googleapis.com/auth/calendar.app.created
https://www.googleapis.com/auth/calendar.events.owned

لمزيد من المعلومات، يُرجى الاطّلاع على صفحة المصادقة والتفويض.

نص الطلب

لا تقدِّم محتوى طلب باستخدام هذه الطريقة.

الردّ

في حال نجاح هذه الطريقة، تعرض مورد الأحداث في نص الاستجابة.

جرّب الآن

استخدِم "مستكشف واجهات برمجة التطبيقات" أدناه لطلب هذه الطريقة على البيانات المباشرة والاطّلاع على الاستجابة.