Events: move

یک رویداد را به تقویم دیگری منتقل می کند، یعنی سازمان دهنده یک رویداد را تغییر می دهد. توجه داشته باشید که فقط رویدادهای 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 مهمانانی که باید درباره تغییر برگزارکننده رویداد اعلان دریافت کنند.

مقادیر قابل قبول عبارتند از:
  • " all ": اعلان ها برای همه مهمانان ارسال می شود.
  • " externalOnly ": اعلان‌ها فقط برای مهمانان غیر Google Calendar ارسال می‌شوند.
  • " none ": هیچ اعلانی ارسال نمی شود. برای کارهای انتقال تقویم، به جای آن از روش Events.import استفاده کنید.

مجوز

این درخواست نیاز به مجوز با حداقل یکی از حوزه های زیر دارد:

محدوده
https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.events

برای اطلاعات بیشتر، به صفحه احراز هویت و مجوز مراجعه کنید.

درخواست بدن

با این روش بدنه درخواستی ارائه نکنید.

واکنش

در صورت موفقیت آمیز بودن، این روش یک منبع رویدادها را در بدنه پاسخ باز می گرداند.

مثال ها

توجه: نمونه‌های کد موجود برای این روش همه زبان‌های برنامه‌نویسی پشتیبانی‌شده را نشان نمی‌دهند (برای فهرست زبان‌های پشتیبانی‌شده به صفحه کتابخانه‌های سرویس گیرنده مراجعه کنید).

جاوا

از کتابخانه سرویس گیرنده جاوا استفاده می کند.

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());

پایتون

از کتابخانه کلاینت پایتون استفاده می کند.

# 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 استفاده می کند.

result = client.move_event('primary', 'eventId', 'destinationCalendarId')
print result.updated

آن را امتحان کنید!

از APIs Explorer زیر برای فراخوانی این روش در داده‌های زنده و دیدن پاسخ استفاده کنید.