Events: delete

یک رویداد را حذف می کند. اکنون آن را امتحان کنید یا نمونه ای را ببینید .

درخواست کنید

درخواست HTTP 

DELETE https://www.googleapis.com/calendar/v3/calendars/calendarId/events/eventId

پارامترها

نام پارامتر ارزش توضیحات
پارامترهای مسیر
calendarId string شناسه تقویم برای بازیابی شناسه های تقویم با روش calendarList.list تماس بگیرید. اگر می‌خواهید به تقویم اصلی کاربر وارد شده در حال حاضر دسترسی داشته باشید، از کلمه کلیدی " primary " استفاده کنید.
eventId 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;

// ...

// Initialize Calendar service with valid OAuth credentials
Calendar service = new Calendar.Builder(httpTransport, jsonFactory, credentials)
    .setApplicationName("applicationName").build();

// Delete an event
service.events().delete('primary', "eventId").execute();

پایتون

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

service.events().delete(calendarId='primary', eventId='eventId').execute()

PHP

از کتابخانه مشتری PHP استفاده می کند. 

$service->events->delete('primary', 'eventId');

روبی

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

client.delete_event('primary', 'eventId')

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

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