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

Acl: update

アクセス制御ルールを更新します。今すぐ試すまたは例を見る。

リクエスト

HTTP リクエスト

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

パラメータ

パラメータ名	値	説明
パスパラメータ
`calendarId`	`string`	カレンダー ID。カレンダー ID を取得するには、calendarList.list メソッドを呼び出します。現在ログインしているユーザーのメインカレンダーにアクセスするには、「`primary`」キーワードを使用します。
`ruleId`	`string`	ACL ルール ID。
省略可能なクエリパラメータ
`sendNotifications`	`boolean`	カレンダーの共有の変更に関する通知を送信するかどうか。アクセス権の削除に関する通知はありません。省略可。デフォルトは True です。

承認

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

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

詳しくは、認証と認可のページをご覧ください。

リクエストの本文

リクエストの本文には、以下のプロパティを使用して Acl リソースを指定します。

プロパティ名	値	説明	メモ
必須プロパティ
`scope`	`object`	この ACL ルールによってカレンダーへのアクセスが許可される範囲。
`scope.type`	`string`	スコープのタイプ。指定できる値は次のとおりです。「`default`」- 公開スコープ。これがデフォルト値です。「`user`」- スコープを 1 人のユーザーに制限します。「`group`」 - スコープをグループに制限します。「`domain`」 - スコープをドメインに制限します。注: 「`default`」スコープ（公開スコープ）に付与された権限は、認証されているかどうかにかかわらず、すべてのユーザーに適用されます。
省略可能なプロパティ
`role`	`string`	スコープに割り当てられたロール。指定できる値は次のとおりです。「`none`」- アクセス権を付与しません。「`freeBusyReader`」- 空き/不在情報への読み取りアクセス権を付与します。「`reader`」 - カレンダーへの読み取りアクセス権を付与します。限定公開のイベントは、閲覧者権限を持つユーザーには表示されますが、イベントの詳細は非表示になります。「`writer`」- カレンダーに対する読み取り / 書き込みアクセス権を付与します。非公開イベントは、作成者権限を持つユーザーに表示され、イベントの詳細も表示されます。カレンダーの ACL への読み取りアクセス権を付与します。「`owner`」 - カレンダーのオーナー権限を付与します。このロールには、書き込みロールのすべての権限に加えて、ACL を操作する権限があります。	書き込み可能
`scope.value`	`string`	スコープの種類に応じて、ユーザーまたはグループのメールアドレス、またはドメイン名。タイプ「`default`」の場合は省略されます。	書き込み可能

レスポンス

成功すると、このメソッドはレスポンスの本文で Acl リソースを返します。

例

注: このメソッドで使用可能なコード例では、サポートされているプログラミング言語すべての例を示しているわけではありません（サポートされている言語の一覧については、クライアントライブラリページをご覧ください）。

Java

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

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

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

$rule = $service->acl->get('primary', 'ruleId');
$rule->setRole('newRole');

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

Ruby

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

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

試してみよう:

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