feat(content): update the API

#### content:v2 The following keys were added: - schemas.Address.id - schemas.Address.properties.administrativeArea.description - schemas.Address.properties.administrativeArea.type - schemas.Address.properties.city.description - schemas.Address.properties.city.type - schemas.Address.properties.country.description - schemas.Address.properties.country.type - schemas.Address.properties.postalCode.description - schemas.Address.properties.postalCode.type - schemas.Address.properties.streetAddress.description - schemas.Address.properties.streetAddress.type - schemas.Address.type - schemas.ShippingSettings.properties.warehouses.description - schemas.ShippingSettings.properties.warehouses.items.$ref - schemas.ShippingSettings.properties.warehouses.type - schemas.Warehouse.description - schemas.Warehouse.id - schemas.Warehouse.properties.businessDayConfig.$ref - schemas.Warehouse.properties.businessDayConfig.description - schemas.Warehouse.properties.cutoffTime.$ref - schemas.Warehouse.properties.cutoffTime.description - schemas.Warehouse.properties.handlingDays.description - schemas.Warehouse.properties.handlingDays.format - schemas.Warehouse.properties.handlingDays.type - schemas.Warehouse.properties.name.description - schemas.Warehouse.properties.name.type - schemas.Warehouse.properties.shippingAddress.$ref - schemas.Warehouse.properties.shippingAddress.description - schemas.Warehouse.type - schemas.WarehouseBasedDeliveryTime.properties.warehouseName.description - schemas.WarehouseBasedDeliveryTime.properties.warehouseName.type - schemas.WarehouseCutoffTime.id - schemas.WarehouseCutoffTime.properties.hour.description - schemas.WarehouseCutoffTime.properties.hour.format - schemas.WarehouseCutoffTime.properties.hour.type - schemas.WarehouseCutoffTime.properties.minute.description - schemas.WarehouseCutoffTime.properties.minute.format - schemas.WarehouseCutoffTime.properties.minute.type - schemas.WarehouseCutoffTime.type The following keys were changed: - schemas.WarehouseBasedDeliveryTime.properties.originAdministrativeArea.description - schemas.WarehouseBasedDeliveryTime.properties.originCity.description - schemas.WarehouseBasedDeliveryTime.properties.originCountry.description - schemas.WarehouseBasedDeliveryTime.properties.originPostalCode.description #### content:v2.1 The following keys were added: - schemas.AccountBusinessInformation.properties.phoneVerificationStatus.description - schemas.AccountBusinessInformation.properties.phoneVerificationStatus.type - schemas.Address.id - schemas.Address.properties.administrativeArea.description - schemas.Address.properties.administrativeArea.type - schemas.Address.properties.city.description - schemas.Address.properties.city.type - schemas.Address.properties.country.description - schemas.Address.properties.country.type - schemas.Address.properties.postalCode.description - schemas.Address.properties.postalCode.type - schemas.Address.properties.streetAddress.description - schemas.Address.properties.streetAddress.type - schemas.Address.type - schemas.OrderTrackingSignalLineItemDetails.properties.productDescription.description - schemas.OrderTrackingSignalLineItemDetails.properties.productDescription.type - schemas.OrderTrackingSignalLineItemDetails.properties.sku.description - schemas.OrderTrackingSignalLineItemDetails.properties.sku.type - schemas.OrderTrackingSignalLineItemDetails.properties.upc.description - schemas.OrderTrackingSignalLineItemDetails.properties.upc.type - schemas.ShippingSettings.properties.warehouses.description - schemas.ShippingSettings.properties.warehouses.items.$ref - schemas.ShippingSettings.properties.warehouses.type - schemas.Warehouse.description - schemas.Warehouse.id - schemas.Warehouse.properties.businessDayConfig.$ref - schemas.Warehouse.properties.businessDayConfig.description - schemas.Warehouse.properties.cutoffTime.$ref - schemas.Warehouse.properties.cutoffTime.description - schemas.Warehouse.properties.handlingDays.description - schemas.Warehouse.properties.handlingDays.format - schemas.Warehouse.properties.handlingDays.type - schemas.Warehouse.properties.name.description - schemas.Warehouse.properties.name.type - schemas.Warehouse.properties.shippingAddress.$ref - schemas.Warehouse.properties.shippingAddress.description - schemas.Warehouse.type - schemas.WarehouseBasedDeliveryTime.properties.warehouseName.description - schemas.WarehouseBasedDeliveryTime.properties.warehouseName.type - schemas.WarehouseCutoffTime.id - schemas.WarehouseCutoffTime.properties.hour.description - schemas.WarehouseCutoffTime.properties.hour.format - schemas.WarehouseCutoffTime.properties.hour.type - schemas.WarehouseCutoffTime.properties.minute.description - schemas.WarehouseCutoffTime.properties.minute.format - schemas.WarehouseCutoffTime.properties.minute.type - schemas.WarehouseCutoffTime.type The following keys were changed: - schemas.AccountBusinessInformation.properties.phoneNumber.description - schemas.Promotion.description - schemas.Promotion.properties.id.description - schemas.Promotion.properties.productApplicability.enum - schemas.WarehouseBasedDeliveryTime.properties.originAdministrativeArea.description - schemas.WarehouseBasedDeliveryTime.properties.originCity.description - schemas.WarehouseBasedDeliveryTime.properties.originCountry.description - schemas.WarehouseBasedDeliveryTime.properties.originPostalCode.description
googleapis · Oct 18, 2021 · 3e942b4 · 3e942b4
1 parent ab6d3f7
commit 3e942b4
Show file tree

Hide file tree

Showing 4 changed files with 361 additions and 31 deletions.
diff --git a/discovery/content-v2.1.json b/discovery/content-v2.1.json
@@ -5783,7 +5783,7 @@
       }
     }
   },
-  "revision": "20210924",
+  "revision": "20211007",
   "rootUrl": "https://shoppingcontent.googleapis.com/",
   "schemas": {
     "Account": {
@@ -5930,7 +5930,11 @@
           "type": "string"
         },
         "phoneNumber": {
-          "description": "! The phone number of the business. This can only be updated if a verified ! phone number is not already set. To replace a verified phone number use ! the `Accounts.requestphoneverification` and ! `Accounts.verifyphonenumber`.",
+          "description": "The phone number of the business. This can only be updated if a verified phone number is not already set. To replace a verified phone number use the `Accounts.requestphoneverification` and `Accounts.verifyphonenumber`.",
+          "type": "string"
+        },
+        "phoneVerificationStatus": {
+          "description": "Verification status of the phone number of the business. This status is read only and can be updated only by successful phone verification. Acceptable values are: - \"`verified`\" - \"`unverified`\" \"`unspecified`\" - ",
           "type": "string"
         }
       },
@@ -6831,6 +6835,32 @@
       "properties": {},
       "type": "object"
     },
+    "Address": {
+      "id": "Address",
+      "properties": {
+        "administrativeArea": {
+          "description": "Required. Top-level administrative subdivision of the country. For example, a state like California (\"CA\") or a province like Quebec (\"QC\").",
+          "type": "string"
+        },
+        "city": {
+          "description": "Required. City, town or commune. May also include dependent localities or sublocalities (e.g. neighborhoods or suburbs).",
+          "type": "string"
+        },
+        "country": {
+          "description": "Required. [CLDR country code](http://www.unicode.org/repos/cldr/tags/latest/common/main/en.xml) (e.g. \"US\").",
+          "type": "string"
+        },
+        "postalCode": {
+          "description": "Required. Postal code or ZIP (e.g. \"94043\").",
+          "type": "string"
+        },
+        "streetAddress": {
+          "description": "Street-level part of the address.",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
     "Amount": {
       "id": "Amount",
       "properties": {
@@ -10239,6 +10269,10 @@
           "description": "The manufacturer part number.",
           "type": "string"
         },
+        "productDescription": {
+          "description": "Plain text description of this product.",
+          "type": "string"
+        },
         "productId": {
           "description": "Required. The Content API REST ID of the product, in the form channel:contentLanguage:targetCountry:offerId.",
           "type": "string"
@@ -10247,6 +10281,14 @@
           "description": "Required. The quantity of the line item in the order.",
           "format": "int64",
           "type": "string"
+        },
+        "sku": {
+          "description": "Merchant SKU for this item.",
+          "type": "string"
+        },
+        "upc": {
+          "description": "Universal product code for this item.",
+          "type": "string"
         }
       },
       "type": "object"
@@ -13022,7 +13064,7 @@
       "type": "object"
     },
     "Promotion": {
-      "description": "Represents a promotion. (1) https://support.google.com/merchants/answer/2906014 (2) https://support.google.com/merchants/answer/10146130 (3) https://support.google.com/merchants/answer/9173673",
+      "description": " The Promotions feature is currently in alpha and is not yet publicly available via Content API for Shopping. This documentation is provided for reference only may be subject to change. Represents a promotion. See the following articles for more details. * [Promotions feed specification](https://support.google.com/merchants/answer/2906014) * [Local promotions feed specification](https://support.google.com/merchants/answer/10146130) * [Promotions on Buy on Google product data specification](https://support.google.com/merchants/answer/9173673)",
       "id": "Promotion",
       "properties": {
         "brand": {
@@ -13099,7 +13141,7 @@
           "type": "integer"
         },
         "id": {
-          "description": "Required. Output only. The REST promotion id to uniquely identify the promotion. Content API methods that operate on promotions take this as their promotionId parameter.",
+          "description": "Required. Output only. The REST promotion id to uniquely identify the promotion. Content API methods that operate on promotions take this as their promotionId parameter. The REST ID for a promotion is of the form channel:contentLanguage:targetCountry:promotionId The channel field will have a value of \"online\", \"local\", or \"onlinelocal\".",
           "readOnly": true,
           "type": "string"
         },
@@ -13190,7 +13232,7 @@
           "enum": [
             "PRODUCT_APPLICABILITY_UNSPECIFIED",
             "ALL_PRODUCTS",
-            "PRODUCT_SPECIFIC"
+            "SPECIFIC_PRODUCTS"
           ],
           "enumDescriptions": [
             "Unknown product applicability.",
@@ -15120,6 +15162,13 @@
             "$ref": "Service"
           },
           "type": "array"
+        },
+        "warehouses": {
+          "description": "Optional. A list of warehouses which can be referred to in `services`.",
+          "items": {
+            "$ref": "Warehouse"
+          },
+          "type": "array"
         }
       },
       "type": "object"
@@ -15841,6 +15890,34 @@
       },
       "type": "object"
     },
+    "Warehouse": {
+      "description": "A fulfillment warehouse, which stores and handles inventory.",
+      "id": "Warehouse",
+      "properties": {
+        "businessDayConfig": {
+          "$ref": "BusinessDayConfig",
+          "description": "Business days of the warehouse. If not set, will be Monday to Friday by default."
+        },
+        "cutoffTime": {
+          "$ref": "WarehouseCutoffTime",
+          "description": "Required. The latest time of day that an order can be accepted and begin processing. Later orders will be processed in the next day. The time is based on the warehouse postal code."
+        },
+        "handlingDays": {
+          "description": "Required. The number of days it takes for this warehouse to pack up and ship an item. This is on the warehouse level, but can be overridden on the offer level based on the attributes of an item.",
+          "format": "int64",
+          "type": "string"
+        },
+        "name": {
+          "description": "Required. The name of the warehouse. Must be unique within account.",
+          "type": "string"
+        },
+        "shippingAddress": {
+          "$ref": "Address",
+          "description": "Required. Shipping address of the warehouse."
+        }
+      },
+      "type": "object"
+    },
     "WarehouseBasedDeliveryTime": {
       "id": "WarehouseBasedDeliveryTime",
       "properties": {
@@ -15853,24 +15930,44 @@
           "type": "string"
         },
         "originAdministrativeArea": {
-          "description": "Required. Shipping origin's state.",
+          "description": "Shipping origin's state.",
           "type": "string"
         },
         "originCity": {
-          "description": "Required. Shipping origin's city.",
+          "description": "Shipping origin's city.",
           "type": "string"
         },
         "originCountry": {
-          "description": "Required. Shipping origin's country represented as a [CLDR territory code](http://www.unicode.org/repos/cldr/tags/latest/common/main/en.xml).",
+          "description": "Shipping origin's country represented as a [CLDR territory code](http://www.unicode.org/repos/cldr/tags/latest/common/main/en.xml).",
           "type": "string"
         },
         "originPostalCode": {
-          "description": "Required. Shipping origin.",
+          "description": "Shipping origin.",
           "type": "string"
         },
         "originStreetAddress": {
           "description": "Shipping origin's street address.",
           "type": "string"
+        },
+        "warehouseName": {
+          "description": "The name of the warehouse. Warehouse name need to be matched with name. If warehouseName is set, the below fields will be ignored. The warehouse info will be read from warehouse.",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "WarehouseCutoffTime": {
+      "id": "WarehouseCutoffTime",
+      "properties": {
+        "hour": {
+          "description": "Required. Hour (24-hour clock) of the cutoff time until which an order has to be placed to be processed in the same day by the warehouse. Hour is based on the timezone of warehouse.",
+          "format": "int32",
+          "type": "integer"
+        },
+        "minute": {
+          "description": "Required. Minute of the cutoff time until which an order has to be placed to be processed in the same day by the warehouse. Minute is based on the timezone of warehouse.",
+          "format": "int32",
+          "type": "integer"
         }
       },
       "type": "object"

diff --git a/discovery/content-v2.json b/discovery/content-v2.json
@@ -3298,7 +3298,7 @@
       }
     }
   },
-  "revision": "20210911",
+  "revision": "20211007",
   "rootUrl": "https://shoppingcontent.googleapis.com/",
   "schemas": {
     "Account": {
@@ -4209,6 +4209,32 @@
       },
       "type": "object"
     },
+    "Address": {
+      "id": "Address",
+      "properties": {
+        "administrativeArea": {
+          "description": "Required. Top-level administrative subdivision of the country. For example, a state like California (\"CA\") or a province like Quebec (\"QC\").",
+          "type": "string"
+        },
+        "city": {
+          "description": "Required. City, town or commune. May also include dependent localities or sublocalities (e.g. neighborhoods or suburbs).",
+          "type": "string"
+        },
+        "country": {
+          "description": "Required. [CLDR country code](http://www.unicode.org/repos/cldr/tags/latest/common/main/en.xml)(e.g. \"US\").",
+          "type": "string"
+        },
+        "postalCode": {
+          "description": "Required. Postal code or ZIP (e.g. \"94043\"). Required.",
+          "type": "string"
+        },
+        "streetAddress": {
+          "description": "Street-level part of the address.",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
     "Amount": {
       "id": "Amount",
       "properties": {
@@ -9721,6 +9747,13 @@
             "$ref": "Service"
           },
           "type": "array"
+        },
+        "warehouses": {
+          "description": "Optional. A list of warehouses which can be referred to in `services`.",
+          "items": {
+            "$ref": "Warehouse"
+          },
+          "type": "array"
         }
       },
       "type": "object"
@@ -10275,6 +10308,34 @@
       },
       "type": "object"
     },
+    "Warehouse": {
+      "description": "A fulfillment warehouse, which stores and handles inventory.",
+      "id": "Warehouse",
+      "properties": {
+        "businessDayConfig": {
+          "$ref": "BusinessDayConfig",
+          "description": "Business days of the warehouse. If not set, will be Monday to Friday by default."
+        },
+        "cutoffTime": {
+          "$ref": "WarehouseCutoffTime",
+          "description": "Required. The latest time of day that an order can be accepted and begin processing. Later orders will be processed in the next day. The time is based on the warehouse postal code."
+        },
+        "handlingDays": {
+          "description": "Required. The number of days it takes for this warehouse to pack up and ship an item. This is on the warehouse level, but can be overridden on the offer level based on the attributes of an item.",
+          "format": "int64",
+          "type": "string"
+        },
+        "name": {
+          "description": "Required. The name of the warehouse. Must be unique within account.",
+          "type": "string"
+        },
+        "shippingAddress": {
+          "$ref": "Address",
+          "description": "Required. Shipping address of the warehouse."
+        }
+      },
+      "type": "object"
+    },
     "WarehouseBasedDeliveryTime": {
       "id": "WarehouseBasedDeliveryTime",
       "properties": {
@@ -10287,24 +10348,44 @@
           "type": "string"
         },
         "originAdministrativeArea": {
-          "description": "Required. Shipping origin's state.",
+          "description": "Shipping origin's state.",
           "type": "string"
         },
         "originCity": {
-          "description": "Required. Shipping origin's city.",
+          "description": "Shipping origin's city.",
           "type": "string"
         },
         "originCountry": {
-          "description": "Required. Shipping origin's country represented as a [CLDR territory code](http://www.unicode.org/repos/cldr/tags/latest/common/main/en.xml).",
+          "description": "Shipping origin's country represented as a [CLDR territory code](http://www.unicode.org/repos/cldr/tags/latest/common/main/en.xml).",
           "type": "string"
         },
         "originPostalCode": {
-          "description": "Required. Shipping origin.",
+          "description": "Shipping origin.",
           "type": "string"
         },
         "originStreetAddress": {
           "description": "Shipping origin's street address",
           "type": "string"
+        },
+        "warehouseName": {
+          "description": "The name of the warehouse. Warehouse name need to be matched with name. If warehouseName is set, the below fields will be ignored. The warehouse info will be read from warehouse.",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "WarehouseCutoffTime": {
+      "id": "WarehouseCutoffTime",
+      "properties": {
+        "hour": {
+          "description": "Required. Hour (24-hour clock) of the cutoff time until which an order has to be placed to be processed in the same day by the warehouse. Hour is based on the timezone of warehouse.",
+          "format": "int32",
+          "type": "integer"
+        },
+        "minute": {
+          "description": "Required. Minute of the cutoff time until which an order has to be placed to be processed in the same day by the warehouse. Minute is based on the timezone of warehouse.",
+          "format": "int32",
+          "type": "integer"
         }
       },
       "type": "object"