إدراج تقويم حالي في قائمة تقويم المستخدم جرِّب الخدمة الآن أو اطّلِع على مثال.
الطلب
طلب HTTP
POST https://www.googleapis.com/calendar/v3/users/me/calendarList
المعلمات
اسم المعلَمة | القيمة | الوصف |
---|---|---|
مَعلمات طلب البحث الاختيارية | ||
colorRgbFormat |
boolean |
يمكنك استخدام الحقلين foregroundColor وbackgroundColor لكتابة ألوان التقويم (نموذج أحمر أخضر أزرق). في حال استخدام هذه الميزة، سيتم تلقائيًا ضبط حقل colorId المستند إلى الفهرس على أفضل خيار مطابقة. اختياريّ. وتكون القيمة التلقائية False.
|
التفويض
يتطلب هذا الطلب تفويضًا بالنطاق التالي:
النطاق |
---|
https://www.googleapis.com/auth/calendar |
لمزيد من المعلومات، يُرجى الاطّلاع على صفحة المصادقة والتفويض.
نص الطلب
في نص الطلب، قدِّم مورد CalendarList مع السمات التالية:
اسم الموقع | القيمة | الوصف | ملاحظات |
---|---|---|---|
الخصائص المطلوبة | |||
id |
string |
معرّف التقويم. | |
الخصائص الاختيارية | |||
backgroundColor |
string |
اللون الرئيسي للتقويم بالتنسيق السداسي العشري "#0088aa ". تحلّ هذه السمة محلّ سمة colorId المستندة إلى الفهرس. لضبط هذه السمة أو تغييرها، عليك تحديد colorRgbFormat=true في مَعلمات طرق insert وupdate وpatch. اختياريّ. |
قابل للكتابة |
colorId |
string |
لون التقويم هذا معرّف يشير إلى إدخال في القسم calendar من تعريف الألوان (يُرجى الاطّلاع على نقطة نهاية الألوان). وتحلّ السمتان backgroundColor وforegroundColor محلّ هذه السمة، ويمكن تجاهلهما عند استخدام هاتين السمتَين. اختياريّ. |
قابل للكتابة |
defaultReminders[] |
list |
التذكيرات التلقائية التي يمتلكها المستخدم الذي تمت مصادقته لهذا التقويم. | قابل للكتابة |
defaultReminders[].method |
string |
الطريقة المستخدمة في هذا التذكير القيم المتاحة:
مطلوب عند إضافة تذكير. |
قابل للكتابة |
defaultReminders[].minutes |
integer |
عدد الدقائق التي تسبق بدء الحدث والتي من المفترض أن يبدأ فيها التذكير. تتراوح القيم الصالحة بين 0 و40320 (4 أسابيع بالدقائق). مطلوب عند إضافة تذكير. |
قابل للكتابة |
foregroundColor |
string |
لون مقدمة التقويم بالتنسيق السداسي العشري "#ffffff ". تحلّ هذه السمة محلّ سمة colorId المستندة إلى الفهرس. لضبط هذه السمة أو تغييرها، عليك تحديد colorRgbFormat=true في مَعلمات طرق insert وupdate وpatch. اختياريّ. |
قابل للكتابة |
notificationSettings |
object |
الإشعارات التي يتلقّاها المستخدم الذي تمت مصادقته لهذا التقويم. | قابل للكتابة |
notificationSettings.notifications[].method |
string |
الطريقة المستخدَمة لتسليم الإشعار. القيمة المحتملة هي:
مطلوب عند إضافة إشعار |
قابل للكتابة |
notificationSettings.notifications[].type |
string |
نوع الإشعار. القيم المتاحة:
مطلوب عند إضافة إشعار |
قابل للكتابة |
selected |
boolean |
ما إذا كان محتوى التقويم سيظهر في واجهة مستخدم التقويم أم لا. اختياريّ. وتكون القيمة التلقائية False. | قابل للكتابة |
summaryOverride |
string |
الملخّص الذي أعده المستخدم الذي تمت مصادقته لهذا التقويم. اختياريّ. | قابل للكتابة |
الرد
في حال نجاح هذه الطريقة، سيتم عرض مورد CalendarList في نص الاستجابة.
أمثلة
ملاحظة: إنّ الأمثلة المرتبطة بالرموز والمتوفرة لهذه الطريقة لا تمثّل كل لغات البرمجة المتوافقة (يُرجى مراجعة صفحة مكتبات البرامج للاطّلاع على قائمة باللغات المتوافقة).
Java
تستخدم مكتبة برامج Java.
import com.google.api.services.calendar.Calendar; import com.google.api.services.calendar.model.CalendarListEntry; // ... // Initialize Calendar service with valid OAuth credentials Calendar service = new Calendar.Builder(httpTransport, jsonFactory, credentials) .setApplicationName("applicationName").build(); // Create a new calendar list entry CalendarListEntry calendarListEntry = new CalendarListEntry(); calendarListEntry.setId("calendarId"); // Insert the new calendar list entry CalendarListEntry createdCalendarListEntry = service.calendarList().insert(calendarListEntry).execute(); System.out.println(createdCalendarListEntry.getSummary());
Python
تستخدم مكتبة برامج Python.
calendar_list_entry = { 'id': 'calendarId' } created_calendar_list_entry = service.calendarList().insert(body=calendar_list_entry).execute() print created_calendar_list_entry['summary']
PHP
لاستخدام مكتبة برامج PHP
$calendarListEntry = new Google_Service_Calendar_CalendarListEntry(); $calendarListEntry->setId("calendarId"); $createdCalendarListEntry = $service->calendarList->insert($calendarListEntry); echo $createdCalendarListEntry->getSummary();
Ruby
تستخدم مكتبة برامج Ruby.
entry = Google::Apis::CalendarV3::CalendarListEntry.new( id: 'calendarId' ) result = client.insert_calendar_list(entry) print result.summary
جرّب الآن
يمكنك استخدام "مستكشف واجهات برمجة التطبيقات" أدناه لطلب هذه الطريقة على البيانات المباشرة والاطّلاع على الردّ.