アクセス制御ルールを更新します。このメソッドは、パッチ セマンティクスをサポートしています。各パッチ リクエストは 3 つの割り当てユニットを消費します。get の後に update を使用することをおすすめします。指定したフィールド値が既存の値に置き換えられます。リクエストで指定しないフィールドは変更されません。配列フィールドが指定されている場合、既存の配列が上書きされます。これにより、以前の配列要素は破棄されます。今すぐお試しください。
リクエスト
HTTP リクエスト
PATCH 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 リソースの該当部分を指定します。
レスポンス
成功すると、このメソッドはレスポンスの本文で Acl リソースを返します。
試してみよう:
以下の API Explorer を使用して、ライブデータに対してこのメソッドを呼び出し、レスポンスを確認します。