Events: move

העברת אירוע ליומן אחר, כלומר שינוי המארגן של האירוע. חשוב לדעת: אפשר להעביר רק אירועים מסוג default. אי אפשר להעביר אירועים מסוג birthday, focusTime, fromGmail, outOfOffice ו-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 משתתפים שאמורים לקבל התראות על השינוי של מארגן האירוע.

הערכים הקבילים הם:
  • 'all': התראות נשלחות לכל המשתתפים.
  • 'externalOnly': ההתראות נשלחות רק למשתתפים שלא משתמשים ביומן Google.
  • "none": לא נשלחות התראות. למשימות של העברת יומן, כדאי להשתמש במקום זאת ב-method Events.import.

אישור

הבקשה הזו מחייבת הרשאה עם לפחות אחד מההיקפים הבאים:

היקף
https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.events

מידע נוסף זמין בדף אימות והרשאה.

גוף הבקשה

אל תספקו גוף בקשה בשיטה הזו.

תשובה

אם הפעולה בוצעה ללא שגיאות, השיטה הזו מחזירה משאב Event בגוף התגובה.

דוגמאות

הערה: דוגמאות הקוד הזמינות לשיטה זו לא מייצגות את כל שפות התכנות הנתמכות (רשימת השפות הנתמכות זמינה בדף של ספריות המשתמשים).

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 שבהמשך כדי להפעיל את השיטה הזו בנתונים בזמן אמת ולראות את התגובה.