Updated API from documentation release

Author: ct-sdks[bot]

api-specs/api/api.raml

@@ -33,8 +33,10 @@ traits:
   versioned: !include traits/versioned.raml
   priceSelecting: !include traits/price-selecting.raml
   projectionSelecting: !include traits/projection-selecting.raml
+  projectionSelectingTailoring: !include traits/projection-selecting-tailoring.raml
   localeProjecting: !include traits/locale-projecting.raml
   storeProjecting: !include traits/store-projecting.raml
+  storeProjectingTailoring: !include traits/store-projecting-tailoring.raml
   dataErasure: !include traits/data-erasure.raml
 types: !include types/types.raml
 mediaType: application/json

api-specs/api/resources/in-store.raml

@@ -2518,9 +2518,11 @@ uriParameters:
 
         If [ProductSelection](ctp:api:type:ProductSelection) is used, it affects the [availability of the Product](/projects/stores#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.
       is:
-        - projectionSelecting
+        - projectionSelectingTailoring
         - priceSelecting
         - localeProjecting
     head:
@@ -2563,9 +2565,11 @@ uriParameters:
 
         If [ProductSelection](ctp:api:type:ProductSelection) is used, it affects the [availability of the Product](/projects/stores#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.
       is:
-        - projectionSelecting
+        - projectionSelectingTailoring
         - priceSelecting
         - localeProjecting
     head:

api-specs/api/resources/product-projections-search.raml

@@ -71,7 +71,7 @@ get:
     - projectionSelecting
     - priceSelecting
     - localeProjecting
-    - storeProjecting
+    - storeProjectingTailoring
     - expandable
   securedBy:
     [

api-specs/api/resources/product-projections.raml

@@ -28,7 +28,7 @@ get:
     - projectionSelecting
     - priceSelecting
     - localeProjecting
-    - storeProjecting
+    - storeProjectingTailoring
   responses:
     200:
       body:
@@ -78,7 +78,7 @@ head:
       - projectionSelecting
       - priceSelecting
       - localeProjecting
-      - storeProjecting
+      - storeProjectingTailoring
     responses:
       200:
         body:
@@ -121,7 +121,7 @@ head:
       - projectionSelecting
       - priceSelecting
       - localeProjecting
-      - storeProjecting
+      - storeProjectingTailoring
     responses:
       200:
         body:

api-specs/api/traits/projection-selecting-tailoring.raml

@@ -0,0 +1,20 @@
+#%RAML 1.0 Trait
+
+queryParameters:
+  staged?:
+    type: boolean
+    default: false
+    description: |
+      If `false`,
+
+      * this endpoint returns the [current](/projects/productProjections#current--staged) Product Projection if the Product is published, a [ResourceNotFound](/errors#resourcenotfound) error otherwise.
+
+      * this endpoint returns the ProductProjection with **tailored** Product information (if a [ProductTailoring](ctp:api:type:ProductTailoring) exists for the Product) when the ProductTailoring's `published` is `true`.
+      * this endpoint returns the ProductProjection with **original** Product information when the ProductTailoring's `published` is `false`.
+
+      If `true`,
+
+      * this endpoint returns the [staged](/projects/productProjections#current--staged) Product Projection (only for API Clients that have the `view_products:{projectKey}` scope).
+
+      * this endpoint returns the ProductProjection with **tailored** Product information (if a ProductTailoring exists for the Product) when either the ProductTailoring's `published` or the [ProductCatalogData](ctp:api:type:ProductCatalogData) `published` is `true`.
+      If `published` is `false` for both ProductTailoring and ProductCatalogData, the ProductProjection contains **original** Product information.

api-specs/api/traits/store-projecting-tailoring.raml

@@ -0,0 +1,12 @@
+#%RAML 1.0 Trait
+queryParameters:
+  storeProjection:
+    type: string
+    required: false
+    description: |
+      `key` of an existing [Store](ctp:api:type:Store).
+      If the Store has defined `languages`, `countries`, `distributionChannels`, or `supplyChannels`,
+      they are used for projections based on [locale](ctp:api:type:ProductProjectionLocales), [price](ctp:api:type:ProductProjectionPrices),
+      and [inventory](ctp:api:type:ProductProjectionInventoryEntries).
+      If [Product Selections](/../api/projects/product-selections) are used, the API does not take the [availability of the Product in the specified Store](/../api/projects/stores#products-available-in-store) into account.
+      [Product Tailoring](/../api/projects/product-tailoring) modifies the product information returned in API responses, but evaluating [Query Predicates](/../api/predicates/query) is restricted to the original product information.

api-specs/api/traits/store-projecting.raml

@@ -1,12 +1,11 @@
 #%RAML 1.0 Trait
-
 queryParameters:
   storeProjection:
     type: string
     required: false
     description: |
       `key` of an existing [Store](ctp:api:type:Store).
-      If the Store has defined some languages, countries, distribution or supply Channels,
+      If the Store has defined `languages`, `countries`, `distributionChannels`, or `supplyChannels`,
       they are used for projections based on [locale](ctp:api:type:ProductProjectionLocales), [price](ctp:api:type:ProductProjectionPrices),
       and [inventory](ctp:api:type:ProductProjectionInventoryEntries).
-      If the Store has defined [Product Selections](ctp:api:type:ProductSelection), they have no effect on the results of this query.
+      For Projects with active [Product Selections](/../api/projects/product-selections), the API does not take the [availability of the Product in the specified Store](/../api/projects/stores#products-available-in-store) into account.

api-specs/api/types/product-search/ProductSearchProjectionParams.raml

@@ -39,7 +39,8 @@ properties:
     type: string
     description: |
       `key` of an existing [Store](ctp:api:type:Store).
-      If the Store has defined some languages, countries, distribution or supply Channels,
+      If the Store has defined `languages`, `countries`, `distributionChannels`, or `supplyChannels`,
       they are used for projections based on [locale](ctp:api:type:ProductProjectionLocales), [price](ctp:api:type:ProductProjectionPrices),
       and [inventory](ctp:api:type:ProductProjectionInventoryEntries).
-      If the Store has defined [Product Selections](ctp:api:type:ProductSelection) or [Product Tailoring](ctp:api:type:ProductTailoring), they have no effect on the results of this query.
+      For Projects with active [Product Selections](/../api/projects/product-selections), the API does not take the [availability of the Product in the specified Store](/../api/projects/stores#products-available-in-store) into account.
+      [Product Tailoring](/../api/projects/product-tailoring) modifies the product information returned in API responses, but evaluating [query expressions](/../api/search-query-language#simple-expressions) is restricted to the original product information.

api-specs/api/types/product-tailoring/ProductTailoring.raml

@@ -4,7 +4,7 @@ displayName: ProductTailoring
 type: BaseResource
 (updateType): ProductTailoringUpdate
 description: |
-  A single ProductTailoring representation contains the _current_ and the _staged_ representation of its product data tailored per Store.
+  A single ProductTailoring representation contains the _current_ and the _staged_ representation of its product information tailored per Store.
 example: !include ../../examples/product-tailoring.example.json
 properties:
   id:
@@ -49,7 +49,9 @@ properties:
   published:
     type: boolean
     description: |
-      `true` if the ProductTailoring is published.
+      If `true`, the tailored information contained in the `current` [ProductTailoringData](ctp:api:type:ProductTailoringData) is provided when [retrieving the ProductProjection in Store](/../api/projects/product-tailoring#retrieve-product-projection-with-tailored-information).
+      For information not part of the ProductTailoringData, the original information contained in the [ProductData](ctp:api:type:ProductData) is provided.
+      If `false`, only the original information contained in the ProductData is provided.
   current:
     type: ProductTailoringData
     description: |

api-specs/api/types/product-tailoring/ProductTailoringData.raml

@@ -3,7 +3,7 @@
 displayName: ProductTailoringData
 type: object
 description: |
-  Contains all the tailored data of a Product.
+  Contains all the tailored information of a Product.
 properties:
   name?:
     type: LocalizedString