تنشئ حدثًا استنادًا إلى سلسلة نصية بسيطة. جرِّبه الآن أو شاهد مثالاً.
الطلب
طلب 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 |
للحصول على مزيد من المعلومات، يُرجى الاطّلاع على صفحة المصادقة والتفويض.
نص الطلب
لا توفِّر نص طلب بهذه الطريقة.
الإجابة
وفي حال نجاحها، تعرِض هذه الطريقة مورد الأحداث في نص الاستجابة.
أمثلة
ملاحظة: إنّ الأمثلة المرتبطة بالرموز والمتوفرة لهذه الطريقة لا تمثّل كل لغات البرمجة المتوافقة (يُرجى مراجعة صفحة مكتبات البرامج للاطّلاع على قائمة باللغات المتوافقة).
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(); // 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());
Python
تستخدم مكتبة برامج Python.
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
تستخدم مكتبة عميل Ruby.
result = client.quick_add_event( 'primary', 'Appointment at Somewhere on June 3rd 10am-10:25am') print result.id
تجربة
يمكنك استخدام مستكشف واجهات برمجة التطبيقات أدناه لطلب هذه الطريقة على البيانات المباشرة والاطّلاع على الاستجابة.