Api-roll 43: 2016-12-13

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": "Manages product items, inventory, and Merchant Center accounts for Google Shopping.",
     "discoveryVersion": "v1",
     "documentationLink": "https://developers.google.com/shopping-content",
-    "etag": "\"C5oy1hgQsABtYOYIOXWcR3BgYqU/3ndj6CrnaIPgtGQaHLaTi2-tP64\"",
+    "etag": "\"tbys6C40o18GZwyMen5GMkdK-3s/VEEyLOh5uQoE1GRmT6bPbJj1uoA\"",
     "icons": {
-        "x16": "http://www.google.com/images/icons/product/search-16.gif",
-        "x32": "http://www.google.com/images/icons/product/search-32.gif"
+        "x16": "https://www.gstatic.com/images/branding/product/1x/googleg_16dp.png",
+        "x32": "https://www.gstatic.com/images/branding/product/1x/googleg_32dp.png"
     },
     "id": "content:v2",
     "kind": "discovery#restDescription",
     "name": "content",
     "ownerDomain": "google.com",
     "ownerName": "Google",
     "parameters": {
         "alt": {
             "default": "json",
             "description": "Data format for the response.",
@@ skipping 70 matching lines @@
                         "$ref": "AccountsCustomBatchRequest"
                     },
                     "response": {
                         "$ref": "AccountsCustomBatchResponse"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/content"
                     ]
                 },
                 "delete": {
-                    "description": "Deletes a Merchant Center sub-account.",
+                    "description": "Deletes a Merchant Center sub-account. This method can only be called for multi-client accounts.",
                     "httpMethod": "DELETE",
                     "id": "content.accounts.delete",
                     "parameterOrder": [
                         "merchantId",
                         "accountId"
                     ],
                     "parameters": {
                         "accountId": {
                             "description": "The ID of the account.",
                             "format": "uint64",
@@ skipping 13 matching lines @@
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{merchantId}/accounts/{accountId}",
                     "scopes": [
                         "https://www.googleapis.com/auth/content"
                     ]
                 },
                 "get": {
-                    "description": "Retrieves a Merchant Center account.",
+                    "description": "Retrieves a Merchant Center account. This method can only be called for accounts to which the managing account has access: either the managing account itself or sub-accounts if the managing account is a multi-client account.",
                     "httpMethod": "GET",
                     "id": "content.accounts.get",
                     "parameterOrder": [
                         "merchantId",
                         "accountId"
                     ],
                     "parameters": {
                         "accountId": {
                             "description": "The ID of the account.",
                             "format": "uint64",
@@ skipping 11 matching lines @@
                     },
                     "path": "{merchantId}/accounts/{accountId}",
                     "response": {
                         "$ref": "Account"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/content"
                     ]
                 },
                 "insert": {
-                    "description": "Creates a Merchant Center sub-account.",
+                    "description": "Creates a Merchant Center sub-account. This method can only be called for multi-client accounts.",
                     "httpMethod": "POST",
                     "id": "content.accounts.insert",
                     "parameterOrder": [
                         "merchantId"
                     ],
                     "parameters": {
                         "dryRun": {
                             "description": "Flag to run the request in dry-run mode.",
                             "location": "query",
                             "type": "boolean"
@@ skipping 11 matching lines @@
                         "$ref": "Account"
                     },
                     "response": {
                         "$ref": "Account"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/content"
                     ]
                 },
                 "list": {
-                    "description": "Lists the sub-accounts in your Merchant Center account.",
+                    "description": "Lists the sub-accounts in your Merchant Center account. This method can only be called for multi-client accounts.",
                     "httpMethod": "GET",
                     "id": "content.accounts.list",
                     "parameterOrder": [
                         "merchantId"
                     ],
                     "parameters": {
                         "maxResults": {
                             "description": "The maximum number of accounts to return in the response, used for paging.",
                             "format": "uint32",
                             "location": "query",
@@ skipping 14 matching lines @@
                     },
                     "path": "{merchantId}/accounts",
                     "response": {
                         "$ref": "AccountsListResponse"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/content"
                     ]
                 },
                 "patch": {
-                    "description": "Updates a Merchant Center account. This method supports patch semantics.",
+                    "description": "Updates a Merchant Center account. This method can only be called for multi-client accounts. This method supports patch semantics.",
                     "httpMethod": "PATCH",
                     "id": "content.accounts.patch",
                     "parameterOrder": [
                         "merchantId",
                         "accountId"
                     ],
                     "parameters": {
                         "accountId": {
                             "description": "The ID of the account.",
                             "format": "uint64",
@@ skipping 19 matching lines @@
                         "$ref": "Account"
                     },
                     "response": {
                         "$ref": "Account"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/content"
                     ]
                 },
                 "update": {
-                    "description": "Updates a Merchant Center account.",
+                    "description": "Updates a Merchant Center account. This method can only be called for multi-client accounts.",
                     "httpMethod": "PUT",
                     "id": "content.accounts.update",
                     "parameterOrder": [
                         "merchantId",
                         "accountId"
                     ],
                     "parameters": {
                         "accountId": {
                             "description": "The ID of the account.",
                             "format": "uint64",
@@ skipping 45 matching lines @@
                         "$ref": "AccountshippingCustomBatchRequest"
                     },
                     "response": {
                         "$ref": "AccountshippingCustomBatchResponse"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/content"
                     ]
                 },
                 "get": {
-                    "description": "Retrieves the shipping settings of the account.",
+                    "description": "Retrieves the shipping settings of the account. This method can only be called for accounts to which the managing account has access: either the managing account itself or sub-accounts if the managing account is a multi-client account.",
                     "httpMethod": "GET",
                     "id": "content.accountshipping.get",
                     "parameterOrder": [
                         "merchantId",
                         "accountId"
                     ],
                     "parameters": {
                         "accountId": {
                             "description": "The ID of the account for which to get/update account shipping settings.",
                             "format": "uint64",
@@ skipping 11 matching lines @@
                     },
                     "path": "{merchantId}/accountshipping/{accountId}",
                     "response": {
                         "$ref": "AccountShipping"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/content"
                     ]
                 },
                 "list": {
-                    "description": "Lists the shipping settings of the sub-accounts in your Merchant Center account.",
+                    "description": "Lists the shipping settings of the sub-accounts in your Merchant Center account. This method can only be called for multi-client accounts.",
                     "httpMethod": "GET",
                     "id": "content.accountshipping.list",
                     "parameterOrder": [
                         "merchantId"
                     ],
                     "parameters": {
                         "maxResults": {
                             "description": "The maximum number of shipping settings to return in the response, used for paging.",
                             "format": "uint32",
                             "location": "query",
@@ skipping 14 matching lines @@
                     },
                     "path": "{merchantId}/accountshipping",
                     "response": {
                         "$ref": "AccountshippingListResponse"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/content"
                     ]
                 },
                 "patch": {
-                    "description": "Updates the shipping settings of the account. This method supports patch semantics.",
+                    "description": "Updates the shipping settings of the account. This method can only be called for accounts to which the managing account has access: either the managing account itself or sub-accounts if the managing account is a multi-client account. This method supports patch semantics.",
                     "httpMethod": "PATCH",
                     "id": "content.accountshipping.patch",
                     "parameterOrder": [
                         "merchantId",
                         "accountId"
                     ],
                     "parameters": {
                         "accountId": {
                             "description": "The ID of the account for which to get/update account shipping settings.",
                             "format": "uint64",
@@ skipping 19 matching lines @@
                         "$ref": "AccountShipping"
                     },
                     "response": {
                         "$ref": "AccountShipping"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/content"
                     ]
                 },
                 "update": {
-                    "description": "Updates the shipping settings of the account.",
+                    "description": "Updates the shipping settings of the account. This method can only be called for accounts to which the managing account has access: either the managing account itself or sub-accounts if the managing account is a multi-client account.",
                     "httpMethod": "PUT",
                     "id": "content.accountshipping.update",
                     "parameterOrder": [
                         "merchantId",
                         "accountId"
                     ],
                     "parameters": {
                         "accountId": {
                             "description": "The ID of the account for which to get/update account shipping settings.",
                             "format": "uint64",
@@ skipping 37 matching lines @@
                         "$ref": "AccountstatusesCustomBatchRequest"
                     },
                     "response": {
                         "$ref": "AccountstatusesCustomBatchResponse"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/content"
                     ]
                 },
                 "get": {
-                    "description": "Retrieves the status of a Merchant Center account.",
+                    "description": "Retrieves the status of a Merchant Center account. This method can only be called for accounts to which the managing account has access: either the managing account itself or sub-accounts if the managing account is a multi-client account.",
                     "httpMethod": "GET",
                     "id": "content.accountstatuses.get",
                     "parameterOrder": [
                         "merchantId",
                         "accountId"
                     ],
                     "parameters": {
                         "accountId": {
                             "description": "The ID of the account.",
                             "format": "uint64",
@@ skipping 11 matching lines @@
                     },
                     "path": "{merchantId}/accountstatuses/{accountId}",
                     "response": {
                         "$ref": "AccountStatus"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/content"
                     ]
                 },
                 "list": {
-                    "description": "Lists the statuses of the sub-accounts in your Merchant Center account.",
+                    "description": "Lists the statuses of the sub-accounts in your Merchant Center account. This method can only be called for multi-client accounts.",
                     "httpMethod": "GET",
                     "id": "content.accountstatuses.list",
                     "parameterOrder": [
                         "merchantId"
                     ],
                     "parameters": {
                         "maxResults": {
                             "description": "The maximum number of account statuses to return in the response, used for paging.",
                             "format": "uint32",
                             "location": "query",
@@ skipping 40 matching lines @@
                         "$ref": "AccounttaxCustomBatchRequest"
                     },
                     "response": {
                         "$ref": "AccounttaxCustomBatchResponse"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/content"
                     ]
                 },
                 "get": {
-                    "description": "Retrieves the tax settings of the account.",
+                    "description": "Retrieves the tax settings of the account. This method can only be called for accounts to which the managing account has access: either the managing account itself or sub-accounts if the managing account is a multi-client account.",
                     "httpMethod": "GET",
                     "id": "content.accounttax.get",
                     "parameterOrder": [
                         "merchantId",
                         "accountId"
                     ],
                     "parameters": {
                         "accountId": {
                             "description": "The ID of the account for which to get/update account tax settings.",
                             "format": "uint64",
@@ skipping 11 matching lines @@
                     },
                     "path": "{merchantId}/accounttax/{accountId}",
                     "response": {
                         "$ref": "AccountTax"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/content"
                     ]
                 },
                 "list": {
-                    "description": "Lists the tax settings of the sub-accounts in your Merchant Center account.",
+                    "description": "Lists the tax settings of the sub-accounts in your Merchant Center account. This method can only be called for multi-client accounts.",
                     "httpMethod": "GET",
                     "id": "content.accounttax.list",
                     "parameterOrder": [
                         "merchantId"
                     ],
                     "parameters": {
                         "maxResults": {
                             "description": "The maximum number of tax settings to return in the response, used for paging.",
                             "format": "uint32",
                             "location": "query",
@@ skipping 14 matching lines @@
                     },
                     "path": "{merchantId}/accounttax",
                     "response": {
                         "$ref": "AccounttaxListResponse"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/content"
                     ]
                 },
                 "patch": {
-                    "description": "Updates the tax settings of the account. This method supports patch semantics.",
+                    "description": "Updates the tax settings of the account. This method can only be called for accounts to which the managing account has access: either the managing account itself or sub-accounts if the managing account is a multi-client account. This method supports patch semantics.",
                     "httpMethod": "PATCH",
                     "id": "content.accounttax.patch",
                     "parameterOrder": [
                         "merchantId",
                         "accountId"
                     ],
                     "parameters": {
                         "accountId": {
                             "description": "The ID of the account for which to get/update account tax settings.",
                             "format": "uint64",
@@ skipping 19 matching lines @@
                         "$ref": "AccountTax"
                     },
                     "response": {
                         "$ref": "AccountTax"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/content"
                     ]
                 },
                 "update": {
-                    "description": "Updates the tax settings of the account.",
+                    "description": "Updates the tax settings of the account. This method can only be called for accounts to which the managing account has access: either the managing account itself or sub-accounts if the managing account is a multi-client account.",
                     "httpMethod": "PUT",
                     "id": "content.accounttax.update",
                     "parameterOrder": [
                         "merchantId",
                         "accountId"
                     ],
                     "parameters": {
                         "accountId": {
                             "description": "The ID of the account for which to get/update account tax settings.",
                             "format": "uint64",
@@ skipping 44 matching lines @@
                         "$ref": "DatafeedsCustomBatchRequest"
                     },
                     "response": {
                         "$ref": "DatafeedsCustomBatchResponse"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/content"
                     ]
                 },
                 "delete": {
-                    "description": "Deletes a datafeed from your Merchant Center account.",
+                    "description": "Deletes a datafeed from your Merchant Center account. This method can only be called for non-multi-client accounts.",
                     "httpMethod": "DELETE",
                     "id": "content.datafeeds.delete",
                     "parameterOrder": [
                         "merchantId",
                         "datafeedId"
                     ],
                     "parameters": {
                         "datafeedId": {
                             "format": "uint64",
                             "location": "path",
@@ skipping 11 matching lines @@
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{merchantId}/datafeeds/{datafeedId}",
                     "scopes": [
                         "https://www.googleapis.com/auth/content"
                     ]
                 },
                 "get": {
-                    "description": "Retrieves a datafeed from your Merchant Center account.",
+                    "description": "Retrieves a datafeed from your Merchant Center account. This method can only be called for non-multi-client accounts.",
                     "httpMethod": "GET",
                     "id": "content.datafeeds.get",
                     "parameterOrder": [
                         "merchantId",
                         "datafeedId"
                     ],
                     "parameters": {
                         "datafeedId": {
                             "format": "uint64",
                             "location": "path",
                             "required": true,
                             "type": "string"
                         },
                         "merchantId": {
                             "format": "uint64",
                             "location": "path",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{merchantId}/datafeeds/{datafeedId}",
                     "response": {
                         "$ref": "Datafeed"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/content"
                     ]
                 },
                 "insert": {
-                    "description": "Registers a datafeed with your Merchant Center account.",
+                    "description": "Registers a datafeed with your Merchant Center account. This method can only be called for non-multi-client accounts.",
                     "httpMethod": "POST",
                     "id": "content.datafeeds.insert",
                     "parameterOrder": [
                         "merchantId"
                     ],
                     "parameters": {
                         "dryRun": {
                             "description": "Flag to run the request in dry-run mode.",
                             "location": "query",
                             "type": "boolean"
@@ skipping 10 matching lines @@
                         "$ref": "Datafeed"
                     },
                     "response": {
                         "$ref": "Datafeed"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/content"
                     ]
                 },
                 "list": {
-                    "description": "Lists the datafeeds in your Merchant Center account.",
+                    "description": "Lists the datafeeds in your Merchant Center account. This method can only be called for non-multi-client accounts.",
                     "httpMethod": "GET",
                     "id": "content.datafeeds.list",
                     "parameterOrder": [
                         "merchantId"
                     ],
                     "parameters": {
                         "maxResults": {
                             "description": "The maximum number of products to return in the response, used for paging.",
                             "format": "uint32",
                             "location": "query",
@@ skipping 14 matching lines @@
                     },
                     "path": "{merchantId}/datafeeds",
                     "response": {
                         "$ref": "DatafeedsListResponse"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/content"
                     ]
                 },
                 "patch": {
-                    "description": "Updates a datafeed of your Merchant Center account. This method supports patch semantics.",
+                    "description": "Updates a datafeed of your Merchant Center account. This method can only be called for non-multi-client accounts. This method supports patch semantics.",
                     "httpMethod": "PATCH",
                     "id": "content.datafeeds.patch",
                     "parameterOrder": [
                         "merchantId",
                         "datafeedId"
                     ],
                     "parameters": {
                         "datafeedId": {
                             "format": "uint64",
                             "location": "path",
@@ skipping 17 matching lines @@
                         "$ref": "Datafeed"
                     },
                     "response": {
                         "$ref": "Datafeed"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/content"
                     ]
                 },
                 "update": {
-                    "description": "Updates a datafeed of your Merchant Center account.",
+                    "description": "Updates a datafeed of your Merchant Center account. This method can only be called for non-multi-client accounts.",
                     "httpMethod": "PUT",
                     "id": "content.datafeeds.update",
                     "parameterOrder": [
                         "merchantId",
                         "datafeedId"
                     ],
                     "parameters": {
                         "datafeedId": {
                             "format": "uint64",
                             "location": "path",
@@ skipping 35 matching lines @@
                         "$ref": "DatafeedstatusesCustomBatchRequest"
                     },
                     "response": {
                         "$ref": "DatafeedstatusesCustomBatchResponse"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/content"
                     ]
                 },
                 "get": {
-                    "description": "Retrieves the status of a datafeed from your Merchant Center account.",
+                    "description": "Retrieves the status of a datafeed from your Merchant Center account. This method can only be called for non-multi-client accounts.",
                     "httpMethod": "GET",
                     "id": "content.datafeedstatuses.get",
                     "parameterOrder": [
                         "merchantId",
                         "datafeedId"
                     ],
                     "parameters": {
                         "datafeedId": {
                             "format": "uint64",
                             "location": "path",
                             "required": true,
                             "type": "string"
                         },
                         "merchantId": {
                             "format": "uint64",
                             "location": "path",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{merchantId}/datafeedstatuses/{datafeedId}",
                     "response": {
                         "$ref": "DatafeedStatus"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/content"
                     ]
                 },
                 "list": {
-                    "description": "Lists the statuses of the datafeeds in your Merchant Center account.",
+                    "description": "Lists the statuses of the datafeeds in your Merchant Center account. This method can only be called for non-multi-client accounts.",
                     "httpMethod": "GET",
                     "id": "content.datafeedstatuses.list",
                     "parameterOrder": [
                         "merchantId"
                     ],
                     "parameters": {
                         "maxResults": {
                             "description": "The maximum number of products to return in the response, used for paging.",
                             "format": "uint32",
                             "location": "query",
@@ skipping 18 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. This operation does not update the expiration date of the products.",
+                    "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. This method can only be called for non-multi-client accounts.",
                     "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. This operation does not update the expiration date of the product.",
+                    "description": "Updates price and availability of a product in your Merchant Center account. This operation does not update the expiration date of the product. This method can only be called for non-multi-client accounts.",
                     "httpMethod": "POST",
                     "id": "content.inventory.set",
                     "parameterOrder": [
                         "merchantId",
                         "storeCode",
                         "productId"
                     ],
                     "parameters": {
                         "dryRun": {
                             "description": "Flag to run the request in dry-run mode.",
@@ skipping 29 matching lines @@
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/content"
                     ]
                 }
             }
         },
         "orders": {
             "methods": {
                 "acknowledge": {
-                    "description": "Marks an order as acknowledged.",
+                    "description": "Marks an order as acknowledged. This method can only be called for non-multi-client accounts.",
                     "httpMethod": "POST",
                     "id": "content.orders.acknowledge",
                     "parameterOrder": [
                         "merchantId",
                         "orderId"
                     ],
                     "parameters": {
                         "merchantId": {
                             "description": "The ID of the managing account.",
                             "format": "uint64",
@@ skipping 13 matching lines @@
                         "$ref": "OrdersAcknowledgeRequest"
                     },
                     "response": {
                         "$ref": "OrdersAcknowledgeResponse"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/content"
                     ]
                 },
                 "advancetestorder": {
-                    "description": "Sandbox only. Moves a test order from state \"inProgress\" to state \"pendingShipment\".",
+                    "description": "Sandbox only. Moves a test order from state \"inProgress\" to state \"pendingShipment\". This method can only be called for non-multi-client accounts.",
                     "httpMethod": "POST",
                     "id": "content.orders.advancetestorder",
                     "parameterOrder": [
                         "merchantId",
                         "orderId"
                     ],
                     "parameters": {
                         "merchantId": {
                             "description": "The ID of the managing account.",
                             "format": "uint64",
@@ skipping 10 matching lines @@
                     },
                     "path": "{merchantId}/testorders/{orderId}/advance",
                     "response": {
                         "$ref": "OrdersAdvanceTestOrderResponse"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/content"
                     ]
                 },
                 "cancel": {
-                    "description": "Cancels all line items in an order.",
+                    "description": "Cancels all line items in an order. This method can only be called for non-multi-client accounts.",
                     "httpMethod": "POST",
                     "id": "content.orders.cancel",
                     "parameterOrder": [
                         "merchantId",
                         "orderId"
                     ],
                     "parameters": {
                         "merchantId": {
                             "description": "The ID of the managing account.",
                             "format": "uint64",
@@ skipping 13 matching lines @@
                         "$ref": "OrdersCancelRequest"
                     },
                     "response": {
                         "$ref": "OrdersCancelResponse"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/content"
                     ]
                 },
                 "cancellineitem": {
-                    "description": "Cancels a line item.",
+                    "description": "Cancels a line item. This method can only be called for non-multi-client accounts.",
                     "httpMethod": "POST",
                     "id": "content.orders.cancellineitem",
                     "parameterOrder": [
                         "merchantId",
                         "orderId"
                     ],
                     "parameters": {
                         "merchantId": {
                             "description": "The ID of the managing account.",
                             "format": "uint64",
@@ skipping 13 matching lines @@
                         "$ref": "OrdersCancelLineItemRequest"
                     },
                     "response": {
                         "$ref": "OrdersCancelLineItemResponse"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/content"
                     ]
                 },
                 "createtestorder": {
-                    "description": "Sandbox only. Creates a test order.",
+                    "description": "Sandbox only. Creates a test order. This method can only be called for non-multi-client accounts.",
                     "httpMethod": "POST",
                     "id": "content.orders.createtestorder",
                     "parameterOrder": [
                         "merchantId"
                     ],
                     "parameters": {
                         "merchantId": {
                             "description": "The ID of the managing account.",
                             "format": "uint64",
                             "location": "path",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{merchantId}/testorders",
                     "request": {
                         "$ref": "OrdersCreateTestOrderRequest"
                     },
                     "response": {
                         "$ref": "OrdersCreateTestOrderResponse"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/content"
                     ]
                 },
                 "custombatch": {
-                    "description": "Retrieves or modifies multiple orders in a single request.",
+                    "description": "Retrieves or modifies multiple orders in a single request. This method can only be called for non-multi-client accounts.",
                     "httpMethod": "POST",
                     "id": "content.orders.custombatch",
                     "path": "orders/batch",
                     "request": {
                         "$ref": "OrdersCustomBatchRequest"
                     },
                     "response": {
                         "$ref": "OrdersCustomBatchResponse"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/content"
                     ]
                 },
                 "get": {
-                    "description": "Retrieves an order from your Merchant Center account.",
+                    "description": "Retrieves an order from your Merchant Center account. This method can only be called for non-multi-client accounts.",
                     "httpMethod": "GET",
                     "id": "content.orders.get",
                     "parameterOrder": [
                         "merchantId",
                         "orderId"
                     ],
                     "parameters": {
                         "merchantId": {
                             "description": "The ID of the managing account.",
                             "format": "uint64",
@@ skipping 10 matching lines @@
                     },
                     "path": "{merchantId}/orders/{orderId}",
                     "response": {
                         "$ref": "Order"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/content"
                     ]
                 },
                 "getbymerchantorderid": {
-                    "description": "Retrieves an order using merchant order id.",
+                    "description": "Retrieves an order using merchant order id. This method can only be called for non-multi-client accounts.",
                     "httpMethod": "GET",
                     "id": "content.orders.getbymerchantorderid",
                     "parameterOrder": [
                         "merchantId",
                         "merchantOrderId"
                     ],
                     "parameters": {
                         "merchantId": {
                             "description": "The ID of the managing account.",
                             "format": "uint64",
@@ skipping 10 matching lines @@
                     },
                     "path": "{merchantId}/ordersbymerchantid/{merchantOrderId}",
                     "response": {
                         "$ref": "OrdersGetByMerchantOrderIdResponse"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/content"
                     ]
                 },
                 "gettestordertemplate": {
-                    "description": "Sandbox only. Retrieves an order template that can be used to quickly create a new order in sandbox.",
+                    "description": "Sandbox only. Retrieves an order template that can be used to quickly create a new order in sandbox. This method can only be called for non-multi-client accounts.",
                     "httpMethod": "GET",
                     "id": "content.orders.gettestordertemplate",
                     "parameterOrder": [
                         "merchantId",
                         "templateName"
                     ],
                     "parameters": {
                         "merchantId": {
                             "description": "The ID of the managing account.",
                             "format": "uint64",
@@ skipping 22 matching lines @@
                     },
                     "path": "{merchantId}/testordertemplates/{templateName}",
                     "response": {
                         "$ref": "OrdersGetTestOrderTemplateResponse"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/content"
                     ]
                 },
                 "list": {
-                    "description": "Lists the orders in your Merchant Center account.",
+                    "description": "Lists the orders in your Merchant Center account. This method can only be called for non-multi-client accounts.",
                     "httpMethod": "GET",
                     "id": "content.orders.list",
                     "parameterOrder": [
                         "merchantId"
                     ],
                     "parameters": {
                         "acknowledged": {
                             "description": "Obtains orders that match the acknowledgement status. When set to true, obtains orders that have been acknowledged. When false, obtains orders that have not been acknowledged.\nWe recommend using this filter set to false, in conjunction with the acknowledge call, such that only un-acknowledged orders are returned.",
                             "location": "query",
                             "type": "boolean"
@@ skipping 74 matching lines @@
                     },
                     "path": "{merchantId}/orders",
                     "response": {
                         "$ref": "OrdersListResponse"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/content"
                     ]
                 },
                 "refund": {
-                    "description": "Refund a portion of the order, up to the full amount paid.",
+                    "description": "Refund a portion of the order, up to the full amount paid. This method can only be called for non-multi-client accounts.",
                     "httpMethod": "POST",
                     "id": "content.orders.refund",
                     "parameterOrder": [
                         "merchantId",
                         "orderId"
                     ],
                     "parameters": {
                         "merchantId": {
                             "description": "The ID of the managing account.",
                             "format": "uint64",
@@ skipping 13 matching lines @@
                         "$ref": "OrdersRefundRequest"
                     },
                     "response": {
                         "$ref": "OrdersRefundResponse"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/content"
                     ]
                 },
                 "returnlineitem": {
-                    "description": "Returns a line item.",
+                    "description": "Returns a line item. This method can only be called for non-multi-client accounts.",
                     "httpMethod": "POST",
                     "id": "content.orders.returnlineitem",
                     "parameterOrder": [
                         "merchantId",
                         "orderId"
                     ],
                     "parameters": {
                         "merchantId": {
                             "description": "The ID of the managing account.",
                             "format": "uint64",
@@ skipping 13 matching lines @@
                         "$ref": "OrdersReturnLineItemRequest"
                     },
                     "response": {
                         "$ref": "OrdersReturnLineItemResponse"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/content"
                     ]
                 },
                 "shiplineitems": {
-                    "description": "Marks line item(s) as shipped.",
+                    "description": "Marks line item(s) as shipped. This method can only be called for non-multi-client accounts.",
                     "httpMethod": "POST",
                     "id": "content.orders.shiplineitems",
                     "parameterOrder": [
                         "merchantId",
                         "orderId"
                     ],
                     "parameters": {
                         "merchantId": {
                             "description": "The ID of the managing account.",
                             "format": "uint64",
@@ skipping 13 matching lines @@
                         "$ref": "OrdersShipLineItemsRequest"
                     },
                     "response": {
                         "$ref": "OrdersShipLineItemsResponse"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/content"
                     ]
                 },
                 "updatemerchantorderid": {
-                    "description": "Updates the merchant order ID for a given order.",
+                    "description": "Updates the merchant order ID for a given order. This method can only be called for non-multi-client accounts.",
                     "httpMethod": "POST",
                     "id": "content.orders.updatemerchantorderid",
                     "parameterOrder": [
                         "merchantId",
                         "orderId"
                     ],
                     "parameters": {
                         "merchantId": {
                             "description": "The ID of the managing account.",
                             "format": "uint64",
@@ skipping 13 matching lines @@
                         "$ref": "OrdersUpdateMerchantOrderIdRequest"
                     },
                     "response": {
                         "$ref": "OrdersUpdateMerchantOrderIdResponse"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/content"
                     ]
                 },
                 "updateshipment": {
-                    "description": "Updates a shipment's status, carrier, and/or tracking ID.",
+                    "description": "Updates a shipment's status, carrier, and/or tracking ID. This method can only be called for non-multi-client accounts.",
                     "httpMethod": "POST",
                     "id": "content.orders.updateshipment",
                     "parameterOrder": [
                         "merchantId",
                         "orderId"
                     ],
                     "parameters": {
                         "merchantId": {
                             "description": "The ID of the managing account.",
                             "format": "uint64",
@@ skipping 17 matching lines @@
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/content"
                     ]
                 }
             }
         },
         "products": {
             "methods": {
                 "custombatch": {
-                    "description": "Retrieves, inserts, and deletes multiple products in a single request.",
+                    "description": "Retrieves, inserts, and deletes multiple products in a single request. This method can only be called for non-multi-client accounts.",
                     "httpMethod": "POST",
                     "id": "content.products.custombatch",
                     "parameters": {
                         "dryRun": {
                             "description": "Flag to run the request in dry-run mode.",
                             "location": "query",
                             "type": "boolean"
                         }
                     },
                     "path": "products/batch",
                     "request": {
                         "$ref": "ProductsCustomBatchRequest"
                     },
                     "response": {
                         "$ref": "ProductsCustomBatchResponse"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/content"
                     ]
                 },
                 "delete": {
-                    "description": "Deletes a product from your Merchant Center account.",
+                    "description": "Deletes a product from your Merchant Center account. This method can only be called for non-multi-client accounts.",
                     "httpMethod": "DELETE",
                     "id": "content.products.delete",
                     "parameterOrder": [
                         "merchantId",
                         "productId"
                     ],
                     "parameters": {
                         "dryRun": {
                             "description": "Flag to run the request in dry-run mode.",
                             "location": "query",
@@ skipping 12 matching lines @@
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "{merchantId}/products/{productId}",
                     "scopes": [
                         "https://www.googleapis.com/auth/content"
                     ]
                 },
                 "get": {
-                    "description": "Retrieves a product from your Merchant Center account.",
+                    "description": "Retrieves a product from your Merchant Center account. This method can only be called for non-multi-client accounts.",
                     "httpMethod": "GET",
                     "id": "content.products.get",
                     "parameterOrder": [
                         "merchantId",
                         "productId"
                     ],
                     "parameters": {
                         "merchantId": {
                             "description": "The ID of the managing account.",
                             "format": "uint64",
@@ skipping 10 matching lines @@
                     },
                     "path": "{merchantId}/products/{productId}",
                     "response": {
                         "$ref": "Product"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/content"
                     ]
                 },
                 "insert": {
-                    "description": "Uploads a product to your Merchant Center account.",
+                    "description": "Uploads a product to your Merchant Center account. If an item with the same channel, contentLanguage, offerId, and targetCountry already exists, this method updates that entry. This method can only be called for non-multi-client accounts.",
                     "httpMethod": "POST",
                     "id": "content.products.insert",
                     "parameterOrder": [
                         "merchantId"
                     ],
                     "parameters": {
                         "dryRun": {
                             "description": "Flag to run the request in dry-run mode.",
                             "location": "query",
                             "type": "boolean"
@@ skipping 11 matching lines @@
                         "$ref": "Product"
                     },
                     "response": {
                         "$ref": "Product"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/content"
                     ]
                 },
                 "list": {
-                    "description": "Lists the products in your Merchant Center account.",
+                    "description": "Lists the products in your Merchant Center account. This method can only be called for non-multi-client accounts.",
                     "httpMethod": "GET",
                     "id": "content.products.list",
                     "parameterOrder": [
                         "merchantId"
                     ],
                     "parameters": {
                         "includeInvalidInsertedItems": {
                             "description": "Flag to include the invalid inserted items in the result of the list request. By default the invalid items are not shown (the default value is false).",
                             "location": "query",
                             "type": "boolean"
@@ skipping 23 matching lines @@
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/content"
                     ]
                 }
             }
         },
         "productstatuses": {
             "methods": {
                 "custombatch": {
-                    "description": "Gets the statuses of multiple products in a single request.",
+                    "description": "Gets the statuses of multiple products in a single request. This method can only be called for non-multi-client accounts.",
                     "httpMethod": "POST",
                     "id": "content.productstatuses.custombatch",
                     "path": "productstatuses/batch",
                     "request": {
                         "$ref": "ProductstatusesCustomBatchRequest"
                     },
                     "response": {
                         "$ref": "ProductstatusesCustomBatchResponse"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/content"
                     ]
                 },
                 "get": {
-                    "description": "Gets the status of a product from your Merchant Center account.",
+                    "description": "Gets the status of a product from your Merchant Center account. This method can only be called for non-multi-client accounts.",
                     "httpMethod": "GET",
                     "id": "content.productstatuses.get",
                     "parameterOrder": [
                         "merchantId",
                         "productId"
                     ],
                     "parameters": {
                         "merchantId": {
                             "description": "The ID of the managing account.",
                             "format": "uint64",
@@ skipping 10 matching lines @@
                     },
                     "path": "{merchantId}/productstatuses/{productId}",
                     "response": {
                         "$ref": "ProductStatus"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/content"
                     ]
                 },
                 "list": {
-                    "description": "Lists the statuses of the products in your Merchant Center account.",
+                    "description": "Lists the statuses of the products in your Merchant Center account. This method can only be called for non-multi-client accounts.",
                     "httpMethod": "GET",
                     "id": "content.productstatuses.list",
                     "parameterOrder": [
                         "merchantId"
                     ],
                     "parameters": {
                         "includeInvalidInsertedItems": {
                             "description": "Flag to include the invalid inserted items in the result of the list request. By default the invalid items are not shown (the default value is false).",
                             "location": "query",
                             "type": "boolean"
@@ skipping 45 matching lines @@
                         "$ref": "ShippingsettingsCustomBatchRequest"
                     },
                     "response": {
                         "$ref": "ShippingsettingsCustomBatchResponse"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/content"
                     ]
                 },
                 "get": {
-                    "description": "Retrieves the shipping settings of the account.",
+                    "description": "Retrieves the shipping settings of the account. This method can only be called for accounts to which the managing account has access: either the managing account itself or sub-accounts if the managing account is a multi-client account.",
                     "httpMethod": "GET",
                     "id": "content.shippingsettings.get",
                     "parameterOrder": [
                         "merchantId",
                         "accountId"
                     ],
                     "parameters": {
                         "accountId": {
                             "description": "The ID of the account for which to get/update shipping settings.",
                             "format": "uint64",
@@ skipping 35 matching lines @@
                     },
                     "path": "{merchantId}/supportedCarriers",
                     "response": {
                         "$ref": "ShippingsettingsGetSupportedCarriersResponse"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/content"
                     ]
                 },
                 "list": {
-                    "description": "Lists the shipping settings of the sub-accounts in your Merchant Center account.",
+                    "description": "Lists the shipping settings of the sub-accounts in your Merchant Center account. This method can only be called for multi-client accounts.",
                     "httpMethod": "GET",
                     "id": "content.shippingsettings.list",
                     "parameterOrder": [
                         "merchantId"
                     ],
                     "parameters": {
                         "maxResults": {
                             "description": "The maximum number of shipping settings to return in the response, used for paging.",
                             "format": "uint32",
                             "location": "query",
@@ skipping 14 matching lines @@
                     },
                     "path": "{merchantId}/shippingsettings",
                     "response": {
                         "$ref": "ShippingsettingsListResponse"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/content"
                     ]
                 },
                 "patch": {
-                    "description": "Updates the shipping settings of the account. This method supports patch semantics.",
+                    "description": "Updates the shipping settings of the account. This method can only be called for accounts to which the managing account has access: either the managing account itself or sub-accounts if the managing account is a multi-client account. This method supports patch semantics.",
                     "httpMethod": "PATCH",
                     "id": "content.shippingsettings.patch",
                     "parameterOrder": [
                         "merchantId",
                         "accountId"
                     ],
                     "parameters": {
                         "accountId": {
                             "description": "The ID of the account for which to get/update shipping settings.",
                             "format": "uint64",
@@ skipping 19 matching lines @@
                         "$ref": "ShippingSettings"
                     },
                     "response": {
                         "$ref": "ShippingSettings"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/content"
                     ]
                 },
                 "update": {
-                    "description": "Updates the shipping settings of the account.",
+                    "description": "Updates the shipping settings of the account. This method can only be called for accounts to which the managing account has access: either the managing account itself or sub-accounts if the managing account is a multi-client account.",
                     "httpMethod": "PUT",
                     "id": "content.shippingsettings.update",
                     "parameterOrder": [
                         "merchantId",
                         "accountId"
                     ],
                     "parameters": {
                         "accountId": {
                             "description": "The ID of the account for which to get/update shipping settings.",
                             "format": "uint64",
@@ skipping 21 matching lines @@
                     "response": {
                         "$ref": "ShippingSettings"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/content"
                     ]
                 }
             }
         }
     },
-    "revision": "20161027",
+    "revision": "20161205",
     "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 2060 matching lines @@
             "type": "object"
         },
         "OrderCustomer": {
             "id": "OrderCustomer",
             "properties": {
                 "email": {
                     "description": "Email address of the customer.",
                     "type": "string"
                 },
                 "explicitMarketingPreference": {
-                    "description": "If set, this indicates the user explicitly chose to opt in or out of providing marketing rights to the merchant. If unset, this indicates the user has already made this choice in a previous purchase, and was thus not shown the marketing right opt in/out checkbox during the Purchases on Google checkout flow.",
+                    "description": "If set, this indicates the user explicitly chose to opt in or out of providing marketing rights to the merchant. If unset, this indicates the user has already made this choice in a previous purchase, and was thus not shown the marketing right opt in/out checkbox during the checkout flow.",
                     "type": "boolean"
                 },
                 "fullName": {
                     "description": "Full name of the customer.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "OrderDeliveryDetails": {
@@ skipping 2368 matching lines @@
                 "email": {
                     "annotations": {
                         "required": [
                             "content.orders.createtestorder"
                         ]
                     },
                     "description": "Email address of the customer.",
                     "type": "string"
                 },
                 "explicitMarketingPreference": {
-                    "description": "If set, this indicates the user explicitly chose to opt in or out of providing marketing rights to the merchant. If unset, this indicates the user has already made this choice in a previous purchase, and was thus not shown the marketing right opt in/out checkbox during the Purchases on Google checkout flow. Optional.",
+                    "description": "If set, this indicates the user explicitly chose to opt in or out of providing marketing rights to the merchant. If unset, this indicates the user has already made this choice in a previous purchase, and was thus not shown the marketing right opt in/out checkbox during the checkout flow. Optional.",
                     "type": "boolean"
                 },
                 "fullName": {
                     "description": "Full name of the customer.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "TestOrderLineItem": {
@@ skipping 226 matching lines @@
                     "type": "string"
                 }
             },
             "type": "object"
         }
     },
     "servicePath": "content/v2/",
     "title": "Content API for Shopping",
     "version": "v2"
 }