chore(api-update): to latest

Using `make update-json`, all json descriptions have been update.
Quite interesting to see that there are plenty of new ones which
are giving 404 when queried. An actual bug, or something I should
look into ?
This commit is contained in:
Sebastian Thiel
2016-09-11 10:00:21 +02:00
parent 33771a6dc7
commit 13ed4eaecb
148 changed files with 84357 additions and 3237 deletions

View File

@@ -1,12 +1,12 @@
{
"kind": "discovery#restDescription",
"etag": "\"bRFOOrZKfO9LweMbPqu0kcu6De8/2jCRejD7TwMcZrBmt-AfB92UN1E\"",
"etag": "\"C5oy1hgQsABtYOYIOXWcR3BgYqU/KYk0P4hLurettj7gPX6wNnI67WQ\"",
"discoveryVersion": "v1",
"id": "content:v2",
"name": "content",
"canonicalName": "Shopping Content",
"version": "v2",
"revision": "20160331",
"revision": "20160905",
"title": "Content API for Shopping",
"description": "Manages product items, inventory, and Merchant Center accounts for Google Shopping.",
"ownerDomain": "google.com",
@@ -455,6 +455,16 @@
"$ref": "AccountShippingShippingServiceCostRule",
"description": "Decision tree for \"complicated\" shipping cost calculation."
},
"maxDaysInTransit": {
"type": "string",
"description": "The maximum number of days in transit. Must be a value between 0 and 250 included. A value of 0 means same day delivery.",
"format": "uint64"
},
"minDaysInTransit": {
"type": "string",
"description": "The minimum number of days in transit. Must be a value between 0 and maxDaysIntransit included. A value of 0 means same day delivery.",
"format": "uint64"
},
"name": {
"type": "string",
"description": "The name of this shipping service.",
@@ -1126,6 +1136,57 @@
}
}
},
"CarrierRate": {
"id": "CarrierRate",
"type": "object",
"properties": {
"carrierName": {
"type": "string",
"description": "Carrier service, such as \"UPS\" or \"Fedex\". The list of supported carriers can be retrieved via the getSupportedCarriers method. Required."
},
"carrierService": {
"type": "string",
"description": "Carrier service, such as \"ground\" or \"2 days\". The list of supported services for a carrier can be retrieved via the getSupportedCarriers method. Required."
},
"flatAdjustment": {
"$ref": "Price",
"description": "Additive shipping rate modifier. Can be negative. For example { \"value\": \"1\", \"currency\" : \"USD\" } adds $1 to the rate, { \"value\": \"-3\", \"currency\" : \"USD\" } removes $3 from the rate. Optional."
},
"name": {
"type": "string",
"description": "Name of the carrier rate. Must be unique per rate group. Required."
},
"originPostalCode": {
"type": "string",
"description": "Shipping origin for this carrier rate. Required."
},
"percentageAdjustment": {
"type": "string",
"description": "Multiplicative shipping rate modifier as a number in decimal notation. Can be negative. For example \"5.4\" increases the rate by 5.4%, \"-3\" decreases the rate by 3%. Optional."
}
}
},
"CarriersCarrier": {
"id": "CarriersCarrier",
"type": "object",
"properties": {
"country": {
"type": "string",
"description": "The CLDR country code of the carrier (e.g., \"US\"). Always present."
},
"name": {
"type": "string",
"description": "The name of the carrier (e.g., \"UPS\"). Always present."
},
"services": {
"type": "array",
"description": "A list of supported services (e.g., \"ground\") for that carrier. Contains at least one service.",
"items": {
"type": "string"
}
}
}
},
"Datafeed": {
"id": "Datafeed",
"type": "object",
@@ -1569,6 +1630,22 @@
}
}
},
"DeliveryTime": {
"id": "DeliveryTime",
"type": "object",
"properties": {
"maxTransitTimeInDays": {
"type": "integer",
"description": "Maximum number of business days that is spent in transit. 0 means same day delivery, 1 means next day delivery. Must be greater than or equal to minTransitTimeInDays. Required.",
"format": "uint32"
},
"minTransitTimeInDays": {
"type": "integer",
"description": "Minimum number of business days that is spent in transit. 0 means same day delivery, 1 means next day delivery. Required.",
"format": "uint32"
}
}
},
"Error": {
"id": "Error",
"type": "object",
@@ -1611,6 +1688,48 @@
}
}
},
"Headers": {
"id": "Headers",
"type": "object",
"description": "A non-empty list of row or column headers for a table. Exactly one of prices, weights, numItems, postalCodeGroupNames, or locations must be set.",
"properties": {
"locations": {
"type": "array",
"description": "A list of location ID sets. Must be non-empty. Can only be set if all other fields are not set.",
"items": {
"$ref": "LocationIdSet"
}
},
"numberOfItems": {
"type": "array",
"description": "A list of inclusive number of items upper bounds. The last value can be \"infinity\". For example [\"10\", \"50\", \"infinity\"] represents the headers \"\u003c= 10 items\", \" 50 items\". Must be non-empty. Can only be set if all other fields are not set.",
"items": {
"type": "string"
}
},
"postalCodeGroupNames": {
"type": "array",
"description": "A list of postal group names. The last value can be \"all other locations\". Example: [\"zone 1\", \"zone 2\", \"all other locations\"]. The referred postal code groups must match the delivery country of the service. Must be non-empty. Can only be set if all other fields are not set.",
"items": {
"type": "string"
}
},
"prices": {
"type": "array",
"description": "be \"infinity\". For example [{\"value\": \"10\", \"currency\": \"USD\"}, {\"value\": \"500\", \"currency\": \"USD\"}, {\"value\": \"infinity\", \"currency\": \"USD\"}] represents the headers \"\u003c= $10\", \" $500\". All prices within a service must have the same currency. Must be non-empty. Can only be set if all other fields are not set.",
"items": {
"$ref": "Price"
}
},
"weights": {
"type": "array",
"description": "be \"infinity\". For example [{\"value\": \"10\", \"unit\": \"kg\"}, {\"value\": \"50\", \"unit\": \"kg\"}, {\"value\": \"infinity\", \"unit\": \"kg\"}] represents the headers \"\u003c= 10kg\", \" 50kg\". All weights within a service must have the same unit. Must be non-empty. Can only be set if all other fields are not set.",
"items": {
"$ref": "Weight"
}
}
}
},
"Installment": {
"id": "Installment",
"type": "object",
@@ -1803,6 +1922,19 @@
}
}
},
"LocationIdSet": {
"id": "LocationIdSet",
"type": "object",
"properties": {
"locationIds": {
"type": "array",
"description": "A non-empty list of location IDs. They must all be of the same location type (e.g., state).",
"items": {
"type": "string"
}
}
}
},
"LoyaltyPoints": {
"id": "LoyaltyPoints",
"type": "object",
@@ -1831,6 +1963,10 @@
"type": "boolean",
"description": "Whether the order was acknowledged."
},
"channelType": {
"type": "string",
"description": "The channel type of the order: \"purchaseOnGoogle\" or \"googleExpress\"."
},
"customer": {
"$ref": "OrderCustomer",
"description": "The details of the customer who placed the order."
@@ -1981,7 +2117,7 @@
},
"reason": {
"type": "string",
"description": "The reason for the cancellation."
"description": "The reason for the cancellation. Orders that are cancelled with a noInventory reason will lead to the removal of the product from POG until you make an update to that product. This will not affect your Shopping ads."
},
"reasonText": {
"type": "string",
@@ -1999,7 +2135,7 @@
},
"explicitMarketingPreference": {
"type": "boolean",
"description": "If set, this indicates the user had a choice 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 Purchases on Google checkout flow."
},
"fullName": {
"type": "string",
@@ -3118,6 +3254,41 @@
}
}
},
"PostalCodeGroup": {
"id": "PostalCodeGroup",
"type": "object",
"properties": {
"country": {
"type": "string",
"description": "The CLDR territory code of the country the postal code group applies to. Required."
},
"name": {
"type": "string",
"description": "The name of the postal code group, referred to in headers. Required."
},
"postalCodeRanges": {
"type": "array",
"description": "A range of postal codes. Required.",
"items": {
"$ref": "PostalCodeRange"
}
}
}
},
"PostalCodeRange": {
"id": "PostalCodeRange",
"type": "object",
"properties": {
"postalCodeRangeBegin": {
"type": "string",
"description": "A postal code or a pattern of the form prefix* denoting the inclusive lower bound of the range defining the area. Examples values: \"94108\", \"9410*\", \"9*\". Required."
},
"postalCodeRangeEnd": {
"type": "string",
"description": "A postal code or a pattern of the form prefix* denoting the inclusive upper bound of the range defining the area. It must have the same length as postalCodeRangeBegin: if postalCodeRangeBegin is a postal code then postalCodeRangeEnd must be a postal code too; if postalCodeRangeBegin is a pattern then postalCodeRangeEnd must be a pattern with the same prefix length. Optional: if not set, then the area is defined as being all the postal codes matching postalCodeRangeBegin."
}
}
},
"Price": {
"id": "Price",
"type": "object",
@@ -3144,6 +3315,13 @@
"type": "string"
}
},
"additionalProductTypes": {
"type": "array",
"description": "Additional categories of the item (formatted as in products feed specification).",
"items": {
"type": "string"
}
},
"adult": {
"type": "boolean",
"description": "Set to true if the item is targeted towards adults."
@@ -3357,7 +3535,7 @@
},
"offerId": {
"type": "string",
"description": "An identifier of the item.",
"description": "An identifier of the item. Leading and trailing whitespaces are stripped and multiple whitespaces are replaced by a single whitespace upon submission. Only valid unicode characters are accepted. See the products feed specification for details.",
"annotations": {
"required": [
"content.products.insert"
@@ -3378,7 +3556,7 @@
},
"productType": {
"type": "string",
"description": "Your category of the item (formatted as in product feeds specification)."
"description": "Your category of the item (formatted as in products feed specification)."
},
"promotionIds": {
"type": "array",
@@ -3393,7 +3571,7 @@
},
"salePriceEffectiveDate": {
"type": "string",
"description": "Date range during which the item is on sale (see product feed specifications)."
"description": "Date range during which the item is on sale (see products feed specification)."
},
"sellOnGoogleQuantity": {
"type": "string",
@@ -3996,6 +4174,262 @@
}
}
},
"RateGroup": {
"id": "RateGroup",
"type": "object",
"properties": {
"applicableShippingLabels": {
"type": "array",
"description": "A list of shipping labels defining the products to which this rate group applies to. This is a disjunction: only one of the labels has to match for the rate group to apply. May only be empty for the last rate group of a service. Required.",
"items": {
"type": "string"
}
},
"carrierRates": {
"type": "array",
"description": "A list of carrier rates that can be referred to by mainTable or singleValue.",
"items": {
"$ref": "CarrierRate"
}
},
"mainTable": {
"$ref": "Table",
"description": "A table defining the rate group, when singleValue is not expressive enough. Can only be set if singleValue is not set."
},
"singleValue": {
"$ref": "Value",
"description": "The value of the rate group (e.g. flat rate $10). Can only be set if mainTable and subtables are not set."
},
"subtables": {
"type": "array",
"description": "A list of subtables referred to by mainTable. Can only be set if mainTable is set.",
"items": {
"$ref": "Table"
}
}
}
},
"Row": {
"id": "Row",
"type": "object",
"properties": {
"cells": {
"type": "array",
"description": "The list of cells that constitute the row. Must have the same length as columnHeaders for two-dimensional tables, a length of 1 for one-dimensional tables. Required.",
"items": {
"$ref": "Value"
}
}
}
},
"Service": {
"id": "Service",
"type": "object",
"properties": {
"active": {
"type": "boolean",
"description": "A boolean exposing the active status of the shipping service. Required."
},
"currency": {
"type": "string",
"description": "The CLDR code of the currency to which this service applies. Must match that of the prices in rate groups."
},
"deliveryCountry": {
"type": "string",
"description": "The CLDR territory code of the country to which the service applies. Required."
},
"deliveryTime": {
"$ref": "DeliveryTime",
"description": "Time spent in various aspects from order to the delivery of the product. Required."
},
"name": {
"type": "string",
"description": "Free-form name of the service. Must be unique within target account. Required."
},
"rateGroups": {
"type": "array",
"description": "Shipping rate group definitions. Only the last one is allowed to have an empty applicableShippingLabels, which means \"everything else\". The other applicableShippingLabels must not overlap.",
"items": {
"$ref": "RateGroup"
}
}
}
},
"ShippingSettings": {
"id": "ShippingSettings",
"type": "object",
"description": "The merchant account's shipping settings.",
"properties": {
"accountId": {
"type": "string",
"description": "The ID of the account to which these account shipping settings belong. Ignored upon update, always present in get request responses.",
"format": "uint64"
},
"postalCodeGroups": {
"type": "array",
"description": "A list of postal code groups that can be referred to in services. Optional.",
"items": {
"$ref": "PostalCodeGroup"
}
},
"services": {
"type": "array",
"description": "The target account's list of services. Optional.",
"items": {
"$ref": "Service"
}
}
}
},
"ShippingsettingsCustomBatchRequest": {
"id": "ShippingsettingsCustomBatchRequest",
"type": "object",
"properties": {
"entries": {
"type": "array",
"description": "The request entries to be processed in the batch.",
"items": {
"$ref": "ShippingsettingsCustomBatchRequestEntry"
}
}
}
},
"ShippingsettingsCustomBatchRequestEntry": {
"id": "ShippingsettingsCustomBatchRequestEntry",
"type": "object",
"description": "A batch entry encoding a single non-batch accountshipping request.",
"properties": {
"accountId": {
"type": "string",
"description": "The ID of the account for which to get/update account shipping settings.",
"format": "uint64"
},
"batchId": {
"type": "integer",
"description": "An entry ID, unique within the batch request.",
"format": "uint32"
},
"merchantId": {
"type": "string",
"description": "The ID of the managing account.",
"format": "uint64"
},
"method": {
"type": "string"
},
"shippingSettings": {
"$ref": "ShippingSettings",
"description": "The account shipping settings to update. Only defined if the method is update."
}
}
},
"ShippingsettingsCustomBatchResponse": {
"id": "ShippingsettingsCustomBatchResponse",
"type": "object",
"properties": {
"entries": {
"type": "array",
"description": "The result of the execution of the batch requests.",
"items": {
"$ref": "ShippingsettingsCustomBatchResponseEntry"
}
},
"kind": {
"type": "string",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#shippingsettingsCustomBatchResponse\".",
"default": "content#shippingsettingsCustomBatchResponse"
}
}
},
"ShippingsettingsCustomBatchResponseEntry": {
"id": "ShippingsettingsCustomBatchResponseEntry",
"type": "object",
"description": "A batch entry encoding a single non-batch shipping settings response.",
"properties": {
"batchId": {
"type": "integer",
"description": "The ID of the request entry to which this entry responds.",
"format": "uint32"
},
"errors": {
"$ref": "Errors",
"description": "A list of errors defined if, and only if, the request failed."
},
"kind": {
"type": "string",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#shippingsettingsCustomBatchResponseEntry\".",
"default": "content#shippingsettingsCustomBatchResponseEntry"
},
"shippingSettings": {
"$ref": "ShippingSettings",
"description": "The retrieved or updated account shipping settings."
}
}
},
"ShippingsettingsGetSupportedCarriersResponse": {
"id": "ShippingsettingsGetSupportedCarriersResponse",
"type": "object",
"properties": {
"carriers": {
"type": "array",
"description": "A list of supported carriers. May be empty.",
"items": {
"$ref": "CarriersCarrier"
}
},
"kind": {
"type": "string",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#shippingsettingsGetSupportedCarriersResponse\".",
"default": "content#shippingsettingsGetSupportedCarriersResponse"
}
}
},
"ShippingsettingsListResponse": {
"id": "ShippingsettingsListResponse",
"type": "object",
"properties": {
"kind": {
"type": "string",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#shippingsettingsListResponse\".",
"default": "content#shippingsettingsListResponse"
},
"nextPageToken": {
"type": "string",
"description": "The token for the retrieval of the next page of shipping settings."
},
"resources": {
"type": "array",
"items": {
"$ref": "ShippingSettings"
}
}
}
},
"Table": {
"id": "Table",
"type": "object",
"properties": {
"columnHeaders": {
"$ref": "Headers",
"description": "Headers of the table's columns. Optional: if not set then the table has only one dimension."
},
"name": {
"type": "string",
"description": "Name of the table. Required for subtables, ignored for the main table."
},
"rowHeaders": {
"$ref": "Headers",
"description": "Headers of the table's rows. Required."
},
"rows": {
"type": "array",
"description": "The list of rows that constitute the table. Must have the same length as rowHeaders. Required.",
"items": {
"$ref": "Row"
}
}
}
},
"TestOrder": {
"id": "TestOrder",
"type": "object",
@@ -4090,7 +4524,7 @@
},
"explicitMarketingPreference": {
"type": "boolean",
"description": "If set, this indicates the user had a choice 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 Purchases on Google checkout flow. Optional."
},
"fullName": {
"type": "string",
@@ -4279,6 +4713,33 @@
}
}
},
"Value": {
"id": "Value",
"type": "object",
"description": "The single value of a rate group or the value of a rate group table's cell. Exactly one of noShipping, flatRate, pricePercentage, carrierRateName, subtableName must be set.",
"properties": {
"carrierRateName": {
"type": "string",
"description": "The name of a carrier rate referring to a carrier rate defined in the same rate group. Can only be set if all other fields are not set."
},
"flatRate": {
"$ref": "Price",
"description": "A flat rate. Can only be set if all other fields are not set."
},
"noShipping": {
"type": "boolean",
"description": "If true, then the product can't ship. Must be true when set, can only be set if all other fields are not set."
},
"pricePercentage": {
"type": "string",
"description": "A percentage of the price represented as a number in decimal notation (e.g., \"5.4\"). Can only be set if all other fields are not set."
},
"subtableName": {
"type": "string",
"description": "The name of a subtable. Can only be set in table cells (i.e., not for single values), and only if all other fields are not set."
}
}
},
"Weight": {
"id": "Weight",
"type": "object",
@@ -6171,6 +6632,203 @@
]
}
}
},
"shippingsettings": {
"methods": {
"custombatch": {
"id": "content.shippingsettings.custombatch",
"path": "shippingsettings/batch",
"httpMethod": "POST",
"description": "Retrieves and updates the shipping settings of multiple accounts in a single request.",
"parameters": {
"dryRun": {
"type": "boolean",
"description": "Flag to run the request in dry-run mode.",
"location": "query"
}
},
"request": {
"$ref": "ShippingsettingsCustomBatchRequest"
},
"response": {
"$ref": "ShippingsettingsCustomBatchResponse"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"get": {
"id": "content.shippingsettings.get",
"path": "{merchantId}/shippingsettings/{accountId}",
"httpMethod": "GET",
"description": "Retrieves the shipping settings of the account.",
"parameters": {
"accountId": {
"type": "string",
"description": "The ID of the account for which to get/update shipping settings.",
"required": true,
"format": "uint64",
"location": "path"
},
"merchantId": {
"type": "string",
"description": "The ID of the managing account.",
"required": true,
"format": "uint64",
"location": "path"
}
},
"parameterOrder": [
"merchantId",
"accountId"
],
"response": {
"$ref": "ShippingSettings"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"getsupportedcarriers": {
"id": "content.shippingsettings.getsupportedcarriers",
"path": "{merchantId}/supportedCarriers",
"httpMethod": "GET",
"description": "Retrieves supported carriers and carrier services for an account.",
"parameters": {
"merchantId": {
"type": "string",
"description": "The ID of the account for which to retrieve the supported carriers.",
"required": true,
"format": "uint64",
"location": "path"
}
},
"parameterOrder": [
"merchantId"
],
"response": {
"$ref": "ShippingsettingsGetSupportedCarriersResponse"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"list": {
"id": "content.shippingsettings.list",
"path": "{merchantId}/shippingsettings",
"httpMethod": "GET",
"description": "Lists the shipping settings of the sub-accounts in your Merchant Center account.",
"parameters": {
"maxResults": {
"type": "integer",
"description": "The maximum number of shipping settings to return in the response, used for paging.",
"format": "uint32",
"location": "query"
},
"merchantId": {
"type": "string",
"description": "The ID of the managing account.",
"required": true,
"format": "uint64",
"location": "path"
},
"pageToken": {
"type": "string",
"description": "The token returned by the previous request.",
"location": "query"
}
},
"parameterOrder": [
"merchantId"
],
"response": {
"$ref": "ShippingsettingsListResponse"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"patch": {
"id": "content.shippingsettings.patch",
"path": "{merchantId}/shippingsettings/{accountId}",
"httpMethod": "PATCH",
"description": "Updates the shipping settings of the account. This method supports patch semantics.",
"parameters": {
"accountId": {
"type": "string",
"description": "The ID of the account for which to get/update shipping settings.",
"required": true,
"format": "uint64",
"location": "path"
},
"dryRun": {
"type": "boolean",
"description": "Flag to run the request in dry-run mode.",
"location": "query"
},
"merchantId": {
"type": "string",
"description": "The ID of the managing account.",
"required": true,
"format": "uint64",
"location": "path"
}
},
"parameterOrder": [
"merchantId",
"accountId"
],
"request": {
"$ref": "ShippingSettings"
},
"response": {
"$ref": "ShippingSettings"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"update": {
"id": "content.shippingsettings.update",
"path": "{merchantId}/shippingsettings/{accountId}",
"httpMethod": "PUT",
"description": "Updates the shipping settings of the account.",
"parameters": {
"accountId": {
"type": "string",
"description": "The ID of the account for which to get/update shipping settings.",
"required": true,
"format": "uint64",
"location": "path"
},
"dryRun": {
"type": "boolean",
"description": "Flag to run the request in dry-run mode.",
"location": "query"
},
"merchantId": {
"type": "string",
"description": "The ID of the managing account.",
"required": true,
"format": "uint64",
"location": "path"
}
},
"parameterOrder": [
"merchantId",
"accountId"
],
"request": {
"$ref": "ShippingSettings"
},
"response": {
"$ref": "ShippingSettings"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
}
}
}
}
}