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': לא נשלחות התראות. במשימות של העברת יומנים, מומלץ להשתמש במקום זאת בשיטה Events.import.

אישור

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

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

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

גוף הבקשה

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

תשובה

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

דוגמאות

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

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

נסה בעצמך!

אפשר להשתמש ב-API Explorer שבהמשך כדי להפעיל את השיטה הזו על נתונים פעילים ולראות את התגובה.