מעביר אירוע ליומן אחר, כלומר משנה את מארגן האירוע. לתשומת ליבך, ניתן להעביר רק default
אירועים; לא ניתן להעביר אירועים מסוג outOfOffice
, focusTime
ו-workingLocation
.
אפשר לנסות עכשיו או לראות דוגמה.
בקשה
בקשת HTTP
POST https://www.googleapis.com/calendar/v3/calendars/calendarId/events/eventId/move
פרמטרים
שם הפרמטר | Value | התיאור |
---|---|---|
פרמטרים של נתיב | ||
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
רוצה לנסות?
ניתן להשתמש ב-APIs Explorer שבהמשך כדי לקרוא לשיטה הזו בנתונים בזמן אמת ולראות את התגובה.