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 في conferenceData. القيمة التلقائية هي 0. القيم المقبولة هي من 0 إلى 1 بشكلٍ شامل.
eventLabelVersion integer رقم إصدار ميزة تصنيف الأحداث التي يتيحها عميل واجهة برمجة التطبيقات يفترض الإصدار 0 عدم إتاحة تصنيف الأحداث ويعالج الحقل colorId لإدارة الألوان. يتيح الإصدار 1 إمكانية تصنيف الأحداث ويعالج eventLabelId في نص الحدث. في هذه الحالة، يتم تجاهل حقل colorId. القيمة التلقائية هي 0. القيم المقبولة هي من 0 إلى 1 بشكلٍ شامل.
maxAttendees integer الحد الأقصى لعدد الحاضرين المطلوب تضمينهم في الردّ إذا كان عدد الحاضرين أكبر من العدد المحدّد، يتم عرض المشارك فقط. اختياريّ.
sendNotifications boolean تم إيقاف هذه المَعلمة. يُرجى استخدام sendUpdates بدلاً منها.

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

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

التفويض

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

النطاق
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

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

نص الطلب

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

الردّ

إذا كانت الاستجابة ناجحة، تعرض هذه الطريقة مصدر Events في نص الردّ.

جرِّبها الآن.

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