Events: patch

لتعديل حدث. تدعم هذه الطريقة دلالات التصحيح. تجدر الإشارة إلى أنّ كل طلب تصحيح يستهلك ثلاث وحدات حصة، ويفضّل استخدام get متبوعة بعلامة update. تحلّ قيم الحقول التي تحدّدها محلّ القيم الحالية. تبقى الحقول التي لا تحدّدها في الطلب بدون تغيير. تؤدي حقول المصفوفة، في حال تحديدها، إلى استبدال الصفائف الحالية، ويؤدي هذا إلى إلغاء أي عناصر صفيف سابقة. تجربة ذلك الآن

الطلب

طلب HTTP

PATCH https://www.googleapis.com/calendar/v3/calendars/calendarId/events/eventId

المَعلمات

اسم المعلَمة القيمة الوصف
مَعلمات المسار
calendarId string معرِّف التقويم. لاسترداد معرّفات التقويم، يمكنك استدعاء الطريقة calendarList.list. إذا كنت تريد الوصول إلى التقويم الأساسي للمستخدم المسجّل دخوله حاليًا، استخدِم الكلمة الرئيسية "primary".
eventId string معرّف الحدث
مَعلمات طلب البحث الاختيارية
alwaysIncludeEmail boolean تم التجاهل وتم تجاهله. سيتم دائمًا عرض قيمة في الحقل email للمنظِّم وصانع المحتوى والحاضرين، حتى في حال عدم توفّر عنوان بريد إلكتروني حقيقي (أي سيتمّ تقديم قيمة غير صالحة ومُنشأة).
conferenceDataVersion integer رقم إصدار بيانات مكالمة الفيديو التي يدعمها عميل واجهة برمجة التطبيقات. يفترض الإصدار 0 عدم توفير أي دعم لبيانات المؤتمر ويتجاهل بيانات مكالمة الفيديو في نص الحدث. يتيح الإصدار 1 إمكانية نسخ بيانات ConferenceData وكذلك إنشاء مكالمات فيديو جديدة باستخدام حقل createRequest في مؤتمراتcom. القيمة التلقائية هي 0. القيم المقبولة هي من 0 إلى 1، بشكل شامل.
maxAttendees integer تمثّل هذه السمة الحد الأقصى لعدد الضيوف الذين سيتم تضمينهم في الرد. إذا كان هناك أكثر من العدد المحدّد من الضيوف، يتم عرض المشارك فقط. اختياريّ.
sendNotifications boolean تمّ الإيقاف. يُرجى استخدام sendUpdates بدلاً من ذلك.

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

القيم المقبولة هي:
  • "all": تم إرسال الإشعارات إلى جميع المدعوين.
  • "externalOnly": يتم إرسال الإشعارات إلى المدعوّين الذين لا يستخدمون "تقويم Google" فقط.
  • "none": لم يتم إرسال أي إشعارات. بالنسبة إلى مهام نقل بيانات "تقويم Google"، يمكنك استخدام طريقة Events.import بدلاً من ذلك.
supportsAttachments boolean ما إذا كان تنفيذ عميل واجهة برمجة التطبيقات يتيح استخدام مرفقات الأحداث اختياريّ. القيمة التلقائية هي False.

التفويض

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

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

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

نص الطلب

في نص الطلب، قدم الأجزاء ذات الصلة من مورد الأحداث، وفقًا لقواعد دلالات التصحيح.

الإجابة

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

تجربة

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