Calendars: update

Updates metadata for a calendar. Try it now or see an example. カレンダーのメタデータを更新します。今すぐ試すか、例を見てください。

Request要求

HTTP requestHTTPリクエスト

PUT https://www.googleapis.com/calendar/v3/calendars/calendarId

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`キーワード" "を使用してください。

Authorization承認

This request requires authorization with the following scope (read more about authentication and authorization).この要求には、以下の範囲での承認が必要です（認証と承認についての詳細を読んでください）。

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

Request bodyリクエストボディ

In the request body, supply a Calendars resource with the following properties:リクエスト本文で、次のプロパティを持つCalendarsリソースを指定します。

Property nameプロパティ名	Value値	Description説明	Notesノート
Optional Propertiesオプションのプロパティ
`description`	`string`	Description of the calendar. Optional.カレンダーの説明オプションです。	writable 書き込み可能
`location`	`string`	Geographic location of the calendar as free-form text. Optional.自由形式のテキストとしてのカレンダーの地理的位置。オプションです。	writable 書き込み可能
`summary`	`string`	Title of the calendar.カレンダーのタイトル	writable 書き込み可能
`timeZone`	`string`	The time zone of the calendar. (Formatted as an IANA Time Zone Database name, e.g. "Europe/Zurich".) Optional.カレンダーのタイムゾーン。（IANAタイムゾーンデータベース名としてフォーマットされます、例えば "Europe / Zurich"）。オプション。	writable 書き込み可能

Response応答

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

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;
// ...
// Initialize Calendar service with valid OAuth credentials
Calendar service = new Calendar.Builder(httpTransport, jsonFactory, credentials)
    .setApplicationName("applicationName").build();
// Retrieve a calendar
com.google.api.services.calendar.model.Calendar calendar =
    service.calendars().get('primary').execute();
// Make a change
calendar.setSummary("calendarSummary");
// Update the altered calendar
com.google.api.services.calendar.model.Calendar updatedCalendar =
    service.calendars().update(calendar.getId(), calendar).execute();
System.out.println(updatedCalendar.getEtag());

Python

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

# First retrieve the calendar from the API.
calendar = service.calendars().get(calendarId='primary').execute()
calendar['summary'] = 'New Summary'
updated_calendar = service.calendars().update(calendarId=calendar['id'], body=calendar).execute()
print updated_calendar['etag']

PHP

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

// First retrieve the calendar from the API.
$calendar = $service->calendars->get('primary');
$calendar->setSummary('New Summary');
$updatedCalendar = $service->calendars->update('primary', $calendar);
echo $updatedCalendar->getEtag();

Rubyルビー

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

calendar = client.get_calendar('primary')
calendar.summary = "New Summary"
result = client.update_calendar(calendar.id, calendar)
print result.etag

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

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