Events: move

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

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

אישור

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

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