نقل حدث إلى تقويم آخر، أي تغيير منظِّم الحدث تجدر الإشارة إلى أنّه لا يمكن نقل سوى default
حدث، أي أنّه لا يمكن نقل أحداث outOfOffice
وfocusTime
وworkingLocation
وfromGmail
.
جرِّبه الآن أو اطّلِع على مثال.
الطلب
طلب HTTP
POST https://www.googleapis.com/calendar/v3/calendars/calendarId/events/eventId/move
المَعلمات
اسم المعلَمة | القيمة | الوصف |
---|---|---|
مَعلمات المسار | ||
calendarId |
string |
معرّف التقويم للتقويم المصدر حيث الحدث حاليًا. |
eventId |
string |
معرّف الحدث |
مَعلمات طلب البحث المطلوبة | ||
destination |
string |
معرِّف التقويم للتقويم المستهدَف الذي سيتم نقل الحدث إليه |
مَعلمات طلب البحث الاختيارية | ||
sendNotifications |
boolean |
تمّ الإيقاف. يُرجى استخدام sendUpdates بدلاً من ذلك. ما إذا كنت تريد إرسال إشعارات حول تغيير منظِّم الحدث أم لا. يُرجى العلم أنّه قد يتم إرسال بعض الرسائل الإلكترونية حتى في حال ضبط القيمة على false . والقيمة التلقائية هي false .
|
sendUpdates |
string |
المدعوّون الذين يجب أن يتلقّوا إشعارات حول تغيير منظِّم الحدث
القيم المقبولة هي:
|
التفويض
يتطلب هذا الطلب تفويضًا باستخدام نطاق واحد على الأقل من النطاقات التالية:
النطاق |
---|
https://www.googleapis.com/auth/calendar |
https://www.googleapis.com/auth/calendar.events |
للحصول على مزيد من المعلومات، يمكنك الاطلاع على صفحة المصادقة والتفويض.
نص الطلب
لا توفِّر نص طلب بهذه الطريقة.
الإجابة
في حال نجاح هذا الإجراء، تعرِض هذه الطريقة مورد الأحداث في نص الاستجابة.
أمثلة
ملاحظة: إنّ الأمثلة المرتبطة بالرموز والمتوفرة لهذه الطريقة لا تمثّل كل لغات البرمجة المتوافقة (يُرجى مراجعة صفحة مكتبات البرامج للاطّلاع على قائمة باللغات المتوافقة).
Java
تستخدم مكتبة عملاء Java.
import com.google.api.services.calendar.Calendar; import com.google.api.services.calendar.model.Event; // ... // Initialize Calendar service with valid OAuth credentials Calendar service = new Calendar.Builder(httpTransport, jsonFactory, credentials) .setApplicationName("applicationName").build(); // Move an event to another calendar Event updatedEvent = service.events().move('primary', "eventId", "destinationCalendarId").execute(); System.out.println(updatedEvent.getUpdated());
Python
تستخدم مكتبة برامج Python.
# First retrieve the event from the API. updated_event = service.events().move( calendarId='primary', eventId='eventId', destination='destinationCalendarId').execute() # Print the updated date. print updated_event['updated']
PHP
تستخدم مكتبة برامج PHP.
$result = $service->events->move('primary', 'eventId', 'destinationCalendarId'); // Print the updated date. echo $result->getUpdated();
Ruby
تستخدم مكتبة برامج Ruby.
result = client.move_event('primary', 'eventId', 'destinationCalendarId') print result.updated
تجربة
استخدِم مستكشف واجهات برمجة التطبيقات أدناه لطلب هذه الطريقة على البيانات المباشرة والاطّلاع على الردّ.