Acl: insert

アクセス制御ルールを作成します。実習をご覧ください。

リクエスト

HTTP リクエスト

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

パラメータ

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

承認

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

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

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

リクエストの本文

リクエストの本文に、次のプロパティを指定した Acl リソースを入力します。

プロパティ名 値 説明 メモ
必須プロパティ
role string スコープに割り当てられたロール。指定できる値は次のとおりです。
  • 「none」 - アクセス権を付与しません。
  • 「freeBusyReader」 - 空き時間情報の読み取りアクセス権を付与します。
  • 「reader」 - カレンダーへの読み取りアクセス権を提供します。限定公開の予定は閲覧権限を持つユーザーに表示されますが、予定の詳細は非表示になります。
  • 「writer」 - カレンダーに対する読み取り / 書き込みアクセス権を付与します。限定公開の予定は、書き込み権限を持つユーザーに表示され、予定の詳細も表示されます。カレンダーの ACL への読み取りアクセス権を付与します。
  • 「owner」 - カレンダーへの管理者アクセス権を付与します。このロールには、ライターのロールのすべての権限に加えて、他のユーザーのアクセスレベルを変更する権限が付与されています。

 書き込み可能
scope object この ACL ルールによって付与されるカレンダー アクセスの範囲。
scope.type string スコープのタイプ。指定できる値は次のとおりです。
  • 「default」- 公開スコープ。これがデフォルト値です。
  • 「user」- 範囲を 1 人のユーザーに制限します。
  • 「group」 - スコープをグループに制限します。
  • 「domain」 - スコープをドメインに制限します。
注: 「default」または公開スコープに付与された権限は、認証の有無にかかわらず、すべてのユーザーに適用されます。
省略可能なプロパティ
scope.value string スコープのタイプに応じて、ユーザーまたはグループのメールアドレス、またはドメインの名前。タイプ「default」では省略されます。 書き込み可能

レスポンス

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

試してみよう:

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