یک رویداد بر اساس یک رشته متن ساده ایجاد می کند. اکنون آن را امتحان کنید یا نمونه ای را ببینید .
درخواست کنید
درخواست HTTP
POST https://www.googleapis.com/calendar/v3/calendars/calendarId/events/quickAdd
پارامترها
نام پارامتر | ارزش | توضیحات |
---|---|---|
پارامترهای مسیر | ||
calendarId | string | شناسه تقویم برای بازیابی شناسه های تقویم با روش calendarList.list تماس بگیرید. اگر میخواهید به تقویم اصلی کاربر وارد شده در حال حاضر دسترسی داشته باشید، از کلمه کلیدی " primary " استفاده کنید. |
پارامترهای پرس و جو مورد نیاز | ||
text | string | متنی که رویدادی را که باید ایجاد شود توصیف می کند. |
پارامترهای پرس و جو اختیاری | ||
sendNotifications | boolean | منسوخ شده است. لطفاً به جای آن از sendUpdates استفاده کنید. ارسال اعلانهایی درباره ایجاد رویداد. توجه داشته باشید که برخی از ایمیلها ممکن است همچنان ارسال شوند حتی اگر مقدار را روی false تنظیم کنید. پیش فرض false است. |
sendUpdates | string | مهمانانی که باید در مورد ایجاد رویداد جدید اعلان دریافت کنند. مقادیر قابل قبول عبارتند از:
|
مجوز
این درخواست نیاز به مجوز با حداقل یکی از حوزه های زیر دارد:
دامنه |
---|
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(); // Quick-add an event String eventText = "Appointment at Somewhere on June 3rd 10am-10:25am"; Event createdEvent = service.events().quickAdd('primary').setText(eventText).execute(); System.out.println(createdEvent.getId());
پایتون
از کتابخانه کلاینت پایتون استفاده می کند.
created_event = service.events().quickAdd( calendarId='primary', text='Appointment at Somewhere on June 3rd 10am-10:25am').execute() print created_event['id']
PHP
از کتابخانه مشتری PHP استفاده می کند.
$createdEvent = $service->events->quickAdd( 'primary', 'Appointment at Somewhere on June 3rd 10am-10:25am'); echo $createdEvent->getId();
روبی
از کتابخانه کلاینت Ruby استفاده می کند.
result = client.quick_add_event( 'primary', 'Appointment at Somewhere on June 3rd 10am-10:25am') print result.id
آن را امتحان کنید!
از APIs Explorer زیر برای فراخوانی این روش در دادههای زنده و دیدن پاسخ استفاده کنید.