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

Acl: insert

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

リクエスト

HTTP リクエスト

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

パラメータ

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

承認

このリクエストには、次のスコープによる認証が必要です。

スコープ
`https://www.googleapis.com/auth/calendar`

詳細については、認証と認可のページをご覧ください。

リクエスト本文

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

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

// Create access rule with associated scope
AclRule rule = new AclRule();
Scope scope = new Scope();
scope.setType("scopeType").setValue("scopeValue");
rule.setScope(scope).setRole("role");

// Insert new access rule
AclRule createdRule = service.acl().insert('primary', rule).execute();
System.out.println(createdRule.getId());

Python

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

rule = {
    'scope': {
        'type': 'scopeType',
        'value': 'scopeEmail',
    },
    'role': 'role'
}

created_rule = service.acl().insert(calendarId='primary', body=rule).execute()

print created_rule['id']

PHP

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

$rule = new Google_Service_Calendar_AclRule();
$scope = new Google_Service_Calendar_AclRuleScope();

$scope->setType("scopeType");
$scope->setValue("scopeValue");
$rule->setScope($scope);
$rule->setRole("role");

$createdRule = $service->acl->insert('primary', $rule);
echo $createdRule->getId();

Ruby

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

rule = Google::Apis::CalendarV3::AclRule.new(
  scope: {
    type: 'scopeType',
    value: 'scopeEmail',
  },
  role: 'role'
)
result = client.insert_acl('primary', rule)
print result.id

試してみよう:

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