このページは Cloud Translation API によって翻訳されました。

Events: quickAdd

シンプルなテキスト文字列に基づいてイベントを作成します。今すぐ試すまたは例を見る。

リクエスト

HTTP リクエスト

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

パラメータ

パラメータ名	値	説明
パスパラメータ
`calendarId`	`string`	カレンダー識別子。カレンダー ID を取得するには、calendarList.list メソッドを呼び出します。現在ログインしているユーザーのメインカレンダーにアクセスするには、「`primary`」キーワードを使用します。
必須のクエリパラメータ
`text`	`string`	作成するイベントを説明するテキスト。
省略可能なクエリパラメータ
`sendNotifications`	`boolean`	非推奨です。代わりに sendUpdates を使用してください。イベントの作成に関する通知を送信するかどうか。値を `false` に設定しても、一部のメールは引き続き送信されることがあります。デフォルトは `false` です。
`sendUpdates`	`string`	新しい予定の作成に関する通知を受信するゲスト。有効な値は次のとおりです。「`all`」: 通知はすべてのゲストに送信されます。 "`externalOnly`": 通知は Google カレンダーを使用していないゲストにのみ送信されます。 "`none`": 通知は送信されません。カレンダー移行タスクの場合は、代わりに Events.import メソッドを使用することを検討してください。

承認

このリクエストは、少なくとも次のうち 1 つのスコープによる承認が必要です。

範囲
`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

Ruby クライアントライブラリを使用します。

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

実習

以下の API Explorer を使用して、ライブデータでこのメソッドを呼び出し、レスポンスを確認します。