Rest Gmail的方法:users.labels.patch允许你做什么,它与users.labels.update有什么不同?

Rest Gmail的方法:users.labels.patch允许你做什么,它与users.labels.update有什么不同?,rest,google-api,gmail-api,Rest,Google Api,Gmail Api,文档只是说修补指定的标签。这是什么意思 一个物体看起来像这样 JSON representation { "id": string, "name": string, "messageListVisibility": enum (MessageListVisibility), "labelListVisibility": enum (LabelListVisibility), "type

文档只是说修补指定的标签。这是什么意思

一个物体看起来像这样

JSON representation

{
  "id": string,
  "name": string,
  "messageListVisibility": enum (MessageListVisibility),
  "labelListVisibility": enum (LabelListVisibility),
  "type": enum (Type),
  "messagesTotal": integer,
  "messagesUnread": integer,
  "threadsTotal": integer,
  "threadsUnread": integer,
  "color": {
    object (Color)
  }
}
对此方法发出的HTTP请求是

这基本上意味着您不需要发送带有请求主体的完整对象,只需要更新您发送的参数。因此,如果只发送名称,则标签上只会更新名称,而不会更新其余参数。这是一个来自update的简化请求,用于要求发送完整的对象正文,然后将未设置的任何内容设置为null,否则将导致错误。

对象如下所示

JSON representation

{
  "id": string,
  "name": string,
  "messageListVisibility": enum (MessageListVisibility),
  "labelListVisibility": enum (LabelListVisibility),
  "type": enum (Type),
  "messagesTotal": integer,
  "messagesUnread": integer,
  "threadsTotal": integer,
  "threadsUnread": integer,
  "color": {
    object (Color)
  }
}
对此方法发出的HTTP请求是

这基本上意味着您不需要发送带有请求主体的完整对象,只需要更新您发送的参数。因此,如果只发送名称,则标签上只会更新名称,而不会更新其余参数。这是一个来自update的简化请求,它通常要求发送完整的对象体,然后将任何未设置的内容设置为null,否则将导致错误