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