نقل حدث إلى تقويم آخر، أي تغيير منظِّم الحدث تجدر الإشارة إلى أنه لا يمكن نقل سوى أحداث default
، ولا يمكن نقل أحداث outOfOffice
وfocusTime
وworkingLocation
.
جرِّبه الآن أو شاهد مثالاً.
الطلب
طلب 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
تجربة
يمكنك استخدام مستكشف واجهات برمجة التطبيقات أدناه لطلب هذه الطريقة على البيانات المباشرة والاطّلاع على الاستجابة.