Events: quickAdd

注意： 需要授權。

根據簡單的文字字串建立事件。 立即試用或查看範例。

要求

HTTP 要求

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

參數

參數名稱	值	說明
路徑參數
calendarId	string	日曆 ID。如要擷取日曆 ID，請呼叫 calendarList.list 方法。如要存取目前登入使用者的主要日曆，請使用「primary」字詞。
必要的查詢參數
text	string	待建立事件的說明文字。
選用的查詢參數
sendNotifications	boolean	已淘汰，請改用 sendUpdates。 是否要傳送活動建立通知。請注意，即使將值設為 false，部分電子郵件仍可能送出。預設為 false。
sendUpdates	string	應該收到新活動建立通知的邀請對象。 可接受的值為： 「all」：系統會傳送通知給所有邀請對象。 「externalOnly」：系統只會傳送通知給非 Google 日曆邀請對象。 「none」：不會傳送通知。針對日曆遷移工作，請考慮改用 Events.import 方法。

授權

這項要求需要授權，且至少要有下列其中一個範圍：

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

詳情請參閱「驗證與授權」網頁。

要求主體

請勿使用這個方法提供請求主體。

回應

如果成功，這個方法會在回應主體中傳回事件資源。

範例

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

Java

使用 Java 用戶端程式庫。

import com.google.api.services.calendar.Calendar;
import com.google.api.services.calendar.model.Event;

// ...

// Initialize Calendar service with valid OAuth credentials
Calendar service = new Calendar.Builder(httpTransport, jsonFactory, credentials)
    .setApplicationName("applicationName").build();

// Quick-add an event
String eventText = "Appointment at Somewhere on June 3rd 10am-10:25am";
Event createdEvent =
    service.events().quickAdd('primary').setText(eventText).execute();

System.out.println(createdEvent.getId());

Python

使用 Python 用戶端程式庫。

created_event = service.events().quickAdd(
    calendarId='primary',
    text='Appointment at Somewhere on June 3rd 10am-10:25am').execute()

print created_event['id']

PHP

使用 PHP 用戶端程式庫。

$createdEvent = $service->events->quickAdd(
    'primary',
    'Appointment at Somewhere on June 3rd 10am-10:25am');

echo $createdEvent->getId();

小茹

使用 Ruby 用戶端程式庫。

result = client.quick_add_event(
  'primary',
  'Appointment at Somewhere on June 3rd 10am-10:25am')
print result.id

試試看！

使用下方的 APIs Explorer，針對即時資料呼叫這個方法，看看會有什麼結果。