تعديل البيانات الوصفية لتقويم جرِّبه الآن أو شاهد مثالاً.
الطلب
طلب HTTP
PUT https://www.googleapis.com/calendar/v3/calendars/calendarId
المَعلمات
| اسم المعلَمة | القيمة | الوصف |
|---|---|---|
| مَعلمات المسار | ||
calendarId |
string |
معرِّف التقويم. لاسترداد معرّفات التقويم، يمكنك استدعاء الطريقة calendarList.list. إذا كنت تريد الوصول إلى التقويم الأساسي للمستخدم المسجّل دخوله حاليًا، استخدِم الكلمة الرئيسية "primary".
|
التفويض
يتطلب هذا الطلب تفويضًا بالنطاق التالي:
| النطاق |
|---|
https://www.googleapis.com/auth/calendar |
للحصول على مزيد من المعلومات، يُرجى الاطّلاع على صفحة المصادقة والتفويض.
نص الطلب
في نص الطلب، وقدِّم مورد "التقاويم" بالخصائص التالية:
| اسم الموقع | القيمة | الوصف | Notes |
|---|---|---|---|
| الخصائص الاختيارية | |||
description |
string |
وصف التقويم. اختياريّ. | قابل للكتابة |
location |
string |
الموقع الجغرافي للتقويم كنص مرن. اختياريّ. | قابل للكتابة |
summary |
string |
عنوان التقويم. | قابل للكتابة |
timeZone |
string |
المنطقة الزمنية للتقويم. (بتنسيق اسم قاعدة بيانات المناطق الزمنية الصادرة عن منظمة IANA (المنظمة المعنية بأرقام الإنترنت المخصصة)، على سبيل المثال "أوروبا/زيورخ"). اختياريّ. | قابل للكتابة |
الإجابة
وفي حال نجاحها، تعرِض هذه الطريقة مورد "التقاويم" في نص الاستجابة.
أمثلة
ملاحظة: إنّ الأمثلة المرتبطة بالرموز والمتوفرة لهذه الطريقة لا تمثّل كل لغات البرمجة المتوافقة (يُرجى مراجعة صفحة مكتبات البرامج للاطّلاع على قائمة باللغات المتوافقة).
Java
تستخدم مكتبة عميل Java.
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();
// Retrieve a calendar
com.google.api.services.calendar.model.Calendar calendar =
service.calendars().get('primary').execute();
// Make a change
calendar.setSummary("calendarSummary");
// Update the altered calendar
com.google.api.services.calendar.model.Calendar updatedCalendar =
service.calendars().update(calendar.getId(), calendar).execute();
System.out.println(updatedCalendar.getEtag());
Python
تستخدم مكتبة برامج Python.
# First retrieve the calendar from the API. calendar = service.calendars().get(calendarId='primary').execute() calendar['summary'] = 'New Summary' updated_calendar = service.calendars().update(calendarId=calendar['id'], body=calendar).execute() print updated_calendar['etag']
PHP
لاستخدام مكتبة برامج PHP.
// First retrieve the calendar from the API.
$calendar = $service->calendars->get('primary');
$calendar->setSummary('New Summary');
$updatedCalendar = $service->calendars->update('primary', $calendar);
echo $updatedCalendar->getEtag();
Ruby
تستخدم مكتبة عميل Ruby.
calendar = client.get_calendar('primary')
calendar.summary = "New Summary"
result = client.update_calendar(calendar.id, calendar)
print result.etag
تجربة
يمكنك استخدام مستكشف واجهات برمجة التطبيقات أدناه لطلب هذه الطريقة على البيانات المباشرة والاطّلاع على الاستجابة.