From 1d579ce5f0f8607781328136e5f4a69805ede652 Mon Sep 17 00:00:00 2001
From: Alena Petraki <a.petraki@perx.ru>
Date: Tue, 23 Jul 2024 20:35:00 +0000
Subject: [PATCH] =?UTF-8?q?=D0=94=D0=BE=D0=B1=D0=B0=D0=B2=D0=BB=D0=B5?=
 =?UTF-8?q?=D0=BD=D1=8B=20=D0=BA=D0=BE=D0=BC=D0=BC=D0=B5=D0=BD=D1=82=D0=B0?=
 =?UTF-8?q?=D1=80=D0=B8=D0=B8=20=D0=BF=D0=BE=20=D0=BF=D0=BE=D0=B2=D0=B5?=
 =?UTF-8?q?=D0=B4=D0=B5=D0=BD=D0=B8=D1=8E=20=D1=81=D0=B5=D1=80=D0=B2=D0=B8?=
 =?UTF-8?q?=D1=81=D0=B0=20Items=20=D1=81=20=D0=BB=D0=BE=D0=BA=D0=B0=D0=BB?=
 =?UTF-8?q?=D0=B8=D0=B7=D0=B0=D1=86=D0=B8=D0=B5=D0=B9?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 proto/items/items.proto | 25 ++++++++++++++++++-------
 1 file changed, 18 insertions(+), 7 deletions(-)

diff --git a/proto/items/items.proto b/proto/items/items.proto
index ff67830..ea19cce 100644
--- a/proto/items/items.proto
+++ b/proto/items/items.proto
@@ -75,16 +75,18 @@ message Item {
 
   // string locale = 18; // DEPRECATED: используется locale_id
 
-  // При создании или обновлении идентификатор локали в котором создается запись, опционально.
+  // Идентификатор локали полученной записи.
+  // При создании или обновлении идентификатор локали, в которой создается запись, опционально.
   // Если указан, то создается перевод для указанного языка, поле translations игнорируется
-  string locale_id = 100; // идентификатор локали полученной записи
+  string locale_id = 100;
 
   // Позволяет одновременно установить/получить несколько переводов и производить манипуляции с переводами
   // Ключами является идентификатор локали, значениями - данные переводы
   map<string, google.protobuf.Struct> translations = 12;
 
-  // список идентификаторов локалей для которых есть переводы
-  // соотвествует ключам в translations
+  // Список идентификаторов локалей, для которых есть переводы
+  // Соотвествует списку переводов в translations, при получении записи всегда возвращается
+  // полный список. Невозможно обновить вручную: формируется системой
   repeated string translations_ids = 101;
 }
 
@@ -144,7 +146,10 @@ message FindOptions {
   bool hidden = 5;
   bool templates = 6;
   string locale_id = 7; // Язык перевода который будет использоваться. Если не указан, то возвращаются данные для языка по умолчанию
-  repeated string translations_ids = 8; // Список идентификаторов переводов/локалей, которых должны быть включены в результат
+
+  // Список идентификаторов переводов/локалей, которых должны быть включены в результат
+  // Возможно указание '*' для получения всех переводов
+  repeated string translations_ids = 8;
 }
 
 message UpdateOptions {
@@ -153,7 +158,10 @@ message UpdateOptions {
 
 message GetPublishedOptions {
   string locale_id = 7; // Язык перевода который будет использоваться. Если не указан, то возвращаются данные для языка по умолчанию
-  repeated string translations_ids = 8; // Список идентификаторов переводов/локалей, которых должны быть включены в результат
+
+  // Список идентификаторов переводов/локалей, которых должны быть включены в результат
+  // Возможно указание '*' для получения всех переводов
+  repeated string translations_ids = 8;
 }
 
 message DeleteOptions {
@@ -180,7 +188,10 @@ message FindPublishedOptions {
   bool hidden = 5;
   bool templates = 6;
   string locale_id = 7; // Язык перевода который будет использоваться. Если не указан, то возвращаются данные для языка по умолчанию
-  repeated string translations_ids = 8; // Список идентификаторов переводов/локалей, которых должны быть включены в результат
+
+  // Список идентификаторов переводов/локалей, которых должны быть включены в результат
+  // Возможно указание '*' для получения всех переводов
+  repeated string translations_ids = 8;
 }
 
 message FindArchivedOptions {
-- 
GitLab