Acl: update

Updates an access control rule. Try it now or see an example. アクセス制御規則を更新します。今すぐ試すか、例を見てください。

Request要求

HTTP requestHTTPリクエスト

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

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`キーワード" "を使用してください。
`ruleId`	`string`	ACL rule identifier. ACLルールID
Optional query parametersオプションのクエリパラメータ
`sendNotifications`	`boolean`	Whether to send notifications about the calendar sharing change. Note that there are no notifications on access removal. Optional. The default is True. カレンダー共有の変更に関する通知を送信するかどうか。アクセス削除に関する通知はありません。オプションです。デフォルトはTrueです。

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 an Acl resource with the following properties:リクエストボディで、次のプロパティを持つAclリソースを指定します。

Property nameプロパティ名	Value値	Description説明	Notesノート
Optional Propertiesオプションのプロパティ
`role`	`string`	The role assigned to the scope. Possible values are: "`none`" - Provides no access." `none`" - アクセス権を与えません。 "`freeBusyReader`" - Provides read access to free/busy information." `freeBusyReader`" - 空き時間情報への読み取りアクセスを提供します。 "`reader`" - Provides read access to the calendar. Private events will appear to users with reader access, but event details will be hidden." `reader`" - カレンダーへの読み取りアクセスを提供します。非公開の予定は閲覧者アクセス権を持つユーザーに表示されますが、予定の詳細は非表示になります。 "`writer`" - Provides read and write access to the calendar. Private events will appear to users with writer access, and event details will be visible." `writer`" - カレンダーへの読み書きアクセスを提供します。非公開のイベントは、書き込み権限を持つユーザーに表示され、イベントの詳細が表示されます。 "`owner`" - Provides ownership of the calendar. This role has all of the permissions of the writer role with the additional ability to see and manipulate ACLs." `owner`" - カレンダーの所有権を提供します。この役割には、ACLを表示および操作するための追加機能を持つ、作成者役割のすべての許可があります。	writable 書き込み可能

Response応答

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

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.AclRule;
// ...
// Initialize Calendar service with valid OAuth credentials
Calendar service = new Calendar.Builder(httpTransport, jsonFactory, credentials)
    .setApplicationName("applicationName").build();
// Retrieve the access rule from the API
AclRule rule = service.acl().get('primary', "ruleId").execute();
// Make a change
rule.setRole("newRole");
// Update the access rule
AclRule updatedRule = service.acl().update('primary', rule.getId(), rule).execute();
System.out.println(updatedRule.getEtag());

Python

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

rule = service.acl().get(calendarId='primary', ruleId='ruleId').execute()
rule['role'] = 'newRole'
updated_rule = service.acl().update(calendarId='primary', ruleId=rule['id'], body=rule).execute()
print updated_rule['etag']

PHP

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

$rule = $service->acl->get('primary', 'ruleId');
$rule->setRole('newRole');
$updatedRule = $service->acl->update('primary', $rule->getId(), $rule);
echo $updatedRule->getEtag();

Rubyルビー

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

rule = client.get_acl('primary', 'ruleId')
rule.role = 'newRole'
result = client.update_acl('primary', rule.id, rule)
print result.etag

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

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