Events: insert

建立事件。立即試用參閱範例

要求

HTTP 要求

POST https://www.googleapis.com/calendar/v3/calendars/calendarId/events

參數

參數名稱 說明
路徑參數
calendarId string 日曆 ID。如要擷取日曆 ID,請呼叫 calendarList.list 方法。如要存取目前登入使用者的主要日曆,請使用「primary」關鍵字。
選用查詢參數
conferenceDataVersion integer API 用戶端支援的會議資料版本號碼。版本 0 會假設不支援會議資料,並忽略事件主體中的會議資料。版本 1 支援複製 ConferenceData,以及使用 conferenceData 的 createRequest 欄位建立新會議。預設值為 0。可接受的值介於 01 (包含這兩者) 之間。
maxAttendees integer 回應中可納入的出席者人數上限。如果出席者人數超過指定數量,系統只會傳回參與者。選用。
sendNotifications boolean 已淘汰,請改用 sendUpdates

是否要傳送新事件建立通知。請注意,即使您將值設為 false,系統仍可能會傳送部分電子郵件。預設為 false
sendUpdates string 是否傳送新活動建立通知。請注意,部分電子郵件可能仍會傳送。預設為 false

可接受的值如下:
  • all」:通知會傳送給所有邀請對象。
  • externalOnly」:通知只會傳送給非 Google 日曆邀請對象。
  • none」:不會傳送通知。
supportsAttachments boolean 執行操作的 API 用戶端是否支援事件附件。選用設定。預設值為 False。

授權

這項要求需要至少具備下列其中一個範圍的授權:

範圍
https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.events

詳情請參閱「驗證和授權」頁面。

要求主體

在要求主體中,請提供具有下列屬性的 Events 資源

屬性名稱 說明 附註
必要屬性
end nested object 事件的結束時間 (不含)。如果是週期性活動,則這是指第一個活動的結束時間。
start nested object 活動的開始時間 (包含在內)。如果是週期性事件,則為第一個例項的開始時間。
選用屬性
anyoneCanAddSelf boolean 是否任何人都能邀請自己參加活動 (已淘汰)。選用設定。預設值為 False。 可寫入
attachments[].fileUrl string 附件的網址連結。

如要新增 Google 雲端硬碟檔案附件,格式與 Drive API 中 Files 資源的 alternateLink 屬性相同。

新增附件時必須提供。

可寫入
attendees[] list 活動的出席者。如要進一步瞭解如何與其他日曆使用者安排活動,請參閱「有參與者的活動」指南。服務帳戶必須使用全網域授權委派功能,才能填入與會者名單。 可寫入
attendees[].additionalGuests integer 額外房客人數。選用設定。預設值為 0。 可寫入
attendees[].comment string 與會者的回覆留言。選填。 可寫入
attendees[].displayName string 出席者的姓名 (如有)。選填。 可寫入
attendees[].email string 與會者的電子郵件地址 (如果有的話)。新增與會者時,必須提供這個欄位。必須是符合 RFC5322 規範的有效電子郵件地址。

新增與會者時必須提供。

可寫入
attendees[].optional boolean 這是否為選填與會者。選用設定。預設值為 False。 可寫入
attendees[].resource boolean 與會者是否為資源。只有在參與者首次加入活動時才能設定。系統會忽略後續的修改。選用設定。預設值為 False。 可寫入
attendees[].responseStatus string 與會者的回覆狀態。可能的值包括:
  • needsAction」:參與者尚未回覆邀請 (如果是新活動,建議採用這個選項)。
  • declined」:與會者已拒絕邀請。
  • tentative」:與會者已暫時接受邀請。
  • accepted」:與會者已接受邀請。
可寫入
birthdayProperties nested object 生日或特殊活動資料。如果 eventType"birthday",則會使用此屬性。不可變更。 可寫入
birthdayProperties.type string 生日或特殊活動類型。可能的值包括:
  • "anniversary" - 生日以外的紀念日。一律包含 contact
  • "birthday" - 生日活動。這是預設值。
  • "custom":特殊日期,其標籤會在 customTypeName 欄位中進一步指定。一律包含 contact
  • "other":不屬於其他類別的特殊日期,且沒有自訂標籤。一律具備 contact
  • "self":日曆擁有者的生日。不能有 contact
Calendar API 僅支援建立類型為 "birthday" 的活動。活動建立後即無法變更類型。
可寫入
colorId string 事件的顏色。這個 ID 會參照顏色定義的 event 部分中的項目 (請參閱 顏色端點)。選填。 可寫入
conferenceData nested object 會議相關資訊,例如 Google Meet 會議的詳細資料。如要建立新的會議詳細資料,請使用 createRequest 欄位。如要保留變更,請務必將所有事件修改要求的 conferenceDataVersion 要求參數設為 1 可寫入
description string 活動的說明。可包含 HTML。選填。 可寫入
end.date date 如果是全天活動,則日期格式為「yyyy-mm-dd」。 可寫入
end.dateTime datetime 時間,以結合日期和時間的值表示 (格式符合 RFC3339 標準)。除非在 timeZone 中明確指定時區,否則必須指定時區偏移量。 可寫入
end.timeZone string 指定時間的時區。(格式為 IANA 時區資料庫名稱,例如「Europe/Zurich」)。這個欄位適用於週期性活動,且為必填欄位,用來指定週期性活動的擴充時區。對於單一事件,這個欄位是選用的,可用於指定事件開始/結束時間的自訂時區。 可寫入
eventType string 事件的具體類型。這項設定在活動建立後即無法變更。可能的值包括:
  • birthday」:一年一度的特殊全天活動。
  • default」:一般事件或未進一步指定的事件。
  • focusTime」:專注時間活動。
  • fromGmail」:Gmail 中的活動。無法建立這類事件。
  • outOfOffice」- 不在辦公室的活動。
  • workingLocation」- 工作地點事件。
可寫入
extendedProperties.private object 此日曆上顯示的活動副本專屬的私人屬性。 可寫入
extendedProperties.shared object 在其他與會者的日曆中,於活動副本之間共用的屬性。 可寫入
focusTimeProperties nested object 專注時間活動資料。如果 eventTypefocusTime,則會使用此屬性。 可寫入
gadget.display string 小工具的顯示模式。已淘汰,可能的值包括:
  • icon」:在日曆檢視畫面中,小工具會顯示在活動標題旁邊。
  • chip」:點選事件時會顯示小工具。
可寫入
gadget.height integer 小工具的高度 (以像素為單位)。高度必須是大於 0 的整數。選用設定。已淘汰。 可寫入
gadget.preferences object 可寫入
gadget.title string 小工具的標題。已淘汰。 可寫入
gadget.type string 小工具的類型。已淘汰。 可寫入
gadget.width integer 小工具的寬度 (以像素為單位)。寬度必須為大於 0 的整數。選用設定。已淘汰。 可寫入
guestsCanInviteOthers boolean 主辦單位以外的參與者是否能邀請其他人參加活動。選用設定。預設值為 True。 可寫入
guestsCanModify boolean 主辦人以外的與會者是否可以修改活動。選用設定。預設值為 False。 可寫入
guestsCanSeeOtherGuests boolean 主辦人以外的與會者是否可以查看活動的與會者。選用設定。預設值為 True。 可寫入
id string 事件的不明瞭識別碼。建立新的單一或週期性活動時,您可以指定活動 ID。提供的 ID 必須遵循下列規則:
  • ID 中允許使用的字元是 base32hex 編碼中使用的字元,也就是小寫字母 a 到 v 和數字 0 到 9,請參閱 RFC2938 中的第 3.1.2 節。
  • ID 的長度必須介於 5 至 1,024 個字元之間
  • 每個日曆的 ID 不得重複
由於系統是全球分散式架構,我們無法保證系統會在事件建立時偵測到 ID 衝突。為了盡可能降低衝突的風險,建議您使用現成的 UUID 演算法,如 RFC4122 中所述。

如果您未指定 ID,系統會自動產生 ID。

請注意,icalUIDid 並不相同,且只須在建立事件時提供其中一個項目。兩者的語意差異之一,就是在週期性事件中,所有出現一個事件的 id 都不同,而所有事件都共用相同的 icalUID

可寫入
location string 活動的地理位置,以任意形式顯示。選填。 可寫入
originalStartTime.date date 如果是全天活動,則日期格式為「yyyy-mm-dd」。 可寫入
originalStartTime.dateTime datetime 時間,以結合日期和時間的值表示 (格式符合 RFC3339 標準)。除非在 timeZone 中明確指定時區,否則必須使用時區偏移。 可寫入
originalStartTime.timeZone string 指定時間的時區。(格式為 IANA 時區資料庫名稱,例如「Europe/Zurich」)。這個欄位適用於週期性活動,且為必填欄位,用來指定週期性活動的擴充時區。對於單一事件,這個欄位是選用的,可用於指定事件開始/結束時間的自訂時區。 可寫入
outOfOfficeProperties nested object 不在辦公室的活動資料。如果 eventTypeoutOfOffice,則會使用此屬性。 可寫入
recurrence[] list RFC5545 所述,這是重複事件的 RRULE、EXRULE、RDATE 和 EXDATE 列清單。請注意,這個欄位不允許「DTSTART」和「DTEND」行,您可以在「start」和「end」欄位中指定活動的開始時間和結束時間。對於單一事件或週期性事件的例項,則省略這個欄位。 可寫入
reminders.overrides[] list 如果活動未使用預設提醒,這裡會列出該活動專屬的提醒事項;如果未設定提醒事項,則表示系統未為此活動設定提醒事項。覆寫提醒的數量上限為 5 個。 可寫入
reminders.overrides[].method string 提醒事項使用的提醒方法。可能的值包括:
  • email」:系統會透過電子郵件傳送提醒。
  • popup」:系統會透過使用者介面彈出式視窗傳送提醒。

新增提醒時必填。

可寫入
reminders.overrides[].minutes integer 活動開始前幾分鐘,系統應觸發提醒的時間點。有效值介於 0 到 40320 (4 週以分鐘為單位) 之間。

新增提醒時為必填。

可寫入
reminders.useDefault boolean 日曆的預設提醒是否套用至活動。 可寫入
sequence integer 其序號。 可寫入
source.title string 來源的標題,例如網頁標題或電子郵件主旨。 可寫入
source.url string 指向資源的來源網址。網址架構必須是 HTTP 或 HTTPS。 可寫入
start.date date 如果是全天活動,則日期格式為「yyyy-mm-dd」。 可寫入
start.dateTime datetime 時間,以結合日期和時間的值表示 (格式符合 RFC3339 標準)。除非在 timeZone 中明確指定時區,否則必須指定時區偏移量。 可寫入
start.timeZone string 指定時間的時區。(格式為 IANA 時區資料庫名稱,例如「Europe/Zurich」)。這個欄位適用於週期性活動,且為必填欄位,用來指定週期性活動的擴充時區。對於單一事件,這個欄位是選用的,可用於指定事件開始/結束時間的自訂時區。 可寫入
status string 事件的狀態。選用設定。可能的值包括:
  • confirmed」:事件已確認。此為預設狀態。
  • tentative」:暫定活動已確認,
  • cancelled」:活動已取消 (已刪除)。list 方法只會在遞增式同步處理 (指定 syncTokenupdatedMin) 或 showDeleted 標記設為 true 時傳回已取消的事件。get 方法一律會傳回這些值。

    取消狀態代表兩種不同的狀態,具體取決於事件類型:

    1. 未取消的週期性活動中,已取消的例外狀況表示此例項不應再向使用者顯示。用戶端應在父項週期性活動的整個生命週期中儲存這些事件。

      系統只保證已取消的例外狀況會填入 idrecurringEventIdoriginalStartTime 欄位的值。其他欄位可能會留空。

    2. 所有其他已取消的事件都代表已刪除的事件。用戶端應移除本機同步處理的副本。這類已取消的事件最終會消失,因此請勿依賴這些事件永久可用。

      系統只保證已刪除的事件會填入 id 欄位。

    在發起人日曆中,已取消的活動會持續顯示活動詳細資料 (摘要、地點等),方便您還原 (取消刪除)。同樣地,使用者邀請並手動移除的活動也會繼續提供詳細資料。不過,如果 showDeleted 設為 false,增量同步處理要求就不會傳回這些詳細資料。

    如果活動變更主辦人 (例如透過移動作業),且原始主辦人不在參與者名單中,系統會留下已取消的活動,並保證只填入 id 欄位。

可寫入
summary string 活動名稱。 可寫入
transparency string 活動是否會在日曆上阻擋時間。選用設定。可能的值包括:
  • opaque」- 預設值。活動會在日曆上顯示為已預約的時間。等同於在日曆 UI 中將「我的顯示狀態」設為「忙碌」
  • transparent」:活動不會在日曆上阻擋時間。等同於在日曆 UI 中將「我的顯示狀態」設為「有空」
可寫入
visibility string 事件的瀏覽權限。選用設定。可能的值包括:
  • default」:使用日曆中活動的預設顯示設定。這是預設值。
  • public」:活動為公開,所有日曆讀者都能查看活動詳細資料。
  • private」:這是私人活動,只有活動參與者可以查看活動詳細資訊。
  • confidential」:事件為私人活動。這個值是為了相容性而提供。
可寫入
workingLocationProperties nested object 工作地點事件資料。 可寫入
workingLocationProperties.customLocation object 如果有此標記,表示使用者從自訂地點工作。 可寫入
workingLocationProperties.customLocation.label string 額外資訊的選用額外標籤。 可寫入
workingLocationProperties.homeOffice any value 如果存在,則表示使用者在家工作。 可寫入
workingLocationProperties.officeLocation object 如果有這個值,表示使用者是在辦公室工作。 可寫入
workingLocationProperties.officeLocation.buildingId string 選用的建築物 ID。這個值應參照機構資源資料庫中的建築物 ID。 可寫入
workingLocationProperties.officeLocation.deskId string 桌面 ID (選填)。 可寫入
workingLocationProperties.officeLocation.floorId string 選用的樓層 ID。 可寫入
workingLocationProperties.officeLocation.floorSectionId string 選用的樓層區段 ID。 可寫入
workingLocationProperties.officeLocation.label string 在 Google 日曆網頁版和行動版客戶端顯示的辦公室名稱。建議您參考機構的「資源」資料庫中的建築物名稱。 可寫入
workingLocationProperties.type string 工作地點類型。可能的值包括:
  • homeOffice」:使用者在家工作。
  • officeLocation」:使用者在辦公室工作。
  • customLocation」:使用者正在自訂位置工作。
所有詳細資料都會在指定名稱的子欄位中指定,但如果此欄位為空白,則可能會缺少此欄位。系統會忽略任何其他欄位。

新增工作地點屬性時必須使用。

可寫入

回應

如果成功的話,這個方法會在回應內文中傳回 Events 資源

範例

注意:這個方法適用的程式語言眾多,我們只在此提供部分程式碼範例,完整的支援語言清單請參閱用戶端程式庫頁面

Java

使用 Java 用戶端程式庫

// Refer to the Java quickstart on how to setup the environment:
// https://developers.google.com/calendar/quickstart/java
// Change the scope to CalendarScopes.CALENDAR and delete any stored
// credentials.

Event event = new Event()
    .setSummary("Google I/O 2015")
    .setLocation("800 Howard St., San Francisco, CA 94103")
    .setDescription("A chance to hear more about Google's developer products.");

DateTime startDateTime = new DateTime("2015-05-28T09:00:00-07:00");
EventDateTime start = new EventDateTime()
    .setDateTime(startDateTime)
    .setTimeZone("America/Los_Angeles");
event.setStart(start);

DateTime endDateTime = new DateTime("2015-05-28T17:00:00-07:00");
EventDateTime end = new EventDateTime()
    .setDateTime(endDateTime)
    .setTimeZone("America/Los_Angeles");
event.setEnd(end);

String[] recurrence = new String[] {"RRULE:FREQ=DAILY;COUNT=2"};
event.setRecurrence(Arrays.asList(recurrence));

EventAttendee[] attendees = new EventAttendee[] {
    new EventAttendee().setEmail("lpage@example.com"),
    new EventAttendee().setEmail("sbrin@example.com"),
};
event.setAttendees(Arrays.asList(attendees));

EventReminder[] reminderOverrides = new EventReminder[] {
    new EventReminder().setMethod("email").setMinutes(24 * 60),
    new EventReminder().setMethod("popup").setMinutes(10),
};
Event.Reminders reminders = new Event.Reminders()
    .setUseDefault(false)
    .setOverrides(Arrays.asList(reminderOverrides));
event.setReminders(reminders);

String calendarId = "primary";
event = service.events().insert(calendarId, event).execute();
System.out.printf("Event created: %s\n", event.getHtmlLink());

Python

使用 Python 用戶端程式庫

# Refer to the Python quickstart on how to setup the environment:
# https://developers.google.com/calendar/quickstart/python
# Change the scope to 'https://www.googleapis.com/auth/calendar' and delete any
# stored credentials.

event = {
  'summary': 'Google I/O 2015',
  'location': '800 Howard St., San Francisco, CA 94103',
  'description': 'A chance to hear more about Google\'s developer products.',
  'start': {
    'dateTime': '2015-05-28T09:00:00-07:00',
    'timeZone': 'America/Los_Angeles',
  },
  'end': {
    'dateTime': '2015-05-28T17:00:00-07:00',
    'timeZone': 'America/Los_Angeles',
  },
  'recurrence': [
    'RRULE:FREQ=DAILY;COUNT=2'
  ],
  'attendees': [
    {'email': 'lpage@example.com'},
    {'email': 'sbrin@example.com'},
  ],
  'reminders': {
    'useDefault': False,
    'overrides': [
      {'method': 'email', 'minutes': 24 * 60},
      {'method': 'popup', 'minutes': 10},
    ],
  },
}

event = service.events().insert(calendarId='primary', body=event).execute()
print 'Event created: %s' % (event.get('htmlLink'))

PHP

使用 PHP 用戶端程式庫

// Refer to the PHP quickstart on how to setup the environment:
// https://developers.google.com/calendar/quickstart/php
// Change the scope to Google_Service_Calendar::CALENDAR and delete any stored
// credentials.

$event = new Google_Service_Calendar_Event(array(
  'summary' => 'Google I/O 2015',
  'location' => '800 Howard St., San Francisco, CA 94103',
  'description' => 'A chance to hear more about Google\'s developer products.',
  'start' => array(
    'dateTime' => '2015-05-28T09:00:00-07:00',
    'timeZone' => 'America/Los_Angeles',
  ),
  'end' => array(
    'dateTime' => '2015-05-28T17:00:00-07:00',
    'timeZone' => 'America/Los_Angeles',
  ),
  'recurrence' => array(
    'RRULE:FREQ=DAILY;COUNT=2'
  ),
  'attendees' => array(
    array('email' => 'lpage@example.com'),
    array('email' => 'sbrin@example.com'),
  ),
  'reminders' => array(
    'useDefault' => FALSE,
    'overrides' => array(
      array('method' => 'email', 'minutes' => 24 * 60),
      array('method' => 'popup', 'minutes' => 10),
    ),
  ),
));

$calendarId = 'primary';
$event = $service->events->insert($calendarId, $event);
printf('Event created: %s\n', $event->htmlLink);

小茹

使用 Ruby 用戶端程式庫

event = Google::Apis::CalendarV3::Event.new(
  summary: 'Google I/O 2015',
  location: '800 Howard St., San Francisco, CA 94103',
  description: 'A chance to hear more about Google\'s developer products.',
  start: Google::Apis::CalendarV3::EventDateTime.new(
    date_time: '2015-05-28T09:00:00-07:00',
    time_zone: 'America/Los_Angeles'
  ),
  end: Google::Apis::CalendarV3::EventDateTime.new(
    date_time: '2015-05-28T17:00:00-07:00',
    time_zone: 'America/Los_Angeles'
  ),
  recurrence: [
    'RRULE:FREQ=DAILY;COUNT=2'
  ],
  attendees: [
    Google::Apis::CalendarV3::EventAttendee.new(
      email: 'lpage@example.com'
    ),
    Google::Apis::CalendarV3::EventAttendee.new(
      email: 'sbrin@example.com'
    )
  ],
  reminders: Google::Apis::CalendarV3::Event::Reminders.new(
    use_default: false,
    overrides: [
      Google::Apis::CalendarV3::EventReminder.new(
        reminder_method: 'email',
        minutes: 24 * 60
      ),
      Google::Apis::CalendarV3::EventReminder.new(
        reminder_method: 'popup',
        minutes: 10
      )
    ]
  )
)

result = client.insert_event('primary', event)
puts "Event created: #{result.html_link}"

.NET

使用 .NET 用戶端程式庫

// Refer to the .NET quickstart on how to setup the environment:
// https://developers.google.com/calendar/quickstart/dotnet
// Change the scope to CalendarService.Scope.Calendar and delete any stored
// credentials.

Event newEvent = new Event()
{
    Summary = "Google I/O 2015",
    Location = "800 Howard St., San Francisco, CA 94103",
    Description = "A chance to hear more about Google's developer products.",
    Start = new EventDateTime()
    {
        DateTime = DateTime.Parse("2015-05-28T09:00:00-07:00"),
        TimeZone = "America/Los_Angeles",
    },
    End = new EventDateTime()
    {
        DateTime = DateTime.Parse("2015-05-28T17:00:00-07:00"),
        TimeZone = "America/Los_Angeles",
    },
    Recurrence = new String[] { "RRULE:FREQ=DAILY;COUNT=2" },
    Attendees = new EventAttendee[] {
        new EventAttendee() { Email = "lpage@example.com" },
        new EventAttendee() { Email = "sbrin@example.com" },
    },
    Reminders = new Event.RemindersData()
    {
        UseDefault = false,
        Overrides = new EventReminder[] {
            new EventReminder() { Method = "email", Minutes = 24 * 60 },
            new EventReminder() { Method = "sms", Minutes = 10 },
        }
    }
};

String calendarId = "primary";
EventsResource.InsertRequest request = service.Events.Insert(newEvent, calendarId);
Event createdEvent = request.Execute();
Console.WriteLine("Event created: {0}", createdEvent.HtmlLink);

Go

使用 Go 用戶端程式庫

// Refer to the Go quickstart on how to setup the environment:
// https://developers.google.com/calendar/quickstart/go
// Change the scope to calendar.CalendarScope and delete any stored credentials.

event := &calendar.Event{
  Summary: "Google I/O 2015",
  Location: "800 Howard St., San Francisco, CA 94103",
  Description: "A chance to hear more about Google's developer products.",
  Start: &calendar.EventDateTime{
    DateTime: "2015-05-28T09:00:00-07:00",
    TimeZone: "America/Los_Angeles",
  },
  End: &calendar.EventDateTime{
    DateTime: "2015-05-28T17:00:00-07:00",
    TimeZone: "America/Los_Angeles",
  },
  Recurrence: []string{"RRULE:FREQ=DAILY;COUNT=2"},
  Attendees: []*calendar.EventAttendee{
    &calendar.EventAttendee{Email:"lpage@example.com"},
    &calendar.EventAttendee{Email:"sbrin@example.com"},
  },
}

calendarId := "primary"
event, err = srv.Events.Insert(calendarId, event).Do()
if err != nil {
  log.Fatalf("Unable to create event. %v\n", err)
}
fmt.Printf("Event created: %s\n", event.HtmlLink)

JavaScript

使用 JavaScript 用戶端程式庫

// Refer to the JavaScript quickstart on how to setup the environment:
// https://developers.google.com/calendar/quickstart/js
// Change the scope to 'https://www.googleapis.com/auth/calendar' and delete any
// stored credentials.

var event = {
  'summary': 'Google I/O 2015',
  'location': '800 Howard St., San Francisco, CA 94103',
  'description': 'A chance to hear more about Google\'s developer products.',
  'start': {
    'dateTime': '2015-05-28T09:00:00-07:00',
    'timeZone': 'America/Los_Angeles'
  },
  'end': {
    'dateTime': '2015-05-28T17:00:00-07:00',
    'timeZone': 'America/Los_Angeles'
  },
  'recurrence': [
    'RRULE:FREQ=DAILY;COUNT=2'
  ],
  'attendees': [
    {'email': 'lpage@example.com'},
    {'email': 'sbrin@example.com'}
  ],
  'reminders': {
    'useDefault': false,
    'overrides': [
      {'method': 'email', 'minutes': 24 * 60},
      {'method': 'popup', 'minutes': 10}
    ]
  }
};

var request = gapi.client.calendar.events.insert({
  'calendarId': 'primary',
  'resource': event
});

request.execute(function(event) {
  appendPre('Event created: ' + event.htmlLink);
});

Node.js

使用 Node.js 用戶端程式庫

// Refer to the Node.js quickstart on how to setup the environment:
// https://developers.google.com/calendar/quickstart/node
// Change the scope to 'https://www.googleapis.com/auth/calendar' and delete any
// stored credentials.

var event = {
  'summary': 'Google I/O 2015',
  'location': '800 Howard St., San Francisco, CA 94103',
  'description': 'A chance to hear more about Google\'s developer products.',
  'start': {
    'dateTime': '2015-05-28T09:00:00-07:00',
    'timeZone': 'America/Los_Angeles',
  },
  'end': {
    'dateTime': '2015-05-28T17:00:00-07:00',
    'timeZone': 'America/Los_Angeles',
  },
  'recurrence': [
    'RRULE:FREQ=DAILY;COUNT=2'
  ],
  'attendees': [
    {'email': 'lpage@example.com'},
    {'email': 'sbrin@example.com'},
  ],
  'reminders': {
    'useDefault': false,
    'overrides': [
      {'method': 'email', 'minutes': 24 * 60},
      {'method': 'popup', 'minutes': 10},
    ],
  },
};

calendar.events.insert({
  auth: auth,
  calendarId: 'primary',
  resource: event,
}, function(err, event) {
  if (err) {
    console.log('There was an error contacting the Calendar service: ' + err);
    return;
  }
  console.log('Event created: %s', event.htmlLink);
});

試試看!

您可以使用下方的 API Explorer,針對即時資料呼叫這個方法,然後查看回應。