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

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

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

التفويض

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

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

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

نص الطلب

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

الرد

وفي حال نجاح الإجراء، سيتم عرض مورد الأحداث في نص الاستجابة.

جرّب الآن

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