Acl: patch
更新访问权限控制规则。此方法支持补丁语义。请注意,每个补丁请求消耗三个配额单元:首选使用 get
,后跟 update
。您指定的字段值会替换现有值。您未在请求中指定的字段将保持不变。数组字段(如果指定)会覆盖现有的数组;这会舍弃之前的所有数组元素
立即试用。
请求
HTTP 请求
PATCH https://www.googleapis.com/calendar/v3/calendars/calendarId/acl/ruleId
参数
参数名称 |
值 |
说明 |
路径参数 |
calendarId |
string |
日历标识符。要检索日历 ID,请调用 calendarList.list 方法。如果您想访问当前登录用户的主日历,请使用“primary ”关键字。
|
ruleId |
string |
ACL 规则标识符。
|
可选的查询参数 |
sendNotifications |
boolean |
是否发送有关日历共享更改的通知。请注意,系统不会发送有关撤消访问权限的通知。可选。默认值为 True。
|
授权
此请求需要获得以下范围的授权:
范围 |
https://www.googleapis.com/auth/calendar |
如需了解详情,请参阅身份验证和授权页面。
请求正文
在请求正文中,根据补丁语义规则提供 Acl 资源的相关部分。
响应
如果成功,此方法将在响应正文中返回一项 Acl 资源。
试试看!
使用下面的 API Explorer 对实际数据调用此方法,然后查看响应。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2024-09-11。
[null,null,["最后更新时间 (UTC):2024-09-11。"],[[["Updates a specific access control rule for a calendar using patch semantics, replacing existing field values with new ones while retaining unchanged fields."],["Requires authorization with the `https://www.googleapis.com/auth/calendar` scope to modify access control rules."],["Each patch request uses three quota units, consider using a `get` followed by an `update` for better quota management."],["Sends notifications about the calendar sharing change by default, but not for access removals, configurable using the `sendNotifications` parameter."],["When specifying array fields, the request overwrites existing arrays, discarding any previous elements."]]],[]]