Events: quickAdd

Requires authorization 承認が必要

Creates an event based on a simple text string. Try it now or see an example. 単純なテキスト文字列に基づいてイベントを作成します。今すぐ試すか、例を見てください。

Request要求

HTTP requestHTTPリクエスト

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

Parametersパラメーター

Parameter nameパラメータ名	Value値	Description説明
Path parametersパスパラメータ
`calendarId`	`string`	Calendar identifier. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the currently logged in user, use the "`primary`" keyword. カレンダーID カレンダーIDを取得するには、calendarList.listメソッドを呼び出します。現在ログインしているユーザーのメインカレンダーにアクセスしたい場合は、`primary`キーワード" "を使用してください。
Required query parameters必須のクエリパラメータ
`text`	`string`	The text describing the event to be created. 作成するイベントを説明するテキスト。
Optional query parametersオプションのクエリパラメータ
`sendNotifications`	`boolean`	Deprecated. Please use sendUpdates instead. Whether to send notifications about the creation of the event. Note that some emails might still be sent even if you set the value to `false`. The default is `false`. 廃止予定です。代わりにsendUpdatesを使ってください。イベントの作成に関する通知を送信するかどうかに値を設定しても、電子メールが送信される可能性があることに注意してください`false`。デフォルトは`false`です。
`sendUpdates`	`string`	Guests who should receive notifications about the creation of the new event. Acceptable values are: "`all`": Notifications are sent to all guests. " `all`"：すべてのゲストに通知が送信されます。 "`externalOnly`": Notifications are sent to non-Google Calendar guests only. " `externalOnly`"：通知は、Googleカレンダー以外のゲストにのみ送信されます。 "`none`": No notifications are sent. This value should only be used for migration use cases (note that in most migration cases the import method should be used). " `none`"：通知は送信されません。この値は、マイグレーションのユースケースにのみ使用する必要があります（ほとんどのマイグレーションのケースでは、インポート方式を使用する必要があります）。

Authorization承認

This request requires authorization with at least one of the following scopes (read more about authentication and authorization).この要求には、以下の範囲のうちの少なくとも1つを使用した許可が必要です（認証および許可について詳しく読む）。

Scope範囲
`https://www.googleapis.com/auth/calendar`
`https://www.googleapis.com/auth/calendar.events`

Request bodyリクエストボディ

Do not supply a request body with this method.このメソッドでリクエストボディを指定しないでください。

Response応答

If successful, this method returns an Events resource in the response body.成功した場合、このメソッドはレスポンスボディにEventsリソースを返します。

Examples例

Note: The code examples available for this method do not represent all supported programming languages (see the client libraries page for a list of supported languages).注：このメソッドで使用可能なコード例は、サポートされているすべてのプログラミング言語を表しているわけではありません（サポートされている言語のリストについては、クライアントライブラリのページを参照してください）。

Java

Uses the Java client library.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

Uses the Python client library.Pythonクライアントライブラリを使用します。

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

PHP

Uses the PHP client library.PHPクライアントライブラリを使用します。

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

Rubyルビー

Uses the Ruby client library.Rubyクライアントライブラリを使用します。

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

Try it!それを試してみてください！

Use the APIs Explorer below to call this method on live data and see the response. 以下のAPI Explorerを使用して、ライブデータに対してこのメ??ソッドを呼び出して応答を確認してください。