Api-roll 43: 2016-12-13

discovery/googleapis/content__v2sandbox.json

 {
     "auth": {
         "oauth2": {
             "scopes": {
                 "https://www.googleapis.com/auth/content": {
                     "description": "Manage your product listings and accounts for Google Shopping"
                 }
             }
         }
     },
     "basePath": "/content/v2sandbox/",
     "baseUrl": "https://www.googleapis.com/content/v2sandbox/",
     "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/pwuIwH6if72qJQNYjyHHHlGz_Mo\"",
+    "etag": "\"tbys6C40o18GZwyMen5GMkdK-3s/W1AQ-5FwbPweFAs-GFJ9Ju07xes\"",
     "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:v2sandbox",
     "kind": "discovery#restDescription",
     "name": "content",
     "ownerDomain": "google.com",
     "ownerName": "Google",
     "parameters": {
         "alt": {
             "default": "json",
             "description": "Data format for the response.",
@@ skipping 36 matching lines @@
             "description": "IP address of the site where the request originates. Use this if you want to enforce per-user limits.",
             "location": "query",
             "type": "string"
         }
     },
     "protocol": "rest",
     "resources": {
         "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 15 matching lines @@
                     "response": {
                         "$ref": "OrdersUpdateShipmentResponse"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/content"
                     ]
                 }
             }
         }
     },
-    "revision": "20161027",
+    "revision": "20161205",
     "rootUrl": "https://www.googleapis.com/",
     "schemas": {
         "Error": {
             "description": "An error returned by the API.",
             "id": "Error",
             "properties": {
                 "domain": {
                     "description": "The domain of the error.",
                     "type": "string"
                 },
@@ skipping 202 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 1206 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 175 matching lines @@
                     "type": "string"
                 }
             },
             "type": "object"
         }
     },
     "servicePath": "content/v2sandbox/",
     "title": "Content API for Shopping",
     "version": "v2sandbox"
 }