متادیتا را برای یک تقویم به روز می کند. اکنون آن را امتحان کنید یا نمونه ای را ببینید .
درخواست کنید
درخواست HTTP
PUT https://www.googleapis.com/calendar/v3/calendars/calendarId
پارامترها
نام پارامتر | ارزش | توضیحات |
---|---|---|
پارامترهای مسیر | ||
calendarId | string | شناسه تقویم برای بازیابی شناسه های تقویم با روش calendarList.list تماس بگیرید. اگر میخواهید به تقویم اصلی کاربر وارد شده در حال حاضر دسترسی داشته باشید، از کلمه کلیدی " primary " استفاده کنید. |
مجوز
این درخواست به مجوز با محدوده زیر نیاز دارد:
دامنه |
---|
https://www.googleapis.com/auth/calendar |
برای اطلاعات بیشتر، به صفحه احراز هویت و مجوز مراجعه کنید.
درخواست بدن
در بدنه درخواست، یک منبع Calendars با ویژگی های زیر ارائه کنید:
نام ملک | ارزش | توضیحات | یادداشت ها |
---|---|---|---|
ویژگی های اختیاری | |||
description | string | شرح تقویم اختیاری. | قابل نوشتن |
location | string | موقعیت جغرافیایی تقویم به صورت متن آزاد. اختیاری. | قابل نوشتن |
summary | string | عنوان تقویم | قابل نوشتن |
timeZone | string | منطقه زمانی تقویم (فرمت شده به عنوان نام پایگاه داده منطقه زمانی IANA، به عنوان مثال "اروپا/زوریخ".) اختیاری است. | قابل نوشتن |
پاسخ
در صورت موفقیت آمیز بودن، این روش یک منبع Calendars را در بدنه پاسخ برمی گرداند.
نمونه ها
توجه: نمونههای کد موجود برای این روش همه زبانهای برنامهنویسی پشتیبانیشده را نشان نمیدهند (برای فهرست زبانهای پشتیبانیشده به صفحه کتابخانههای سرویس گیرنده مراجعه کنید).
جاوا
از کتابخانه سرویس گیرنده جاوا استفاده می کند.
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());
پایتون
از کتابخانه کلاینت پایتون استفاده می کند.
# 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 استفاده می کند.
calendar = client.get_calendar('primary') calendar.summary = "New Summary" result = client.update_calendar(calendar.id, calendar) print result.etag
آن را امتحان کنید!
از APIs Explorer زیر برای فراخوانی این روش در دادههای زنده و دیدن پاسخ استفاده کنید.