OZON: Подписчики товара и коды активации

Bayselonarrend · Sep 1, 2024 · f8677b7 · f8677b7
1 parent 98f1fdb
commit f8677b7
Show file tree

Hide file tree

Showing 73 changed files with 5,547 additions and 4,063 deletions.
diff --git a/docs/en/cli/Ozon/GetCodesUploadStatus.txt b/docs/en/cli/Ozon/GetCodesUploadStatus.txt
@@ -0,0 +1 @@
+oint ozon GetCodesUploadStatus --clientid "2128753" --apikey "7cc90d26-33e4-499b..." --taskid %taskid%
diff --git a/docs/en/cli/Ozon/GetProductSubscribersCount.txt b/docs/en/cli/Ozon/GetProductSubscribersCount.txt
@@ -0,0 +1 @@
+oint ozon GetProductSubscribersCount --clientid "2128753" --apikey "7cc90d26-33e4-499b..." --sku %sku%
diff --git a/docs/en/cli/Ozon/UploadProductActivationCodes.txt b/docs/en/cli/Ozon/UploadProductActivationCodes.txt
@@ -0,0 +1 @@
+oint ozon UploadProductActivationCodes --clientid "2128753" --apikey "7cc90d26-33e4-499b..." --productid "1111588191" --codes %codes%
diff --git a/docs/en/data/Ozon/GetCodesUploadStatus.json b/docs/en/data/Ozon/GetCodesUploadStatus.json
@@ -0,0 +1,5 @@
+{
+"ClientID": "2128753",
+"APIKey": "7cc90d26-33e4-499b...",
+"TaskID": ""
+}
diff --git a/docs/en/data/Ozon/GetProductSubscribersCount.json b/docs/en/data/Ozon/GetProductSubscribersCount.json
@@ -0,0 +1,4 @@
+{
+"ClientID": "2128753",
+"APIKey": "7cc90d26-33e4-499b..."
+}
diff --git a/docs/en/data/Ozon/UploadProductActivationCodes.json b/docs/en/data/Ozon/UploadProductActivationCodes.json
@@ -0,0 +1,5 @@
+{
+"ClientID": "2128753",
+"APIKey": "7cc90d26-33e4-499b...",
+"ProductID": 1111588191
+}
diff --git a/docs/en/examples/Ozon/DeleteProductsWithoutSKU.txt b/docs/en/examples/Ozon/DeleteProductsWithoutSKU.txt
@@ -1,8 +1,10 @@
-    ClientID  = "2128753";
+    OPI_Tools.Pause(30);
+
+    ClientID  = "2128753";
     APIKey    = "7cc90d26-33e4-499b...";
     ProductID = "1111588191";
 
-    OPI_Ozon.ArchiveProducts(ClientID, APIKey, ProductID);
+    Result = OPI_Ozon.ArchiveProducts(ClientID, APIKey, ProductID);
 
     Article = "143210608";
 

diff --git a/docs/en/examples/Ozon/GetCodesUploadStatus.txt b/docs/en/examples/Ozon/GetCodesUploadStatus.txt
@@ -0,0 +1,5 @@
+    ClientID = "2128753";
+    APIKey   = "7cc90d26-33e4-499b...";
+    TaskID   = "";
+
+    Result = OPI_Ozon.GetCodesUploadStatus(ClientID, APIKey, TaskID);
diff --git a/docs/en/examples/Ozon/GetProductSubscribersCount.txt b/docs/en/examples/Ozon/GetProductSubscribersCount.txt
@@ -0,0 +1,5 @@
+    ClientID = "2128753";
+    APIKey   = "7cc90d26-33e4-499b...";
+    SKU      = 1626044001;
+
+    Result = OPI_Ozon.GetProductSubscribersCount(ClientID, APIKey, SKU);
diff --git a/docs/en/examples/Ozon/UploadProductActivationCodes.txt b/docs/en/examples/Ozon/UploadProductActivationCodes.txt
@@ -0,0 +1,9 @@
+    ClientID  = "2128753";
+    APIKey    = "7cc90d26-33e4-499b...";
+    ProductID = "1111588191";
+
+    Codes = New Array;
+    Codes.Add("11111111");
+    Codes.Add("22222222");
+
+    Result = OPI_Ozon.UploadProductActivationCodes(ClientID, APIKey, ProductID, Codes);
diff --git a/docs/en/md/Ozon/Uploading-and-updating-products/Add-product-video-cover.md b/docs/en/md/Ozon/Uploading-and-updating-products/Add-product-video-cover.md
@@ -1,5 +1,5 @@
 ---
-sidebar_position: 21
+sidebar_position: 24
 ---
 
 # Add product video cover

diff --git a/docs/en/md/Ozon/Uploading-and-updating-products/Add-product-video.md b/docs/en/md/Ozon/Uploading-and-updating-products/Add-product-video.md
@@ -1,5 +1,5 @@
 ---
-sidebar_position: 20
+sidebar_position: 23
 ---
 
 # Add product video

diff --git a/docs/en/md/Ozon/Uploading-and-updating-products/Archive-products.md b/docs/en/md/Ozon/Uploading-and-updating-products/Archive-products.md
@@ -1,5 +1,5 @@
 ---
-sidebar_position: 13
+sidebar_position: 12
 ---
 
 # Archive products
@@ -40,7 +40,7 @@ You can pass up to 100 identifiers at a time
 
 ```sh title="CLI command example"
 
-oint ozon ArchiveProducts --clientid "2128753" --apikey "7cc90d26-33e4-499b..." --products %products%
+  oint ozon ArchiveProducts --clientid "2128753" --apikey "7cc90d26-33e4-499b..." --products %products%
 
 ```
 

diff --git a/docs/en/md/Ozon/Uploading-and-updating-products/Check-products-images-upload.md b/docs/en/md/Ozon/Uploading-and-updating-products/Check-products-images-upload.md
@@ -1,5 +1,5 @@
 ---
-sidebar_position: 11
+sidebar_position: 10
 ---
 
 # Check products images upload

diff --git a/docs/en/md/Ozon/Uploading-and-updating-products/Complete-complex-attribute.md b/docs/en/md/Ozon/Uploading-and-updating-products/Complete-complex-attribute.md
@@ -1,5 +1,5 @@
 ---
-sidebar_position: 22
+sidebar_position: 25
 ---
 
 # Complete the complex attribute

diff --git a/docs/en/md/Ozon/Uploading-and-updating-products/Create-update-products.md b/docs/en/md/Ozon/Uploading-and-updating-products/Create-update-products.md
@@ -23,6 +23,8 @@ sidebar_position: 6
 :::tip
 Methods of product structure formation: GetProductStructure(), AddProductVideo(), AddProductVideoCover()
 
+ Uploading status check - GetProductCreationStatus()
+
  Method at API documentation: [post /v3/product/import](https://docs.ozon.ru/api/seller/#operation/ProductAPI_ImportProductsV3)
 :::
 <br/>

diff --git a/docs/en/md/Ozon/Uploading-and-updating-products/Delete-products-without-sku.md b/docs/en/md/Ozon/Uploading-and-updating-products/Delete-products-without-sku.md
@@ -1,5 +1,5 @@
 ---
-sidebar_position: 15
+sidebar_position: 14
 ---
 
 # Delete products without SKU
@@ -31,11 +31,13 @@ The product must be pre-archived (see ArchiveProducts)
 
 
 ```bsl title="Code example"
+    OPI_Tools.Pause(30);
+
     ClientID  = "2128753";
     APIKey    = "7cc90d26-33e4-499b...";
     ProductID = "1111588191";
 
-    OPI_Ozon.ArchiveProducts(ClientID, APIKey, ProductID);
+    Result = OPI_Ozon.ArchiveProducts(ClientID, APIKey, ProductID);
 
     Article = "143210608";
 
@@ -46,7 +48,7 @@ The product must be pre-archived (see ArchiveProducts)
 
 ```sh title="CLI command example"
 
-oint ozon DeleteProductsWithoutSKU --clientid "2128753" --apikey "7cc90d26-33e4-499b..." --articles %articles%
+  oint ozon DeleteProductsWithoutSKU --clientid "2128753" --apikey "7cc90d26-33e4-499b..." --articles %articles%
 
 ```
 

diff --git a/docs/en/md/Ozon/Uploading-and-updating-products/Get-attributes-update-structure.md b/docs/en/md/Ozon/Uploading-and-updating-products/Get-attributes-update-structure.md
@@ -1,5 +1,5 @@
 ---
-sidebar_position: 18
+sidebar_position: 21
 ---
 
 # Get attributes update structure

diff --git a/docs/en/md/Ozon/Uploading-and-updating-products/Get-codes-upload-status.md b/docs/en/md/Ozon/Uploading-and-updating-products/Get-codes-upload-status.md
@@ -0,0 +1,47 @@
+---
+sidebar_position: 18
+---
+
+# Get codes upload status
+ Gets the status of digital item codes upload by task ID
+
+
+
+`Function GetCodesUploadStatus(Val ClientID, Val APIKey, Val TaskID) Export`
+
+  | Parameter | CLI option | Type | Description |
+  |-|-|-|-|
+  | ClientID | --clientid | String | Client identifier |
+  | APIKey | --apikey | String | API key |
+  | TaskID | --taskid | String, Number | Add product task ID |
+
+
+  Returns:  Map Of KeyAndValue - Serialized JSON response from Ozon Seller API
+
+<br/>
+
+:::tip
+Method at API documentation: [post /v1/product/upload_digital_codes/info](https://docs.ozon.ru/api/seller/#operation/ProductAPI_UploadDigitalCodeInfo)
+:::
+<br/>
+
+
+```bsl title="Code example"
+    ClientID = "2128753";
+    APIKey   = "7cc90d26-33e4-499b...";
+    TaskID   = "";
+
+    Result = OPI_Ozon.GetCodesUploadStatus(ClientID, APIKey, TaskID);
+```
+
+
+
+```sh title="CLI command example"
+
+oint ozon GetCodesUploadStatus --clientid "2128753" --apikey "7cc90d26-33e4-499b..." --taskid %taskid%
+
+```
+
+```json title="Result"
+
+```
diff --git a/docs/en/md/Ozon/Uploading-and-updating-products/Get-product-creation-status.md b/docs/en/md/Ozon/Uploading-and-updating-products/Get-product-creation-status.md
@@ -1,5 +1,5 @@
 ---
-sidebar_position: 10
+sidebar_position: 17
 ---
 
 # Get product creation status

diff --git a/docs/en/md/Ozon/Uploading-and-updating-products/Get-product-structure.md b/docs/en/md/Ozon/Uploading-and-updating-products/Get-product-structure.md
@@ -1,5 +1,5 @@
 ---
-sidebar_position: 16
+sidebar_position: 19
 ---
 
 # Get product structure

diff --git a/docs/en/md/Ozon/Uploading-and-updating-products/Get-product-subscribers-count.md b/docs/en/md/Ozon/Uploading-and-updating-products/Get-product-subscribers-count.md
@@ -0,0 +1,47 @@
+---
+sidebar_position: 16
+---
+
+# Get product subscribers count
+ Gets the number of users who clicked Know about arrival button on the product page
+
+
+
+`Function GetProductSubscribersCount(Val ClientID, Val APIKey, Val SKU) Export`
+
+  | Parameter | CLI option | Type | Description |
+  |-|-|-|-|
+  | ClientID | --clientid | String | Client identifier |
+  | APIKey | --apikey | String | API key |
+  | SKU | --sku | Number, Array Of Number | Products identifiers in the Ozon system (SKU) |
+
+
+  Returns:  Map Of KeyAndValue - Serialized JSON response from Ozon Seller API
+
+<br/>
+
+:::tip
+Method at API documentation: [post /v1/product/info/subscription](https://docs.ozon.ru/api/seller/#operation/ProductAPI_GetProductInfoSubscription)
+:::
+<br/>
+
+
+```bsl title="Code example"
+    ClientID = "2128753";
+    APIKey   = "7cc90d26-33e4-499b...";
+    SKU      = 1626044001;
+
+    Result = OPI_Ozon.GetProductSubscribersCount(ClientID, APIKey, SKU);
+```
+
+
+
+```sh title="CLI command example"
+
+oint ozon GetProductSubscribersCount --clientid "2128753" --apikey "7cc90d26-33e4-499b..." --sku %sku%
+
+```
+
+```json title="Result"
+
+```
diff --git a/docs/en/md/Ozon/Uploading-and-updating-products/Get-products-attributes-data.md b/docs/en/md/Ozon/Uploading-and-updating-products/Get-products-attributes-data.md
@@ -45,7 +45,7 @@ Method at API documentation: [post /v3/products/info/attributes](https://docs.oz
 
 ```sh title="CLI command example"
 
-oint ozon GetProductsAttributesData --clientid "2128753" --apikey "7cc90d26-33e4-499b..." --filter %filter% --last %last%
+  oint ozon GetProductsAttributesData --clientid "2128753" --apikey "7cc90d26-33e4-499b..." --filter %filter% --last %last%
 
 ```
 

diff --git a/docs/en/md/Ozon/Uploading-and-updating-products/Get-products-content-rating.md b/docs/en/md/Ozon/Uploading-and-updating-products/Get-products-content-rating.md
@@ -13,7 +13,7 @@ sidebar_position: 5
   |-|-|-|-|
   | ClientID | --clientid | String | Client identifier |
   | APIKey | --apikey | String | API key |
-  | SKU | --sku | String, Number, Array of String, Number | One or array of SKUs |
+  | SKU | --sku | Number, Array Of Number | Products identifiers in the Ozon system (SKU) |
 
 
   Returns:  Map Of KeyAndValue - Serialized JSON response from Ozon Seller API

diff --git a/docs/en/md/Ozon/Uploading-and-updating-products/Get-products-filter-structure.md b/docs/en/md/Ozon/Uploading-and-updating-products/Get-products-filter-structure.md
@@ -1,5 +1,5 @@
 ---
-sidebar_position: 19
+sidebar_position: 22
 ---
 
 # Get products filter structure

diff --git a/.../en/md/Ozon/Uploading-and-updating-products/Get-simplified-product-structure.md b/.../en/md/Ozon/Uploading-and-updating-products/Get-simplified-product-structure.md
@@ -1,5 +1,5 @@
 ---
-sidebar_position: 17
+sidebar_position: 20
 ---
 
 # Get simplified product structure

diff --git a/docs/en/md/Ozon/Uploading-and-updating-products/Unarchive-products.md b/docs/en/md/Ozon/Uploading-and-updating-products/Unarchive-products.md
@@ -1,5 +1,5 @@
 ---
-sidebar_position: 14
+sidebar_position: 13
 ---
 
 # Unarchive products
@@ -40,7 +40,7 @@ You can restore from the archive no more than 10 products that were automaticall
 
 ```sh title="CLI command example"
 
-oint ozon UnarchiveProducts --clientid "2128753" --apikey "7cc90d26-33e4-499b..." --products %products%
+  oint ozon UnarchiveProducts --clientid "2128753" --apikey "7cc90d26-33e4-499b..." --products %products%
 
 ```
 

diff --git a/docs/en/md/Ozon/Uploading-and-updating-products/Update-products-articles.md b/docs/en/md/Ozon/Uploading-and-updating-products/Update-products-articles.md
@@ -1,5 +1,5 @@
 ---
-sidebar_position: 12
+sidebar_position: 11
 ---
 
 # Update products articles

diff --git a/docs/en/md/Ozon/Uploading-and-updating-products/Upload-product-activation-codes.md b/docs/en/md/Ozon/Uploading-and-updating-products/Upload-product-activation-codes.md
@@ -0,0 +1,56 @@
+---
+sidebar_position: 15
+---
+
+# Upload product activations codes
+ Uploads activation codes for a digital product or service
+
+
+
+`Function UploadProductActivationCodes(Val ClientID, Val APIKey, Val ProductID, Val Codes) Export`
+
+  | Parameter | CLI option | Type | Description |
+  |-|-|-|-|
+  | ClientID | --clientid | String | Client identifier |
+  | APIKey | --apikey | String | API key |
+  | ProductID | --productid | Number | Product ID |
+  | Codes | --codes | String, Array of String | Digital product activation codes |
+
+
+  Returns:  Map Of KeyAndValue - Serialized JSON response from Ozon Seller API
+
+<br/>
+
+:::tip
+The activation code is linked to the digital product card
+
+ Uploading status check - GetCodesUploadStatus()
+
+ Method at API documentation: [post /v1/product/upload_digital_codes](https://docs.ozon.ru/api/seller/#operation/ProductAPI_UploadDigitalCode)
+:::
+<br/>
+
+
+```bsl title="Code example"
+    ClientID  = "2128753";
+    APIKey    = "7cc90d26-33e4-499b...";
+    ProductID = "1111588191";
+
+    Codes = New Array;
+    Codes.Add("11111111");
+    Codes.Add("22222222");
+
+    Result = OPI_Ozon.UploadProductActivationCodes(ClientID, APIKey, ProductID, Codes);
+```
+
+
+
+```sh title="CLI command example"
+
+oint ozon UploadProductActivationCodes --clientid "2128753" --apikey "7cc90d26-33e4-499b..." --productid "1111588191" --codes %codes%
+
+```
+
+```json title="Result"
+
+```
diff --git a/docs/ru/cli/Ozon/ЗагрузитьКодыАктивацииТовара.txt b/docs/ru/cli/Ozon/ЗагрузитьКодыАктивацииТовара.txt
@@ -0,0 +1 @@
+oint ozon ЗагрузитьКодыАктивацииТовара --clientid "2128753" --apikey "7cc90d26-33e4-499b..." --productid "1111588191" --codes %codes%
diff --git a/docs/ru/cli/Ozon/ПолучитьКоличествоПодписчиковТоваров.txt b/docs/ru/cli/Ozon/ПолучитьКоличествоПодписчиковТоваров.txt
@@ -0,0 +1 @@
+oint ozon ПолучитьКоличествоПодписчиковТоваров --clientid "2128753" --apikey "7cc90d26-33e4-499b..." --sku %sku%
diff --git a/docs/ru/cli/Ozon/ПолучитьСтатусДобавленияКодов.txt b/docs/ru/cli/Ozon/ПолучитьСтатусДобавленияКодов.txt
@@ -0,0 +1 @@
+oint ozon ПолучитьСтатусДобавленияКодов --clientid "2128753" --apikey "7cc90d26-33e4-499b..." --taskid %taskid%
diff --git a/docs/ru/data/Ozon/ЗагрузитьКодыАктивацииТовара.json b/docs/ru/data/Ozon/ЗагрузитьКодыАктивацииТовара.json
@@ -0,0 +1,5 @@
+{
+"IDКлиента": "2128753",
+"КлючAPI": "7cc90d26-33e4-499b...",
+"IDТовара": 1111588191
+}
diff --git a/docs/ru/data/Ozon/ПолучитьКоличествоПодписчиковТоваров.json b/docs/ru/data/Ozon/ПолучитьКоличествоПодписчиковТоваров.json
@@ -0,0 +1,4 @@
+{
+"IDКлиента": "2128753",
+"КлючAPI": "7cc90d26-33e4-499b..."
+}
diff --git a/docs/ru/data/Ozon/ПолучитьСтатусДобавленияКодов.json b/docs/ru/data/Ozon/ПолучитьСтатусДобавленияКодов.json
@@ -0,0 +1,5 @@
+{
+"IDКлиента": "2128753",
+"КлючAPI": "7cc90d26-33e4-499b...",
+"IDЗадачи": ""
+}
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		oint ozon GetCodesUploadStatus --clientid "2128753" --apikey "7cc90d26-33e4-499b..." --taskid %taskid%
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		oint ozon GetProductSubscribersCount --clientid "2128753" --apikey "7cc90d26-33e4-499b..." --sku %sku%
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		oint ozon UploadProductActivationCodes --clientid "2128753" --apikey "7cc90d26-33e4-499b..." --productid "1111588191" --codes %codes%
-Original file line number
+Diff line change
@@ Expand Up / @@ -23,6 +23,8 @@ sidebar_position: 6 @@
     :::tip
     Methods of product structure formation: GetProductStructure(), AddProductVideo(), AddProductVideoCover()
+     Uploading status check - GetProductCreationStatus()
      Method at API documentation: [post /v3/product/import](https://docs.ozon.ru/api/seller/#operation/ProductAPI_ImportProductsV3)
     :::
     <br/>
@@ Expand Down @@
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		oint ozon ЗагрузитьКодыАктивацииТовара --clientid "2128753" --apikey "7cc90d26-33e4-499b..." --productid "1111588191" --codes %codes%
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		oint ozon ПолучитьКоличествоПодписчиковТоваров --clientid "2128753" --apikey "7cc90d26-33e4-499b..." --sku %sku%
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		oint ozon ПолучитьСтатусДобавленияКодов --clientid "2128753" --apikey "7cc90d26-33e4-499b..." --taskid %taskid%