تعديل البيانات الوصفية لتقويم جرِّب ذلك الآن أو اطّلِع على مثال.
الطلب
طلب HTTP
PUT https://www.googleapis.com/calendar/v3/calendars/calendarId
المعلمات
اسم المعلَمة | القيمة | الوصف |
---|---|---|
مَعلمات المسار | ||
calendarId |
string |
معرّف التقويم لاسترداد أرقام تعريف التقاويم، يمكنك استدعاء الطريقة calendarList.list. إذا كنت تريد الوصول إلى التقويم الأساسي للمستخدم الذي سجّل الدخول حاليًا، استخدِم الكلمة الرئيسية "primary ".
|
التفويض
يتطلب هذا الطلب تفويضًا بنطاق واحد على الأقل من النطاقات التالية:
النطاق |
---|
https://www.googleapis.com/auth/calendar |
https://www.googleapis.com/auth/calendar.app.created |
https://www.googleapis.com/auth/calendar.calendars |
لمزيد من المعلومات، يُرجى الاطّلاع على صفحة المصادقة والتفويض.
نص الطلب
في نص الطلب، قدِّم مورد التقاويم مع السمات التالية:
اسم السمة | القيمة | الوصف | ملاحظات |
---|---|---|---|
السمات الاختيارية | |||
description |
string |
وصف التقويم اختياريّ. | قابلة للكتابة |
location |
string |
الموقع الجغرافي للتقويم بتنسيق نصّي حر اختياريّ. | قابلة للكتابة |
summary |
string |
عنوان التقويم | قابلة للكتابة |
timeZone |
string |
المنطقة الزمنية للتقويم (يكون التنسيق على هيئة اسم في "قاعدة بيانات المناطق الزمنية IANA"، مثل "أوروبا/زيورخ") اختياريّ. | قابلة للكتابة |
الردّ
إذا كانت الاستجابة ناجحة، تُرجع هذه الطريقة مورد "تقويم Google" في نص الاستجابة.
أمثلة
ملاحظة: إنّ الأمثلة المرتبطة بالرموز والمتوفرة لهذه الطريقة لا تمثّل كل لغات البرمجة المتوافقة (يُرجى مراجعة صفحة مكتبات البرامج للاطّلاع على قائمة باللغات المتوافقة).
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
جرّب الآن
استخدِم "مستكشف واجهات برمجة التطبيقات" أدناه لطلب هذه الطريقة على البيانات المباشرة والاطّلاع على الاستجابة.