build(codegen): updating SDK

Author: ct-sdks[bot]

lib/commercetools-api/docs/RequestBuilder.md

@@ -5964,13 +5964,22 @@ $request = $builder
 ```
 ## `withProjectKey("projectKey")->inStoreKeyWithStoreKeyValue("storeKey")->productProjections()->withId("ID")->get()`
 
-Gets the current or staged representation of a [Product](ctp:api:type:Product) by its ID in the specified [Store](ctp:api:type:Store).
+Retrieves the [projected](/../api/projects/productProjections#projection-dimensions) representation of a [Product](ctp:api:type:Product) by its ID in the specified [Store](ctp:api:type:Store).
+
 If the Store has defined some languages, countries, distribution, supply Channels, and/or Product Selection,
 they are used for projections based on [locale](ctp:api:type:ProductProjectionLocales), [price](ctp:api:type:ProductProjectionPrices),
 and [inventory](ctp:api:type:ProductProjectionInventoryEntries).
 If [ProductSelection](ctp:api:type:ProductSelection) is used, it affects the [availability of the Product](/api/project-configuration-overview#products-available-in-store) in the specified Store.
-If a [ProductTailoring](ctp:api:type:ProductTailoring) exists for the Product with the given `id` and the given Store, this endpoint returns the ProductProjection with tailored data.
-When used with an API Client that has the `view_published_products:{projectKey}` scope, this endpoint only returns published (current) Product Projections.
+If a [ProductTailoring](ctp:api:type:ProductTailoring) exists for the Product with the given `key` and the given Store, this endpoint returns the ProductProjection with tailored data.
+
+By default, this endpoint returns the `current` representation of Products where the `published` flag is `true`.
+If a Product is unpublished (`published=false`), the endpoint returns a [Not Found](/../api/errors#404-not-found) error.
+
+Required access scopes:
+
+- To retrieve the current representation of published Products (published data), the `view_published_products:{projectKey}` scope is required.
+
+- To retrieve the staged representation of Products (draft data) or access unpublished Products, the API Client must have the `view_products:{projectKey}` scope.
 
 
 ### Example
@@ -6003,13 +6012,22 @@ $request = $builder
 ```
 ## `withProjectKey("projectKey")->inStoreKeyWithStoreKeyValue("storeKey")->productProjections()->withKey("key")->get()`
 
-Gets the current or staged representation of a [Product](ctp:api:type:Product) by its key in the specified [Store](ctp:api:type:Store).
+Retrieves the [projected](/../api/projects/productProjections#projection-dimensions) representation of a [Product](ctp:api:type:Product) by its Key in the specified [Store](ctp:api:type:Store).
+
 If the Store has defined some languages, countries, distribution, supply Channels, and/or Product Selection,
 they are used for projections based on [locale](ctp:api:type:ProductProjectionLocales), [price](ctp:api:type:ProductProjectionPrices),
 and [inventory](ctp:api:type:ProductProjectionInventoryEntries).
 If [ProductSelection](ctp:api:type:ProductSelection) is used, it affects the [availability of the Product](/api/project-configuration-overview#products-available-in-store) in the specified Store.
 If a [ProductTailoring](ctp:api:type:ProductTailoring) exists for the Product with the given `key` and the given Store, this endpoint returns the ProductProjection with tailored data.
-When used with an API Client that has the `view_published_products:{projectKey}` scope, this endpoint only returns published (current) Product Projections.
+
+By default, this endpoint returns the `current` representation of Products where the `published` flag is `true`.
+If a Product is unpublished (`published=false`), the endpoint returns a [Not Found](/../api/errors#404-not-found) error.
+
+Required access scopes:
+
+- To retrieve the current representation of published Products (published data), the `view_published_products:{projectKey}` scope is required.
+
+- To retrieve the staged representation of Products (draft data) or access unpublished Products, the API Client must have the `view_products:{projectKey}` scope.
 
 
 ### Example
@@ -9548,9 +9566,16 @@ $request = $builder
 ```
 ## `withProjectKey("projectKey")->productProjections()->get()`
 
-Use the Product Projections query endpoint to get the current or staged representations of Products.
-When used with an API Client that has the `view_published_products:{projectKey}` scope,
-this endpoint only returns published (current) Product Projections.
+Retrieves the [projected](/../api/projects/productProjections#projection-dimensions) representation of [Products](ctp:api:type:Product) by [query predicates](/../api/predicates/query).
+
+By default, this endpoint returns the `current` representation of Products where the `published` flag is `true`.
+If a Product is unpublished (`published=false`), the endpoint returns a [Not Found](/../api/errors#404-not-found) error.
+
+Required access scopes:
+
+- To retrieve the current representation of published Products (published data), the `view_published_products:{projectKey}` scope is required.
+
+- To retrieve the staged representation of Products (draft data) or access unpublished Products, the API Client must have the `view_products:{projectKey}` scope.
 
 
 ### Example
@@ -9579,7 +9604,16 @@ $request = $builder
 ```
 ## `withProjectKey("projectKey")->productProjections()->withId("ID")->get()`
 
-Gets the current or staged representation of a [Product](ctp:api:type:Product) by its ID. When used with an API Client that has the `view_published_products:{projectKey}` scope, this endpoint only returns published (current) Product Projections.
+Retrieves the [projected](/../api/projects/productProjections#projection-dimensions) representation of a [Product](ctp:api:type:Product) by its ID.
+
+By default, this endpoint returns the `current` representation of Products where the `published` flag is `true`.
+If a Product is unpublished (`published=false`), the endpoint returns a [Not Found](/../api/errors#404-not-found) error.
+
+Required access scopes:
+
+- To retrieve the current representation of published Products (published data), the `view_published_products:{projectKey}` scope is required.
+
+- To retrieve the staged representation of Products (draft data) or access unpublished Products, the API Client must have the `view_products:{projectKey}` scope.
 
 
 ### Example
@@ -9610,9 +9644,16 @@ $request = $builder
 ```
 ## `withProjectKey("projectKey")->productProjections()->withKey("key")->get()`
 
-Gets the current or staged representation of a [Product](ctp:api:type:Product) found by Key.
-When used with an API Client that has the `view_published_products:{projectKey}` scope,
-this endpoint only returns published (current) Product Projections.
+Retrieves the [projected](/../api/projects/productProjections#projection-dimensions) representation of a [Product](ctp:api:type:Product) by its Key.
+
+By default, this endpoint returns the `current` representation of Products where the `published` flag is `true`.
+If a Product is unpublished (`published=false`), the endpoint returns a [Not Found](/../api/errors#404-not-found) error.
+
+Required access scopes:
+
+- To retrieve the current representation of published Products (published data), the `view_published_products:{projectKey}` scope is required.
+
+- To retrieve the staged representation of Products (draft data) or access unpublished Products, the API Client must have the `view_products:{projectKey}` scope.
 
 
 ### Example

lib/commercetools-api/src/Models/Product/ProductCatalogData.php

@@ -19,7 +19,7 @@ interface ProductCatalogData extends JsonObject
     public const FIELD_HAS_STAGED_CHANGES = 'hasStagedChanges';
 
     /**
-     * <p><code>true</code> if the Product is published.</p>
+     * <p>If <code>true</code>, the <code>current</code> representation of the Product is retrievable in the <a href="/projects/productProjections">Product Projection</a> endpoints and indexed for <a href="/../api/projects/product-search">Product Search</a>.</p>
      *
 
      * @return null|bool

lib/commercetools-api/src/Models/Product/ProductCatalogDataBuilder.php

@@ -45,7 +45,7 @@ final class ProductCatalogDataBuilder implements Builder
     private $hasStagedChanges;
 
     /**
-     * <p><code>true</code> if the Product is published.</p>
+     * <p>If <code>true</code>, the <code>current</code> representation of the Product is retrievable in the <a href="/projects/productProjections">Product Projection</a> endpoints and indexed for <a href="/../api/projects/product-search">Product Search</a>.</p>
      *
 
      * @return null|bool

lib/commercetools-api/src/Models/Product/ProductCatalogDataModel.php

@@ -60,7 +60,7 @@ public function __construct(
     }
 
     /**
-     * <p><code>true</code> if the Product is published.</p>
+     * <p>If <code>true</code>, the <code>current</code> representation of the Product is retrievable in the <a href="/projects/productProjections">Product Projection</a> endpoints and indexed for <a href="/../api/projects/product-search">Product Search</a>.</p>
      *
      *
      * @return null|bool

lib/commercetools-api/src/Models/Product/ProductDraft.php

@@ -162,7 +162,9 @@ public function getSearchKeywords();
     public function getState();
 
     /**
-     * <p>If <code>true</code>, the Product is published immediately to the current projection.</p>
+     * <p>If <code>true</code>, the platform sets the <code>published</code> flag on the resulting <a href="ctp:api:type:ProductCatalogData">ProductCatalogData</a> to <code>true</code>.
+     * This makes the current representation retrievable in <a href="/projects/productProjections">Product Projection</a> endpoints and indexes it for <a href="/../api/projects/product-search">Product Search</a>.
+     * You can also set this flag later using the <a href="/projects/products#publish">Publish</a> update action.</p>
      *
 
      * @return null|bool

lib/commercetools-api/src/Models/Product/ProductDraftBuilder.php

@@ -307,7 +307,9 @@ public function getState()
     }
 
     /**
-     * <p>If <code>true</code>, the Product is published immediately to the current projection.</p>
+     * <p>If <code>true</code>, the platform sets the <code>published</code> flag on the resulting <a href="ctp:api:type:ProductCatalogData">ProductCatalogData</a> to <code>true</code>.
+     * This makes the current representation retrievable in <a href="/projects/productProjections">Product Projection</a> endpoints and indexes it for <a href="/../api/projects/product-search">Product Search</a>.
+     * You can also set this flag later using the <a href="/projects/products#publish">Publish</a> update action.</p>
      *
 
      * @return null|bool

lib/commercetools-api/src/Models/Product/ProductDraftModel.php

@@ -497,7 +497,9 @@ public function getState()
     }
 
     /**
-     * <p>If <code>true</code>, the Product is published immediately to the current projection.</p>
+     * <p>If <code>true</code>, the platform sets the <code>published</code> flag on the resulting <a href="ctp:api:type:ProductCatalogData">ProductCatalogData</a> to <code>true</code>.
+     * This makes the current representation retrievable in <a href="/projects/productProjections">Product Projection</a> endpoints and indexes it for <a href="/../api/projects/product-search">Product Search</a>.
+     * You can also set this flag later using the <a href="/projects/products#publish">Publish</a> update action.</p>
      *
      *
      * @return null|bool

lib/commercetools-api/src/Models/ProductTailoring/ProductTailoring.php

@@ -114,15 +114,15 @@ public function getProduct();
     public function getPublished();
 
     /**
-     * <p>Current (published) data of the ProductTailoring.</p>
+     * <p>Current data of the ProductTailoring returned in the <a href="/projects/productProjections">Product Projection</a> response when the ProductTailoring is published.</p>
      *
 
      * @return null|ProductTailoringData
      */
     public function getCurrent();
 
     /**
-     * <p>Staged (unpublished) data of the ProductTailoring.</p>
+     * <p>Staged data of the ProductTailoring. This data is not returned in the Product Projection response by default.</p>
      *
 
      * @return null|ProductTailoringData

lib/commercetools-api/src/Models/ProductTailoring/ProductTailoringBuilder.php

@@ -229,7 +229,7 @@ public function getPublished()
     }
 
     /**
-     * <p>Current (published) data of the ProductTailoring.</p>
+     * <p>Current data of the ProductTailoring returned in the <a href="/projects/productProjections">Product Projection</a> response when the ProductTailoring is published.</p>
      *
 
      * @return null|ProductTailoringData
@@ -240,7 +240,7 @@ public function getCurrent()
     }
 
     /**
-     * <p>Staged (unpublished) data of the ProductTailoring.</p>
+     * <p>Staged data of the ProductTailoring. This data is not returned in the Product Projection response by default.</p>
      *
 
      * @return null|ProductTailoringData

lib/commercetools-api/src/Models/ProductTailoring/ProductTailoringModel.php

@@ -366,7 +366,7 @@ public function getPublished()
     }
 
     /**
-     * <p>Current (published) data of the ProductTailoring.</p>
+     * <p>Current data of the ProductTailoring returned in the <a href="/projects/productProjections">Product Projection</a> response when the ProductTailoring is published.</p>
      *
      *
      * @return null|ProductTailoringData
@@ -387,7 +387,7 @@ public function getCurrent()
     }
 
     /**
-     * <p>Staged (unpublished) data of the ProductTailoring.</p>
+     * <p>Staged data of the ProductTailoring. This data is not returned in the Product Projection response by default.</p>
      *
      *
      * @return null|ProductTailoringData