选择匹配的操作
GENERAL 与 TAGS 可通过各自操作掩码更新。WEBHOOKS 只用于读取投影,应通过独立操作修改 Webhook。此结构不提供令牌与会话内部设置。
此结构在哪里使用
以下链接根据协议快照中的直接引用生成。认证、可写字段和运行行为应以调用操作为准;可复用资源结构本身并不是完整的写入请求。
- GETGet User Setting
/api/v1/users/{user}/settings/{setting} - PATCHUpdate User Setting
/api/v1/users/{user}/settings/{setting}
被以下组件结构引用:
结构与字段
object
User settings message
| 字段 | 类型 / 是否必需 | 描述 |
|---|---|---|
name | string | The name of the user setting. Format: users/{user}/settings/{setting}, {setting} is the key for the setting. For example, "users/steven/settings/GENERAL" for general settings. |
generalSetting | UserSetting_GeneralSetting | |
webhooksSetting | UserSetting_WebhooksSetting | |
tagsSetting | UserSetting_TagsSetting |
完整结构
约束与嵌套结构请以这份完整 JSON 定义为准。字段出现在这里,并不意味着每位调用者都能修改它。
{
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "The name of the user setting.\n Format: users/{user}/settings/{setting}, {setting} is the key for the setting.\n For example, \"users/steven/settings/GENERAL\" for general settings."
},
"generalSetting": {
"$ref": "#/components/schemas/UserSetting_GeneralSetting"
},
"webhooksSetting": {
"$ref": "#/components/schemas/UserSetting_WebhooksSetting"
},
"tagsSetting": {
"$ref": "#/components/schemas/UserSetting_TagsSetting"
}
},
"description": "User settings message"
}