MessagePatch
Данные дополнения к сообщению.
message MessagePatch {
required string MessageId = 1;
required sfixed64 TimestampTicks = 2;
repeated Entity Entities = 3;
optional bool ForDraft = 4 [default = false];
optional bool DraftIsRecycled = 5 [default = false];
repeated string DraftIsTransformedToMessageIdList = 6;
optional bool DraftIsLocked = 7 [default = false];
optional bool MessageIsDeleted = 8 [default = false];
repeated EntityPatch EntityPatches = 9;
optional bool MessageIsRestored = 10 [default = false];
optional bool MessageIsDelivered = 11 [default = false];
optional string DeliveredPatchId = 12;
required string PatchId = 13;
optional string NotDeliveredEventId = 14;
required MessageType MessageType = 15;
}
message EntityPatch {
required string EntityId = 1;
optional bool DocumentIsDeleted = 2 [default = false];
optional string MovedToDepartment = 3;
optional bool DocumentIsRestored = 4 [default = false];
optional bool ContentIsPatched = 5 [default = false];
optional string ForwardedToBoxId = 6;
}
MessageId
— идентификатор сообщения, к которому относится дополнение.TimestampTicks
— время создания дополнения.Entities
— список сущностей дополнения, представленных структурой Entity.ForDraft
— признак того, что сообщение, к которому относится текущее дополнение, является черновиком.DraftIsRecycled
— признак того, что черновик, к которому относится текущее дополнение, утилизирован: он либо был удален, либо на его основе было создано и отправлено полноценное сообщение. Заполняется только для дополнений, относящихся к черновикам.DraftIsTransformedToMessageIdList
— список идентификаторов сообщений, созданных на основе черновика, к которому относится текущее дополнение. Заполняется только для дополнений, относящихся к черновикам.DraftIsLocked
— признак того, что черновик, к которому относится текущее дополнение, заблокирован: в него нельзя добавлять или удалять документы. Такой черновик можно либо отправить, превратив в полноценное сообщение, либо удалить. Заполняется только для дополнений, относящихся к черновикам.MessageIsDeleted
— признак того, что сообщение, к которому относится текущее дополнение, было удалено.EntityPatches
— список дополнений к сущностям сообщения, к которому относится текущее дополнение. Каждый элемент списка представлен структуройEntityPatch
с полями:EntityId
— идентификатор сущности, к которой относится текущее дополнение.DocumentIsDeleted
— признак того, что документ, к которому относится текущее дополнение, был удален.MovedToDepartment
— идентификатор подразделения, в которое был перемещен документ. Заполняется только в случае перемещения документа между подразделениями организации.DocumentIsRestored
— признак того, что документ, к которому относится текущее дополнение, был восстановлен из удаленных.ContentIsPatched
— признак того, что исходящий документ, к которому относится текущее дополнение, был подписан, и к содержимому документа были добавлены данные из сертификата подписанта.ForwardedToBoxId
— идентификатор ящика получателя при пересылке документа третьей стороне.
MessageIsRestored
— признак того, что сообщение, к которому относится текущее дополнение, было восстановлено из удаленных.MessageIsDelivered
— признак того, что сообщение, к которому относится текущее дополнение, было доставлено получателю.DeliveredPatchId
— идентификатор дополнения, доставленного получателю.PatchId
— идентификатор дополнения.NotDeliveredEventId
— идентификатор дополнения, которое не удалось доставить (например, из-за некорректности одной или нескольких подписей в нем). Получить недоставленную часть сообщения можно с помощью метода GetEvent (V2) или GetEvent (V3), передав в качестве параметраeventId
значениеNotDeliveredEventId
.MessageType
— тип сообщения, принимает значения из перечисления MessageType.
См. также
- Структура используется:
в структуре BoxEvent
в теле ответа метода PostMessagePatch (V3)
в теле ответа метода PostMessagePatch (V4)
в теле ответа метода PostTemplatePatch