diff --git a/docs/dyn/content_v2.products.html b/docs/dyn/content_v2.products.html index 9d12b4932a5..ca80fee4b9b 100644 --- a/docs/dyn/content_v2.products.html +++ b/docs/dyn/content_v2.products.html @@ -115,7 +115,7 @@

Method Details

"batchId": 42, # An entry ID, unique within the batch request. "merchantId": "A String", # The ID of the managing account. "method": "A String", # The method of the batch entry. Acceptable values are: - "`delete`" - "`get`" - "`insert`" - "product": { # Required product attributes are primarily defined by the products data specification. See the Products Data Specification Help Center article for information. Some attributes are country-specific, so make sure you select the appropriate country in the drop-down selector at the top of the page. Product data. After inserting, updating, or deleting a product, it may take several minutes before changes take effect. # The product to insert. Only required if the method is `insert`. + "product": { # Required product attributes are primarily defined by the products data specification. See the Products Data Specification Help Center article for information. Product data. After inserting, updating, or deleting a product, it may take several minutes before changes take effect. # The product to insert. Only required if the method is `insert`. "additionalImageLinks": [ # Additional URLs of images of the item. "A String", ], @@ -335,7 +335,7 @@

Method Details

"message": "A String", # The message of the first error in `errors`. }, "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "`content#productsCustomBatchResponseEntry`" - "product": { # Required product attributes are primarily defined by the products data specification. See the Products Data Specification Help Center article for information. Some attributes are country-specific, so make sure you select the appropriate country in the drop-down selector at the top of the page. Product data. After inserting, updating, or deleting a product, it may take several minutes before changes take effect. # The inserted product. Only defined if the method is `insert` and if the request was successful. + "product": { # Required product attributes are primarily defined by the products data specification. See the Products Data Specification Help Center article for information. Product data. After inserting, updating, or deleting a product, it may take several minutes before changes take effect. # The inserted product. Only defined if the method is `insert` and if the request was successful. "additionalImageLinks": [ # Additional URLs of images of the item. "A String", ], @@ -561,7 +561,7 @@

Method Details

Returns: An object of the form: - { # Required product attributes are primarily defined by the products data specification. See the Products Data Specification Help Center article for information. Some attributes are country-specific, so make sure you select the appropriate country in the drop-down selector at the top of the page. Product data. After inserting, updating, or deleting a product, it may take several minutes before changes take effect. + { # Required product attributes are primarily defined by the products data specification. See the Products Data Specification Help Center article for information. Product data. After inserting, updating, or deleting a product, it may take several minutes before changes take effect. "additionalImageLinks": [ # Additional URLs of images of the item. "A String", ], @@ -762,7 +762,7 @@

Method Details

body: object, The request body. The object takes the form of: -{ # Required product attributes are primarily defined by the products data specification. See the Products Data Specification Help Center article for information. Some attributes are country-specific, so make sure you select the appropriate country in the drop-down selector at the top of the page. Product data. After inserting, updating, or deleting a product, it may take several minutes before changes take effect. +{ # Required product attributes are primarily defined by the products data specification. See the Products Data Specification Help Center article for information. Product data. After inserting, updating, or deleting a product, it may take several minutes before changes take effect. "additionalImageLinks": [ # Additional URLs of images of the item. "A String", ], @@ -962,7 +962,7 @@

Method Details

Returns: An object of the form: - { # Required product attributes are primarily defined by the products data specification. See the Products Data Specification Help Center article for information. Some attributes are country-specific, so make sure you select the appropriate country in the drop-down selector at the top of the page. Product data. After inserting, updating, or deleting a product, it may take several minutes before changes take effect. + { # Required product attributes are primarily defined by the products data specification. See the Products Data Specification Help Center article for information. Product data. After inserting, updating, or deleting a product, it may take several minutes before changes take effect. "additionalImageLinks": [ # Additional URLs of images of the item. "A String", ], @@ -1175,7 +1175,7 @@

Method Details

"kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "content#productsListResponse". "nextPageToken": "A String", # The token for the retrieval of the next page of products. "resources": [ - { # Required product attributes are primarily defined by the products data specification. See the Products Data Specification Help Center article for information. Some attributes are country-specific, so make sure you select the appropriate country in the drop-down selector at the top of the page. Product data. After inserting, updating, or deleting a product, it may take several minutes before changes take effect. + { # Required product attributes are primarily defined by the products data specification. See the Products Data Specification Help Center article for information. Product data. After inserting, updating, or deleting a product, it may take several minutes before changes take effect. "additionalImageLinks": [ # Additional URLs of images of the item. "A String", ], diff --git a/docs/dyn/content_v2.productstatuses.html b/docs/dyn/content_v2.productstatuses.html index 529437a8f12..b73d78a8959 100644 --- a/docs/dyn/content_v2.productstatuses.html +++ b/docs/dyn/content_v2.productstatuses.html @@ -182,7 +182,7 @@

Method Details

"kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "`content#productStatus`" "lastUpdateDate": "A String", # Date on which the item has been last updated, in ISO 8601 format. "link": "A String", # The link to the product. - "product": { # Required product attributes are primarily defined by the products data specification. See the Products Data Specification Help Center article for information. Some attributes are country-specific, so make sure you select the appropriate country in the drop-down selector at the top of the page. Product data. After inserting, updating, or deleting a product, it may take several minutes before changes take effect. # Product data after applying all the join inputs. + "product": { # Required product attributes are primarily defined by the products data specification. See the Products Data Specification Help Center article for information. Product data. After inserting, updating, or deleting a product, it may take several minutes before changes take effect. # Product data after applying all the join inputs. "additionalImageLinks": [ # Additional URLs of images of the item. "A String", ], @@ -437,7 +437,7 @@

Method Details

"kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "`content#productStatus`" "lastUpdateDate": "A String", # Date on which the item has been last updated, in ISO 8601 format. "link": "A String", # The link to the product. - "product": { # Required product attributes are primarily defined by the products data specification. See the Products Data Specification Help Center article for information. Some attributes are country-specific, so make sure you select the appropriate country in the drop-down selector at the top of the page. Product data. After inserting, updating, or deleting a product, it may take several minutes before changes take effect. # Product data after applying all the join inputs. + "product": { # Required product attributes are primarily defined by the products data specification. See the Products Data Specification Help Center article for information. Product data. After inserting, updating, or deleting a product, it may take several minutes before changes take effect. # Product data after applying all the join inputs. "additionalImageLinks": [ # Additional URLs of images of the item. "A String", ], @@ -694,7 +694,7 @@

Method Details

"kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "`content#productStatus`" "lastUpdateDate": "A String", # Date on which the item has been last updated, in ISO 8601 format. "link": "A String", # The link to the product. - "product": { # Required product attributes are primarily defined by the products data specification. See the Products Data Specification Help Center article for information. Some attributes are country-specific, so make sure you select the appropriate country in the drop-down selector at the top of the page. Product data. After inserting, updating, or deleting a product, it may take several minutes before changes take effect. # Product data after applying all the join inputs. + "product": { # Required product attributes are primarily defined by the products data specification. See the Products Data Specification Help Center article for information. Product data. After inserting, updating, or deleting a product, it may take several minutes before changes take effect. # Product data after applying all the join inputs. "additionalImageLinks": [ # Additional URLs of images of the item. "A String", ], diff --git a/googleapiclient/discovery_cache/documents/content.v2.json b/googleapiclient/discovery_cache/documents/content.v2.json index a6a2993d3d9..d220b4fde6e 100644 --- a/googleapiclient/discovery_cache/documents/content.v2.json +++ b/googleapiclient/discovery_cache/documents/content.v2.json @@ -3298,7 +3298,7 @@ } } }, - "revision": "20210505", + "revision": "20210514", "rootUrl": "https://shoppingcontent.googleapis.com/", "schemas": { "Account": { @@ -8554,7 +8554,7 @@ "type": "object" }, "Product": { - "description": " Required product attributes are primarily defined by the products data specification. See the Products Data Specification Help Center article for information. Some attributes are country-specific, so make sure you select the appropriate country in the drop-down selector at the top of the page. Product data. After inserting, updating, or deleting a product, it may take several minutes before changes take effect.", + "description": " Required product attributes are primarily defined by the products data specification. See the Products Data Specification Help Center article for information. Product data. After inserting, updating, or deleting a product, it may take several minutes before changes take effect.", "id": "Product", "properties": { "additionalImageLinks": { diff --git a/googleapiclient/discovery_cache/documents/content.v21.json b/googleapiclient/discovery_cache/documents/content.v21.json index cf257f497c8..cf0dac0c2a5 100644 --- a/googleapiclient/discovery_cache/documents/content.v21.json +++ b/googleapiclient/discovery_cache/documents/content.v21.json @@ -397,7 +397,7 @@ "type": "string" }, "maxResults": { - "description": "The maximum number of links to return in the response, used for pagination.", + "description": "The maximum number of links to return in the response, used for pagination. The minimum allowed value is 5 results per page. If provided value is lower than 5, it will be automatically increased to 5.", "format": "uint32", "location": "query", "type": "integer" @@ -3937,6 +3937,47 @@ "scopes": [ "https://www.googleapis.com/auth/content" ] + }, + "update": { + "description": "Updates an existing product in your Merchant Center account. Only updates attributes provided in the request.", + "flatPath": "{merchantId}/products/{productId}", + "httpMethod": "PATCH", + "id": "content.products.update", + "parameterOrder": [ + "merchantId", + "productId" + ], + "parameters": { + "merchantId": { + "description": "The ID of the account that contains the product. This account cannot be a multi-client account.", + "format": "uint64", + "location": "path", + "required": true, + "type": "string" + }, + "productId": { + "description": "The REST ID of the product for which to update.", + "location": "path", + "required": true, + "type": "string" + }, + "updateMask": { + "description": "The list of product attributes to be updated. Attributes specified in the update mask without a value specified in the body will be deleted from the product. Only top-level product attributes can be updated. If not defined, product attributes with set values will be updated and other attributes will stay unchanged.", + "format": "google-fieldmask", + "location": "query", + "type": "string" + } + }, + "path": "{merchantId}/products/{productId}", + "request": { + "$ref": "Product" + }, + "response": { + "$ref": "Product" + }, + "scopes": [ + "https://www.googleapis.com/auth/content" + ] } } }, @@ -5444,7 +5485,7 @@ } } }, - "revision": "20210505", + "revision": "20210514", "rootUrl": "https://shoppingcontent.googleapis.com/", "schemas": { "Account": { @@ -9522,7 +9563,7 @@ "description": "The shipping fee of the order; this value should be set to zero in the case of free shipping." }, "deliveryPostalCode": { - "description": "Required. The delivery postal code, as a continuous string without spaces or dashes, e.g. \"95016\".", + "description": "Required. The delivery postal code, as a continuous string without spaces or dashes, e.g. \"95016\". This field will be anonymized in returned OrderTrackingSignal creation response.", "type": "string" }, "deliveryRegionCode": { @@ -9546,7 +9587,7 @@ "description": "Required. The time when the order was created on the merchant side. Include the year and timezone string, if available." }, "orderId": { - "description": "Required. The ID of the order on the merchant side.", + "description": "Required. The ID of the order on the merchant side. This field will be hashed in returned OrderTrackingSignal creation response.", "type": "string" }, "orderTrackingSignalId": { @@ -9614,7 +9655,7 @@ "type": "string" }, "shipmentId": { - "description": "Required. The shipment ID.", + "description": "Required. The shipment ID. This field will be hashed in returned OrderTrackingSignal creation response.", "type": "string" } }, @@ -9645,7 +9686,7 @@ "description": "The latest delivery promised time. Include the year and timezone string, if available. This field is required, if one of the following fields is absent: tracking_id or carrier_name." }, "originPostalCode": { - "description": "The origin postal code, as a continuous string without spaces or dashes, e.g. \"95016\".", + "description": "The origin postal code, as a continuous string without spaces or dashes, e.g. \"95016\". This field will be anonymized in returned OrderTrackingSignal creation response.", "type": "string" }, "originRegionCode": { @@ -9653,7 +9694,7 @@ "type": "string" }, "shipmentId": { - "description": "Required. The shipment ID.", + "description": "Required. The shipment ID. This field will be hashed in returned OrderTrackingSignal creation response.", "type": "string" }, "shippedTime": { @@ -9908,7 +9949,11 @@ "id": "OrderreturnsLineItem", "properties": { "lineItemId": { - "description": "The ID of the line item. This value is assigned by Google when an order is created.", + "description": "The ID of the line item. This value is assigned by Google when an order is created. Either lineItemId or productId is required.", + "type": "string" + }, + "productId": { + "description": "The ID of the product to cancel. This is the REST ID used in the products service. Either lineItemId or productId is required.", "type": "string" }, "quantity": { @@ -11374,7 +11419,7 @@ "type": "object" }, "Product": { - "description": " Required product attributes are primarily defined by the products data specification. See the Products Data Specification Help Center article for information. Some attributes are country-specific, so make sure you select the appropriate country in the drop-down selector at the top of the page. Product data. After inserting, updating, or deleting a product, it may take several minutes before changes take effect.", + "description": " Required product attributes are primarily defined by the products data specification. See the Products Data Specification Help Center article for information. Product data. After inserting, updating, or deleting a product, it may take several minutes before changes take effect.", "id": "Product", "properties": { "additionalImageLinks": { @@ -12115,7 +12160,7 @@ "type": "string" }, "method": { - "description": "The method of the batch entry. Acceptable values are: - \"`delete`\" - \"`get`\" - \"`insert`\" ", + "description": "The method of the batch entry. Acceptable values are: - \"`delete`\" - \"`get`\" - \"`insert`\" - \"`update`\" ", "type": "string" }, "product": { @@ -12125,6 +12170,11 @@ "productId": { "description": "The ID of the product to get or delete. Only defined if the method is `get` or `delete`.", "type": "string" + }, + "updateMask": { + "description": "The list of product attributes to be updated. Attributes specified in the update mask without a value specified in the body will be deleted from the product. Only top-level product attributes can be updated. If not defined, product attributes with set values will be updated and other attributes will stay unchanged. Only defined if the method is `update`.", + "format": "google-fieldmask", + "type": "string" } }, "type": "object" @@ -12609,7 +12659,7 @@ }, "buyboxWinningProductStats": { "$ref": "RepricingProductReportBuyboxWinningProductStats", - "description": "Stats specific to buybox winning rules for product report." + "description": "Stats specific to buybox winning rules for product report (deprecated)." }, "date": { "$ref": "Date", @@ -12848,7 +12898,7 @@ "properties": { "buyboxWinningRuleStats": { "$ref": "RepricingRuleReportBuyboxWinningRuleStats", - "description": "Stats specific to buybox winning rules for rule report." + "description": "Stats specific to buybox winning rules for rule report (deprecated)." }, "date": { "$ref": "Date",