@@ -1,12 +1,12 @@
2 "kind": "discovery#restDescription",
2 "kind": "discovery#restDescription",
3− "etag": "\"jQLIOHBVnDZie4rQHGH1WJF-INE/hqrMddPMFaU74nL8Pb566O2vUwc\"",
3+ "etag": "\"C5oy1hgQsABtYOYIOXWcR3BgYqU/s25nZfCDiUSmvUdwENlGP-4IYvU\"",
4 "discoveryVersion": "v1",
4 "discoveryVersion": "v1",
5 "id": "content:v2",
5 "id": "content:v2",
6 "name": "content",
6 "name": "content",
7 "canonicalName": "Shopping Content",
7 "canonicalName": "Shopping Content",
8 "version": "v2",
8 "version": "v2",
9− "revision": "20160419",
9+ "revision": "20160928",
10 "title": "Content API for Shopping",
10 "title": "Content API for Shopping",
11 "description": "Manages product items, inventory, and Merchant Center accounts for Google Shopping.",
11 "description": "Manages product items, inventory, and Merchant Center accounts for Google Shopping.",
12 "ownerDomain": "google.com",
12 "ownerDomain": "google.com",
@@ -455,6 +455,16 @@
455 "$ref": "AccountShippingShippingServiceCostRule",
455 "$ref": "AccountShippingShippingServiceCostRule",
456 "description": "Decision tree for \"complicated\" shipping cost calculation."
456 "description": "Decision tree for \"complicated\" shipping cost calculation."
458+ "maxDaysInTransit": {
460+ "description": "The maximum number of days in transit. Must be a value between 0 and 250 included. A value of 0 means same day delivery.",
463+ "minDaysInTransit": {
465+ "description": "The minimum number of days in transit. Must be a value between 0 and maxDaysIntransit included. A value of 0 means same day delivery.",
458 "name": {
468 "name": {
459 "type": "string",
469 "type": "string",
460 "description": "The name of this shipping service.",
470 "description": "The name of this shipping service.",
@@ -1126,6 +1136,57 @@
1140+ "id": "CarrierRate",
1145+ "description": "Carrier service, such as \"UPS\" or \"Fedex\". The list of supported carriers can be retrieved via the getSupportedCarriers method. Required."
1147+ "carrierService": {
1149+ "description": "Carrier service, such as \"ground\" or \"2 days\". The list of supported services for a carrier can be retrieved via the getSupportedCarriers method. Required."
1151+ "flatAdjustment": {
1153+ "description": "Additive shipping rate modifier. Can be negative. For example { \"value\": \"1\", \"currency\" : \"USD\" } adds $1 to the rate, { \"value\": \"-3\", \"currency\" : \"USD\" } removes $3 from the rate. Optional."
1157+ "description": "Name of the carrier rate. Must be unique per rate group. Required."
1159+ "originPostalCode": {
1161+ "description": "Shipping origin for this carrier rate. Required."
1163+ "percentageAdjustment": {
1165+ "description": "Multiplicative shipping rate modifier as a number in decimal notation. Can be negative. For example \"5.4\" increases the rate by 5.4%, \"-3\" decreases the rate by 3%. Optional."
1169+ "CarriersCarrier": {
1170+ "id": "CarriersCarrier",
1175+ "description": "The CLDR country code of the carrier (e.g., \"US\"). Always present."
1179+ "description": "The name of the carrier (e.g., \"UPS\"). Always present."
1183+ "description": "A list of supported services (e.g., \"ground\") for that carrier. Contains at least one service.",
1129 "Datafeed": {
1190 "Datafeed": {
1130 "id": "Datafeed",
1191 "id": "Datafeed",
1131 "type": "object",
1192 "type": "object",
@@ -1569,6 +1630,22 @@
1634+ "id": "DeliveryTime",
1637+ "maxTransitTimeInDays": {
1639+ "description": "Maximum number of business days that is spent in transit. 0 means same day delivery, 1 means next day delivery. Must be greater than or equal to minTransitTimeInDays. Required.",
1642+ "minTransitTimeInDays": {
1644+ "description": "Minimum number of business days that is spent in transit. 0 means same day delivery, 1 means next day delivery. Required.",
1572 "Error": {
1649 "Error": {
1573 "id": "Error",
1650 "id": "Error",
1574 "type": "object",
1651 "type": "object",
@@ -1611,6 +1688,48 @@
1694+ "description": "A non-empty list of row or column headers for a table. Exactly one of prices, weights, numItems, postalCodeGroupNames, or locations must be set.",
1698+ "description": "A list of location ID sets. Must be non-empty. Can only be set if all other fields are not set.",
1700+ "$ref": "LocationIdSet"
1705+ "description": "A list of inclusive number of items upper bounds. The last value can be \"infinity\". For example [\"10\", \"50\", \"infinity\"] represents the headers \"\u003c= 10 items\", \" 50 items\". Must be non-empty. Can only be set if all other fields are not set.",
1710+ "postalCodeGroupNames": {
1712+ "description": "A list of postal group names. The last value can be \"all other locations\". Example: [\"zone 1\", \"zone 2\", \"all other locations\"]. The referred postal code groups must match the delivery country of the service. Must be non-empty. Can only be set if all other fields are not set.",
1719+ "description": "be \"infinity\". For example [{\"value\": \"10\", \"currency\": \"USD\"}, {\"value\": \"500\", \"currency\": \"USD\"}, {\"value\": \"infinity\", \"currency\": \"USD\"}] represents the headers \"\u003c= $10\", \" $500\". All prices within a service must have the same currency. Must be non-empty. Can only be set if all other fields are not set.",
1726+ "description": "be \"infinity\". For example [{\"value\": \"10\", \"unit\": \"kg\"}, {\"value\": \"50\", \"unit\": \"kg\"}, {\"value\": \"infinity\", \"unit\": \"kg\"}] represents the headers \"\u003c= 10kg\", \" 50kg\". All weights within a service must have the same unit. Must be non-empty. Can only be set if all other fields are not set.",
1614 "Installment": {
1733 "Installment": {
1615 "id": "Installment",
1734 "id": "Installment",
1616 "type": "object",
1735 "type": "object",
@@ -1803,6 +1922,19 @@
1926+ "id": "LocationIdSet",
1931+ "description": "A non-empty list of location IDs. They must all be of the same location type (e.g., state).",
1806 "LoyaltyPoints": {
1938 "LoyaltyPoints": {
1807 "id": "LoyaltyPoints",
1939 "id": "LoyaltyPoints",
1808 "type": "object",
1940 "type": "object",
@@ -1831,6 +1963,10 @@
1831 "type": "boolean",
1963 "type": "boolean",
1832 "description": "Whether the order was acknowledged."
1964 "description": "Whether the order was acknowledged."
1968+ "description": "The channel type of the order: \"purchaseOnGoogle\" or \"googleExpress\"."
1834 "customer": {
1970 "customer": {
1835 "$ref": "OrderCustomer",
1971 "$ref": "OrderCustomer",
1836 "description": "The details of the customer who placed the order."
1972 "description": "The details of the customer who placed the order."
@@ -1981,7 +2117,7 @@
1982 "reason": {
2118 "reason": {
1983 "type": "string",
2119 "type": "string",
1984− "description": "The reason for the cancellation. Orders that are cancelled with a noIventory reason will lead to the removal of the product from POG until you make an update to that product. This will not affect your Shopping ads."
2120+ "description": "The reason for the cancellation. Orders that are cancelled with a noInventory reason will lead to the removal of the product from POG until you make an update to that product. This will not affect your Shopping ads."
1986 "reasonText": {
2122 "reasonText": {
1987 "type": "string",
2123 "type": "string",
@@ -3118,6 +3254,41 @@
3257+ "PostalCodeGroup": {
3258+ "id": "PostalCodeGroup",
3263+ "description": "The CLDR territory code of the country the postal code group applies to. Required."
3267+ "description": "The name of the postal code group, referred to in headers. Required."
3269+ "postalCodeRanges": {
3271+ "description": "A range of postal codes. Required.",
3273+ "$ref": "PostalCodeRange"
3278+ "PostalCodeRange": {
3279+ "id": "PostalCodeRange",
3282+ "postalCodeRangeBegin": {
3284+ "description": "A postal code or a pattern of the form prefix* denoting the inclusive lower bound of the range defining the area. Examples values: \"94108\", \"9410*\", \"9*\". Required."
3286+ "postalCodeRangeEnd": {
3288+ "description": "A postal code or a pattern of the form prefix* denoting the inclusive upper bound of the range defining the area. It must have the same length as postalCodeRangeBegin: if postalCodeRangeBegin is a postal code then postalCodeRangeEnd must be a postal code too; if postalCodeRangeBegin is a pattern then postalCodeRangeEnd must be a pattern with the same prefix length. Optional: if not set, then the area is defined as being all the postal codes matching postalCodeRangeBegin."
3121 "Price": {
3292 "Price": {
3122 "id": "Price",
3293 "id": "Price",
3123 "type": "object",
3294 "type": "object",
@@ -3144,6 +3315,13 @@
3144 "type": "string"
3315 "type": "string"
3318+ "additionalProductTypes": {
3320+ "description": "Additional categories of the item (formatted as in products feed specification).",
3147 "adult": {
3325 "adult": {
3148 "type": "boolean",
3326 "type": "boolean",
3149 "description": "Set to true if the item is targeted towards adults."
3327 "description": "Set to true if the item is targeted towards adults."
@@ -3996,6 +4174,262 @@
4181+ "applicableShippingLabels": {
4183+ "description": "A list of shipping labels defining the products to which this rate group applies to. This is a disjunction: only one of the labels has to match for the rate group to apply. May only be empty for the last rate group of a service. Required.",
4190+ "description": "A list of carrier rates that can be referred to by mainTable or singleValue.",
4192+ "$ref": "CarrierRate"
4197+ "description": "A table defining the rate group, when singleValue is not expressive enough. Can only be set if singleValue is not set."
4201+ "description": "The value of the rate group (e.g. flat rate $10). Can only be set if mainTable and subtables are not set."
4205+ "description": "A list of subtables referred to by mainTable. Can only be set if mainTable is set.",
4218+ "description": "The list of cells that constitute the row. Must have the same length as columnHeaders for two-dimensional tables, a length of 1 for one-dimensional tables. Required.",
4231+ "description": "A boolean exposing the active status of the shipping service. Required."
4235+ "description": "The CLDR code of the currency to which this service applies. Must match that of the prices in rate groups."
4237+ "deliveryCountry": {
4239+ "description": "The CLDR territory code of the country to which the service applies. Required."
4242+ "$ref": "DeliveryTime",
4243+ "description": "Time spent in various aspects from order to the delivery of the product. Required."
4247+ "description": "Free-form name of the service. Must be unique within target account. Required."
4251+ "description": "Shipping rate group definitions. Only the last one is allowed to have an empty applicableShippingLabels, which means \"everything else\". The other applicableShippingLabels must not overlap.",
4253+ "$ref": "RateGroup"
4258+ "ShippingSettings": {
4259+ "id": "ShippingSettings",
4261+ "description": "The merchant account's shipping settings.",
4265+ "description": "The ID of the account to which these account shipping settings belong. Ignored upon update, always present in get request responses.",
4268+ "postalCodeGroups": {
4270+ "description": "A list of postal code groups that can be referred to in services. Optional.",
4272+ "$ref": "PostalCodeGroup"
4277+ "description": "The target account's list of services. Optional.",
4284+ "ShippingsettingsCustomBatchRequest": {
4285+ "id": "ShippingsettingsCustomBatchRequest",
4290+ "description": "The request entries to be processed in the batch.",
4292+ "$ref": "ShippingsettingsCustomBatchRequestEntry"
4297+ "ShippingsettingsCustomBatchRequestEntry": {
4298+ "id": "ShippingsettingsCustomBatchRequestEntry",
4300+ "description": "A batch entry encoding a single non-batch accountshipping request.",
4304+ "description": "The ID of the account for which to get/update account shipping settings.",
4309+ "description": "An entry ID, unique within the batch request.",
4314+ "description": "The ID of the managing account.",
4320+ "shippingSettings": {
4321+ "$ref": "ShippingSettings",
4322+ "description": "The account shipping settings to update. Only defined if the method is update."
4326+ "ShippingsettingsCustomBatchResponse": {
4327+ "id": "ShippingsettingsCustomBatchResponse",
4332+ "description": "The result of the execution of the batch requests.",
4334+ "$ref": "ShippingsettingsCustomBatchResponseEntry"
4339+ "description": "Identifies what kind of resource this is. Value: the fixed string \"content#shippingsettingsCustomBatchResponse\".",
4340+ "default": "content#shippingsettingsCustomBatchResponse"
4344+ "ShippingsettingsCustomBatchResponseEntry": {
4345+ "id": "ShippingsettingsCustomBatchResponseEntry",
4347+ "description": "A batch entry encoding a single non-batch shipping settings response.",
4351+ "description": "The ID of the request entry to which this entry responds.",
4356+ "description": "A list of errors defined if, and only if, the request failed."
4360+ "description": "Identifies what kind of resource this is. Value: the fixed string \"content#shippingsettingsCustomBatchResponseEntry\".",
4361+ "default": "content#shippingsettingsCustomBatchResponseEntry"
4363+ "shippingSettings": {
4364+ "$ref": "ShippingSettings",
4365+ "description": "The retrieved or updated account shipping settings."
4369+ "ShippingsettingsGetSupportedCarriersResponse": {
4370+ "id": "ShippingsettingsGetSupportedCarriersResponse",
4375+ "description": "A list of supported carriers. May be empty.",
4377+ "$ref": "CarriersCarrier"
4382+ "description": "Identifies what kind of resource this is. Value: the fixed string \"content#shippingsettingsGetSupportedCarriersResponse\".",
4383+ "default": "content#shippingsettingsGetSupportedCarriersResponse"
4387+ "ShippingsettingsListResponse": {
4388+ "id": "ShippingsettingsListResponse",
4393+ "description": "Identifies what kind of resource this is. Value: the fixed string \"content#shippingsettingsListResponse\".",
4394+ "default": "content#shippingsettingsListResponse"
4398+ "description": "The token for the retrieval of the next page of shipping settings."
4403+ "$ref": "ShippingSettings"
4414+ "description": "Headers of the table's columns. Optional: if not set then the table has only one dimension."
4418+ "description": "Name of the table. Required for subtables, ignored for the main table."
4422+ "description": "Headers of the table's rows. Required."
4426+ "description": "The list of rows that constitute the table. Must have the same length as rowHeaders. Required.",
3999 "TestOrder": {
4433 "TestOrder": {
4000 "id": "TestOrder",
4434 "id": "TestOrder",
4001 "type": "object",
4435 "type": "object",
@@ -4279,6 +4713,33 @@
4719+ "description": "The single value of a rate group or the value of a rate group table's cell. Exactly one of noShipping, flatRate, pricePercentage, carrierRateName, subtableName must be set.",
4721+ "carrierRateName": {
4723+ "description": "The name of a carrier rate referring to a carrier rate defined in the same rate group. Can only be set if all other fields are not set."
4727+ "description": "A flat rate. Can only be set if all other fields are not set."
4731+ "description": "If true, then the product can't ship. Must be true when set, can only be set if all other fields are not set."
4733+ "pricePercentage": {
4735+ "description": "A percentage of the price represented as a number in decimal notation (e.g., \"5.4\"). Can only be set if all other fields are not set."
4739+ "description": "The name of a subtable. Can only be set in table cells (i.e., not for single values), and only if all other fields are not set."
4282 "Weight": {
4743 "Weight": {
4283 "id": "Weight",
4744 "id": "Weight",
4284 "type": "object",
4745 "type": "object",
@@ -6171,6 +6632,203 @@
6636+ "shippingsettings": {
6639+ "id": "content.shippingsettings.custombatch",
6640+ "path": "shippingsettings/batch",
6641+ "httpMethod": "POST",
6642+ "description": "Retrieves and updates the shipping settings of multiple accounts in a single request.",
6646+ "description": "Flag to run the request in dry-run mode.",
6647+ "location": "query"
6651+ "$ref": "ShippingsettingsCustomBatchRequest"
6654+ "$ref": "ShippingsettingsCustomBatchResponse"
6657+ "https://www.googleapis.com/auth/content"
6661+ "id": "content.shippingsettings.get",
6662+ "path": "{merchantId}/shippingsettings/{accountId}",
6663+ "httpMethod": "GET",
6664+ "description": "Retrieves the shipping settings of the account.",
6668+ "description": "The ID of the account for which to get/update shipping settings.",
6670+ "format": "uint64",
6675+ "description": "The ID of the managing account.",
6677+ "format": "uint64",
6681+ "parameterOrder": [
6686+ "$ref": "ShippingSettings"
6689+ "https://www.googleapis.com/auth/content"
6692+ "getsupportedcarriers": {
6693+ "id": "content.shippingsettings.getsupportedcarriers",
6694+ "path": "{merchantId}/supportedCarriers",
6695+ "httpMethod": "GET",
6696+ "description": "Retrieves supported carriers and carrier services for an account.",
6700+ "description": "The ID of the account for which to retrieve the supported carriers.",
6702+ "format": "uint64",
6706+ "parameterOrder": [
6710+ "$ref": "ShippingsettingsGetSupportedCarriersResponse"
6713+ "https://www.googleapis.com/auth/content"
6717+ "id": "content.shippingsettings.list",
6718+ "path": "{merchantId}/shippingsettings",
6719+ "httpMethod": "GET",
6720+ "description": "Lists the shipping settings of the sub-accounts in your Merchant Center account.",
6724+ "description": "The maximum number of shipping settings to return in the response, used for paging.",
6725+ "format": "uint32",
6726+ "location": "query"
6730+ "description": "The ID of the managing account.",
6732+ "format": "uint64",
6737+ "description": "The token returned by the previous request.",
6738+ "location": "query"
6741+ "parameterOrder": [
6745+ "$ref": "ShippingsettingsListResponse"
6748+ "https://www.googleapis.com/auth/content"
6752+ "id": "content.shippingsettings.patch",
6753+ "path": "{merchantId}/shippingsettings/{accountId}",
6754+ "httpMethod": "PATCH",
6755+ "description": "Updates the shipping settings of the account. This method supports patch semantics.",
6759+ "description": "The ID of the account for which to get/update shipping settings.",
6761+ "format": "uint64",
6766+ "description": "Flag to run the request in dry-run mode.",
6767+ "location": "query"
6771+ "description": "The ID of the managing account.",
6773+ "format": "uint64",
6777+ "parameterOrder": [
6782+ "$ref": "ShippingSettings"
6785+ "$ref": "ShippingSettings"
6788+ "https://www.googleapis.com/auth/content"
6792+ "id": "content.shippingsettings.update",
6793+ "path": "{merchantId}/shippingsettings/{accountId}",
6794+ "httpMethod": "PUT",
6795+ "description": "Updates the shipping settings of the account.",
6799+ "description": "The ID of the account for which to get/update shipping settings.",
6801+ "format": "uint64",
6806+ "description": "Flag to run the request in dry-run mode.",
6807+ "location": "query"
6811+ "description": "The ID of the managing account.",
6813+ "format": "uint64",
6817+ "parameterOrder": [
6822+ "$ref": "ShippingSettings"
6825+ "$ref": "ShippingSettings"
6828+ "https://www.googleapis.com/auth/content"