Api-roll 21: 2015-08-04

discovery/googleapis/content__v2.json

 {
     "auth": {
         "oauth2": {
             "scopes": {
                 "https://www.googleapis.com/auth/content": {
                     "description": "Manage your product listings and accounts for Google Shopping"
                 }
             }
         }
     },
     "basePath": "/content/v2/",
     "baseUrl": "https://www.googleapis.com/content/v2/",
     "batchPath": "batch",
     "canonicalName": "Shopping Content",
     "description": "Manage product items, inventory, and Merchant Center accounts for Google Shopping.",
     "discoveryVersion": "v1",
     "documentationLink": "https://developers.google.com/shopping-content/v2/",
-    "etag": "\"ye6orv2F-1npMW3u9suM3a7C5Bo/RsxRME9Gu_f17mSFUnwX4Br4j90\"",
+    "etag": "\"ye6orv2F-1npMW3u9suM3a7C5Bo/ienJtHXSgvp2PqTI_8QrrraJ4bU\"",
     "icons": {
         "x16": "http://www.google.com/images/icons/product/search-16.gif",
         "x32": "http://www.google.com/images/icons/product/search-32.gif"
     },
     "id": "content:v2",
     "kind": "discovery#restDescription",
     "name": "content",
     "ownerDomain": "google.com",
     "ownerName": "Google",
     "parameters": {
@@ skipping 54 matching lines @@
                         "$ref": "AccountsAuthInfoResponse"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/content"
                     ]
                 },
                 "custombatch": {
                     "description": "Retrieves, inserts, updates, and deletes multiple Merchant Center (sub-)accounts in a single request.",
                     "httpMethod": "POST",
                     "id": "content.accounts.custombatch",
+                    "parameters": {
+                        "dryRun": {
+                            "description": "Flag to run the request in dry-run mode.",
+                            "location": "query",
+                            "type": "boolean"
+                        }
+                    },
                     "path": "accounts/batch",
                     "request": {
                         "$ref": "AccountsCustomBatchRequest"
                     },
                     "response": {
                         "$ref": "AccountsCustomBatchResponse"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/content"
                     ]
                 },
                 "delete": {
                     "description": "Deletes a Merchant Center sub-account.",
                     "httpMethod": "DELETE",
                     "id": "content.accounts.delete",
                     "parameterOrder": [
                         "merchantId",
                         "accountId"
                     ],
                     "parameters": {
                         "accountId": {
                             "description": "The ID of the account.",
                             "format": "uint64",
                             "location": "path",
                             "required": true,
                             "type": "string"
                         },
+                        "dryRun": {
+                            "description": "Flag to run the request in dry-run mode.",
+                            "location": "query",
+                            "type": "boolean"
+                        },
                         "merchantId": {
                             "description": "The ID of the managing account.",
                             "format": "uint64",
                             "location": "path",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{merchantId}/accounts/{accountId}",
                     "scopes": [
@@ skipping 33 matching lines @@
                     ]
                 },
                 "insert": {
                     "description": "Creates a Merchant Center sub-account.",
                     "httpMethod": "POST",
                     "id": "content.accounts.insert",
                     "parameterOrder": [
                         "merchantId"
                     ],
                     "parameters": {
+                        "dryRun": {
+                            "description": "Flag to run the request in dry-run mode.",
+                            "location": "query",
+                            "type": "boolean"
+                        },
                         "merchantId": {
                             "description": "The ID of the managing account.",
                             "format": "uint64",
                             "location": "path",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{merchantId}/accounts",
                     "request": {
@@ skipping 50 matching lines @@
                         "accountId"
                     ],
                     "parameters": {
                         "accountId": {
                             "description": "The ID of the account.",
                             "format": "uint64",
                             "location": "path",
                             "required": true,
                             "type": "string"
                         },
+                        "dryRun": {
+                            "description": "Flag to run the request in dry-run mode.",
+                            "location": "query",
+                            "type": "boolean"
+                        },
                         "merchantId": {
                             "description": "The ID of the managing account.",
                             "format": "uint64",
                             "location": "path",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{merchantId}/accounts/{accountId}",
                     "request": {
@@ skipping 15 matching lines @@
                         "accountId"
                     ],
                     "parameters": {
                         "accountId": {
                             "description": "The ID of the account.",
                             "format": "uint64",
                             "location": "path",
                             "required": true,
                             "type": "string"
                         },
+                        "dryRun": {
+                            "description": "Flag to run the request in dry-run mode.",
+                            "location": "query",
+                            "type": "boolean"
+                        },
                         "merchantId": {
                             "description": "The ID of the managing account.",
                             "format": "uint64",
                             "location": "path",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{merchantId}/accounts/{accountId}",
                     "request": {
@@ skipping 437 matching lines @@
                         "https://www.googleapis.com/auth/content"
                     ]
                 }
             }
         },
         "datafeeds": {
             "methods": {
                 "custombatch": {
                     "httpMethod": "POST",
                     "id": "content.datafeeds.custombatch",
+                    "parameters": {
+                        "dryRun": {
+                            "description": "Flag to run the request in dry-run mode.",
+                            "location": "query",
+                            "type": "boolean"
+                        }
+                    },
                     "path": "datafeeds/batch",
                     "request": {
                         "$ref": "DatafeedsCustomBatchRequest"
                     },
                     "response": {
                         "$ref": "DatafeedsCustomBatchResponse"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/content"
                     ]
                 },
                 "delete": {
                     "description": "Deletes a datafeed from your Merchant Center account.",
                     "httpMethod": "DELETE",
                     "id": "content.datafeeds.delete",
                     "parameterOrder": [
                         "merchantId",
                         "datafeedId"
                     ],
                     "parameters": {
                         "datafeedId": {
                             "format": "uint64",
                             "location": "path",
                             "required": true,
                             "type": "string"
                         },
+                        "dryRun": {
+                            "description": "Flag to run the request in dry-run mode.",
+                            "location": "query",
+                            "type": "boolean"
+                        },
                         "merchantId": {
                             "format": "uint64",
                             "location": "path",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{merchantId}/datafeeds/{datafeedId}",
                     "scopes": [
                         "https://www.googleapis.com/auth/content"
@@ skipping 30 matching lines @@
                     ]
                 },
                 "insert": {
                     "description": "Registers a datafeed with your Merchant Center account.",
                     "httpMethod": "POST",
                     "id": "content.datafeeds.insert",
                     "parameterOrder": [
                         "merchantId"
                     ],
                     "parameters": {
+                        "dryRun": {
+                            "description": "Flag to run the request in dry-run mode.",
+                            "location": "query",
+                            "type": "boolean"
+                        },
                         "merchantId": {
                             "format": "uint64",
                             "location": "path",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{merchantId}/datafeeds",
                     "request": {
                         "$ref": "Datafeed"
@@ skipping 48 matching lines @@
                         "merchantId",
                         "datafeedId"
                     ],
                     "parameters": {
                         "datafeedId": {
                             "format": "uint64",
                             "location": "path",
                             "required": true,
                             "type": "string"
                         },
+                        "dryRun": {
+                            "description": "Flag to run the request in dry-run mode.",
+                            "location": "query",
+                            "type": "boolean"
+                        },
                         "merchantId": {
                             "format": "uint64",
                             "location": "path",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{merchantId}/datafeeds/{datafeedId}",
                     "request": {
                         "$ref": "Datafeed"
@@ skipping 13 matching lines @@
                         "merchantId",
                         "datafeedId"
                     ],
                     "parameters": {
                         "datafeedId": {
                             "format": "uint64",
                             "location": "path",
                             "required": true,
                             "type": "string"
                         },
+                        "dryRun": {
+                            "description": "Flag to run the request in dry-run mode.",
+                            "location": "query",
+                            "type": "boolean"
+                        },
                         "merchantId": {
                             "format": "uint64",
                             "location": "path",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{merchantId}/datafeeds/{datafeedId}",
                     "request": {
                         "$ref": "Datafeed"
@@ skipping 86 matching lines @@
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/content"
                     ]
                 }
             }
         },
         "inventory": {
             "methods": {
                 "custombatch": {
-                    "description": "Updates price and availability for multiple products or stores in a single request.",
+                    "description": "Updates price and availability for multiple products or stores in a single request. This operation does not update the expiration date of the products.",
                     "httpMethod": "POST",
                     "id": "content.inventory.custombatch",
+                    "parameters": {
+                        "dryRun": {
+                            "description": "Flag to run the request in dry-run mode.",
+                            "location": "query",
+                            "type": "boolean"
+                        }
+                    },
                     "path": "inventory/batch",
                     "request": {
                         "$ref": "InventoryCustomBatchRequest"
                     },
                     "response": {
                         "$ref": "InventoryCustomBatchResponse"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/content"
                     ]
                 },
                 "set": {
-                    "description": "Updates price and availability of a product in your Merchant Center account.",
+                    "description": "Updates price and availability of a product in your Merchant Center account. This operation does not update the expiration date of the product.",
                     "httpMethod": "POST",
                     "id": "content.inventory.set",
                     "parameterOrder": [
                         "merchantId",
                         "storeCode",
                         "productId"
                     ],
                     "parameters": {
+                        "dryRun": {
+                            "description": "Flag to run the request in dry-run mode.",
+                            "location": "query",
+                            "type": "boolean"
+                        },
                         "merchantId": {
                             "description": "The ID of the managing account.",
                             "format": "uint64",
                             "location": "path",
                             "required": true,
                             "type": "string"
                         },
                         "productId": {
                             "description": "The ID of the product for which to update price and availability.",
                             "location": "path",
@@ skipping 256 matching lines @@
                     "response": {
                         "$ref": "ProductstatusesListResponse"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/content"
                     ]
                 }
             }
         }
     },
-    "revision": "20150528",
+    "revision": "20150729",
     "rootUrl": "https://www.googleapis.com/",
     "schemas": {
         "Account": {
             "description": "Account data.",
             "id": "Account",
             "properties": {
                 "adultContent": {
                     "description": "Indicates whether the merchant sells adult content.",
                     "type": "boolean"
                 },
@@ skipping 170 matching lines @@
                     },
                     "description": "The name of the carrier rate.",
                     "type": "string"
                 },
                 "saleCountry": {
                     "annotations": {
                         "required": [
                             "content.accountshipping.update"
                         ]
                     },
-                    "description": "Sale country for which this carrier rate is valid, represented as an ISO 3166-1 Alpha-2 code.",
+                    "description": "The sale country for which this carrier rate is valid, represented as a CLDR territory code.",
                     "type": "string"
                 },
                 "shippingOrigin": {
                     "annotations": {
                         "required": [
                             "content.accountshipping.update"
                         ]
                     },
                     "description": "Shipping origin represented as a postal code.",
                     "type": "string"
@@ skipping 39 matching lines @@
         "AccountShippingLocationGroup": {
             "description": "A user-defined locations group in a given country. All the locations of the group must be of the same type.",
             "id": "AccountShippingLocationGroup",
             "properties": {
                 "country": {
                     "annotations": {
                         "required": [
                             "content.accountshipping.update"
                         ]
                     },
-                    "description": "The country in which this location group is, represented as ISO 3166-1 Alpha-2 code.",
+                    "description": "The CLDR territory code of the country in which this location group is.",
                     "type": "string"
                 },
                 "locationIds": {
                     "description": "A location ID (also called criteria ID) representing administrative areas, smaller country subdivisions (counties), or cities.",
                     "items": {
                         "format": "int64",
                         "type": "string"
                     },
                     "type": "array"
                 },
@@ skipping 67 matching lines @@
                     },
                     "description": "The name of the rate table.",
                     "type": "string"
                 },
                 "saleCountry": {
                     "annotations": {
                         "required": [
                             "content.accountshipping.update"
                         ]
                     },
-                    "description": "Sale country for which this table is valid, represented as an ISO 3166-1 Alpha-2 code.",
+                    "description": "The sale country for which this table is valid, represented as a CLDR territory code.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "AccountShippingRateTableCell": {
             "id": "AccountShippingRateTableCell",
             "properties": {
                 "condition": {
                     "$ref": "AccountShippingCondition",
@@ skipping 35 matching lines @@
                     },
                     "description": "The name of this shipping service.",
                     "type": "string"
                 },
                 "saleCountry": {
                     "annotations": {
                         "required": [
                             "content.accountshipping.update"
                         ]
                     },
-                    "description": "Sale country for which this service can be used, represented as an ISO 3166-1 Alpha-2 code.",
+                    "description": "The CLDR territory code of the sale country for which this service can be used.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "AccountShippingShippingServiceCalculationMethod": {
             "description": "Shipping cost calculation method. Exactly one of the field is set.",
             "id": "AccountShippingShippingServiceCalculationMethod",
             "properties": {
                 "carrierRate": {
@@ skipping 719 matching lines @@
                     "description": "A descriptive name of the data feed.",
                     "type": "string"
                 },
                 "targetCountry": {
                     "annotations": {
                         "required": [
                             "content.datafeeds.insert",
                             "content.datafeeds.update"
                         ]
                     },
-                    "description": "The two-letter ISO 3166 country where the items in the feed will be included in the search index.",
+                    "description": "The country where the items in the feed will be included in the search index, represented as a CLDR territory code.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "DatafeedFetchSchedule": {
             "description": "The required fields vary based on the frequency of fetching. For a monthly fetch schedule, day_of_month and hour are required. For a weekly fetch schedule, weekday and hour are required. For a daily fetch schedule, only hour is required.",
             "id": "DatafeedFetchSchedule",
             "properties": {
                 "dayOfMonth": {
@@ skipping 404 matching lines @@
                     "format": "uint32",
                     "type": "integer"
                 },
                 "salePrice": {
                     "$ref": "Price",
                     "description": "The sale price of the product. Mandatory if sale_price_effective_date is defined."
                 },
                 "salePriceEffectiveDate": {
                     "description": "A date range represented by a pair of ISO 8601 dates separated by a space, comma, or slash. Both dates might be specified as 'null' if undecided.",
                     "type": "string"
+                },
+                "sellOnGoogleQuantity": {
+                    "description": "The quantity of the product that is reserved for sell-on-google ads. Supported only for online products.",
+                    "format": "uint32",
+                    "type": "integer"
                 }
             },
             "type": "object"
         },
         "InventoryCustomBatchRequest": {
             "id": "InventoryCustomBatchRequest",
             "properties": {
                 "entries": {
                     "description": "The request entries to be processed in the batch.",
                     "items": {
@@ skipping 88 matching lines @@
                     "format": "uint32",
                     "type": "integer"
                 },
                 "salePrice": {
                     "$ref": "Price",
                     "description": "The sale price of the product. Mandatory if sale_price_effective_date is defined."
                 },
                 "salePriceEffectiveDate": {
                     "description": "A date range represented by a pair of ISO 8601 dates separated by a space, comma, or slash. Both dates might be specified as 'null' if undecided.",
                     "type": "string"
+                },
+                "sellOnGoogleQuantity": {
+                    "description": "The quantity of the product that is reserved for sell-on-google ads. Supported only for online products.",
+                    "format": "uint32",
+                    "type": "integer"
                 }
             },
             "type": "object"
         },
         "InventorySetResponse": {
             "id": "InventorySetResponse",
             "properties": {
                 "kind": {
                     "default": "content#inventorySetResponse",
                     "description": "Identifies what kind of resource this is. Value: the fixed string \"content#inventorySetResponse\".",
@@ skipping 332 matching lines @@
                         "type": "string"
                     },
                     "type": "array"
                 },
                 "targetCountry": {
                     "annotations": {
                         "required": [
                             "content.products.insert"
                         ]
                     },
-                    "description": "The two-letter ISO 3166 country code for the item.",
+                    "description": "The CLDR territory code for the item.",
                     "type": "string"
                 },
                 "taxes": {
                     "description": "Tax information.",
                     "items": {
                         "$ref": "ProductTax"
                     },
                     "type": "array"
                 },
                 "title": {
@@ skipping 108 matching lines @@
                     "format": "int64",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "ProductShipping": {
             "id": "ProductShipping",
             "properties": {
                 "country": {
-                    "description": "The two-letter ISO 3166 country code for the country to which an item will ship.",
+                    "description": "The CLDR territory code of the country to which an item will ship.",
                     "type": "string"
                 },
                 "locationGroupName": {
                     "description": "The location where the shipping is applicable, represented by a location group name.",
                     "type": "string"
                 },
                 "locationId": {
                     "description": "The numeric id of a location that the shipping rate applies to as defined in the AdWords API.",
                     "format": "int64",
                     "type": "string"
@@ skipping 150 matching lines @@
                     "description": "Whether the destination is required, excluded, selected by default or should be validated.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "ProductTax": {
             "id": "ProductTax",
             "properties": {
                 "country": {
-                    "description": "The country within which the item is taxed, specified with a two-letter ISO 3166 country code.",
+                    "description": "The country within which the item is taxed, specified as a CLDR territory code.",
                     "type": "string"
                 },
                 "locationId": {
                     "description": "The numeric id of a location that the tax rate applies to as defined in the AdWords API.",
                     "format": "int64",
                     "type": "string"
                 },
                 "postalCode": {
                     "description": "The postal code range that the tax rate applies to, represented by a ZIP code, a ZIP code prefix using * wildcard, a range between two ZIP codes or two ZIP code prefixes of equal length. Examples: 94114, 94*, 94002-95460, 94*-95*.",
                     "type": "string"
@@ skipping 272 matching lines @@
                     "type": "string"
                 }
             },
             "type": "object"
         }
     },
     "servicePath": "content/v2/",
     "title": "Content API for Shopping",
     "version": "v2"
 }