要求
HTTP 要求
POST https://www.googleapis.com/calendar/v3/calendars
授權
此要求需要具有下列範圍的授權:
範圍 |
---|
https://www.googleapis.com/auth/calendar |
詳情請參閱「驗證與授權」網頁。
要求主體
在要求主體中,提供含有以下屬性的行事曆資源:
屬性名稱 | 值 | 說明 | 附註 |
---|---|---|---|
必要屬性 | |||
summary |
string |
日曆的標題。 | 可寫入 |
回應
成功的話,這個方法會在回應主體中傳回行事曆資源。
範例
注意:這個方法適用的程式語言眾多,我們只在此提供部分程式碼範例,完整的支援語言清單請參閱用戶端程式庫頁面。
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(); // Create a new calendar com.google.api.services.calendar.model.Calendar calendar = new Calendar(); calendar.setSummary("calendarSummary"); calendar.setTimeZone("America/Los_Angeles"); // Insert the new calendar Calendar createdCalendar = service.calendars().insert(calendar).execute(); System.out.println(createdCalendar.getId());
Python
使用 Python 用戶端程式庫。
calendar = { 'summary': 'calendarSummary', 'timeZone': 'America/Los_Angeles' } created_calendar = service.calendars().insert(body=calendar).execute() print created_calendar['id']
PHP
使用 PHP 用戶端程式庫。
$calendar = new Google_Service_Calendar_Calendar(); $calendar->setSummary('calendarSummary'); $calendar->setTimeZone('America/Los_Angeles'); $createdCalendar = $service->calendars->insert($calendar); echo $createdCalendar->getId();
小茹
使用 Ruby 用戶端程式庫。
calendar = Google::Apis::CalendarV3::Calendar.new( summary: 'calendarSummary', time_zone: 'America/Los_Angeles' ) result = client.insert_calendar(calendar) print result.id
試試看!
使用下方的 APIs Explorer,針對即時資料呼叫這個方法,看看會有什麼結果。