Что позволяет вам делать метод Gmail: users.labels.patch и чем он отличается от users.labels.update?

#rest #google-api #gmail-api

#rest #google-api #gmail-api

Вопрос:

В документации просто сказано: «Исправьте указанную метку». Что это значит?

Документация

Ответ №1:

Объект label выглядит следующим образом

 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-запрос, отправленный этому методу, является ИСПРАВЛЕНИЕМ

 PATCH https://gmail.googleapis.com/gmail/v1/users/{userId}/labels/{id}
 

Это в основном означает, что вам не нужно отправлять полный объект с телом запроса, будут обновлены только параметры, которые вы отправляете. Так что, если вы просто отправите Name, на ярлыке будет обновлено только имя, а не остальные параметры. Это упрощенный запрос от update, который раньше требовал, чтобы было отправлено полное тело объекта, и все, что не задано, было бы установлено в значение null, или это привело бы к ошибке.