یک تقویم را از لیست تقویم کاربر برمی گرداند. اکنون آن را امتحان کنید یا نمونه ای را ببینید .
درخواست
درخواست HTTP
GET https://www.googleapis.com/calendar/v3/users/me/calendarList/calendarId
مولفه های
| نام پارامتر | ارزش | شرح |
|---|---|---|
| پارامترهای مسیر | ||
calendarId | string | شناسه تقویم برای بازیابی شناسه های تقویم با روش calendarList.list تماس بگیرید. اگر می‌خواهید به تقویم اصلی کاربر وارد شده در حال حاضر دسترسی داشته باشید، از کلمه کلیدی " primary " استفاده کنید. |
مجوز
این درخواست نیاز به مجوز با حداقل یکی از حوزه های زیر دارد:
| محدوده |
|---|
https://www.googleapis.com/auth/calendar.readonly |
https://www.googleapis.com/auth/calendar |
برای اطلاعات بیشتر، به صفحه احراز هویت و مجوز مراجعه کنید.
درخواست بدن
با این روش بدنه درخواستی ارائه نکنید.
واکنش
در صورت موفقیت آمیز بودن، این روش یک منبع CalendarList را در بدنه پاسخ برمی گرداند.
مثال ها
توجه: نمونه‌های کد موجود برای این روش همه زبان‌های برنامه‌نویسی پشتیبانی‌شده را نشان نمی‌دهند (برای فهرست زبان‌های پشتیبانی‌شده به صفحه کتابخانه‌های سرویس گیرنده مراجعه کنید).
جاوا
از کتابخانه سرویس گیرنده جاوا استفاده می کند.
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();
// Retrieve a specific calendar list entry
CalendarListEntry calendarListEntry = service.calendarList().get("calendarId").execute();
System.out.println(calendarListEntry.getSummary());
پایتون
از کتابخانه کلاینت پایتون استفاده می کند.
calendar_list_entry = service.calendarList().get(calendarId='calendarId').execute() print(calendar_list_entry['summary'])
PHP
از کتابخانه مشتری PHP استفاده می کند.
$calendarListEntry = $service->calendarList->get('calendarId');
echo $calendarListEntry->getSummary();
روبی
از کتابخانه کلاینت Ruby استفاده می کند.
result = client.get_calendar_list('calendarId')
print result.summary
آن را امتحان کنید!
از APIs Explorer زیر برای فراخوانی این روش در داده‌های زنده و دیدن پاسخ استفاده کنید.