blob: 42e73da6f97e0aa8d26abd532777f27738e4d245 [file] [log] [blame]
{
"auth": {
"oauth2": {
"scopes": {
"https://www.googleapis.com/auth/content": {
"description": "Manage your product listings and accounts for Google Shopping"
}
}
}
},
"basePath": "/content/v2.1/",
"baseUrl": "https://www.googleapis.com/content/v2.1/",
"batchPath": "batch/content/v2.1",
"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": "\"u9GIe6H63LSGq-9_t39K2Zx_EAc/tQFcbBCt4CJWdiNSdoc_10f4ff8\"",
"icons": {
"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.1",
"kind": "discovery#restDescription",
"name": "content",
"ownerDomain": "google.com",
"ownerName": "Google",
"parameters": {
"alt": {
"default": "json",
"description": "Data format for the response.",
"enum": [
"json"
],
"enumDescriptions": [
"Responses with Content-Type of application/json"
],
"location": "query",
"type": "string"
},
"fields": {
"description": "Selector specifying which fields to include in a partial response.",
"location": "query",
"type": "string"
},
"key": {
"description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.",
"location": "query",
"type": "string"
},
"oauth_token": {
"description": "OAuth 2.0 token for the current user.",
"location": "query",
"type": "string"
},
"prettyPrint": {
"default": "true",
"description": "Returns response with indentations and line breaks.",
"location": "query",
"type": "boolean"
},
"quotaUser": {
"description": "An opaque string that represents a user for quota purposes. Must not exceed 40 characters.",
"location": "query",
"type": "string"
},
"userIp": {
"description": "Deprecated. Please use quotaUser instead.",
"location": "query",
"type": "string"
}
},
"protocol": "rest",
"resources": {
"accounts": {
"methods": {
"authinfo": {
"description": "Returns information about the authenticated user.",
"httpMethod": "GET",
"id": "content.accounts.authinfo",
"path": "accounts/authinfo",
"response": {
"$ref": "AccountsAuthInfoResponse"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"claimwebsite": {
"description": "Claims the website of a Merchant Center sub-account.",
"httpMethod": "POST",
"id": "content.accounts.claimwebsite",
"parameterOrder": [
"merchantId",
"accountId"
],
"parameters": {
"accountId": {
"description": "The ID of the account whose website is claimed.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
},
"merchantId": {
"description": "The ID of the managing account. If this parameter is not the same as accountId, then this account must be a multi-client account and accountId must be the ID of a sub-account of this account.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
},
"overwrite": {
"description": "Only available to selected merchants. When set to True, this flag removes any existing claim on the requested website by another account and replaces it with a claim from this account.",
"location": "query",
"type": "boolean"
}
},
"path": "{merchantId}/accounts/{accountId}/claimwebsite",
"response": {
"$ref": "AccountsClaimWebsiteResponse"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"custombatch": {
"description": "Retrieves, inserts, updates, and deletes multiple Merchant Center (sub-)accounts in a single request.",
"httpMethod": "POST",
"id": "content.accounts.custombatch",
"path": "accounts/batch",
"request": {
"$ref": "AccountsCustomBatchRequest"
},
"response": {
"$ref": "AccountsCustomBatchResponse"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"delete": {
"description": "Deletes a Merchant Center sub-account.",
"httpMethod": "DELETE",
"id": "content.accounts.delete",
"parameterOrder": [
"merchantId",
"accountId"
],
"parameters": {
"accountId": {
"description": "The ID of the account.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
},
"force": {
"default": "false",
"description": "Flag to delete sub-accounts with products. The default value is false.",
"location": "query",
"type": "boolean"
},
"merchantId": {
"description": "The ID of the managing account. This must be a multi-client account, and accountId must be the ID of a sub-account of this account.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "{merchantId}/accounts/{accountId}",
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"get": {
"description": "Retrieves a Merchant Center account.",
"httpMethod": "GET",
"id": "content.accounts.get",
"parameterOrder": [
"merchantId",
"accountId"
],
"parameters": {
"accountId": {
"description": "The ID of the account.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
},
"merchantId": {
"description": "The ID of the managing account. If this parameter is not the same as accountId, then this account must be a multi-client account and accountId must be the ID of a sub-account of this account.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "{merchantId}/accounts/{accountId}",
"response": {
"$ref": "Account"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"insert": {
"description": "Creates a Merchant Center sub-account.",
"httpMethod": "POST",
"id": "content.accounts.insert",
"parameterOrder": [
"merchantId"
],
"parameters": {
"merchantId": {
"description": "The ID of the managing account. This must be a multi-client account.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "{merchantId}/accounts",
"request": {
"$ref": "Account"
},
"response": {
"$ref": "Account"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"link": {
"description": "Performs an action on a link between two Merchant Center accounts, namely accountId and linkedAccountId.",
"httpMethod": "POST",
"id": "content.accounts.link",
"parameterOrder": [
"merchantId",
"accountId"
],
"parameters": {
"accountId": {
"description": "The ID of the account that should be linked.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
},
"merchantId": {
"description": "The ID of the managing account. If this parameter is not the same as accountId, then this account must be a multi-client account and accountId must be the ID of a sub-account of this account.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "{merchantId}/accounts/{accountId}/link",
"request": {
"$ref": "AccountsLinkRequest"
},
"response": {
"$ref": "AccountsLinkResponse"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"list": {
"description": "Lists the sub-accounts in your Merchant Center account.",
"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",
"type": "integer"
},
"merchantId": {
"description": "The ID of the managing account. This must be a multi-client account.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
},
"pageToken": {
"description": "The token returned by the previous request.",
"location": "query",
"type": "string"
}
},
"path": "{merchantId}/accounts",
"response": {
"$ref": "AccountsListResponse"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"listlinks": {
"description": "Returns the list of accounts linked to your Merchant Center account.",
"httpMethod": "GET",
"id": "content.accounts.listlinks",
"parameterOrder": [
"merchantId",
"accountId"
],
"parameters": {
"accountId": {
"description": "The ID of the account for which to list links.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
},
"maxResults": {
"description": "The maximum number of links to return in the response, used for pagination.",
"format": "uint32",
"location": "query",
"type": "integer"
},
"merchantId": {
"description": "The ID of the managing account. If this parameter is not the same as accountId, then this account must be a multi-client account and accountId must be the ID of a sub-account of this account.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
},
"pageToken": {
"description": "The token returned by the previous request.",
"location": "query",
"type": "string"
}
},
"path": "{merchantId}/accounts/{accountId}/listlinks",
"response": {
"$ref": "AccountsListLinksResponse"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"update": {
"description": "Updates a Merchant Center account.",
"httpMethod": "PUT",
"id": "content.accounts.update",
"parameterOrder": [
"merchantId",
"accountId"
],
"parameters": {
"accountId": {
"description": "The ID of the account.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
},
"merchantId": {
"description": "The ID of the managing account. If this parameter is not the same as accountId, then this account must be a multi-client account and accountId must be the ID of a sub-account of this account.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "{merchantId}/accounts/{accountId}",
"request": {
"$ref": "Account"
},
"response": {
"$ref": "Account"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
}
}
},
"accountstatuses": {
"methods": {
"custombatch": {
"description": "Retrieves multiple Merchant Center account statuses in a single request.",
"httpMethod": "POST",
"id": "content.accountstatuses.custombatch",
"path": "accountstatuses/batch",
"request": {
"$ref": "AccountstatusesCustomBatchRequest"
},
"response": {
"$ref": "AccountstatusesCustomBatchResponse"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"get": {
"description": "Retrieves the status of a Merchant Center account. No itemLevelIssues are returned for multi-client accounts.",
"httpMethod": "GET",
"id": "content.accountstatuses.get",
"parameterOrder": [
"merchantId",
"accountId"
],
"parameters": {
"accountId": {
"description": "The ID of the account.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
},
"destinations": {
"description": "If set, only issues for the specified destinations are returned, otherwise only issues for the Shopping destination.",
"location": "query",
"repeated": true,
"type": "string"
},
"merchantId": {
"description": "The ID of the managing account. If this parameter is not the same as accountId, then this account must be a multi-client account and accountId must be the ID of a sub-account of this account.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
}
},
"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.",
"httpMethod": "GET",
"id": "content.accountstatuses.list",
"parameterOrder": [
"merchantId"
],
"parameters": {
"destinations": {
"description": "If set, only issues for the specified destinations are returned, otherwise only issues for the Shopping destination.",
"location": "query",
"repeated": true,
"type": "string"
},
"maxResults": {
"description": "The maximum number of account statuses to return in the response, used for paging.",
"format": "uint32",
"location": "query",
"type": "integer"
},
"merchantId": {
"description": "The ID of the managing account. This must be a multi-client account.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
},
"pageToken": {
"description": "The token returned by the previous request.",
"location": "query",
"type": "string"
}
},
"path": "{merchantId}/accountstatuses",
"response": {
"$ref": "AccountstatusesListResponse"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
}
}
},
"accounttax": {
"methods": {
"custombatch": {
"description": "Retrieves and updates tax settings of multiple accounts in a single request.",
"httpMethod": "POST",
"id": "content.accounttax.custombatch",
"path": "accounttax/batch",
"request": {
"$ref": "AccounttaxCustomBatchRequest"
},
"response": {
"$ref": "AccounttaxCustomBatchResponse"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"get": {
"description": "Retrieves the tax settings of the 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",
"location": "path",
"required": true,
"type": "string"
},
"merchantId": {
"description": "The ID of the managing account. If this parameter is not the same as accountId, then this account must be a multi-client account and accountId must be the ID of a sub-account of this account.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
}
},
"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.",
"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",
"type": "integer"
},
"merchantId": {
"description": "The ID of the managing account. This must be a multi-client account.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
},
"pageToken": {
"description": "The token returned by the previous request.",
"location": "query",
"type": "string"
}
},
"path": "{merchantId}/accounttax",
"response": {
"$ref": "AccounttaxListResponse"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"update": {
"description": "Updates the tax settings of the 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",
"location": "path",
"required": true,
"type": "string"
},
"merchantId": {
"description": "The ID of the managing account. If this parameter is not the same as accountId, then this account must be a multi-client account and accountId must be the ID of a sub-account of this account.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "{merchantId}/accounttax/{accountId}",
"request": {
"$ref": "AccountTax"
},
"response": {
"$ref": "AccountTax"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
}
}
},
"datafeeds": {
"methods": {
"custombatch": {
"description": "Deletes, fetches, gets, inserts and updates multiple datafeeds in a single request.",
"httpMethod": "POST",
"id": "content.datafeeds.custombatch",
"path": "datafeeds/batch",
"request": {
"$ref": "DatafeedsCustomBatchRequest"
},
"response": {
"$ref": "DatafeedsCustomBatchResponse"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"delete": {
"description": "Deletes a datafeed configuration from your Merchant Center account.",
"httpMethod": "DELETE",
"id": "content.datafeeds.delete",
"parameterOrder": [
"merchantId",
"datafeedId"
],
"parameters": {
"datafeedId": {
"description": "The ID of the datafeed.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
},
"merchantId": {
"description": "The ID of the account that manages the datafeed. This account cannot be a multi-client account.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "{merchantId}/datafeeds/{datafeedId}",
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"fetchnow": {
"description": "Invokes a fetch for the datafeed in your Merchant Center account.",
"httpMethod": "POST",
"id": "content.datafeeds.fetchnow",
"parameterOrder": [
"merchantId",
"datafeedId"
],
"parameters": {
"datafeedId": {
"description": "The ID of the datafeed to be fetched.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
},
"merchantId": {
"description": "The ID of the account that manages the datafeed. This account cannot be a multi-client account.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "{merchantId}/datafeeds/{datafeedId}/fetchNow",
"response": {
"$ref": "DatafeedsFetchNowResponse"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"get": {
"description": "Retrieves a datafeed configuration from your Merchant Center account.",
"httpMethod": "GET",
"id": "content.datafeeds.get",
"parameterOrder": [
"merchantId",
"datafeedId"
],
"parameters": {
"datafeedId": {
"description": "The ID of the datafeed.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
},
"merchantId": {
"description": "The ID of the account that manages the datafeed. This account cannot be a multi-client account.",
"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 configuration with your Merchant Center account.",
"httpMethod": "POST",
"id": "content.datafeeds.insert",
"parameterOrder": [
"merchantId"
],
"parameters": {
"merchantId": {
"description": "The ID of the account that manages the datafeed. This account cannot be a multi-client account.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "{merchantId}/datafeeds",
"request": {
"$ref": "Datafeed"
},
"response": {
"$ref": "Datafeed"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"list": {
"description": "Lists the configurations for datafeeds in your Merchant Center account.",
"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",
"type": "integer"
},
"merchantId": {
"description": "The ID of the account that manages the datafeeds. This account cannot be a multi-client account.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
},
"pageToken": {
"description": "The token returned by the previous request.",
"location": "query",
"type": "string"
}
},
"path": "{merchantId}/datafeeds",
"response": {
"$ref": "DatafeedsListResponse"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"update": {
"description": "Updates a datafeed configuration of your Merchant Center account.",
"httpMethod": "PUT",
"id": "content.datafeeds.update",
"parameterOrder": [
"merchantId",
"datafeedId"
],
"parameters": {
"datafeedId": {
"description": "The ID of the datafeed.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
},
"merchantId": {
"description": "The ID of the account that manages the datafeed. This account cannot be a multi-client account.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "{merchantId}/datafeeds/{datafeedId}",
"request": {
"$ref": "Datafeed"
},
"response": {
"$ref": "Datafeed"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
}
}
},
"datafeedstatuses": {
"methods": {
"custombatch": {
"description": "Gets multiple Merchant Center datafeed statuses in a single request.",
"httpMethod": "POST",
"id": "content.datafeedstatuses.custombatch",
"path": "datafeedstatuses/batch",
"request": {
"$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.",
"httpMethod": "GET",
"id": "content.datafeedstatuses.get",
"parameterOrder": [
"merchantId",
"datafeedId"
],
"parameters": {
"country": {
"description": "The country for which to get the datafeed status. If this parameter is provided then language must also be provided. Note that this parameter is required for feeds targeting multiple countries and languages, since a feed may have a different status for each target.",
"location": "query",
"type": "string"
},
"datafeedId": {
"description": "The ID of the datafeed.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
},
"language": {
"description": "The language for which to get the datafeed status. If this parameter is provided then country must also be provided. Note that this parameter is required for feeds targeting multiple countries and languages, since a feed may have a different status for each target.",
"location": "query",
"type": "string"
},
"merchantId": {
"description": "The ID of the account that manages the datafeed. This account cannot be a multi-client account.",
"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.",
"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",
"type": "integer"
},
"merchantId": {
"description": "The ID of the account that manages the datafeeds. This account cannot be a multi-client account.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
},
"pageToken": {
"description": "The token returned by the previous request.",
"location": "query",
"type": "string"
}
},
"path": "{merchantId}/datafeedstatuses",
"response": {
"$ref": "DatafeedstatusesListResponse"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
}
}
},
"liasettings": {
"methods": {
"custombatch": {
"description": "Retrieves and/or updates the LIA settings of multiple accounts in a single request.",
"httpMethod": "POST",
"id": "content.liasettings.custombatch",
"path": "liasettings/batch",
"request": {
"$ref": "LiasettingsCustomBatchRequest"
},
"response": {
"$ref": "LiasettingsCustomBatchResponse"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"get": {
"description": "Retrieves the LIA settings of the account.",
"httpMethod": "GET",
"id": "content.liasettings.get",
"parameterOrder": [
"merchantId",
"accountId"
],
"parameters": {
"accountId": {
"description": "The ID of the account for which to get or update LIA settings.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
},
"merchantId": {
"description": "The ID of the managing account. If this parameter is not the same as accountId, then this account must be a multi-client account and accountId must be the ID of a sub-account of this account.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "{merchantId}/liasettings/{accountId}",
"response": {
"$ref": "LiaSettings"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"getaccessiblegmbaccounts": {
"description": "Retrieves the list of accessible Google My Business accounts.",
"httpMethod": "GET",
"id": "content.liasettings.getaccessiblegmbaccounts",
"parameterOrder": [
"merchantId",
"accountId"
],
"parameters": {
"accountId": {
"description": "The ID of the account for which to retrieve accessible Google My Business accounts.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
},
"merchantId": {
"description": "The ID of the managing account. If this parameter is not the same as accountId, then this account must be a multi-client account and accountId must be the ID of a sub-account of this account.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "{merchantId}/liasettings/{accountId}/accessiblegmbaccounts",
"response": {
"$ref": "LiasettingsGetAccessibleGmbAccountsResponse"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"list": {
"description": "Lists the LIA settings of the sub-accounts in your Merchant Center account.",
"httpMethod": "GET",
"id": "content.liasettings.list",
"parameterOrder": [
"merchantId"
],
"parameters": {
"maxResults": {
"description": "The maximum number of LIA settings to return in the response, used for paging.",
"format": "uint32",
"location": "query",
"type": "integer"
},
"merchantId": {
"description": "The ID of the managing account. This must be a multi-client account.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
},
"pageToken": {
"description": "The token returned by the previous request.",
"location": "query",
"type": "string"
}
},
"path": "{merchantId}/liasettings",
"response": {
"$ref": "LiasettingsListResponse"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"listposdataproviders": {
"description": "Retrieves the list of POS data providers that have active settings for the all eiligible countries.",
"httpMethod": "GET",
"id": "content.liasettings.listposdataproviders",
"path": "liasettings/posdataproviders",
"response": {
"$ref": "LiasettingsListPosDataProvidersResponse"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"requestgmbaccess": {
"description": "Requests access to a specified Google My Business account.",
"httpMethod": "POST",
"id": "content.liasettings.requestgmbaccess",
"parameterOrder": [
"merchantId",
"accountId",
"gmbEmail"
],
"parameters": {
"accountId": {
"description": "The ID of the account for which GMB access is requested.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
},
"gmbEmail": {
"description": "The email of the Google My Business account.",
"location": "query",
"required": true,
"type": "string"
},
"merchantId": {
"description": "The ID of the managing account. If this parameter is not the same as accountId, then this account must be a multi-client account and accountId must be the ID of a sub-account of this account.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "{merchantId}/liasettings/{accountId}/requestgmbaccess",
"response": {
"$ref": "LiasettingsRequestGmbAccessResponse"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"requestinventoryverification": {
"description": "Requests inventory validation for the specified country.",
"httpMethod": "POST",
"id": "content.liasettings.requestinventoryverification",
"parameterOrder": [
"merchantId",
"accountId",
"country"
],
"parameters": {
"accountId": {
"description": "The ID of the account that manages the order. This cannot be a multi-client account.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
},
"country": {
"description": "The country for which inventory validation is requested.",
"location": "path",
"required": true,
"type": "string"
},
"merchantId": {
"description": "The ID of the managing account. If this parameter is not the same as accountId, then this account must be a multi-client account and accountId must be the ID of a sub-account of this account.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "{merchantId}/liasettings/{accountId}/requestinventoryverification/{country}",
"response": {
"$ref": "LiasettingsRequestInventoryVerificationResponse"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"setinventoryverificationcontact": {
"description": "Sets the inventory verification contract for the specified country.",
"httpMethod": "POST",
"id": "content.liasettings.setinventoryverificationcontact",
"parameterOrder": [
"merchantId",
"accountId",
"contactEmail",
"contactName",
"country",
"language"
],
"parameters": {
"accountId": {
"description": "The ID of the account that manages the order. This cannot be a multi-client account.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
},
"contactEmail": {
"description": "The email of the inventory verification contact.",
"location": "query",
"required": true,
"type": "string"
},
"contactName": {
"description": "The name of the inventory verification contact.",
"location": "query",
"required": true,
"type": "string"
},
"country": {
"description": "The country for which inventory verification is requested.",
"location": "query",
"required": true,
"type": "string"
},
"language": {
"description": "The language for which inventory verification is requested.",
"location": "query",
"required": true,
"type": "string"
},
"merchantId": {
"description": "The ID of the managing account. If this parameter is not the same as accountId, then this account must be a multi-client account and accountId must be the ID of a sub-account of this account.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "{merchantId}/liasettings/{accountId}/setinventoryverificationcontact",
"response": {
"$ref": "LiasettingsSetInventoryVerificationContactResponse"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"setposdataprovider": {
"description": "Sets the POS data provider for the specified country.",
"httpMethod": "POST",
"id": "content.liasettings.setposdataprovider",
"parameterOrder": [
"merchantId",
"accountId",
"country"
],
"parameters": {
"accountId": {
"description": "The ID of the account for which to retrieve accessible Google My Business accounts.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
},
"country": {
"description": "The country for which the POS data provider is selected.",
"location": "query",
"required": true,
"type": "string"
},
"merchantId": {
"description": "The ID of the managing account. If this parameter is not the same as accountId, then this account must be a multi-client account and accountId must be the ID of a sub-account of this account.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
},
"posDataProviderId": {
"description": "The ID of POS data provider.",
"format": "uint64",
"location": "query",
"type": "string"
},
"posExternalAccountId": {
"description": "The account ID by which this merchant is known to the POS data provider.",
"location": "query",
"type": "string"
}
},
"path": "{merchantId}/liasettings/{accountId}/setposdataprovider",
"response": {
"$ref": "LiasettingsSetPosDataProviderResponse"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"update": {
"description": "Updates the LIA settings of the account.",
"httpMethod": "PUT",
"id": "content.liasettings.update",
"parameterOrder": [
"merchantId",
"accountId"
],
"parameters": {
"accountId": {
"description": "The ID of the account for which to get or update LIA settings.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
},
"merchantId": {
"description": "The ID of the managing account. If this parameter is not the same as accountId, then this account must be a multi-client account and accountId must be the ID of a sub-account of this account.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "{merchantId}/liasettings/{accountId}",
"request": {
"$ref": "LiaSettings"
},
"response": {
"$ref": "LiaSettings"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
}
}
},
"localinventory": {
"methods": {
"custombatch": {
"description": "Updates local inventory for multiple products or stores in a single request.",
"httpMethod": "POST",
"id": "content.localinventory.custombatch",
"path": "localinventory/batch",
"request": {
"$ref": "LocalinventoryCustomBatchRequest"
},
"response": {
"$ref": "LocalinventoryCustomBatchResponse"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"insert": {
"description": "Update the local inventory of a product in your Merchant Center account.",
"httpMethod": "POST",
"id": "content.localinventory.insert",
"parameterOrder": [
"merchantId",
"productId"
],
"parameters": {
"merchantId": {
"description": "The ID of the account that contains the product. This account cannot be a multi-client account.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
},
"productId": {
"description": "The REST ID of the product for which to update local inventory.",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "{merchantId}/products/{productId}/localinventory",
"request": {
"$ref": "LocalInventory"
},
"response": {
"$ref": "LocalInventory"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
}
}
},
"orderinvoices": {
"methods": {
"createchargeinvoice": {
"description": "Creates a charge invoice for a shipment group, and triggers a charge capture for orderinvoice enabled orders.",
"httpMethod": "POST",
"id": "content.orderinvoices.createchargeinvoice",
"parameterOrder": [
"merchantId",
"orderId"
],
"parameters": {
"merchantId": {
"description": "The ID of the account that manages the order. This cannot be a multi-client account.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
},
"orderId": {
"description": "The ID of the order.",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "{merchantId}/orderinvoices/{orderId}/createChargeInvoice",
"request": {
"$ref": "OrderinvoicesCreateChargeInvoiceRequest"
},
"response": {
"$ref": "OrderinvoicesCreateChargeInvoiceResponse"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"createrefundinvoice": {
"description": "Creates a refund invoice for one or more shipment groups, and triggers a refund for orderinvoice enabled orders. This can only be used for line items that have previously been charged using createChargeInvoice. All amounts (except for the summary) are incremental with respect to the previous invoice.",
"httpMethod": "POST",
"id": "content.orderinvoices.createrefundinvoice",
"parameterOrder": [
"merchantId",
"orderId"
],
"parameters": {
"merchantId": {
"description": "The ID of the account that manages the order. This cannot be a multi-client account.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
},
"orderId": {
"description": "The ID of the order.",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "{merchantId}/orderinvoices/{orderId}/createRefundInvoice",
"request": {
"$ref": "OrderinvoicesCreateRefundInvoiceRequest"
},
"response": {
"$ref": "OrderinvoicesCreateRefundInvoiceResponse"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
}
}
},
"orderreports": {
"methods": {
"listdisbursements": {
"description": "Retrieves a report for disbursements from your Merchant Center account.",
"httpMethod": "GET",
"id": "content.orderreports.listdisbursements",
"parameterOrder": [
"merchantId",
"disbursementStartDate"
],
"parameters": {
"disbursementEndDate": {
"description": "The last date which disbursements occurred. In ISO 8601 format. Default: current date.",
"location": "query",
"type": "string"
},
"disbursementStartDate": {
"description": "The first date which disbursements occurred. In ISO 8601 format.",
"location": "query",
"required": true,
"type": "string"
},
"maxResults": {
"description": "The maximum number of disbursements to return in the response, used for paging.",
"format": "uint32",
"location": "query",
"type": "integer"
},
"merchantId": {
"description": "The ID of the account that manages the order. This cannot be a multi-client account.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
},
"pageToken": {
"description": "The token returned by the previous request.",
"location": "query",
"type": "string"
}
},
"path": "{merchantId}/orderreports/disbursements",
"response": {
"$ref": "OrderreportsListDisbursementsResponse"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"listtransactions": {
"description": "Retrieves a list of transactions for a disbursement from your Merchant Center account.",
"httpMethod": "GET",
"id": "content.orderreports.listtransactions",
"parameterOrder": [
"merchantId",
"disbursementId",
"transactionStartDate"
],
"parameters": {
"disbursementId": {
"description": "The Google-provided ID of the disbursement (found in Wallet).",
"location": "path",
"required": true,
"type": "string"
},
"maxResults": {
"description": "The maximum number of disbursements to return in the response, used for paging.",
"format": "uint32",
"location": "query",
"type": "integer"
},
"merchantId": {
"description": "The ID of the account that manages the order. This cannot be a multi-client account.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
},
"pageToken": {
"description": "The token returned by the previous request.",
"location": "query",
"type": "string"
},
"transactionEndDate": {
"description": "The last date in which transaction occurred. In ISO 8601 format. Default: current date.",
"location": "query",
"type": "string"
},
"transactionStartDate": {
"description": "The first date in which transaction occurred. In ISO 8601 format.",
"location": "query",
"required": true,
"type": "string"
}
},
"path": "{merchantId}/orderreports/disbursements/{disbursementId}/transactions",
"response": {
"$ref": "OrderreportsListTransactionsResponse"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
}
}
},
"orderreturns": {
"methods": {
"get": {
"description": "Retrieves an order return from your Merchant Center account.",
"httpMethod": "GET",
"id": "content.orderreturns.get",
"parameterOrder": [
"merchantId",
"returnId"
],
"parameters": {
"merchantId": {
"description": "The ID of the account that manages the order. This cannot be a multi-client account.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
},
"returnId": {
"description": "Merchant order return ID generated by Google.",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "{merchantId}/orderreturns/{returnId}",
"response": {
"$ref": "MerchantOrderReturn"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"list": {
"description": "Lists order returns in your Merchant Center account.",
"httpMethod": "GET",
"id": "content.orderreturns.list",
"parameterOrder": [
"merchantId"
],
"parameters": {
"createdEndDate": {
"description": "Obtains order returns created before this date (inclusively), in ISO 8601 format.",
"location": "query",
"type": "string"
},
"createdStartDate": {
"description": "Obtains order returns created after this date (inclusively), in ISO 8601 format.",
"location": "query",
"type": "string"
},
"maxResults": {
"description": "The maximum number of order returns to return in the response, used for paging. The default value is 25 returns per page, and the maximum allowed value is 250 returns per page.",
"format": "uint32",
"location": "query",
"type": "integer"
},
"merchantId": {
"description": "The ID of the account that manages the order. This cannot be a multi-client account.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
},
"orderBy": {
"description": "Return the results in the specified order.",
"enum": [
"returnCreationTimeAsc",
"returnCreationTimeDesc"
],
"enumDescriptions": [
"",
""
],
"location": "query",
"type": "string"
},
"pageToken": {
"description": "The token returned by the previous request.",
"location": "query",
"type": "string"
}
},
"path": "{merchantId}/orderreturns",
"response": {
"$ref": "OrderreturnsListResponse"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
}
}
},
"orders": {
"methods": {
"acknowledge": {
"description": "Marks an order as acknowledged.",
"httpMethod": "POST",
"id": "content.orders.acknowledge",
"parameterOrder": [
"merchantId",
"orderId"
],
"parameters": {
"merchantId": {
"description": "The ID of the account that manages the order. This cannot be a multi-client account.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
},
"orderId": {
"description": "The ID of the order.",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "{merchantId}/orders/{orderId}/acknowledge",
"request": {
"$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\".",
"httpMethod": "POST",
"id": "content.orders.advancetestorder",
"parameterOrder": [
"merchantId",
"orderId"
],
"parameters": {
"merchantId": {
"description": "The ID of the account that manages the order. This cannot be a multi-client account.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
},
"orderId": {
"description": "The ID of the test order to modify.",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "{merchantId}/testorders/{orderId}/advance",
"response": {
"$ref": "OrdersAdvanceTestOrderResponse"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"cancel": {
"description": "Cancels all line items in an order, making a full refund.",
"httpMethod": "POST",
"id": "content.orders.cancel",
"parameterOrder": [
"merchantId",
"orderId"
],
"parameters": {
"merchantId": {
"description": "The ID of the account that manages the order. This cannot be a multi-client account.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
},
"orderId": {
"description": "The ID of the order to cancel.",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "{merchantId}/orders/{orderId}/cancel",
"request": {
"$ref": "OrdersCancelRequest"
},
"response": {
"$ref": "OrdersCancelResponse"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"cancellineitem": {
"description": "Cancels a line item, making a full refund.",
"httpMethod": "POST",
"id": "content.orders.cancellineitem",
"parameterOrder": [
"merchantId",
"orderId"
],
"parameters": {
"merchantId": {
"description": "The ID of the account that manages the order. This cannot be a multi-client account.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
},
"orderId": {
"description": "The ID of the order.",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "{merchantId}/orders/{orderId}/cancelLineItem",
"request": {
"$ref": "OrdersCancelLineItemRequest"
},
"response": {
"$ref": "OrdersCancelLineItemResponse"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"canceltestorderbycustomer": {
"description": "Sandbox only. Cancels a test order for customer-initiated cancellation.",
"httpMethod": "POST",
"id": "content.orders.canceltestorderbycustomer",
"parameterOrder": [
"merchantId",
"orderId"
],
"parameters": {
"merchantId": {
"description": "The ID of the account that manages the order. This cannot be a multi-client account.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
},
"orderId": {
"description": "The ID of the test order to cancel.",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "{merchantId}/testorders/{orderId}/cancelByCustomer",
"request": {
"$ref": "OrdersCancelTestOrderByCustomerRequest"
},
"response": {
"$ref": "OrdersCancelTestOrderByCustomerResponse"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"createtestorder": {
"description": "Sandbox only. Creates a test order.",
"httpMethod": "POST",
"id": "content.orders.createtestorder",
"parameterOrder": [
"merchantId"
],
"parameters": {
"merchantId": {
"description": "The ID of the account that should manage the order. This cannot be a multi-client 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"
]
},
"createtestreturn": {
"description": "Sandbox only. Creates a test return.",
"httpMethod": "POST",
"id": "content.orders.createtestreturn",
"parameterOrder": [
"merchantId",
"orderId"
],
"parameters": {
"merchantId": {
"description": "The ID of the account that manages the order. This cannot be a multi-client account.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
},
"orderId": {
"description": "The ID of the order.",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "{merchantId}/orders/{orderId}/testreturn",
"request": {
"$ref": "OrdersCreateTestReturnRequest"
},
"response": {
"$ref": "OrdersCreateTestReturnResponse"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"get": {
"description": "Retrieves an order from your Merchant Center account.",
"httpMethod": "GET",
"id": "content.orders.get",
"parameterOrder": [
"merchantId",
"orderId"
],
"parameters": {
"merchantId": {
"description": "The ID of the account that manages the order. This cannot be a multi-client account.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
},
"orderId": {
"description": "The ID of the order.",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "{merchantId}/orders/{orderId}",
"response": {
"$ref": "Order"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"getbymerchantorderid": {
"description": "Retrieves an order using merchant order ID.",
"httpMethod": "GET",
"id": "content.orders.getbymerchantorderid",
"parameterOrder": [
"merchantId",
"merchantOrderId"
],
"parameters": {
"merchantId": {
"description": "The ID of the account that manages the order. This cannot be a multi-client account.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
},
"merchantOrderId": {
"description": "The merchant order ID to be looked for.",
"location": "path",
"required": true,
"type": "string"
}
},
"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.",
"httpMethod": "GET",
"id": "content.orders.gettestordertemplate",
"parameterOrder": [
"merchantId",
"templateName"
],
"parameters": {
"country": {
"description": "The country of the template to retrieve. Defaults to US.",
"location": "query",
"type": "string"
},
"merchantId": {
"description": "The ID of the account that should manage the order. This cannot be a multi-client account.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
},
"templateName": {
"description": "The name of the template to retrieve.",
"enum": [
"template1",
"template1a",
"template1b",
"template2",
"template3"
],
"enumDescriptions": [
"",
"",
"",
"",
""
],
"location": "path",
"required": true,
"type": "string"
}
},
"path": "{merchantId}/testordertemplates/{templateName}",
"response": {
"$ref": "OrdersGetTestOrderTemplateResponse"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"instorerefundlineitem": {
"description": "Deprecated. Notifies that item return and refund was handled directly by merchant outside of Google payments processing (e.g. cash refund done in store).\nNote: We recommend calling the returnrefundlineitem method to refund in-store returns. We will issue the refund directly to the customer. This helps to prevent possible differences arising between merchant and Google transaction records. We also recommend having the point of sale system communicate with Google to ensure that customers do not receive a double refund by first refunding via Google then via an in-store return.",
"httpMethod": "POST",
"id": "content.orders.instorerefundlineitem",
"parameterOrder": [
"merchantId",
"orderId"
],
"parameters": {
"merchantId": {
"description": "The ID of the account that manages the order. This cannot be a multi-client account.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
},
"orderId": {
"description": "The ID of the order.",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "{merchantId}/orders/{orderId}/inStoreRefundLineItem",
"request": {
"$ref": "OrdersInStoreRefundLineItemRequest"
},
"response": {
"$ref": "OrdersInStoreRefundLineItemResponse"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"list": {
"description": "Lists the orders in your Merchant Center account.",
"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"
},
"maxResults": {
"description": "The maximum number of orders to return in the response, used for paging. The default value is 25 orders per page, and the maximum allowed value is 250 orders per page.",
"format": "uint32",
"location": "query",
"type": "integer"
},
"merchantId": {
"description": "The ID of the account that manages the order. This cannot be a multi-client account.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
},
"orderBy": {
"description": "Order results by placement date in descending or ascending order.\n\nAcceptable values are:\n- placedDateAsc\n- placedDateDesc",
"location": "query",
"type": "string"
},
"pageToken": {
"description": "The token returned by the previous request.",
"location": "query",
"type": "string"
},
"placedDateEnd": {
"description": "Obtains orders placed before this date (exclusively), in ISO 8601 format.",
"location": "query",
"type": "string"
},
"placedDateStart": {
"description": "Obtains orders placed after this date (inclusively), in ISO 8601 format.",
"location": "query",
"type": "string"
},
"statuses": {
"description": "Obtains orders that match any of the specified statuses. Please note that active is a shortcut for pendingShipment and partiallyShipped, and completed is a shortcut for shipped, partiallyDelivered, delivered, partiallyReturned, returned, and canceled.",
"enum": [
"active",
"canceled",
"completed",
"delivered",
"inProgress",
"partiallyDelivered",
"partiallyReturned",
"partiallyShipped",
"pendingShipment",
"returned",
"shipped"
],
"enumDescriptions": [
"",
"",
"",
"",
"",
"",
"",
"",
"",
"",
""
],
"location": "query",
"repeated": true,
"type": "string"
}
},
"path": "{merchantId}/orders",
"response": {
"$ref": "OrdersListResponse"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"rejectreturnlineitem": {
"description": "Rejects return on an line item.",
"httpMethod": "POST",
"id": "content.orders.rejectreturnlineitem",
"parameterOrder": [
"merchantId",
"orderId"
],
"parameters": {
"merchantId": {
"description": "The ID of the account that manages the order. This cannot be a multi-client account.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
},
"orderId": {
"description": "The ID of the order.",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "{merchantId}/orders/{orderId}/rejectReturnLineItem",
"request": {
"$ref": "OrdersRejectReturnLineItemRequest"
},
"response": {
"$ref": "OrdersRejectReturnLineItemResponse"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"returnrefundlineitem": {
"description": "Returns and refunds a line item. Note that this method can only be called on fully shipped orders.",
"httpMethod": "POST",
"id": "content.orders.returnrefundlineitem",
"parameterOrder": [
"merchantId",
"orderId"
],
"parameters": {
"merchantId": {
"description": "The ID of the account that manages the order. This cannot be a multi-client account.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
},
"orderId": {
"description": "The ID of the order.",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "{merchantId}/orders/{orderId}/returnRefundLineItem",
"request": {
"$ref": "OrdersReturnRefundLineItemRequest"
},
"response": {
"$ref": "OrdersReturnRefundLineItemResponse"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"setlineitemmetadata": {
"description": "Sets (or overrides if it already exists) merchant provided annotations in the form of key-value pairs. A common use case would be to supply us with additional structured information about a line item that cannot be provided via other methods. Submitted key-value pairs can be retrieved as part of the orders resource.",
"httpMethod": "POST",
"id": "content.orders.setlineitemmetadata",
"parameterOrder": [
"merchantId",
"orderId"
],
"parameters": {
"merchantId": {
"description": "The ID of the account that manages the order. This cannot be a multi-client account.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
},
"orderId": {
"description": "The ID of the order.",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "{merchantId}/orders/{orderId}/setLineItemMetadata",
"request": {
"$ref": "OrdersSetLineItemMetadataRequest"
},
"response": {
"$ref": "OrdersSetLineItemMetadataResponse"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"shiplineitems": {
"description": "Marks line item(s) as shipped.",
"httpMethod": "POST",
"id": "content.orders.shiplineitems",
"parameterOrder": [
"merchantId",
"orderId"
],
"parameters": {
"merchantId": {
"description": "The ID of the account that manages the order. This cannot be a multi-client account.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
},
"orderId": {
"description": "The ID of the order.",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "{merchantId}/orders/{orderId}/shipLineItems",
"request": {
"$ref": "OrdersShipLineItemsRequest"
},
"response": {
"$ref": "OrdersShipLineItemsResponse"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"updatelineitemshippingdetails": {
"description": "Updates ship by and delivery by dates for a line item.",
"httpMethod": "POST",
"id": "content.orders.updatelineitemshippingdetails",
"parameterOrder": [
"merchantId",
"orderId"
],
"parameters": {
"merchantId": {
"description": "The ID of the account that manages the order. This cannot be a multi-client account.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
},
"orderId": {
"description": "The ID of the order.",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "{merchantId}/orders/{orderId}/updateLineItemShippingDetails",
"request": {
"$ref": "OrdersUpdateLineItemShippingDetailsRequest"
},
"response": {
"$ref": "OrdersUpdateLineItemShippingDetailsResponse"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"updatemerchantorderid": {
"description": "Updates the merchant order ID for a given order.",
"httpMethod": "POST",
"id": "content.orders.updatemerchantorderid",
"parameterOrder": [
"merchantId",
"orderId"
],
"parameters": {
"merchantId": {
"description": "The ID of the account that manages the order. This cannot be a multi-client account.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
},
"orderId": {
"description": "The ID of the order.",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "{merchantId}/orders/{orderId}/updateMerchantOrderId",
"request": {
"$ref": "OrdersUpdateMerchantOrderIdRequest"
},
"response": {
"$ref": "OrdersUpdateMerchantOrderIdResponse"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"updateshipment": {
"description": "Updates a shipment's status, carrier, and/or tracking ID.",
"httpMethod": "POST",
"id": "content.orders.updateshipment",
"parameterOrder": [
"merchantId",
"orderId"
],
"parameters": {
"merchantId": {
"description": "The ID of the account that manages the order. This cannot be a multi-client account.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
},
"orderId": {
"description": "The ID of the order.",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "{merchantId}/orders/{orderId}/updateShipment",
"request": {
"$ref": "OrdersUpdateShipmentRequest"
},
"response": {
"$ref": "OrdersUpdateShipmentResponse"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
}
}
},
"pos": {
"methods": {
"custombatch": {
"description": "Batches multiple POS-related calls in a single request.",
"httpMethod": "POST",
"id": "content.pos.custombatch",
"path": "pos/batch",
"request": {
"$ref": "PosCustomBatchRequest"
},
"response": {
"$ref": "PosCustomBatchResponse"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"delete": {
"description": "Deletes a store for the given merchant.",
"httpMethod": "DELETE",
"id": "content.pos.delete",
"parameterOrder": [
"merchantId",
"targetMerchantId",
"storeCode"
],
"parameters": {
"merchantId": {
"description": "The ID of the POS or inventory data provider.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
},
"storeCode": {
"description": "A store code that is unique per merchant.",
"location": "path",
"required": true,
"type": "string"
},
"targetMerchantId": {
"description": "The ID of the target merchant.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "{merchantId}/pos/{targetMerchantId}/store/{storeCode}",
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"get": {
"description": "Retrieves information about the given store.",
"httpMethod": "GET",
"id": "content.pos.get",
"parameterOrder": [
"merchantId",
"targetMerchantId",
"storeCode"
],
"parameters": {
"merchantId": {
"description": "The ID of the POS or inventory data provider.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
},
"storeCode": {
"description": "A store code that is unique per merchant.",
"location": "path",
"required": true,
"type": "string"
},
"targetMerchantId": {
"description": "The ID of the target merchant.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "{merchantId}/pos/{targetMerchantId}/store/{storeCode}",
"response": {
"$ref": "PosStore"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"insert": {
"description": "Creates a store for the given merchant.",
"httpMethod": "POST",
"id": "content.pos.insert",
"parameterOrder": [
"merchantId",
"targetMerchantId"
],
"parameters": {
"merchantId": {
"description": "The ID of the POS or inventory data provider.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
},
"targetMerchantId": {
"description": "The ID of the target merchant.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "{merchantId}/pos/{targetMerchantId}/store",
"request": {
"$ref": "PosStore"
},
"response": {
"$ref": "PosStore"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"inventory": {
"description": "Submit inventory for the given merchant.",
"httpMethod": "POST",
"id": "content.pos.inventory",
"parameterOrder": [
"merchantId",
"targetMerchantId"
],
"parameters": {
"merchantId": {
"description": "The ID of the POS or inventory data provider.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
},
"targetMerchantId": {
"description": "The ID of the target merchant.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "{merchantId}/pos/{targetMerchantId}/inventory",
"request": {
"$ref": "PosInventoryRequest"
},
"response": {
"$ref": "PosInventoryResponse"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"list": {
"description": "Lists the stores of the target merchant.",
"httpMethod": "GET",
"id": "content.pos.list",
"parameterOrder": [
"merchantId",
"targetMerchantId"
],
"parameters": {
"merchantId": {
"description": "The ID of the POS or inventory data provider.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
},
"targetMerchantId": {
"description": "The ID of the target merchant.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "{merchantId}/pos/{targetMerchantId}/store",
"response": {
"$ref": "PosListResponse"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"sale": {
"description": "Submit a sale event for the given merchant.",
"httpMethod": "POST",
"id": "content.pos.sale",
"parameterOrder": [
"merchantId",
"targetMerchantId"
],
"parameters": {
"merchantId": {
"description": "The ID of the POS or inventory data provider.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
},
"targetMerchantId": {
"description": "The ID of the target merchant.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "{merchantId}/pos/{targetMerchantId}/sale",
"request": {
"$ref": "PosSaleRequest"
},
"response": {
"$ref": "PosSaleResponse"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
}
}
},
"products": {
"methods": {
"custombatch": {
"description": "Retrieves, inserts, and deletes multiple products in a single request.",
"httpMethod": "POST",
"id": "content.products.custombatch",
"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.",
"httpMethod": "DELETE",
"id": "content.products.delete",
"parameterOrder": [
"merchantId",
"productId"
],
"parameters": {
"feedId": {
"description": "The Content API Supplemental Feed ID.",
"format": "uint64",
"location": "query",
"type": "string"
},
"merchantId": {
"description": "The ID of the account that contains the product. This account cannot be a multi-client account.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
},
"productId": {
"description": "The REST ID of the product.",
"location": "path",
"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.",
"httpMethod": "GET",
"id": "content.products.get",
"parameterOrder": [
"merchantId",
"productId"
],
"parameters": {
"merchantId": {
"description": "The ID of the account that contains the product. This account cannot be a multi-client account.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
},
"productId": {
"description": "The REST ID of the product.",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "{merchantId}/products/{productId}",
"response": {
"$ref": "Product"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"insert": {
"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.",
"httpMethod": "POST",
"id": "content.products.insert",
"parameterOrder": [
"merchantId"
],
"parameters": {
"feedId": {
"description": "The Content API Supplemental Feed ID.",
"format": "uint64",
"location": "query",
"type": "string"
},
"merchantId": {
"description": "The ID of the account that contains the product. This account cannot be a multi-client account.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "{merchantId}/products",
"request": {
"$ref": "Product"
},
"response": {
"$ref": "Product"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"list": {
"description": "Lists the products in your Merchant Center account. The response might contain fewer items than specified by maxResults. Rely on nextPageToken to determine if there are more items to be requested.",
"httpMethod": "GET",
"id": "content.products.list",
"parameterOrder": [
"merchantId"
],
"parameters": {
"maxResults": {
"description": "The maximum number of products to return in the response, used for paging.",
"format": "uint32",
"location": "query",
"type": "integer"
},
"merchantId": {
"description": "The ID of the account that contains the products. This account cannot be a multi-client account.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
},
"pageToken": {
"description": "The token returned by the previous request.",
"location": "query",
"type": "string"
}
},
"path": "{merchantId}/products",
"response": {
"$ref": "ProductsListResponse"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
}
}
},
"productstatuses": {
"methods": {
"custombatch": {
"description": "Gets the statuses of multiple products in a single request.",
"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.",
"httpMethod": "GET",
"id": "content.productstatuses.get",
"parameterOrder": [
"merchantId",
"productId"
],
"parameters": {
"destinations": {
"description": "If set, only issues for the specified destinations are returned, otherwise only issues for the Shopping destination.",
"location": "query",
"repeated": true,
"type": "string"
},
"merchantId": {
"description": "The ID of the account that contains the product. This account cannot be a multi-client account.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
},
"productId": {
"description": "The REST ID of the product.",
"location": "path",
"required": true,
"type": "string"
}
},
"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.",
"httpMethod": "GET",
"id": "content.productstatuses.list",
"parameterOrder": [
"merchantId"
],
"parameters": {
"destinations": {
"description": "If set, only issues for the specified destinations are returned, otherwise only issues for the Shopping destination.",
"location": "query",
"repeated": true,
"type": "string"
},
"maxResults": {
"description": "The maximum number of product statuses to return in the response, used for paging.",
"format": "uint32",
"location": "query",
"type": "integer"
},
"merchantId": {
"description": "The ID of the account that contains the products. This account cannot be a multi-client account.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
},
"pageToken": {
"description": "The token returned by the previous request.",
"location": "query",
"type": "string"
}
},
"path": "{merchantId}/productstatuses",
"response": {
"$ref": "ProductstatusesListResponse"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
}
}
},
"pubsubnotificationsettings": {
"methods": {
"get": {
"description": "Retrieves a Merchant Center account's pubsub notification settings.",
"httpMethod": "GET",
"id": "content.pubsubnotificationsettings.get",
"parameterOrder": [
"merchantId"
],
"parameters": {
"merchantId": {
"description": "The ID of the account for which to get pubsub notification settings.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "{merchantId}/pubsubnotificationsettings",
"response": {
"$ref": "PubsubNotificationSettings"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"update": {
"description": "Register a Merchant Center account for pubsub notifications. Note that cloud topic name should not be provided as part of the request.",
"httpMethod": "PUT",
"id": "content.pubsubnotificationsettings.update",
"parameterOrder": [
"merchantId"
],
"parameters": {
"merchantId": {
"description": "The ID of the account.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "{merchantId}/pubsubnotificationsettings",
"request": {
"$ref": "PubsubNotificationSettings"
},
"response": {
"$ref": "PubsubNotificationSettings"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
}
}
},
"regionalinventory": {
"methods": {
"custombatch": {
"description": "Updates regional inventory for multiple products or regions in a single request.",
"httpMethod": "POST",
"id": "content.regionalinventory.custombatch",
"path": "regionalinventory/batch",
"request": {
"$ref": "RegionalinventoryCustomBatchRequest"
},
"response": {
"$ref": "RegionalinventoryCustomBatchResponse"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"insert": {
"description": "Update the regional inventory of a product in your Merchant Center account. If a regional inventory with the same region ID already exists, this method updates that entry.",
"httpMethod": "POST",
"id": "content.regionalinventory.insert",
"parameterOrder": [
"merchantId",
"productId"
],
"parameters": {
"merchantId": {
"description": "The ID of the account that contains the product. This account cannot be a multi-client account.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
},
"productId": {
"description": "The REST ID of the product for which to update the regional inventory.",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "{merchantId}/products/{productId}/regionalinventory",
"request": {
"$ref": "RegionalInventory"
},
"response": {
"$ref": "RegionalInventory"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
}
}
},
"returnaddress": {
"methods": {
"custombatch": {
"description": "Batches multiple return address related calls in a single request.",
"httpMethod": "POST",
"id": "content.returnaddress.custombatch",
"path": "returnaddress/batch",
"request": {
"$ref": "ReturnaddressCustomBatchRequest"
},
"response": {
"$ref": "ReturnaddressCustomBatchResponse"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"delete": {
"description": "Deletes a return address for the given Merchant Center account.",
"httpMethod": "DELETE",
"id": "content.returnaddress.delete",
"parameterOrder": [
"merchantId",
"returnAddressId"
],
"parameters": {
"merchantId": {
"description": "The Merchant Center account from which to delete the given return address.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
},
"returnAddressId": {
"description": "Return address ID generated by Google.",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "{merchantId}/returnaddress/{returnAddressId}",
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"get": {
"description": "Gets a return address of the Merchant Center account.",
"httpMethod": "GET",
"id": "content.returnaddress.get",
"parameterOrder": [
"merchantId",
"returnAddressId"
],
"parameters": {
"merchantId": {
"description": "The Merchant Center account to get a return address for.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
},
"returnAddressId": {
"description": "Return address ID generated by Google.",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "{merchantId}/returnaddress/{returnAddressId}",
"response": {
"$ref": "ReturnAddress"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"insert": {
"description": "Inserts a return address for the Merchant Center account.",
"httpMethod": "POST",
"id": "content.returnaddress.insert",
"parameterOrder": [
"merchantId"
],
"parameters": {
"merchantId": {
"description": "The Merchant Center account to insert a return address for.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "{merchantId}/returnaddress",
"request": {
"$ref": "ReturnAddress"
},
"response": {
"$ref": "ReturnAddress"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"list": {
"description": "Lists the return addresses of the Merchant Center account.",
"httpMethod": "GET",
"id": "content.returnaddress.list",
"parameterOrder": [
"merchantId"
],
"parameters": {
"country": {
"description": "List only return addresses applicable to the given country of sale. When omitted, all return addresses are listed.",
"location": "query",
"type": "string"
},
"maxResults": {
"description": "The maximum number of addresses in the response, used for paging.",
"format": "uint32",
"location": "query",
"type": "integer"
},
"merchantId": {
"description": "The Merchant Center account to list return addresses for.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
},
"pageToken": {
"description": "The token returned by the previous request.",
"location": "query",
"type": "string"
}
},
"path": "{merchantId}/returnaddress",
"response": {
"$ref": "ReturnaddressListResponse"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
}
}
},
"returnpolicy": {
"methods": {
"custombatch": {
"description": "Batches multiple return policy related calls in a single request.",
"httpMethod": "POST",
"id": "content.returnpolicy.custombatch",
"path": "returnpolicy/batch",
"request": {
"$ref": "ReturnpolicyCustomBatchRequest"
},
"response": {
"$ref": "ReturnpolicyCustomBatchResponse"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"delete": {
"description": "Deletes a return policy for the given Merchant Center account.",
"httpMethod": "DELETE",
"id": "content.returnpolicy.delete",
"parameterOrder": [
"merchantId",
"returnPolicyId"
],
"parameters": {
"merchantId": {
"description": "The Merchant Center account from which to delete the given return policy.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
},
"returnPolicyId": {
"description": "Return policy ID generated by Google.",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "{merchantId}/returnpolicy/{returnPolicyId}",
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"get": {
"description": "Gets a return policy of the Merchant Center account.",
"httpMethod": "GET",
"id": "content.returnpolicy.get",
"parameterOrder": [
"merchantId",
"returnPolicyId"
],
"parameters": {
"merchantId": {
"description": "The Merchant Center account to get a return policy for.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
},
"returnPolicyId": {
"description": "Return policy ID generated by Google.",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "{merchantId}/returnpolicy/{returnPolicyId}",
"response": {
"$ref": "ReturnPolicy"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"insert": {
"description": "Inserts a return policy for the Merchant Center account.",
"httpMethod": "POST",
"id": "content.returnpolicy.insert",
"parameterOrder": [
"merchantId"
],
"parameters": {
"merchantId": {
"description": "The Merchant Center account to insert a return policy for.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "{merchantId}/returnpolicy",
"request": {
"$ref": "ReturnPolicy"
},
"response": {
"$ref": "ReturnPolicy"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"list": {
"description": "Lists the return policies of the Merchant Center account.",
"httpMethod": "GET",
"id": "content.returnpolicy.list",
"parameterOrder": [
"merchantId"
],
"parameters": {
"merchantId": {
"description": "The Merchant Center account to list return policies for.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "{merchantId}/returnpolicy",
"response": {
"$ref": "ReturnpolicyListResponse"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
}
}
},
"shippingsettings": {
"methods": {
"custombatch": {
"description": "Retrieves and updates the shipping settings of multiple accounts in a single request.",
"httpMethod": "POST",
"id": "content.shippingsettings.custombatch",
"path": "shippingsettings/batch",
"request": {
"$ref": "ShippingsettingsCustomBatchRequest"
},
"response": {
"$ref": "ShippingsettingsCustomBatchResponse"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"get": {
"description": "Retrieves the shipping settings of the 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",
"location": "path",
"required": true,
"type": "string"
},
"merchantId": {
"description": "The ID of the managing account. If this parameter is not the same as accountId, then this account must be a multi-client account and accountId must be the ID of a sub-account of this account.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "{merchantId}/shippingsettings/{accountId}",
"response": {
"$ref": "ShippingSettings"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"getsupportedcarriers": {
"description": "Retrieves supported carriers and carrier services for an account.",
"httpMethod": "GET",
"id": "content.shippingsettings.getsupportedcarriers",
"parameterOrder": [
"merchantId"
],
"parameters": {
"merchantId": {
"description": "The ID of the account for which to retrieve the supported carriers.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "{merchantId}/supportedCarriers",
"response": {
"$ref": "ShippingsettingsGetSupportedCarriersResponse"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"getsupportedholidays": {
"description": "Retrieves supported holidays for an account.",
"httpMethod": "GET",
"id": "content.shippingsettings.getsupportedholidays",
"parameterOrder": [
"merchantId"
],
"parameters": {
"merchantId": {
"description": "The ID of the account for which to retrieve the supported holidays.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "{merchantId}/supportedHolidays",
"response": {
"$ref": "ShippingsettingsGetSupportedHolidaysResponse"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"getsupportedpickupservices": {
"description": "Retrieves supported pickup services for an account.",
"httpMethod": "GET",
"id": "content.shippingsettings.getsupportedpickupservices",
"parameterOrder": [
"merchantId"
],
"parameters": {
"merchantId": {
"description": "The ID of the account for which to retrieve the supported pickup services.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "{merchantId}/supportedPickupServices",
"response": {
"$ref": "ShippingsettingsGetSupportedPickupServicesResponse"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"list": {
"description": "Lists the shipping settings of the sub-accounts in your Merchant Center account.",
"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",
"type": "integer"
},
"merchantId": {
"description": "The ID of the managing account. This must be a multi-client account.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
},
"pageToken": {
"description": "The token returned by the previous request.",
"location": "query",
"type": "string"
}
},
"path": "{merchantId}/shippingsettings",
"response": {
"$ref": "ShippingsettingsListResponse"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"update": {
"description": "Updates the shipping settings of the 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",
"location": "path",
"required": true,
"type": "string"
},
"merchantId": {
"description": "The ID of the managing account. If this parameter is not the same as accountId, then this account must be a multi-client account and accountId must be the ID of a sub-account of this account.",
"format": "uint64",
"location": "path",
"required": true,
"type": "string"
}
},
"path": "{merchantId}/shippingsettings/{accountId}",
"request": {
"$ref": "ShippingSettings"
},
"response": {
"$ref": "ShippingSettings"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
}
}
}
},
"revision": "20200303",
"rootUrl": "https://www.googleapis.com/",
"schemas": {
"Account": {
"description": "Account data. After the creation of a new account it may take a few minutes before it is fully operational. The methods delete, insert, and update require the admin role.",
"id": "Account",
"properties": {
"adsLinks": {
"description": "List of linked Ads accounts that are active or pending approval. To create a new link request, add a new link with status active to the list. It will remain in a pending state until approved or rejected either in the Ads interface or through the AdWords API. To delete an active link, or to cancel a link request, remove it from the list.",
"items": {
"$ref": "AccountAdsLink"
},
"type": "array"
},
"adultContent": {
"description": "Indicates whether the merchant sells adult content.",
"type": "boolean"
},
"businessInformation": {
"$ref": "AccountBusinessInformation",
"description": "The business information of the account."
},
"googleMyBusinessLink": {
"$ref": "AccountGoogleMyBusinessLink",
"description": "The GMB account which is linked or in the process of being linked with the Merchant Center account."
},
"id": {
"annotations": {
"required": [
"content.accounts.update"
]
},
"description": "Merchant Center account ID.",
"format": "uint64",
"type": "string"
},
"kind": {
"default": "content#account",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#account\".",
"type": "string"
},
"name": {
"annotations": {
"required": [
"content.accounts.insert",
"content.accounts.update"
]
},
"description": "Display name for the account.",
"type": "string"
},
"sellerId": {
"description": "Client-specific, locally-unique, internal ID for the child account.",
"type": "string"
},
"users": {
"description": "Users with access to the account. Every account (except for subaccounts) must have at least one admin user.",
"items": {
"$ref": "AccountUser"
},
"type": "array"
},
"websiteUrl": {
"description": "The merchant's website.",
"type": "string"
},
"youtubeChannelLinks": {
"description": "List of linked YouTube channels that are active or pending approval. To create a new link request, add a new link with status active to the list. It will remain in a pending state until approved or rejected in the YT Creator Studio interface. To delete an active link, or to cancel a link request, remove it from the list.",
"items": {
"$ref": "AccountYouTubeChannelLink"
},
"type": "array"
}
},
"type": "object"
},
"AccountAddress": {
"id": "AccountAddress",
"properties": {
"country": {
"description": "CLDR country code (e.g. \"US\").",
"type": "string"
},
"locality": {
"description": "City, town or commune. May also include dependent localities or sublocalities (e.g. neighborhoods or suburbs).",
"type": "string"
},
"postalCode": {
"description": "Postal code or ZIP (e.g. \"94043\").",
"type": "string"
},
"region": {
"description": "Top-level administrative subdivision of the country. For example, a state like California (\"CA\") or a province like Quebec (\"QC\").",
"type": "string"
},
"streetAddress": {
"description": "Street-level part of the address.",
"type": "string"
}
},
"type": "object"
},
"AccountAdsLink": {
"id": "AccountAdsLink",
"properties": {
"adsId": {
"description": "Customer ID of the Ads account.",
"format": "uint64",
"type": "string"
},
"status": {
"description": "Status of the link between this Merchant Center account and the Ads account. Upon retrieval, it represents the actual status of the link and can be either active if it was approved in Google Ads or pending if it's pending approval. Upon insertion, it represents the intended status of the link. Re-uploading a link with status active when it's still pending or with status pending when it's already active will have no effect: the status will remain unchanged. Re-uploading a link with deprecated status inactive is equivalent to not submitting the link at all and will delete the link if it was active or cancel the link request if it was pending.",
"type": "string"
}
},
"type": "object"
},
"AccountBusinessInformation": {
"id": "AccountBusinessInformation",
"properties": {
"address": {
"$ref": "AccountAddress",
"description": "The address of the business."
},
"customerService": {
"$ref": "AccountCustomerService",
"description": "The customer service information of the business."
},
"phoneNumber": {
"description": "The phone number of the business.",
"type": "string"
}
},
"type": "object"
},
"AccountCustomerService": {
"id": "AccountCustomerService",
"properties": {
"email": {
"description": "Customer service email.",
"type": "string"
},
"phoneNumber": {
"description": "Customer service phone number.",
"type": "string"
},
"url": {
"description": "Customer service URL.",
"type": "string"
}
},
"type": "object"
},
"AccountGoogleMyBusinessLink": {
"id": "AccountGoogleMyBusinessLink",
"properties": {
"gmbEmail": {
"description": "The GMB email address of which a specific account within a GMB account. A sample account within a GMB account could be a business account with set of locations, managed under the GMB account.",
"type": "string"
},
"status": {
"description": "Status of the link between this Merchant Center account and the GMB account.",
"type": "string"
}
},
"type": "object"
},
"AccountIdentifier": {
"id": "AccountIdentifier",
"properties": {
"aggregatorId": {
"description": "The aggregator ID, set for aggregators and subaccounts (in that case, it represents the aggregator of the subaccount).",
"format": "uint64",
"type": "string"
},
"merchantId": {
"description": "The merchant account ID, set for individual accounts and subaccounts.",
"format": "uint64",
"type": "string"
}
},
"type": "object"
},
"AccountStatus": {
"description": "The status of an account, i.e., information about its products, which is computed offline and not returned immediately at insertion time.",
"id": "AccountStatus",
"properties": {
"accountId": {
"description": "The ID of the account for which the status is reported.",
"type": "string"
},
"accountLevelIssues": {
"description": "A list of account level issues.",
"items": {
"$ref": "AccountStatusAccountLevelIssue"
},
"type": "array"
},
"kind": {
"default": "content#accountStatus",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#accountStatus\".",
"type": "string"
},
"products": {
"description": "List of product-related data by channel, destination, and country. Data in this field may be delayed by up to 30 minutes.",
"items": {
"$ref": "AccountStatusProducts"
},
"type": "array"
},
"websiteClaimed": {
"description": "Whether the account's website is claimed or not.",
"type": "boolean"
}
},
"type": "object"
},
"AccountStatusAccountLevelIssue": {
"id": "AccountStatusAccountLevelIssue",
"properties": {
"country": {
"description": "Country for which this issue is reported.",
"type": "string"
},
"destination": {
"description": "The destination the issue applies to.",
"type": "string"
},
"detail": {
"description": "Additional details about the issue.",
"type": "string"
},
"documentation": {
"description": "The URL of a web page to help resolving this issue.",
"type": "string"
},
"id": {
"description": "Issue identifier.",
"type": "string"
},
"severity": {
"description": "Severity of the issue.",
"type": "string"
},
"title": {
"description": "Short description of the issue.",
"type": "string"
}
},
"type": "object"
},
"AccountStatusItemLevelIssue": {
"id": "AccountStatusItemLevelIssue",
"properties": {
"attributeName": {
"description": "The attribute's name, if the issue is caused by a single attribute.",
"type": "string"
},
"code": {
"description": "The error code of the issue.",
"type": "string"
},
"description": {
"description": "A short issue description in English.",
"type": "string"
},
"detail": {
"description": "A detailed issue description in English.",
"type": "string"
},
"documentation": {
"description": "The URL of a web page to help with resolving this issue.",
"type": "string"
},
"numItems": {
"description": "Number of items with this issue.",
"format": "int64",
"type": "string"
},
"resolution": {
"description": "Whether the issue can be resolved by the merchant.",
"type": "string"
},
"servability": {
"description": "How this issue affects serving of the offer.",
"type": "string"
}
},
"type": "object"
},
"AccountStatusProducts": {
"id": "AccountStatusProducts",
"properties": {
"channel": {
"description": "The channel the data applies to.",
"type": "string"
},
"country": {
"description": "The country the data applies to.",
"type": "string"
},
"destination": {
"description": "The destination the data applies to.",
"type": "string"
},
"itemLevelIssues": {
"description": "List of item-level issues.",
"items": {
"$ref": "AccountStatusItemLevelIssue"
},
"type": "array"
},
"statistics": {
"$ref": "AccountStatusStatistics",
"description": "Aggregated product statistics."
}
},
"type": "object"
},
"AccountStatusStatistics": {
"id": "AccountStatusStatistics",
"properties": {
"active": {
"description": "Number of active offers.",
"format": "int64",
"type": "string"
},
"disapproved": {
"description": "Number of disapproved offers.",
"format": "int64",
"type": "string"
},
"expiring": {
"description": "Number of expiring offers.",
"format": "int64",
"type": "string"
},
"pending": {
"description": "Number of pending offers.",
"format": "int64",
"type": "string"
}
},
"type": "object"
},
"AccountTax": {
"description": "The tax settings of a merchant account. All methods require the admin role.",
"id": "AccountTax",
"properties": {
"accountId": {
"annotations": {
"required": [
"content.accounttax.update"
]
},
"description": "The ID of the account to which these account tax settings belong.",
"format": "uint64",
"type": "string"
},
"kind": {
"default": "content#accountTax",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#accountTax\".",
"type": "string"
},
"rules": {
"description": "Tax rules. Updating the tax rules will enable US taxes (not reversible). Defining no rules is equivalent to not charging tax at all.",
"items": {
"$ref": "AccountTaxTaxRule"
},
"type": "array"
}
},
"type": "object"
},
"AccountTaxTaxRule": {
"description": "Tax calculation rule to apply in a state or province (USA only).",
"id": "AccountTaxTaxRule",
"properties": {
"country": {
"description": "Country code in which tax is applicable.",
"type": "string"
},
"locationId": {
"annotations": {
"required": [
"content.accounttax.update"
]
},
"description": "State (or province) is which the tax is applicable, described by its location ID (also called criteria ID).",
"format": "uint64",
"type": "string"
},
"ratePercent": {
"description": "Explicit tax rate in percent, represented as a floating point number without the percentage character. Must not be negative.",
"type": "string"
},
"shippingTaxed": {
"description": "If true, shipping charges are also taxed.",
"type": "boolean"
},
"useGlobalRate": {
"description": "Whether the tax rate is taken from a global tax table or specified explicitly.",
"type": "boolean"
}
},
"type": "object"
},
"AccountUser": {
"id": "AccountUser",
"properties": {
"admin": {
"description": "Whether user is an admin.",
"type": "boolean"
},
"emailAddress": {
"description": "User's email address.",
"type": "string"
},
"orderManager": {
"description": "Whether user is an order manager.",
"type": "boolean"
},
"paymentsAnalyst": {
"description": "Whether user can access payment statements.",
"type": "boolean"
},
"paymentsManager": {
"description": "Whether user can manage payment settings.",
"type": "boolean"
}
},
"type": "object"
},
"AccountYouTubeChannelLink": {
"id": "AccountYouTubeChannelLink",
"properties": {
"channelId": {
"description": "Channel ID.",
"type": "string"
},
"status": {
"description": "Status of the link between this Merchant Center account and the YouTube channel. Upon retrieval, it represents the actual status of the link and can be either active if it was approved in YT Creator Studio or pending if it's pending approval. Upon insertion, it represents the intended status of the link. Re-uploading a link with status active when it's still pending or with status pending when it's already active will have no effect: the status will remain unchanged. Re-uploading a link with deprecated status inactive is equivalent to not submitting the link at all and will delete the link if it was active or cancel the link request if it was pending.",
"type": "string"
}
},
"type": "object"
},
"AccountsAuthInfoResponse": {
"id": "AccountsAuthInfoResponse",
"properties": {
"accountIdentifiers": {
"description": "The account identifiers corresponding to the authenticated user.\n- For an individual account: only the merchant ID is defined\n- For an aggregator: only the aggregator ID is defined\n- For a subaccount of an MCA: both the merchant ID and the aggregator ID are defined.",
"items": {
"$ref": "AccountIdentifier"
},
"type": "array"
},
"kind": {
"default": "content#accountsAuthInfoResponse",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#accountsAuthInfoResponse\".",
"type": "string"
}
},
"type": "object"
},
"AccountsClaimWebsiteResponse": {
"id": "AccountsClaimWebsiteResponse",
"properties": {
"kind": {
"default": "content#accountsClaimWebsiteResponse",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#accountsClaimWebsiteResponse\".",
"type": "string"
}
},
"type": "object"
},
"AccountsCustomBatchRequest": {
"id": "AccountsCustomBatchRequest",
"properties": {
"entries": {
"description": "The request entries to be processed in the batch.",
"items": {
"$ref": "AccountsCustomBatchRequestEntry"
},
"type": "array"
}
},
"type": "object"
},
"AccountsCustomBatchRequestEntry": {
"description": "A batch entry encoding a single non-batch accounts request.",
"id": "AccountsCustomBatchRequestEntry",
"properties": {
"account": {
"$ref": "Account",
"description": "The account to create or update. Only defined if the method is insert or update."
},
"accountId": {
"description": "The ID of the targeted account. Only defined if the method is not insert.",
"format": "uint64",
"type": "string"
},
"batchId": {
"description": "An entry ID, unique within the batch request.",
"format": "uint32",
"type": "integer"
},
"force": {
"description": "Whether the account should be deleted if the account has offers. Only applicable if the method is delete.",
"type": "boolean"
},
"linkRequest": {
"$ref": "AccountsCustomBatchRequestEntryLinkRequest",
"description": "Details about the link request."
},
"merchantId": {
"description": "The ID of the managing account.",
"format": "uint64",
"type": "string"
},
"method": {
"description": "The method of the batch entry.",
"type": "string"
},
"overwrite": {
"description": "Only applicable if the method is claimwebsite. Indicates whether or not to take the claim from another account in case there is a conflict.",
"type": "boolean"
}
},
"type": "object"
},
"AccountsCustomBatchRequestEntryLinkRequest": {
"id": "AccountsCustomBatchRequestEntryLinkRequest",
"properties": {
"action": {
"description": "Action to perform for this link. The \"request\" action is only available to select merchants.",
"type": "string"
},
"linkType": {
"description": "Type of the link between the two accounts.",
"type": "string"
},
"linkedAccountId": {
"description": "The ID of the linked account.",
"type": "string"
},
"services": {
"description": "List of provided services.",
"items": {
"type": "string"
},
"type": "array"
}
},
"type": "object"
},
"AccountsCustomBatchResponse": {
"id": "AccountsCustomBatchResponse",
"properties": {
"entries": {
"description": "The result of the execution of the batch requests.",
"items": {
"$ref": "AccountsCustomBatchResponseEntry"
},
"type": "array"
},
"kind": {
"default": "content#accountsCustomBatchResponse",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#accountsCustomBatchResponse\".",
"type": "string"
}
},
"type": "object"
},
"AccountsCustomBatchResponseEntry": {
"description": "A batch entry encoding a single non-batch accounts response.",
"id": "AccountsCustomBatchResponseEntry",
"properties": {
"account": {
"$ref": "Account",
"description": "The retrieved, created, or updated account. Not defined if the method was delete, claimwebsite or link."
},
"batchId": {
"description": "The ID of the request entry this entry responds to.",
"format": "uint32",
"type": "integer"
},
"errors": {
"$ref": "Errors",
"description": "A list of errors defined if and only if the request failed."
},
"kind": {
"default": "content#accountsCustomBatchResponseEntry",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#accountsCustomBatchResponseEntry\".",
"type": "string"
}
},
"type": "object"
},
"AccountsLinkRequest": {
"id": "AccountsLinkRequest",
"properties": {
"action": {
"description": "Action to perform for this link. The \"request\" action is only available to select merchants.",
"type": "string"
},
"linkType": {
"description": "Type of the link between the two accounts.",
"type": "string"
},
"linkedAccountId": {
"description": "The ID of the linked account.",
"type": "string"
},
"services": {
"description": "List of provided services.",
"items": {
"type": "string"
},
"type": "array"
}
},
"type": "object"
},
"AccountsLinkResponse": {
"id": "AccountsLinkResponse",
"properties": {
"kind": {
"default": "content#accountsLinkResponse",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#accountsLinkResponse\".",
"type": "string"
}
},
"type": "object"
},
"AccountsListLinksResponse": {
"id": "AccountsListLinksResponse",
"properties": {
"kind": {
"default": "content#accountsListLinksResponse",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#accountsListLinksResponse\".",
"type": "string"
},
"links": {
"description": "The list of available links.",
"items": {
"$ref": "LinkedAccount"
},
"type": "array"
},
"nextPageToken": {
"description": "The token for the retrieval of the next page of links.",
"type": "string"
}
},
"type": "object"
},
"AccountsListResponse": {
"id": "AccountsListResponse",
"properties": {
"kind": {
"default": "content#accountsListResponse",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#accountsListResponse\".",
"type": "string"
},
"nextPageToken": {
"description": "The token for the retrieval of the next page of accounts.",
"type": "string"
},
"resources": {
"items": {
"$ref": "Account"
},
"type": "array"
}
},
"type": "object"
},
"AccountstatusesCustomBatchRequest": {
"id": "AccountstatusesCustomBatchRequest",
"properties": {
"entries": {
"description": "The request entries to be processed in the batch.",
"items": {
"$ref": "AccountstatusesCustomBatchRequestEntry"
},
"type": "array"
}
},
"type": "object"
},
"AccountstatusesCustomBatchRequestEntry": {
"description": "A batch entry encoding a single non-batch accountstatuses request.",
"id": "AccountstatusesCustomBatchRequestEntry",
"properties": {
"accountId": {
"description": "The ID of the (sub-)account whose status to get.",
"format": "uint64",
"type": "string"
},
"batchId": {
"description": "An entry ID, unique within the batch request.",
"format": "uint32",
"type": "integer"
},
"destinations": {
"description": "If set, only issues for the specified destinations are returned, otherwise only issues for the Shopping destination.",
"items": {
"type": "string"
},
"type": "array"
},
"merchantId": {
"description": "The ID of the managing account.",
"format": "uint64",
"type": "string"
},
"method": {
"description": "The method (get).",
"type": "string"
}
},
"type": "object"
},
"AccountstatusesCustomBatchResponse": {
"id": "AccountstatusesCustomBatchResponse",
"properties": {
"entries": {
"description": "The result of the execution of the batch requests.",
"items": {
"$ref": "AccountstatusesCustomBatchResponseEntry"
},
"type": "array"
},
"kind": {
"default": "content#accountstatusesCustomBatchResponse",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#accountstatusesCustomBatchResponse\".",
"type": "string"
}
},
"type": "object"
},
"AccountstatusesCustomBatchResponseEntry": {
"description": "A batch entry encoding a single non-batch accountstatuses response.",
"id": "AccountstatusesCustomBatchResponseEntry",
"properties": {
"accountStatus": {
"$ref": "AccountStatus",
"description": "The requested account status. Defined if and only if the request was successful."
},
"batchId": {
"description": "The ID of the request entry this entry responds to.",
"format": "uint32",
"type": "integer"
},
"errors": {
"$ref": "Errors",
"description": "A list of errors defined if and only if the request failed."
}
},
"type": "object"
},
"AccountstatusesListResponse": {
"id": "AccountstatusesListResponse",
"properties": {
"kind": {
"default": "content#accountstatusesListResponse",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#accountstatusesListResponse\".",
"type": "string"
},
"nextPageToken": {
"description": "The token for the retrieval of the next page of account statuses.",
"type": "string"
},
"resources": {
"items": {
"$ref": "AccountStatus"
},
"type": "array"
}
},
"type": "object"
},
"AccounttaxCustomBatchRequest": {
"id": "AccounttaxCustomBatchRequest",
"properties": {
"entries": {
"description": "The request entries to be processed in the batch.",
"items": {
"$ref": "AccounttaxCustomBatchRequestEntry"
},
"type": "array"
}
},
"type": "object"
},
"AccounttaxCustomBatchRequestEntry": {
"description": "A batch entry encoding a single non-batch accounttax request.",
"id": "AccounttaxCustomBatchRequestEntry",
"properties": {
"accountId": {
"description": "The ID of the account for which to get/update account tax settings.",
"format": "uint64",
"type": "string"
},
"accountTax": {
"$ref": "AccountTax",
"description": "The account tax settings to update. Only defined if the method is update."
},
"batchId": {
"description": "An entry ID, unique within the batch request.",
"format": "uint32",
"type": "integer"
},
"merchantId": {
"description": "The ID of the managing account.",
"format": "uint64",
"type": "string"
},
"method": {
"type": "string"
}
},
"type": "object"
},
"AccounttaxCustomBatchResponse": {
"id": "AccounttaxCustomBatchResponse",
"properties": {
"entries": {
"description": "The result of the execution of the batch requests.",
"items": {
"$ref": "AccounttaxCustomBatchResponseEntry"
},
"type": "array"
},
"kind": {
"default": "content#accounttaxCustomBatchResponse",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#accounttaxCustomBatchResponse\".",
"type": "string"
}
},
"type": "object"
},
"AccounttaxCustomBatchResponseEntry": {
"description": "A batch entry encoding a single non-batch accounttax response.",
"id": "AccounttaxCustomBatchResponseEntry",
"properties": {
"accountTax": {
"$ref": "AccountTax",
"description": "The retrieved or updated account tax settings."
},
"batchId": {
"description": "The ID of the request entry this entry responds to.",
"format": "uint32",
"type": "integer"
},
"errors": {
"$ref": "Errors",
"description": "A list of errors defined if and only if the request failed."
},
"kind": {
"default": "content#accounttaxCustomBatchResponseEntry",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#accounttaxCustomBatchResponseEntry\".",
"type": "string"
}
},
"type": "object"
},
"AccounttaxListResponse": {
"id": "AccounttaxListResponse",
"properties": {
"kind": {
"default": "content#accounttaxListResponse",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#accounttaxListResponse\".",
"type": "string"
},
"nextPageToken": {
"description": "The token for the retrieval of the next page of account tax settings.",
"type": "string"
},
"resources": {
"items": {
"$ref": "AccountTax"
},
"type": "array"
}
},
"type": "object"
},
"Amount": {
"id": "Amount",
"properties": {
"priceAmount": {
"$ref": "Price",
"description": "[required] The pre-tax or post-tax price depending on the location of the order."
},
"taxAmount": {
"$ref": "Price",
"description": "[required] Tax value."
}
},
"type": "object"
},
"BusinessDayConfig": {
"id": "BusinessDayConfig",
"properties": {
"businessDays": {
"description": "Regular business days. May not be empty.",
"items": {
"type": "string"
},
"type": "array"
}
},
"type": "object"
},
"CarrierRate": {
"id": "CarrierRate",
"properties": {
"carrierName": {
"description": "Carrier service, such as \"UPS\" or \"Fedex\". The list of supported carriers can be retrieved via the getSupportedCarriers method. Required.",
"type": "string"
},
"carrierService": {
"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.",
"type": "string"
},
"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": {
"description": "Name of the carrier rate. Must be unique per rate group. Required.",
"type": "string"
},
"originPostalCode": {
"description": "Shipping origin for this carrier rate. Required.",
"type": "string"
},
"percentageAdjustment": {
"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.",
"type": "string"
}
},
"type": "object"
},
"CarriersCarrier": {
"id": "CarriersCarrier",
"properties": {
"country": {
"description": "The CLDR country code of the carrier (e.g., \"US\"). Always present.",
"type": "string"
},
"name": {
"description": "The name of the carrier (e.g., \"UPS\"). Always present.",
"type": "string"
},
"services": {
"description": "A list of supported services (e.g., \"ground\") for that carrier. Contains at least one service.",
"items": {
"type": "string"
},
"type": "array"
}
},
"type": "object"
},
"CustomAttribute": {
"id": "CustomAttribute",
"properties": {
"groupValues": {
"description": "Subattributes within this attribute group. Exactly one of value or groupValues must be provided.",
"items": {
"$ref": "CustomAttribute"
},
"type": "array"
},
"name": {
"description": "The name of the attribute. Underscores will be replaced by spaces upon insertion.",
"type": "string"
},
"value": {
"description": "The value of the attribute.",
"type": "string"
}
},
"type": "object"
},
"CustomerReturnReason": {
"id": "CustomerReturnReason",
"properties": {
"description": {
"description": "Description of the reason.",
"type": "string"
},
"reasonCode": {
"description": "Code of the return reason.",
"type": "string"
}
},
"type": "object"
},
"CutoffTime": {
"id": "CutoffTime",
"properties": {
"hour": {
"description": "Hour of the cutoff time until which an order has to be placed to be processed in the same day. Required.",
"format": "uint32",
"type": "integer"
},
"minute": {
"description": "Minute of the cutoff time until which an order has to be placed to be processed in the same day. Required.",
"format": "uint32",
"type": "integer"
},
"timezone": {
"description": "Timezone identifier for the cutoff time. A list of identifiers can be found in the AdWords API documentation. E.g. \"Europe/Zurich\". Required.",
"type": "string"
}
},
"type": "object"
},
"Datafeed": {
"description": "Datafeed configuration data.",
"id": "Datafeed",
"properties": {
"attributeLanguage": {
"description": "The two-letter ISO 639-1 language in which the attributes are defined in the data feed.",
"type": "string"
},
"contentType": {
"annotations": {
"required": [
"content.datafeeds.insert",
"content.datafeeds.update"
]
},
"description": "The type of data feed. For product inventory feeds, only feeds for local stores, not online stores, are supported.",
"type": "string"
},
"fetchSchedule": {
"$ref": "DatafeedFetchSchedule",
"description": "Fetch schedule for the feed file."
},
"fileName": {
"annotations": {
"required": [
"content.datafeeds.insert",
"content.datafeeds.update"
]
},
"description": "The filename of the feed. All feeds must have a unique file name.",
"type": "string"
},
"format": {
"$ref": "DatafeedFormat",
"description": "Format of the feed file."
},
"id": {
"annotations": {
"required": [
"content.datafeeds.update"
]
},
"description": "The ID of the data feed.",
"format": "int64",
"type": "string"
},
"kind": {
"default": "content#datafeed",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#datafeed\".",
"type": "string"
},
"name": {
"annotations": {
"required": [
"content.datafeeds.insert"
]
},
"description": "A descriptive name of the data feed.",
"type": "string"
},
"targets": {
"description": "The targets this feed should apply to (country, language, destinations).",
"items": {
"$ref": "DatafeedTarget"
},
"type": "array"
}
},
"type": "object"
},
"DatafeedFetchSchedule": {
"description": "The required fields vary based on the frequency of fetching. For a monthly fetch schedule, day_of_month and hour are required. For a weekly fetch schedule, weekday and hour are required. For a daily fetch schedule, only hour is required.",
"id": "DatafeedFetchSchedule",
"properties": {
"dayOfMonth": {
"description": "The day of the month the feed file should be fetched (1-31).",
"format": "uint32",
"type": "integer"
},
"fetchUrl": {
"description": "The URL where the feed file can be fetched. Google Merchant Center will support automatic scheduled uploads using the HTTP, HTTPS, FTP, or SFTP protocols, so the value will need to be a valid link using one of those four protocols.",
"type": "string"
},
"hour": {
"description": "The hour of the day the feed file should be fetched (0-23).",
"format": "uint32",
"type": "integer"
},
"minuteOfHour": {
"description": "The minute of the hour the feed file should be fetched (0-59). Read-only.",
"format": "uint32",
"type": "integer"
},
"password": {
"description": "An optional password for fetch_url.",
"type": "string"
},
"paused": {
"description": "Whether the scheduled fetch is paused or not.",
"type": "boolean"
},
"timeZone": {
"description": "Time zone used for schedule. UTC by default. E.g., \"America/Los_Angeles\".",
"type": "string"
},
"username": {
"description": "An optional user name for fetch_url.",
"type": "string"
},
"weekday": {
"description": "The day of the week the feed file should be fetched.",
"type": "string"
}
},
"type": "object"
},
"DatafeedFormat": {
"id": "DatafeedFormat",
"properties": {
"columnDelimiter": {
"description": "Delimiter for the separation of values in a delimiter-separated values feed. If not specified, the delimiter will be auto-detected. Ignored for non-DSV data feeds.",
"type": "string"
},
"fileEncoding": {
"description": "Character encoding scheme of the data feed. If not specified, the encoding will be auto-detected.",
"type": "string"
},
"quotingMode": {
"description": "Specifies how double quotes are interpreted. If not specified, the mode will be auto-detected. Ignored for non-DSV data feeds.",
"type": "string"
}
},
"type": "object"
},
"DatafeedStatus": {
"description": "The status of a datafeed, i.e., the result of the last retrieval of the datafeed computed asynchronously when the feed processing is finished.",
"id": "DatafeedStatus",
"properties": {
"country": {
"description": "The country for which the status is reported, represented as a CLDR territory code.",
"type": "string"
},
"datafeedId": {
"description": "The ID of the feed for which the status is reported.",
"format": "uint64",
"type": "string"
},
"errors": {
"description": "The list of errors occurring in the feed.",
"items": {
"$ref": "DatafeedStatusError"
},
"type": "array"
},
"itemsTotal": {
"description": "The number of items in the feed that were processed.",
"format": "uint64",
"type": "string"
},
"itemsValid": {
"description": "The number of items in the feed that were valid.",
"format": "uint64",
"type": "string"
},
"kind": {
"default": "content#datafeedStatus",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#datafeedStatus\".",
"type": "string"
},
"language": {
"description": "The two-letter ISO 639-1 language for which the status is reported.",
"type": "string"
},
"lastUploadDate": {
"description": "The last date at which the feed was uploaded.",
"type": "string"
},
"processingStatus": {
"description": "The processing status of the feed.",
"type": "string"
},
"warnings": {
"description": "The list of errors occurring in the feed.",
"items": {
"$ref": "DatafeedStatusError"
},
"type": "array"
}
},
"type": "object"
},
"DatafeedStatusError": {
"description": "An error occurring in the feed, like \"invalid price\".",
"id": "DatafeedStatusError",
"properties": {
"code": {
"description": "The code of the error, e.g., \"validation/invalid_value\".",
"type": "string"
},
"count": {
"description": "The number of occurrences of the error in the feed.",
"format": "uint64",
"type": "string"
},
"examples": {
"description": "A list of example occurrences of the error, grouped by product.",
"items": {
"$ref": "DatafeedStatusExample"
},
"type": "array"
},
"message": {
"description": "The error message, e.g., \"Invalid price\".",
"type": "string"
}
},
"type": "object"
},
"DatafeedStatusExample": {
"description": "An example occurrence for a particular error.",
"id": "DatafeedStatusExample",
"properties": {
"itemId": {
"description": "The ID of the example item.",
"type": "string"
},
"lineNumber": {
"description": "Line number in the data feed where the example is found.",
"format": "uint64",
"type": "string"
},
"value": {
"description": "The problematic value.",
"type": "string"
}
},
"type": "object"
},
"DatafeedTarget": {
"id": "DatafeedTarget",
"properties": {
"country": {
"description": "The country where the items in the feed will be included in the search index, represented as a CLDR territory code.",
"type": "string"
},
"excludedDestinations": {
"description": "The list of destinations to exclude for this target (corresponds to unchecked check boxes in Merchant Center).",
"items": {
"type": "string"
},
"type": "array"
},
"includedDestinations": {
"description": "The list of destinations to include for this target (corresponds to checked check boxes in Merchant Center). Default destinations are always included unless provided in excludedDestinations.\n\nList of supported destinations (if available to the account): \n- DisplayAds \n- Shopping \n- ShoppingActions \n- SurfacesAcrossGoogle",
"items": {
"type": "string"
},
"type": "array"
},
"language": {
"description": "The two-letter ISO 639-1 language of the items in the feed. Must be a valid language for targets[].country.",
"type": "string"
}
},
"type": "object"
},
"DatafeedsCustomBatchRequest": {
"id": "DatafeedsCustomBatchRequest",
"properties": {
"entries": {
"description": "The request entries to be processed in the batch.",
"items": {
"$ref": "DatafeedsCustomBatchRequestEntry"
},
"type": "array"
}
},
"type": "object"
},
"DatafeedsCustomBatchRequestEntry": {
"description": "A batch entry encoding a single non-batch datafeeds request.",
"id": "DatafeedsCustomBatchRequestEntry",
"properties": {
"batchId": {
"description": "An entry ID, unique within the batch request.",
"format": "uint32",
"type": "integer"
},
"datafeed": {
"$ref": "Datafeed",
"description": "The data feed to insert."
},
"datafeedId": {
"description": "The ID of the data feed to get, delete or fetch.",
"format": "uint64",
"type": "string"
},
"merchantId": {
"description": "The ID of the managing account.",
"format": "uint64",
"type": "string"
},
"method": {
"type": "string"
}
},
"type": "object"
},
"DatafeedsCustomBatchResponse": {
"id": "DatafeedsCustomBatchResponse",
"properties": {
"entries": {
"description": "The result of the execution of the batch requests.",
"items": {
"$ref": "DatafeedsCustomBatchResponseEntry"
},
"type": "array"
},
"kind": {
"default": "content#datafeedsCustomBatchResponse",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#datafeedsCustomBatchResponse\".",
"type": "string"
}
},
"type": "object"
},
"DatafeedsCustomBatchResponseEntry": {
"description": "A batch entry encoding a single non-batch datafeeds response.",
"id": "DatafeedsCustomBatchResponseEntry",
"properties": {
"batchId": {
"description": "The ID of the request entry this entry responds to.",
"format": "uint32",
"type": "integer"
},
"datafeed": {
"$ref": "Datafeed",
"description": "The requested data feed. Defined if and only if the request was successful."
},
"errors": {
"$ref": "Errors",
"description": "A list of errors defined if and only if the request failed."
}
},
"type": "object"
},
"DatafeedsFetchNowResponse": {
"id": "DatafeedsFetchNowResponse",
"properties": {
"kind": {
"default": "content#datafeedsFetchNowResponse",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#datafeedsFetchNowResponse\".",
"type": "string"
}
},
"type": "object"
},
"DatafeedsListResponse": {
"id": "DatafeedsListResponse",
"properties": {
"kind": {
"default": "content#datafeedsListResponse",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#datafeedsListResponse\".",
"type": "string"
},
"nextPageToken": {
"description": "The token for the retrieval of the next page of datafeeds.",
"type": "string"
},
"resources": {
"items": {
"$ref": "Datafeed"
},
"type": "array"
}
},
"type": "object"
},
"DatafeedstatusesCustomBatchRequest": {
"id": "DatafeedstatusesCustomBatchRequest",
"properties": {
"entries": {
"description": "The request entries to be processed in the batch.",
"items": {
"$ref": "DatafeedstatusesCustomBatchRequestEntry"
},
"type": "array"
}
},
"type": "object"
},
"DatafeedstatusesCustomBatchRequestEntry": {
"description": "A batch entry encoding a single non-batch datafeedstatuses request.",
"id": "DatafeedstatusesCustomBatchRequestEntry",
"properties": {
"batchId": {
"description": "An entry ID, unique within the batch request.",
"format": "uint32",
"type": "integer"
},
"country": {
"description": "The country for which to get the datafeed status. If this parameter is provided then language must also be provided. Note that for multi-target datafeeds this parameter is required.",
"type": "string"
},
"datafeedId": {
"description": "The ID of the data feed to get.",
"format": "uint64",
"type": "string"
},
"language": {
"description": "The language for which to get the datafeed status. If this parameter is provided then country must also be provided. Note that for multi-target datafeeds this parameter is required.",
"type": "string"
},
"merchantId": {
"description": "The ID of the managing account.",
"format": "uint64",
"type": "string"
},
"method": {
"type": "string"
}
},
"type": "object"
},
"DatafeedstatusesCustomBatchResponse": {
"id": "DatafeedstatusesCustomBatchResponse",
"properties": {
"entries": {
"description": "The result of the execution of the batch requests.",
"items": {
"$ref": "DatafeedstatusesCustomBatchResponseEntry"
},
"type": "array"
},
"kind": {
"default": "content#datafeedstatusesCustomBatchResponse",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#datafeedstatusesCustomBatchResponse\".",
"type": "string"
}
},
"type": "object"
},
"DatafeedstatusesCustomBatchResponseEntry": {
"description": "A batch entry encoding a single non-batch datafeedstatuses response.",
"id": "DatafeedstatusesCustomBatchResponseEntry",
"properties": {
"batchId": {
"description": "The ID of the request entry this entry responds to.",
"format": "uint32",
"type": "integer"
},
"datafeedStatus": {
"$ref": "DatafeedStatus",
"description": "The requested data feed status. Defined if and only if the request was successful."
},
"errors": {
"$ref": "Errors",
"description": "A list of errors defined if and only if the request failed."
}
},
"type": "object"
},
"DatafeedstatusesListResponse": {
"id": "DatafeedstatusesListResponse",
"properties": {
"kind": {
"default": "content#datafeedstatusesListResponse",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#datafeedstatusesListResponse\".",
"type": "string"
},
"nextPageToken": {
"description": "The token for the retrieval of the next page of datafeed statuses.",
"type": "string"
},
"resources": {
"items": {
"$ref": "DatafeedStatus"
},
"type": "array"
}
},
"type": "object"
},
"DeliveryTime": {
"id": "DeliveryTime",
"properties": {
"cutoffTime": {
"$ref": "CutoffTime",
"description": "Business days cutoff time definition. If not configured the cutoff time will be defaulted to 8AM PST."
},
"handlingBusinessDayConfig": {
"$ref": "BusinessDayConfig",
"description": "The business days during which orders can be handled. If not provided, Monday to Friday business days will be assumed."
},
"holidayCutoffs": {
"description": "Holiday cutoff definitions. If configured, they specify order cutoff times for holiday-specific shipping.",
"items": {
"$ref": "HolidayCutoff"
},
"type": "array"
},
"maxHandlingTimeInDays": {
"description": "Maximum number of business days spent before an order is shipped. 0 means same day shipped, 1 means next day shipped. Must be greater than or equal to minHandlingTimeInDays.",
"format": "uint32",
"type": "integer"
},
"maxTransitTimeInDays": {
"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.",
"format": "uint32",
"type": "integer"
},
"minHandlingTimeInDays": {
"description": "Minimum number of business days spent before an order is shipped. 0 means same day shipped, 1 means next day shipped.",
"format": "uint32",
"type": "integer"
},
"minTransitTimeInDays": {
"description": "Minimum number of business days that is spent in transit. 0 means same day delivery, 1 means next day delivery. Either {min,max}TransitTimeInDays or transitTimeTable must be set, but not both.",
"format": "uint32",
"type": "integer"
},
"transitBusinessDayConfig": {
"$ref": "BusinessDayConfig",
"description": "The business days during which orders can be in-transit. If not provided, Monday to Friday business days will be assumed."
},
"transitTimeTable": {
"$ref": "TransitTable",
"description": "Transit time table, number of business days spent in transit based on row and column dimensions. Either {min,max}TransitTimeInDays or transitTimeTable can be set, but not both."
}
},
"type": "object"
},
"Error": {
"description": "An error returned by the API.",
"id": "Error",
"properties": {
"domain": {
"description": "The domain of the error.",
"type": "string"
},
"message": {
"description": "A description of the error.",
"type": "string"
},
"reason": {
"description": "The error code.",
"type": "string"
}
},
"type": "object"
},
"Errors": {
"description": "A list of errors returned by a failed batch entry.",
"id": "Errors",
"properties": {
"code": {
"description": "The HTTP status of the first error in errors.",
"format": "uint32",
"type": "integer"
},
"errors": {
"description": "A list of errors.",
"items": {
"$ref": "Error"
},
"type": "array"
},
"message": {
"description": "The message of the first error in errors.",
"type": "string"
}
},
"type": "object"
},
"GmbAccounts": {
"id": "GmbAccounts",
"properties": {
"accountId": {
"description": "The ID of the account.",
"format": "uint64",
"type": "string"
},
"gmbAccounts": {
"description": "A list of GMB accounts which are available to the merchant.",
"items": {
"$ref": "GmbAccountsGmbAccount"
},
"type": "array"
}
},
"type": "object"
},
"GmbAccountsGmbAccount": {
"id": "GmbAccountsGmbAccount",
"properties": {
"email": {
"description": "The email which identifies the GMB account.",
"type": "string"
},
"listingCount": {
"description": "Number of listings under this account.",
"format": "uint64",
"type": "string"
},
"name": {
"description": "The name of the GMB account.",
"type": "string"
},
"type": {
"description": "The type of the GMB account (User or Business).",
"type": "string"
}
},
"type": "object"
},
"Headers": {
"description": "A non-empty list of row or column headers for a table. Exactly one of prices, weights, numItems, postalCodeGroupNames, or location must be set.",
"id": "Headers",
"properties": {
"locations": {
"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"
},
"type": "array"
},
"numberOfItems": {
"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"
},
"type": "array"
},
"postalCodeGroupNames": {
"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"
},
"type": "array"
},
"prices": {
"description": "A list of inclusive order price upper bounds. The last price's value can 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"
},
"type": "array"
},
"weights": {
"description": "A list of inclusive order weight upper bounds. The last weight's value can 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"
},
"type": "array"
}
},
"type": "object"
},
"HolidayCutoff": {
"id": "HolidayCutoff",
"properties": {
"deadlineDate": {
"description": "Date of the order deadline, in ISO 8601 format. E.g. \"2016-11-29\" for 29th November 2016. Required.",
"type": "string"
},
"deadlineHour": {
"description": "Hour of the day on the deadline date until which the order has to be placed to qualify for the delivery guarantee. Possible values are: 0 (midnight), 1, ..., 12 (noon), 13, ..., 23. Required.",
"format": "uint32",
"type": "integer"
},
"deadlineTimezone": {
"description": "Timezone identifier for the deadline hour. A list of identifiers can be found in the AdWords API documentation. E.g. \"Europe/Zurich\". Required.",
"type": "string"
},
"holidayId": {
"description": "Unique identifier for the holiday. Required.",
"type": "string"
},
"visibleFromDate": {
"description": "Date on which the deadline will become visible to consumers in ISO 8601 format. E.g. \"2016-10-31\" for 31st October 2016. Required.",
"type": "string"
}
},
"type": "object"
},
"HolidaysHoliday": {
"id": "HolidaysHoliday",
"properties": {
"countryCode": {
"description": "The CLDR territory code of the country in which the holiday is available. E.g. \"US\", \"DE\", \"GB\". A holiday cutoff can only be configured in a shipping settings service with matching delivery country. Always present.",
"type": "string"
},
"date": {
"description": "Date of the holiday, in ISO 8601 format. E.g. \"2016-12-25\" for Christmas 2016. Always present.",
"type": "string"
},
"deliveryGuaranteeDate": {
"description": "Date on which the order has to arrive at the customer's, in ISO 8601 format. E.g. \"2016-12-24\" for 24th December 2016. Always present.",
"type": "string"
},
"deliveryGuaranteeHour": {
"description": "Hour of the day in the delivery location's timezone on the guaranteed delivery date by which the order has to arrive at the customer's. Possible values are: 0 (midnight), 1, ..., 12 (noon), 13, ..., 23. Always present.",
"format": "uint64",
"type": "string"
},
"id": {
"description": "Unique identifier for the holiday to be used when configuring holiday cutoffs. Always present.",
"type": "string"
},
"type": {
"description": "The holiday type. Always present.",
"type": "string"
}
},
"type": "object"
},
"Installment": {
"id": "Installment",
"properties": {
"amount": {
"$ref": "Price",
"description": "The amount the buyer has to pay per month."
},
"months": {
"description": "The number of installments the buyer has to pay.",
"format": "int64",
"type": "string"
}
},
"type": "object"
},
"InvoiceSummary": {
"id": "InvoiceSummary",
"properties": {
"additionalChargeSummaries": {
"description": "Summary of the total amounts of the additional charges.",
"items": {
"$ref": "InvoiceSummaryAdditionalChargeSummary"
},
"type": "array"
},
"productTotal": {
"$ref": "Amount",
"description": "[required] Total price for the product."
}
},
"type": "object"
},
"InvoiceSummaryAdditionalChargeSummary": {
"id": "InvoiceSummaryAdditionalChargeSummary",
"properties": {
"totalAmount": {
"$ref": "Amount",
"description": "[required] Total additional charge for this type."
},
"type": {
"description": "[required] Type of the additional charge.",
"type": "string"
}
},
"type": "object"
},
"LiaAboutPageSettings": {
"id": "LiaAboutPageSettings",
"properties": {
"status": {
"description": "The status of the verification process for the About page.",
"type": "string"
},
"url": {
"description": "The URL for the About page.",
"type": "string"
}
},
"type": "object"
},
"LiaCountrySettings": {
"id": "LiaCountrySettings",
"properties": {
"about": {
"$ref": "LiaAboutPageSettings",
"description": "The settings for the About page."
},
"country": {
"annotations": {
"required": [
"content.liasettings.update"
]
},
"description": "CLDR country code (e.g. \"US\").",
"type": "string"
},
"hostedLocalStorefrontActive": {
"description": "The status of the \"Merchant hosted local storefront\" feature.",
"type": "boolean"
},
"inventory": {
"$ref": "LiaInventorySettings",
"description": "LIA inventory verification settings."
},
"onDisplayToOrder": {
"$ref": "LiaOnDisplayToOrderSettings",
"description": "LIA \"On Display To Order\" settings."
},
"posDataProvider": {
"$ref": "LiaPosDataProvider",
"description": "The POS data provider linked with this country."
},
"storePickupActive": {
"description": "The status of the \"Store pickup\" feature.",
"type": "boolean"
}
},
"type": "object"
},
"LiaInventorySettings": {
"id": "LiaInventorySettings",
"properties": {
"inventoryVerificationContactEmail": {
"description": "The email of the contact for the inventory verification process.",
"type": "string"
},
"inventoryVerificationContactName": {
"description": "The name of the contact for the inventory verification process.",
"type": "string"
},
"inventoryVerificationContactStatus": {
"description": "The status of the verification contact.",
"type": "string"
},
"status": {
"description": "The status of the inventory verification process.",
"type": "string"
}
},
"type": "object"
},
"LiaOnDisplayToOrderSettings": {
"id": "LiaOnDisplayToOrderSettings",
"properties": {
"shippingCostPolicyUrl": {
"description": "Shipping cost and policy URL.",
"type": "string"
},
"status": {
"description": "The status of the ?On display to order? feature.",
"type": "string"
}
},
"type": "object"
},
"LiaPosDataProvider": {
"id": "LiaPosDataProvider",
"properties": {
"posDataProviderId": {
"description": "The ID of the POS data provider.",
"format": "uint64",
"type": "string"
},
"posExternalAccountId": {
"description": "The account ID by which this merchant is known to the POS data provider.",
"type": "string"
}
},
"type": "object"
},
"LiaSettings": {
"description": "Local Inventory ads (LIA) settings. All methods except listposdataproviders require the admin role.",
"id": "LiaSettings",
"properties": {
"accountId": {
"description": "The ID of the account to which these LIA settings belong. Ignored upon update, always present in get request responses.",
"format": "uint64",
"type": "string"
},
"countrySettings": {
"description": "The LIA settings for each country.",
"items": {
"$ref": "LiaCountrySettings"
},
"type": "array"
},
"kind": {
"default": "content#liaSettings",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#liaSettings\".",
"type": "string"
}
},
"type": "object"
},
"LiasettingsCustomBatchRequest": {
"id": "LiasettingsCustomBatchRequest",
"properties": {
"entries": {
"description": "The request entries to be processed in the batch.",
"items": {
"$ref": "LiasettingsCustomBatchRequestEntry"
},
"type": "array"
}
},
"type": "object"
},
"LiasettingsCustomBatchRequestEntry": {
"id": "LiasettingsCustomBatchRequestEntry",
"properties": {
"accountId": {
"description": "The ID of the account for which to get/update account shipping settings.",
"format": "uint64",
"type": "string"
},
"batchId": {
"description": "An entry ID, unique within the batch request.",
"format": "uint32",
"type": "integer"
},
"contactEmail": {
"description": "Inventory validation contact email. Required only for SetInventoryValidationContact.",
"type": "string"
},
"contactName": {
"description": "Inventory validation contact name. Required only for SetInventoryValidationContact.",
"type": "string"
},
"country": {
"description": "The country code. Required only for RequestInventoryVerification.",
"type": "string"
},
"gmbEmail": {
"description": "The GMB account. Required only for RequestGmbAccess.",
"type": "string"
},
"liaSettings": {
"$ref": "LiaSettings",
"description": "The account Lia settings to update. Only defined if the method is update."
},
"merchantId": {
"description": "The ID of the managing account.",
"format": "uint64",
"type": "string"
},
"method": {
"type": "string"
},
"posDataProviderId": {
"description": "The ID of POS data provider. Required only for SetPosProvider.",
"format": "uint64",
"type": "string"
},
"posExternalAccountId": {
"description": "The account ID by which this merchant is known to the POS provider.",
"type": "string"
}
},
"type": "object"
},
"LiasettingsCustomBatchResponse": {
"id": "LiasettingsCustomBatchResponse",
"properties": {
"entries": {
"description": "The result of the execution of the batch requests.",
"items": {
"$ref": "LiasettingsCustomBatchResponseEntry"
},
"type": "array"
},
"kind": {
"default": "content#liasettingsCustomBatchResponse",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#liasettingsCustomBatchResponse\".",
"type": "string"
}
},
"type": "object"
},
"LiasettingsCustomBatchResponseEntry": {
"id": "LiasettingsCustomBatchResponseEntry",
"properties": {
"batchId": {
"description": "The ID of the request entry to which this entry responds.",
"format": "uint32",
"type": "integer"
},
"errors": {
"$ref": "Errors",
"description": "A list of errors defined if, and only if, the request failed."
},
"gmbAccounts": {
"$ref": "GmbAccounts",
"description": "The the list of accessible GMB accounts."
},
"kind": {
"default": "content#liasettingsCustomBatchResponseEntry",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#liasettingsCustomBatchResponseEntry\".",
"type": "string"
},
"liaSettings": {
"$ref": "LiaSettings",
"description": "The retrieved or updated Lia settings."
},
"posDataProviders": {
"description": "The list of POS data providers.",
"items": {
"$ref": "PosDataProviders"
},
"type": "array"
}
},
"type": "object"
},
"LiasettingsGetAccessibleGmbAccountsResponse": {
"id": "LiasettingsGetAccessibleGmbAccountsResponse",
"properties": {
"accountId": {
"description": "The ID of the account.",
"format": "uint64",
"type": "string"
},
"gmbAccounts": {
"description": "A list of GMB accounts which are available to the merchant.",
"items": {
"$ref": "GmbAccountsGmbAccount"
},
"type": "array"
},
"kind": {
"default": "content#liasettingsGetAccessibleGmbAccountsResponse",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#liasettingsGetAccessibleGmbAccountsResponse\".",
"type": "string"
}
},
"type": "object"
},
"LiasettingsListPosDataProvidersResponse": {
"id": "LiasettingsListPosDataProvidersResponse",
"properties": {
"kind": {
"default": "content#liasettingsListPosDataProvidersResponse",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#liasettingsListPosDataProvidersResponse\".",
"type": "string"
},
"posDataProviders": {
"description": "The list of POS data providers for each eligible country",
"items": {
"$ref": "PosDataProviders"
},
"type": "array"
}
},
"type": "object"
},
"LiasettingsListResponse": {
"id": "LiasettingsListResponse",
"properties": {
"kind": {
"default": "content#liasettingsListResponse",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#liasettingsListResponse\".",
"type": "string"
},
"nextPageToken": {
"description": "The token for the retrieval of the next page of LIA settings.",
"type": "string"
},
"resources": {
"items": {
"$ref": "LiaSettings"
},
"type": "array"
}
},
"type": "object"
},
"LiasettingsRequestGmbAccessResponse": {
"id": "LiasettingsRequestGmbAccessResponse",
"properties": {
"kind": {
"default": "content#liasettingsRequestGmbAccessResponse",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#liasettingsRequestGmbAccessResponse\".",
"type": "string"
}
},
"type": "object"
},
"LiasettingsRequestInventoryVerificationResponse": {
"id": "LiasettingsRequestInventoryVerificationResponse",
"properties": {
"kind": {
"default": "content#liasettingsRequestInventoryVerificationResponse",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#liasettingsRequestInventoryVerificationResponse\".",
"type": "string"
}
},
"type": "object"
},
"LiasettingsSetInventoryVerificationContactResponse": {
"id": "LiasettingsSetInventoryVerificationContactResponse",
"properties": {
"kind": {
"default": "content#liasettingsSetInventoryVerificationContactResponse",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#liasettingsSetInventoryVerificationContactResponse\".",
"type": "string"
}
},
"type": "object"
},
"LiasettingsSetPosDataProviderResponse": {
"id": "LiasettingsSetPosDataProviderResponse",
"properties": {
"kind": {
"default": "content#liasettingsSetPosDataProviderResponse",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#liasettingsSetPosDataProviderResponse\".",
"type": "string"
}
},
"type": "object"
},
"LinkService": {
"id": "LinkService",
"properties": {
"service": {
"description": "Service provided to or by the linked account.",
"type": "string"
},
"status": {
"description": "Status of the link",
"type": "string"
}
},
"type": "object"
},
"LinkedAccount": {
"id": "LinkedAccount",
"properties": {
"linkedAccountId": {
"description": "The ID of the linked account.",
"type": "string"
},
"services": {
"description": "List of provided services.",
"items": {
"$ref": "LinkService"
},
"type": "array"
}
},
"type": "object"
},
"LocalInventory": {
"description": "Local inventory resource. For accepted attribute values, see the local product inventory feed specification.",
"id": "LocalInventory",
"properties": {
"availability": {
"description": "Availability of the product.",
"type": "string"
},
"instoreProductLocation": {
"description": "In-store product location.",
"type": "string"
},
"kind": {
"default": "content#localInventory",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#localInventory\".",
"type": "string"
},
"pickupMethod": {
"description": "Supported pickup method for this offer. Unless the value is \"not supported\", this field must be submitted together with pickupSla.",
"type": "string"
},
"pickupSla": {
"description": "Expected date that an order will be ready for pickup relative to the order date. Must be submitted together with pickupMethod.",
"type": "string"
},
"price": {
"$ref": "Price",
"description": "Price of the product."
},
"quantity": {
"description": "Quantity of the product. Must be nonnegative.",
"format": "uint32",
"type": "integer"
},
"salePrice": {
"$ref": "Price",
"description": "Sale price of the product. Mandatory if sale_price_effective_date is defined."
},
"salePriceEffectiveDate": {
"description": "A date range represented by a pair of ISO 8601 dates separated by a space, comma, or slash. Both dates may be specified as 'null' if undecided.",
"type": "string"
},
"storeCode": {
"description": "Store code of this local inventory resource.",
"type": "string"
}
},
"type": "object"
},
"LocalinventoryCustomBatchRequest": {
"id": "LocalinventoryCustomBatchRequest",
"properties": {
"entries": {
"description": "The request entries to be processed in the batch.",
"items": {
"$ref": "LocalinventoryCustomBatchRequestEntry"
},
"type": "array"
}
},
"type": "object"
},
"LocalinventoryCustomBatchRequestEntry": {
"description": "Batch entry encoding a single local inventory update request.",
"id": "LocalinventoryCustomBatchRequestEntry",
"properties": {
"batchId": {
"description": "An entry ID, unique within the batch request.",
"format": "uint32",
"type": "integer"
},
"localInventory": {
"$ref": "LocalInventory",
"description": "Local inventory of the product."
},
"merchantId": {
"description": "The ID of the managing account.",
"format": "uint64",
"type": "string"
},
"method": {
"description": "Method of the batch request entry.",
"type": "string"
},
"productId": {
"description": "The ID of the product for which to update local inventory.",
"type": "string"
}
},
"type": "object"
},
"LocalinventoryCustomBatchResponse": {
"id": "LocalinventoryCustomBatchResponse",
"properties": {
"entries": {
"description": "The result of the execution of the batch requests.",
"items": {
"$ref": "LocalinventoryCustomBatchResponseEntry"
},
"type": "array"
},
"kind": {
"default": "content#localinventoryCustomBatchResponse",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#localinventoryCustomBatchResponse\".",
"type": "string"
}
},
"type": "object"
},
"LocalinventoryCustomBatchResponseEntry": {
"description": "Batch entry encoding a single local inventory update response.",
"id": "LocalinventoryCustomBatchResponseEntry",
"properties": {
"batchId": {
"description": "The ID of the request entry this entry responds to.",
"format": "uint32",
"type": "integer"
},
"errors": {
"$ref": "Errors",
"description": "A list of errors defined if and only if the request failed."
},
"kind": {
"default": "content#localinventoryCustomBatchResponseEntry",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#localinventoryCustomBatchResponseEntry\".",
"type": "string"
}
},
"type": "object"
},
"LocationIdSet": {
"id": "LocationIdSet",
"properties": {
"locationIds": {
"description": "A non-empty list of location IDs. They must all be of the same location type (e.g., state).",
"items": {
"type": "string"
},
"type": "array"
}
},
"type": "object"
},
"LoyaltyPoints": {
"id": "LoyaltyPoints",
"properties": {
"name": {
"description": "Name of loyalty points program. It is recommended to limit the name to 12 full-width characters or 24 Roman characters.",
"type": "string"
},
"pointsValue": {
"description": "The retailer's loyalty points in absolute value.",
"format": "int64",
"type": "string"
},
"ratio": {
"description": "The ratio of a point when converted to currency. Google assumes currency based on Merchant Center settings. If ratio is left out, it defaults to 1.0.",
"format": "double",
"type": "number"
}
},
"type": "object"
},
"MerchantOrderReturn": {
"description": "Order return. Production access (all methods) requires the order manager role. Sandbox access does not.",
"id": "MerchantOrderReturn",
"properties": {
"creationDate": {
"description": "The date of creation of the return, in ISO 8601 format.",
"type": "string"
},
"merchantOrderId": {
"description": "Merchant defined order ID.",
"type": "string"
},
"orderId": {
"description": "Google order ID.",
"type": "string"
},
"orderReturnId": {
"description": "Order return ID generated by Google.",
"type": "string"
},
"returnItems": {
"description": "Items of the return.",
"items": {
"$ref": "MerchantOrderReturnItem"
},
"type": "array"
},
"returnShipments": {
"description": "Shipments of the return.",
"items": {
"$ref": "ReturnShipment"
},
"type": "array"
}
},
"type": "object"
},
"MerchantOrderReturnItem": {
"id": "MerchantOrderReturnItem",
"properties": {
"customerReturnReason": {
"$ref": "CustomerReturnReason",
"description": "The reason that the customer chooses to return an item."
},
"itemId": {
"description": "Product level item ID. If the returned items are of the same product, they will have the same ID.",
"type": "string"
},
"merchantReturnReason": {
"$ref": "RefundReason",
"description": "The reason that merchant chooses to accept a return item."
},
"product": {
"$ref": "OrderLineItemProduct",
"description": "Product data from the time of the order placement."
},
"returnShipmentIds": {
"description": "IDs of the return shipments that this return item belongs to.",
"items": {
"type": "string"
},
"type": "array"
},
"state": {
"description": "State of the item.",
"type": "string"
}
},
"type": "object"
},
"Order": {
"description": "Order. Production access (all methods) requires the order manager role. Sandbox access does not.",
"id": "Order",
"properties": {
"acknowledged": {
"description": "Whether the order was acknowledged.",
"type": "boolean"
},
"billingAddress": {
"$ref": "OrderAddress",
"description": "The billing address."
},
"customer": {
"$ref": "OrderCustomer",
"description": "The details of the customer who placed the order."
},
"deliveryDetails": {
"$ref": "OrderDeliveryDetails",
"description": "Delivery details for shipments of type delivery."
},
"id": {
"description": "The REST ID of the order. Globally unique.",
"type": "string"
},
"kind": {
"default": "content#order",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#order\".",
"type": "string"
},
"lineItems": {
"description": "Line items that are ordered.",
"items": {
"$ref": "OrderLineItem"
},
"type": "array"
},
"merchantId": {
"format": "uint64",
"type": "string"
},
"merchantOrderId": {
"description": "Merchant-provided ID of the order.",
"type": "string"
},
"netPriceAmount": {
"$ref": "Price",
"description": "The net amount for the order (price part). For example, if an order was originally for $100 and a refund was issued for $20, the net amount will be $80."
},
"netTaxAmount": {
"$ref": "Price",
"description": "The net amount for the order (tax part). Note that in certain cases due to taxable base adjustment netTaxAmount might not match to a sum of tax field across all lineItems and refunds."
},
"paymentStatus": {
"description": "The status of the payment.",
"type": "string"
},
"pickupDetails": {
"$ref": "OrderPickupDetails",
"description": "Pickup details for shipments of type pickup."
},
"placedDate": {
"description": "The date when the order was placed, in ISO 8601 format.",
"type": "string"
},
"promotions": {
"description": "Promotions associated with the order.\n\nTo determine which promotions apply to which products, check the Promotions[].appliedItems[].lineItemId field against the LineItems[].id field for each promotion. If a promotion is applied to more than 1 offerId, divide the discount value by the number of affected offers to determine how much discount to apply to each offerId.\n\nExamples: \n- To calculate price paid by the customer for a single line item including the discount: For each promotion, subtract the LineItems[].adjustments[].priceAdjustment.value amount from the LineItems[].Price.value. \n- To calculate price paid by the customer for a single line item including the discount in case of multiple quantity: For each promotion, divide the LineItems[].adjustments[].priceAdjustment.value by the quantity of products then subtract the resulting value from the LineItems[].Product.Price.value for each quantity item. \n\nOnly 1 promotion can be applied to an offerId in a given order. To refund an item which had a promotion applied to it, make sure to refund the amount after first subtracting the promotion discount from the item price.\n\nMore details about the program are here.",
"items": {
"$ref": "OrderPromotion"
},
"type": "array"
},
"refunds": {
"description": "Refunds for the order.",
"items": {
"$ref": "OrderRefund"
},
"type": "array"
},
"shipments": {
"description": "Shipments of the order.",
"items": {
"$ref": "OrderShipment"
},
"type": "array"
},
"shippingCost": {
"$ref": "Price",
"description": "The total cost of shipping for all items."
},
"shippingCostTax": {
"$ref": "Price",
"description": "The tax for the total shipping cost."
},
"status": {
"description": "The status of the order.",
"type": "string"
},
"taxCollector": {
"description": "The party responsible for collecting and remitting taxes.",
"type": "string"
}
},
"type": "object"
},
"OrderAddress": {
"id": "OrderAddress",
"properties": {
"country": {
"description": "CLDR country code (e.g. \"US\").",
"type": "string"
},
"fullAddress": {
"description": "Strings representing the lines of the printed label for mailing the order, for example:\nJohn Smith\n1600 Amphitheatre Parkway\nMountain View, CA, 94043\nUnited States",
"items": {
"type": "string"
},
"type": "array"
},
"isPostOfficeBox": {
"description": "Whether the address is a post office box.",
"type": "boolean"
},
"locality": {
"description": "City, town or commune. May also include dependent localities or sublocalities (e.g. neighborhoods or suburbs).",
"type": "string"
},
"postalCode": {
"description": "Postal Code or ZIP (e.g. \"94043\").",
"type": "string"
},
"recipientName": {
"description": "Name of the recipient.",
"type": "string"
},
"region": {
"description": "Top-level administrative subdivision of the country. For example, a state like California (\"CA\") or a province like Quebec (\"QC\").",
"type": "string"
},
"streetAddress": {
"description": "Street-level part of the address.",
"items": {
"type": "string"
},
"type": "array"
}
},
"type": "object"
},
"OrderCancellation": {
"id": "OrderCancellation",
"properties": {
"actor": {
"description": "The actor that created the cancellation.",
"type": "string"
},
"creationDate": {
"description": "Date on which the cancellation has been created, in ISO 8601 format.",
"type": "string"
},
"quantity": {
"description": "The quantity that was canceled.",
"format": "uint32",
"type": "integer"
},
"reason": {
"description": "The reason for the cancellation. Orders that are canceled with a noInventory reason will lead to the removal of the product from Shopping Actions until you make an update to that product. This will not affect your Shopping ads.",
"type": "string"
},
"reasonText": {
"description": "The explanation of the reason.",
"type": "string"
}
},
"type": "object"
},
"OrderCustomer": {
"id": "OrderCustomer",
"properties": {
"fullName": {
"description": "Full name of the customer.",
"type": "string"
},
"invoiceReceivingEmail": {
"description": "Email address for the merchant to send value-added tax or invoice documentation of the order. This documentation is made available to the customer.",
"type": "string"
},
"loyaltyInfo": {
"$ref": "OrderCustomerLoyaltyInfo",
"description": "Loyalty program information."
},
"marketingRightsInfo": {
"$ref": "OrderCustomerMarketingRightsInfo",
"description": "Customer's marketing preferences. Contains the marketing opt-in information that is current at the time that the merchant call. User preference selections can change from one order to the next so preferences must be checked with every order."
}
},
"type": "object"
},
"OrderCustomerLoyaltyInfo": {
"id": "OrderCustomerLoyaltyInfo",
"properties": {
"loyaltyNumber": {
"description": "The loyalty card/membership number.",
"type": "string"
},
"name": {
"description": "Name of card/membership holder, this field will be populated when",
"type": "string"
}
},
"type": "object"
},
"OrderCustomerMarketingRightsInfo": {
"id": "OrderCustomerMarketingRightsInfo",
"properties": {
"explicitMarketingPreference": {
"description": "Last known customer selection regarding marketing preferences. In certain cases this selection might not be known, so this field would be empty. If a customer selected granted in their most recent order, they can be subscribed to marketing emails. Customers who have chosen denied must not be subscribed, or must be unsubscribed if already opted-in.",
"type": "string"
},
"lastUpdatedTimestamp": {
"description": "Timestamp when last time marketing preference was updated. Could be empty, if user wasn't offered a selection yet.",
"type": "string"
},
"marketingEmailAddress": {
"description": "Email address that can be used for marketing purposes. The field may be empty even if explicitMarketingPreference is 'granted'. This happens when retrieving an old order from the customer who deleted their account.",
"type": "string"
}
},
"type": "object"
},
"OrderDeliveryDetails": {
"id": "OrderDeliveryDetails",
"properties": {
"address": {
"$ref": "OrderAddress",
"description": "The delivery address"
},
"phoneNumber": {
"description": "The phone number of the person receiving the delivery.",
"type": "string"
}
},
"type": "object"
},
"OrderLineItem": {
"id": "OrderLineItem",
"properties": {
"adjustments": {
"description": "Price and tax adjustments applied on the line item.",
"items": {
"$ref": "OrderLineItemAdjustment"
},
"type": "array"
},
"annotations": {
"description": "Annotations that are attached to the line item.",
"items": {
"$ref": "OrderMerchantProvidedAnnotation"
},
"type": "array"
},
"cancellations": {
"description": "Cancellations of the line item.",
"items": {
"$ref": "OrderCancellation"
},
"type": "array"
},
"id": {
"description": "The ID of the line item.",
"type": "string"
},
"price": {
"$ref": "Price",
"description": "Total price for the line item. For example, if two items for $10 are purchased, the total price will be $20."
},
"product": {
"$ref": "OrderLineItemProduct",
"description": "Product data as seen by customer from the time of the order placement. Note that certain attributes values (e.g. title or gtin) might be reformatted and no longer match values submitted via product feed."
},
"quantityCanceled": {
"description": "Number of items canceled.",
"format": "uint32",
"type": "integer"
},
"quantityDelivered": {
"description": "Number of items delivered.",
"format": "uint32",
"type": "integer"
},
"quantityOrdered": {
"description": "Number of items ordered.",
"format": "uint32",
"type": "integer"
},
"quantityPending": {
"description": "Number of items pending.",
"format": "uint32",
"type": "integer"
},
"quantityReadyForPickup": {
"description": "Number of items ready for pickup.",
"format": "uint32",
"type": "integer"
},
"quantityReturned": {
"description": "Number of items returned.",
"format": "uint32",
"type": "integer"
},
"quantityShipped": {
"description": "Number of items shipped.",
"format": "uint32",
"type": "integer"
},
"quantityUndeliverable": {
"description": "Number of items undeliverable.",
"format": "uint32",
"type": "integer"
},
"returnInfo": {
"$ref": "OrderLineItemReturnInfo",
"description": "Details of the return policy for the line item."
},
"returns": {
"description": "Returns of the line item.",
"items": {
"$ref": "OrderReturn"
},
"type": "array"
},
"shippingDetails": {
"$ref": "OrderLineItemShippingDetails",
"description": "Details of the requested shipping for the line item."
},
"tax": {
"$ref": "Price",
"description": "Total tax amount for the line item. For example, if two items are purchased, and each have a cost tax of $2, the total tax amount will be $4."
}
},
"type": "object"
},
"OrderLineItemAdjustment": {
"id": "OrderLineItemAdjustment",
"properties": {
"priceAdjustment": {
"$ref": "Price",
"description": "Adjustment for total price of the line item."
},
"taxAdjustment": {
"$ref": "Price",
"description": "Adjustment for total tax of the line item."
},
"type": {
"description": "Type of this adjustment.",
"type": "string"
}
},
"type": "object"
},
"OrderLineItemProduct": {
"id": "OrderLineItemProduct",
"properties": {
"brand": {
"description": "Brand of the item.",
"type": "string"
},
"condition": {
"description": "Condition or state of the item.",
"type": "string"
},
"contentLanguage": {
"description": "The two-letter ISO 639-1 language code for the item.",
"type": "string"
},
"fees": {
"description": "Associated fees at order creation time.",
"items": {
"$ref": "OrderLineItemProductFee"
},
"type": "array"
},
"gtin": {
"description": "Global Trade Item Number (GTIN) of the item.",
"type": "string"
},
"id": {
"description": "The REST ID of the product.",
"type": "string"
},
"imageLink": {
"description": "URL of an image of the item.",
"type": "string"
},
"itemGroupId": {
"description": "Shared identifier for all variants of the same product.",
"type": "string"
},
"mpn": {
"description": "Manufacturer Part Number (MPN) of the item.",
"type": "string"
},
"offerId": {
"description": "An identifier of the item.",
"type": "string"
},
"price": {
"$ref": "Price",
"description": "Price of the item."
},
"shownImage": {
"description": "URL to the cached image shown to the user when order was placed.",
"type": "string"
},
"targetCountry": {
"description": "The CLDR territory code of the target country of the product.",
"type": "string"
},
"title": {
"description": "The title of the product.",
"type": "string"
},
"variantAttributes": {
"description": "Variant attributes for the item. These are dimensions of the product, such as color, gender, material, pattern, and size. You can find a comprehensive list of variant attributes here.",
"items": {
"$ref": "OrderLineItemProductVariantAttribute"
},
"type": "array"
}
},
"type": "object"
},
"OrderLineItemProductFee": {
"id": "OrderLineItemProductFee",
"properties": {
"amount": {
"$ref": "Price",
"description": "Amount of the fee."
},
"name": {
"description": "Name of the fee.",
"type": "string"
}
},
"type": "object"
},
"OrderLineItemProductVariantAttribute": {
"id": "OrderLineItemProductVariantAttribute",
"properties": {
"dimension": {
"description": "The dimension of the variant.",
"type": "string"
},
"value": {
"description": "The value for the dimension.",
"type": "string"
}
},
"type": "object"
},
"OrderLineItemReturnInfo": {
"id": "OrderLineItemReturnInfo",
"properties": {
"daysToReturn": {
"annotations": {
"required": [
"content.orders.createtestorder"
]
},
"description": "How many days later the item can be returned.",
"format": "int32",
"type": "integer"
},
"isReturnable": {
"annotations": {
"required": [
"content.orders.createtestorder"
]
},
"description": "Whether the item is returnable.",
"type": "boolean"
},
"policyUrl": {
"annotations": {
"required": [
"content.orders.createtestorder"
]
},
"description": "URL of the item return policy.",
"type": "string"
}
},
"type": "object"
},
"OrderLineItemShippingDetails": {
"id": "OrderLineItemShippingDetails",
"properties": {
"deliverByDate": {
"annotations": {
"required": [
"content.orders.createtestorder"
]
},
"description": "The delivery by date, in ISO 8601 format.",
"type": "string"
},
"method": {
"$ref": "OrderLineItemShippingDetailsMethod",
"annotations": {
"required": [
"content.orders.createtestorder"
]
},
"description": "Details of the shipping method."
},
"shipByDate": {
"annotations": {
"required": [
"content.orders.createtestorder"
]
},
"description": "The ship by date, in ISO 8601 format.",
"type": "string"
},
"type": {
"description": "Type of shipment. Indicates whether deliveryDetails or pickupDetails is applicable for this shipment.",
"type": "string"
}
},
"type": "object"
},
"OrderLineItemShippingDetailsMethod": {
"id": "OrderLineItemShippingDetailsMethod",
"properties": {
"carrier": {
"description": "The carrier for the shipping. Optional. See shipments[].carrier for a list of acceptable values.",
"type": "string"
},
"maxDaysInTransit": {
"annotations": {
"required": [
"content.orders.createtestorder"
]
},
"description": "Maximum transit time.",
"format": "uint32",
"type": "integer"
},
"methodName": {
"annotations": {
"required": [
"content.orders.createtestorder"
]
},
"description": "The name of the shipping method.",
"type": "string"
},
"minDaysInTransit": {
"annotations": {
"required": [
"content.orders.createtestorder"
]
},
"description": "Minimum transit time.",
"format": "uint32",
"type": "integer"
}
},
"type": "object"
},
"OrderMerchantProvidedAnnotation": {
"id": "OrderMerchantProvidedAnnotation",
"properties": {
"key": {
"description": "Key for additional merchant provided (as key-value pairs) annotation about the line item.",
"type": "string"
},
"value": {
"description": "Value for additional merchant provided (as key-value pairs) annotation about the line item.",
"type": "string"
}
},
"type": "object"
},
"OrderPickupDetails": {
"id": "OrderPickupDetails",
"properties": {
"address": {
"$ref": "OrderAddress",
"description": "Address of the pickup location where the shipment should be sent. Note that recipientName in the address is the name of the business at the pickup location."
},
"collectors": {
"description": "Collectors authorized to pick up shipment from the pickup location.",
"items": {
"$ref": "OrderPickupDetailsCollector"
},
"type": "array"
},
"locationId": {
"description": "ID of the pickup location.",
"type": "string"
}
},
"type": "object"
},
"OrderPickupDetailsCollector": {
"id": "OrderPickupDetailsCollector",
"properties": {
"name": {
"description": "Name of the person picking up the shipment.",
"type": "string"
},
"phoneNumber": {
"description": "Phone number of the person picking up the shipment.",
"type": "string"
}
},
"type": "object"
},
"OrderPromotion": {
"id": "OrderPromotion",
"properties": {
"applicableItems": {
"description": "Items which this promotion may be applied to. If empty, there are no restrictions on applicable items and quantity.",
"items": {
"$ref": "OrderPromotionItem"
},
"type": "array"
},
"appliedItems": {
"description": "Items which this promotion have been applied to. Do not provide for orders.createtestorder.",
"items": {
"$ref": "OrderPromotionItem"
},
"type": "array"
},
"endTime": {
"description": "Promotion end time in ISO 8601 format. Date, time, and offset required, e.g., \"2020-01-02T09:00:00+01:00\" or \"2020-01-02T09:00:00Z\".",
"type": "string"
},
"funder": {
"annotations": {
"required": [
"content.orders.createtestorder"
]
},
"description": "The party funding the promotion. Only merchant is supported for orders.createtestorder.",
"type": "string"
},
"merchantPromotionId": {
"annotations": {
"required": [
"content.orders.createtestorder"
]
},
"description": "This field is used to identify promotions within merchants' own systems.",
"type": "string"
},
"priceValue": {
"$ref": "Price",
"description": "Estimated discount applied to price. Amount is pre-tax or post-tax depending on location of order."
},
"shortTitle": {
"description": "A short title of the promotion to be shown on the checkout page. Do not provide for orders.createtestorder.",
"type": "string"
},
"startTime": {
"description": "Promotion start time in ISO 8601 format. Date, time, and offset required, e.g., \"2020-01-02T09:00:00+01:00\" or \"2020-01-02T09:00:00Z\".",
"type": "string"
},
"subtype": {
"annotations": {
"required": [
"content.orders.createtestorder"
]
},
"description": "The category of the promotion. Only moneyOff is supported for orders.createtestorder.",
"type": "string"
},
"taxValue": {
"$ref": "Price",
"description": "Estimated discount applied to tax (if allowed by law). Do not provide for orders.createtestorder."
},
"title": {
"annotations": {
"required": [
"content.orders.createtestorder"
]
},
"description": "The title of the promotion.",
"type": "string"
},
"type": {
"annotations": {
"required": [
"content.orders.createtestorder"
]
},
"description": "The scope of the promotion. Only product is supported for orders.createtestorder.",
"type": "string"
}
},
"type": "object"
},
"OrderPromotionItem": {
"id": "OrderPromotionItem",
"properties": {
"lineItemId": {
"description": "The line item ID of a product. Do not provide for orders.createtestorder.",
"type": "string"
},
"offerId": {
"annotations": {
"required": [
"content.orders.createtestorder"
]
},
"description": "Offer ID of a product. Only for orders.createtestorder.",
"type": "string"
},
"productId": {
"description": "orders.createtestorder.",
"type": "string"
},
"quantity": {
"description": "The quantity of the associated product. Do not provide for orders.createtestorder.",
"format": "int32",
"type": "integer"
}
},
"type": "object"
},
"OrderRefund": {
"id": "OrderRefund",
"properties": {
"actor": {
"description": "The actor that created the refund.",
"type": "string"
},
"amount": {
"$ref": "Price",
"description": "The amount that is refunded."
},
"creationDate": {
"description": "Date on which the item has been created, in ISO 8601 format.",
"type": "string"
},
"reason": {
"description": "The reason for the refund.",
"type": "string"
},
"reasonText": {
"description": "The explanation of the reason.",
"type": "string"
}
},
"type": "object"
},
"OrderReportDisbursement": {
"description": "Order disbursement. All methods require the payment analyst role.",
"id": "OrderReportDisbursement",
"properties": {
"disbursementAmount": {
"$ref": "Price",
"description": "The disbursement amount."
},
"disbursementCreationDate": {
"description": "The disbursement date, in ISO 8601 format.",
"type": "string"
},
"disbursementDate": {
"description": "The date the disbursement was initiated, in ISO 8601 format.",
"type": "string"
},
"disbursementId": {
"description": "The ID of the disbursement.",
"type": "string"
},
"merchantId": {
"description": "The ID of the managing account.",
"format": "uint64",
"type": "string"
}
},
"type": "object"
},
"OrderReportTransaction": {
"id": "OrderReportTransaction",
"properties": {
"disbursementAmount": {
"$ref": "Price",
"description": "The disbursement amount."
},
"disbursementCreationDate": {
"description": "The date the disbursement was created, in ISO 8601 format.",
"type": "string"
},
"disbursementDate": {
"description": "The date the disbursement was initiated, in ISO 8601 format.",
"type": "string"
},
"disbursementId": {
"description": "The ID of the disbursement.",
"type": "string"
},
"merchantId": {
"description": "The ID of the managing account.",
"format": "uint64",
"type": "string"
},
"merchantOrderId": {
"description": "Merchant-provided ID of the order.",
"type": "string"
},
"orderId": {
"description": "The ID of the order.",
"type": "string"
},
"productAmount": {
"$ref": "ProductAmount",
"description": "Total amount for the items."
},
"transactionDate": {
"description": "The date of the transaction, in ISO 8601 format.",
"type": "string"
}
},
"type": "object"
},
"OrderReturn": {
"id": "OrderReturn",
"properties": {
"actor": {
"description": "The actor that created the refund.",
"type": "string"
},
"creationDate": {
"description": "Date on which the item has been created, in ISO 8601 format.",
"type": "string"
},
"quantity": {
"description": "Quantity that is returned.",
"format": "uint32",
"type": "integer"
},
"reason": {
"description": "The reason for the return.",
"type": "string"
},
"reasonText": {
"description": "The explanation of the reason.",
"type": "string"
}
},
"type": "object"
},
"OrderShipment": {
"id": "OrderShipment",
"properties": {
"carrier": {
"description": "The carrier handling the shipment.\n\nFor supported carriers, Google includes the carrier name and tracking URL in emails to customers. For select supported carriers, Google also automatically updates the shipment status based on the provided shipment ID. Note: You can also use unsupported carriers, but emails to customers will not include the carrier name or tracking URL, and there will be no automatic order status updates. \nSupported carriers for US are: \n- \"ups\" (United Parcel Service) automatic status updates \n- \"usps\" (United States Postal Service) automatic status updates \n- \"fedex\" (FedEx) automatic status updates \n- \"dhl\" (DHL eCommerce) automatic status updates (US only) \n- \"ontrac\" (OnTrac) automatic status updates \n- \"dhl express\" (DHL Express)\n- \"deliv\" (Deliv) \n- \"dynamex\" (TForce) \n- \"lasership\" (LaserShip) \n- \"mpx\" (Military Parcel Xpress) \n- \"uds\" (United Delivery Service) \n- \"efw\" (Estes Forwarding Worldwide) \n- \"jd logistics\" (JD Logistics) \n- \"yunexpress\" (YunExpress) \n- \"china post\" (China Post) \n- \"china ems\" (China Post Express Mail Service) \n- \"singapore post\" (Singapore Post) \n- \"pos malaysia\" (Pos Malaysia) \n- \"postnl\" (PostNL) \n- \"ptt\" (PTT Turkish Post) \n- \"eub\" (ePacket) \n- \"chukou1\" (Chukou1 Logistics) \nSupported carriers for FR are: \n- \"la poste\" (La Poste) automatic status updates \n- \"colissimo\" (Colissimo by La Poste) automatic status updates \n- \"ups\" (United Parcel Service) automatic status updates \n- \"chronopost\" (Chronopost by La Poste) \n- \"gls\" (General Logistics Systems France) \n- \"dpd\" (DPD Group by GeoPost) \n- \"bpost\" (Belgian Post Group) \n- \"colis prive\" (Colis Privé) \n- \"boxtal\" (Boxtal) \n- \"geodis\" (GEODIS) \n- \"tnt\" (TNT) \n- \"db schenker\" (DB Schenker) \n- \"aramex\" (Aramex)",
"type": "string"
},
"creationDate": {
"description": "Date on which the shipment has been created, in ISO 8601 format.",
"type": "string"
},
"deliveryDate": {
"description": "Date on which the shipment has been delivered, in ISO 8601 format. Present only if status is delivered",
"type": "string"
},
"id": {
"description": "The ID of the shipment.",
"type": "string"
},
"lineItems": {
"description": "The line items that are shipped.",
"items": {
"$ref": "OrderShipmentLineItemShipment"
},
"type": "array"
},
"shipmentGroupId": {
"description": "The shipment group ID of the shipment. This is set in shiplineitems request.",
"type": "string"
},
"status": {
"description": "The status of the shipment.",
"type": "string"
},
"trackingId": {
"description": "The tracking ID for the shipment.",
"type": "string"
}
},
"type": "object"
},
"OrderShipmentLineItemShipment": {
"id": "OrderShipmentLineItemShipment",
"properties": {
"lineItemId": {
"description": "The ID of the line item that is shipped. This value is assigned by Google when an order is created. Either lineItemId or productId is required.",
"type": "string"
},
"productId": {
"description": "The ID of the product to ship. This is the REST ID used in the products service. Either lineItemId or productId is required.",
"type": "string"
},
"quantity": {
"description": "The quantity that is shipped.",
"format": "uint32",
"type": "integer"
}
},
"type": "object"
},
"OrderinvoicesCreateChargeInvoiceRequest": {
"id": "OrderinvoicesCreateChargeInvoiceRequest",
"properties": {
"invoiceId": {
"description": "[required] The ID of the invoice.",
"type": "string"
},
"invoiceSummary": {
"$ref": "InvoiceSummary",
"description": "[required] Invoice summary."
},
"lineItemInvoices": {
"description": "[required] Invoice details per line item.",
"items": {
"$ref": "ShipmentInvoiceLineItemInvoice"
},
"type": "array"
},
"operationId": {
"description": "[required] The ID of the operation, unique across all operations for a given order.",
"type": "string"
},
"shipmentGroupId": {
"description": "[required] ID of the shipment group. It is assigned by the merchant in the shipLineItems method and is used to group multiple line items that have the same kind of shipping charges.",
"type": "string"
}
},
"type": "object"
},
"OrderinvoicesCreateChargeInvoiceResponse": {
"id": "OrderinvoicesCreateChargeInvoiceResponse",
"properties": {
"executionStatus": {
"description": "The status of the execution.",
"type": "string"
},
"kind": {
"default": "content#orderinvoicesCreateChargeInvoiceResponse",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#orderinvoicesCreateChargeInvoiceResponse\".",
"type": "string"
}
},
"type": "object"
},
"OrderinvoicesCreateRefundInvoiceRequest": {
"id": "OrderinvoicesCreateRefundInvoiceRequest",
"properties": {
"invoiceId": {
"description": "[required] The ID of the invoice.",
"type": "string"
},
"operationId": {
"description": "[required] The ID of the operation, unique across all operations for a given order.",
"type": "string"
},
"refundOnlyOption": {
"$ref": "OrderinvoicesCustomBatchRequestEntryCreateRefundInvoiceRefundOption",
"description": "Option to create a refund-only invoice. Exactly one of refundOnlyOption or returnOption must be provided."
},
"returnOption": {
"$ref": "OrderinvoicesCustomBatchRequestEntryCreateRefundInvoiceReturnOption",
"description": "Option to create an invoice for a refund and mark all items within the invoice as returned. Exactly one of refundOnlyOption or returnOption must be provided."
},
"shipmentInvoices": {
"description": "Invoice details for different shipment groups.",
"items": {
"$ref": "ShipmentInvoice"
},
"type": "array"
}
},
"type": "object"
},
"OrderinvoicesCreateRefundInvoiceResponse": {
"id": "OrderinvoicesCreateRefundInvoiceResponse",
"properties": {
"executionStatus": {
"description": "The status of the execution.",
"type": "string"
},
"kind": {
"default": "content#orderinvoicesCreateRefundInvoiceResponse",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#orderinvoicesCreateRefundInvoiceResponse\".",
"type": "string"
}
},
"type": "object"
},
"OrderinvoicesCustomBatchRequestEntryCreateRefundInvoiceRefundOption": {
"id": "OrderinvoicesCustomBatchRequestEntryCreateRefundInvoiceRefundOption",
"properties": {
"description": {
"description": "Optional description of the refund reason.",
"type": "string"
},
"reason": {
"description": "[required] Reason for the refund.",
"type": "string"
}
},
"type": "object"
},
"OrderinvoicesCustomBatchRequestEntryCreateRefundInvoiceReturnOption": {
"id": "OrderinvoicesCustomBatchRequestEntryCreateRefundInvoiceReturnOption",
"properties": {
"description": {
"description": "Optional description of the return reason.",
"type": "string"
},
"reason": {
"description": "[required] Reason for the return.",
"type": "string"
}
},
"type": "object"
},
"OrderreportsListDisbursementsResponse": {
"id": "OrderreportsListDisbursementsResponse",
"properties": {
"disbursements": {
"description": "The list of disbursements.",
"items": {
"$ref": "OrderReportDisbursement"
},
"type": "array"
},
"kind": {
"default": "content#orderreportsListDisbursementsResponse",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#orderreportsListDisbursementsResponse\".",
"type": "string"
},
"nextPageToken": {
"description": "The token for the retrieval of the next page of disbursements.",
"type": "string"
}
},
"type": "object"
},
"OrderreportsListTransactionsResponse": {
"id": "OrderreportsListTransactionsResponse",
"properties": {
"kind": {
"default": "content#orderreportsListTransactionsResponse",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#orderreportsListTransactionsResponse\".",
"type": "string"
},
"nextPageToken": {
"description": "The token for the retrieval of the next page of transactions.",
"type": "string"
},
"transactions": {
"description": "The list of transactions.",
"items": {
"$ref": "OrderReportTransaction"
},
"type": "array"
}
},
"type": "object"
},
"OrderreturnsListResponse": {
"id": "OrderreturnsListResponse",
"properties": {
"kind": {
"default": "content#orderreturnsListResponse",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#orderreturnsListResponse\".",
"type": "string"
},
"nextPageToken": {
"description": "The token for the retrieval of the next page of returns.",
"type": "string"
},
"resources": {
"items": {
"$ref": "MerchantOrderReturn"
},
"type": "array"
}
},
"type": "object"
},
"OrdersAcknowledgeRequest": {
"id": "OrdersAcknowledgeRequest",
"properties": {
"operationId": {
"description": "The ID of the operation. Unique across all operations for a given order.",
"type": "string"
}
},
"type": "object"
},
"OrdersAcknowledgeResponse": {
"id": "OrdersAcknowledgeResponse",
"properties": {
"executionStatus": {
"description": "The status of the execution.",
"type": "string"
},
"kind": {
"default": "content#ordersAcknowledgeResponse",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#ordersAcknowledgeResponse\".",
"type": "string"
}
},
"type": "object"
},
"OrdersAdvanceTestOrderResponse": {
"id": "OrdersAdvanceTestOrderResponse",
"properties": {
"kind": {
"default": "content#ordersAdvanceTestOrderResponse",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#ordersAdvanceTestOrderResponse\".",
"type": "string"
}
},
"type": "object"
},
"OrdersCancelLineItemRequest": {
"id": "OrdersCancelLineItemRequest",
"properties": {
"lineItemId": {
"description": "The ID of the line item to cancel. Either lineItemId or productId is required.",
"type": "string"
},
"operationId": {
"description": "The ID of the operation. Unique across all operations for a given order.",
"type": "string"
},
"productId": {
"description": "The ID of the product to cancel. This is the REST ID used in the products service. Either lineItemId or productId is required.",
"type": "string"
},
"quantity": {
"description": "The quantity to cancel.",
"format": "uint32",
"type": "integer"
},
"reason": {
"description": "The reason for the cancellation.",
"type": "string"
},
"reasonText": {
"description": "The explanation of the reason.",
"type": "string"
}
},
"type": "object"
},
"OrdersCancelLineItemResponse": {
"id": "OrdersCancelLineItemResponse",
"properties": {
"executionStatus": {
"description": "The status of the execution.",
"type": "string"
},
"kind": {
"default": "content#ordersCancelLineItemResponse",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#ordersCancelLineItemResponse\".",
"type": "string"
}
},
"type": "object"
},
"OrdersCancelRequest": {
"id": "OrdersCancelRequest",
"properties": {
"operationId": {
"description": "The ID of the operation. Unique across all operations for a given order.",
"type": "string"
},
"reason": {
"description": "The reason for the cancellation.",
"type": "string"
},
"reasonText": {
"description": "The explanation of the reason.",
"type": "string"
}
},
"type": "object"
},
"OrdersCancelResponse": {
"id": "OrdersCancelResponse",
"properties": {
"executionStatus": {
"description": "The status of the execution.",
"type": "string"
},
"kind": {
"default": "content#ordersCancelResponse",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#ordersCancelResponse\".",
"type": "string"
}
},
"type": "object"
},
"OrdersCancelTestOrderByCustomerRequest": {
"id": "OrdersCancelTestOrderByCustomerRequest",
"properties": {
"reason": {
"description": "The reason for the cancellation.",
"type": "string"
}
},
"type": "object"
},
"OrdersCancelTestOrderByCustomerResponse": {
"id": "OrdersCancelTestOrderByCustomerResponse",
"properties": {
"kind": {
"default": "content#ordersCancelTestOrderByCustomerResponse",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#ordersCancelTestOrderByCustomerResponse\".",
"type": "string"
}
},
"type": "object"
},
"OrdersCreateTestOrderRequest": {
"id": "OrdersCreateTestOrderRequest",
"properties": {
"country": {
"description": "The CLDR territory code of the country of the test order to create. Affects the currency and addresses of orders created via template_name, or the addresses of orders created via test_order.\n\nAcceptable values are: \n- \"US\" \n- \"FR\" Defaults to US.",
"type": "string"
},
"templateName": {
"description": "The test order template to use. Specify as an alternative to testOrder as a shortcut for retrieving a template and then creating an order using that template.",
"type": "string"
},
"testOrder": {
"$ref": "TestOrder",
"description": "The test order to create."
}
},
"type": "object"
},
"OrdersCreateTestOrderResponse": {
"id": "OrdersCreateTestOrderResponse",
"properties": {
"kind": {
"default": "content#ordersCreateTestOrderResponse",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#ordersCreateTestOrderResponse\".",
"type": "string"
},
"orderId": {
"description": "The ID of the newly created test order.",
"type": "string"
}
},
"type": "object"
},
"OrdersCreateTestReturnRequest": {
"id": "OrdersCreateTestReturnRequest",
"properties": {
"items": {
"description": "Returned items.",
"items": {
"$ref": "OrdersCustomBatchRequestEntryCreateTestReturnReturnItem"
},
"type": "array"
}
},
"type": "object"
},
"OrdersCreateTestReturnResponse": {
"id": "OrdersCreateTestReturnResponse",
"properties": {
"kind": {
"default": "content#ordersCreateTestReturnResponse",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#ordersCreateTestReturnResponse\".",
"type": "string"
},
"returnId": {
"description": "The ID of the newly created test order return.",
"type": "string"
}
},
"type": "object"
},
"OrdersCustomBatchRequestEntryCreateTestReturnReturnItem": {
"id": "OrdersCustomBatchRequestEntryCreateTestReturnReturnItem",
"properties": {
"lineItemId": {
"description": "The ID of the line item to return.",
"type": "string"
},
"quantity": {
"description": "Quantity that is returned.",
"format": "uint32",
"type": "integer"
}
},
"type": "object"
},
"OrdersCustomBatchRequestEntryShipLineItemsShipmentInfo": {
"id": "OrdersCustomBatchRequestEntryShipLineItemsShipmentInfo",
"properties": {
"carrier": {
"description": "The carrier handling the shipment. See shipments[].carrier in the Orders resource representation for a list of acceptable values.",
"type": "string"
},
"shipmentId": {
"annotations": {
"required": [
"content.orders.shiplineitems"
]
},
"description": "The ID of the shipment. This is assigned by the merchant and is unique to each shipment.",
"type": "string"
},
"trackingId": {
"description": "The tracking ID for the shipment.",
"type": "string"
}
},
"type": "object"
},
"OrdersGetByMerchantOrderIdResponse": {
"id": "OrdersGetByMerchantOrderIdResponse",
"properties": {
"kind": {
"default": "content#ordersGetByMerchantOrderIdResponse",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#ordersGetByMerchantOrderIdResponse\".",
"type": "string"
},
"order": {
"$ref": "Order",
"description": "The requested order."
}
},
"type": "object"
},
"OrdersGetTestOrderTemplateResponse": {
"id": "OrdersGetTestOrderTemplateResponse",
"properties": {
"kind": {
"default": "content#ordersGetTestOrderTemplateResponse",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#ordersGetTestOrderTemplateResponse\".",
"type": "string"
},
"template": {
"$ref": "TestOrder",
"description": "The requested test order template."
}
},
"type": "object"
},
"OrdersInStoreRefundLineItemRequest": {
"id": "OrdersInStoreRefundLineItemRequest",
"properties": {
"lineItemId": {
"description": "The ID of the line item to return. Either lineItemId or productId is required.",
"type": "string"
},
"operationId": {
"description": "The ID of the operation. Unique across all operations for a given order.",
"type": "string"
},
"priceAmount": {
"$ref": "Price",
"description": "The amount to be refunded. This may be pre-tax or post-tax depending on the location of the order. Required."
},
"productId": {
"description": "The ID of the product to return. This is the REST ID used in the products service. Either lineItemId or productId is required.",
"type": "string"
},
"quantity": {
"description": "The quantity to return and refund.",
"format": "uint32",
"type": "integer"
},
"reason": {
"description": "The reason for the return.",
"type": "string"
},
"reasonText": {
"description": "The explanation of the reason.",
"type": "string"
},
"taxAmount": {
"$ref": "Price",
"description": "The amount of tax to be refunded. Required."
}
},
"type": "object"
},
"OrdersInStoreRefundLineItemResponse": {
"id": "OrdersInStoreRefundLineItemResponse",
"properties": {
"executionStatus": {
"description": "The status of the execution.",
"type": "string"
},
"kind": {
"default": "content#ordersInStoreRefundLineItemResponse",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#ordersInStoreRefundLineItemResponse\".",
"type": "string"
}
},
"type": "object"
},
"OrdersListResponse": {
"id": "OrdersListResponse",
"properties": {
"kind": {
"default": "content#ordersListResponse",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#ordersListResponse\".",
"type": "string"
},
"nextPageToken": {
"description": "The token for the retrieval of the next page of orders.",
"type": "string"
},
"resources": {
"items": {
"$ref": "Order"
},
"type": "array"
}
},
"type": "object"
},
"OrdersRejectReturnLineItemRequest": {
"id": "OrdersRejectReturnLineItemRequest",
"properties": {
"lineItemId": {
"description": "The ID of the line item to return. Either lineItemId or productId is required.",
"type": "string"
},
"operationId": {
"description": "The ID of the operation. Unique across all operations for a given order.",
"type": "string"
},
"productId": {
"description": "The ID of the product to return. This is the REST ID used in the products service. Either lineItemId or productId is required.",
"type": "string"
},
"quantity": {
"description": "The quantity to return and refund.",
"format": "uint32",
"type": "integer"
},
"reason": {
"description": "The reason for the return.",
"type": "string"
},
"reasonText": {
"description": "The explanation of the reason.",
"type": "string"
}
},
"type": "object"
},
"OrdersRejectReturnLineItemResponse": {
"id": "OrdersRejectReturnLineItemResponse",
"properties": {
"executionStatus": {
"description": "The status of the execution.",
"type": "string"
},
"kind": {
"default": "content#ordersRejectReturnLineItemResponse",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#ordersRejectReturnLineItemResponse\".",
"type": "string"
}
},
"type": "object"
},
"OrdersReturnRefundLineItemRequest": {
"id": "OrdersReturnRefundLineItemRequest",
"properties": {
"lineItemId": {
"description": "The ID of the line item to return. Either lineItemId or productId is required.",
"type": "string"
},
"operationId": {
"description": "The ID of the operation. Unique across all operations for a given order.",
"type": "string"
},
"priceAmount": {
"$ref": "Price",
"description": "The amount to be refunded. This may be pre-tax or post-tax depending on the location of the order. If omitted, refundless return is assumed."
},
"productId": {
"description": "The ID of the product to return. This is the REST ID used in the products service. Either lineItemId or productId is required.",
"type": "string"
},
"quantity": {
"description": "The quantity to return and refund.",
"format": "uint32",
"type": "integer"
},
"reason": {
"description": "The reason for the return.",
"type": "string"
},
"reasonText": {
"description": "The explanation of the reason.",
"type": "string"
},
"taxAmount": {
"$ref": "Price",
"description": "The amount of tax to be refunded. Optional, but if filled, then priceAmount must be set. Calculated automatically if not provided."
}
},
"type": "object"
},
"OrdersReturnRefundLineItemResponse": {
"id": "OrdersReturnRefundLineItemResponse",
"properties": {
"executionStatus": {
"description": "The status of the execution.",
"type": "string"
},
"kind": {
"default": "content#ordersReturnRefundLineItemResponse",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#ordersReturnRefundLineItemResponse\".",
"type": "string"
}
},
"type": "object"
},
"OrdersSetLineItemMetadataRequest": {
"id": "OrdersSetLineItemMetadataRequest",
"properties": {
"annotations": {
"items": {
"$ref": "OrderMerchantProvidedAnnotation"
},
"type": "array"
},
"lineItemId": {
"description": "The ID of the line item to set metadata. Either lineItemId or productId is required.",
"type": "string"
},
"operationId": {
"description": "The ID of the operation. Unique across all operations for a given order.",
"type": "string"
},
"productId": {
"description": "The ID of the product to set metadata. This is the REST ID used in the products service. Either lineItemId or productId is required.",
"type": "string"
}
},
"type": "object"
},
"OrdersSetLineItemMetadataResponse": {
"id": "OrdersSetLineItemMetadataResponse",
"properties": {
"executionStatus": {
"description": "The status of the execution.",
"type": "string"
},
"kind": {
"default": "content#ordersSetLineItemMetadataResponse",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#ordersSetLineItemMetadataResponse\".",
"type": "string"
}
},
"type": "object"
},
"OrdersShipLineItemsRequest": {
"id": "OrdersShipLineItemsRequest",
"properties": {
"lineItems": {
"description": "Line items to ship.",
"items": {
"$ref": "OrderShipmentLineItemShipment"
},
"type": "array"
},
"operationId": {
"description": "The ID of the operation. Unique across all operations for a given order.",
"type": "string"
},
"shipmentGroupId": {
"description": "ID of the shipment group. Required for orders that use the orderinvoices service.",
"type": "string"
},
"shipmentInfos": {
"description": "Shipment information. This field is repeated because a single line item can be shipped in several packages (and have several tracking IDs).",
"items": {
"$ref": "OrdersCustomBatchRequestEntryShipLineItemsShipmentInfo"
},
"type": "array"
}
},
"type": "object"
},
"OrdersShipLineItemsResponse": {
"id": "OrdersShipLineItemsResponse",
"properties": {
"executionStatus": {
"description": "The status of the execution.",
"type": "string"
},
"kind": {
"default": "content#ordersShipLineItemsResponse",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#ordersShipLineItemsResponse\".",
"type": "string"
}
},
"type": "object"
},
"OrdersUpdateLineItemShippingDetailsRequest": {
"id": "OrdersUpdateLineItemShippingDetailsRequest",
"properties": {
"deliverByDate": {
"description": "Updated delivery by date, in ISO 8601 format. If not specified only ship by date is updated.\n\nProvided date should be within 1 year timeframe and can not be a date in the past.",
"type": "string"
},
"lineItemId": {
"description": "The ID of the line item to set metadata. Either lineItemId or productId is required.",
"type": "string"
},
"operationId": {
"description": "The ID of the operation. Unique across all operations for a given order.",
"type": "string"
},
"productId": {
"description": "The ID of the product to set metadata. This is the REST ID used in the products service. Either lineItemId or productId is required.",
"type": "string"
},
"shipByDate": {
"description": "Updated ship by date, in ISO 8601 format. If not specified only deliver by date is updated.\n\nProvided date should be within 1 year timeframe and can not be a date in the past.",
"type": "string"
}
},
"type": "object"
},
"OrdersUpdateLineItemShippingDetailsResponse": {
"id": "OrdersUpdateLineItemShippingDetailsResponse",
"properties": {
"executionStatus": {
"description": "The status of the execution.",
"type": "string"
},
"kind": {
"default": "content#ordersUpdateLineItemShippingDetailsResponse",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#ordersUpdateLineItemShippingDetailsResponse\".",
"type": "string"
}
},
"type": "object"
},
"OrdersUpdateMerchantOrderIdRequest": {
"id": "OrdersUpdateMerchantOrderIdRequest",
"properties": {
"merchantOrderId": {
"description": "The merchant order id to be assigned to the order. Must be unique per merchant.",
"type": "string"
},
"operationId": {
"description": "The ID of the operation. Unique across all operations for a given order.",
"type": "string"
}
},
"type": "object"
},
"OrdersUpdateMerchantOrderIdResponse": {
"id": "OrdersUpdateMerchantOrderIdResponse",
"properties": {
"executionStatus": {
"description": "The status of the execution.",
"type": "string"
},
"kind": {
"default": "content#ordersUpdateMerchantOrderIdResponse",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#ordersUpdateMerchantOrderIdResponse\".",
"type": "string"
}
},
"type": "object"
},
"OrdersUpdateShipmentRequest": {
"id": "OrdersUpdateShipmentRequest",
"properties": {
"carrier": {
"description": "The carrier handling the shipment. Not updated if missing. See shipments[].carrier in the Orders resource representation for a list of acceptable values.",
"type": "string"
},
"deliveryDate": {
"description": "Date on which the shipment has been delivered, in ISO 8601 format. Optional and can be provided only if status is delivered.",
"type": "string"
},
"operationId": {
"description": "The ID of the operation. Unique across all operations for a given order.",
"type": "string"
},
"shipmentId": {
"description": "The ID of the shipment.",
"type": "string"
},
"status": {
"description": "New status for the shipment. Not updated if missing.",
"type": "string"
},
"trackingId": {
"description": "The tracking ID for the shipment. Not updated if missing.",
"type": "string"
}
},
"type": "object"
},
"OrdersUpdateShipmentResponse": {
"id": "OrdersUpdateShipmentResponse",
"properties": {
"executionStatus": {
"description": "The status of the execution.",
"type": "string"
},
"kind": {
"default": "content#ordersUpdateShipmentResponse",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#ordersUpdateShipmentResponse\".",
"type": "string"
}
},
"type": "object"
},
"PickupCarrierService": {
"id": "PickupCarrierService",
"properties": {
"carrierName": {
"description": "The name of the pickup carrier (e.g., \"UPS\"). Required.",
"type": "string"
},
"serviceName": {
"description": "The name of the pickup service (e.g., \"Access point\"). Required.",
"type": "string"
}
},
"type": "object"
},
"PickupServicesPickupService": {
"id": "PickupServicesPickupService",
"properties": {
"carrierName": {
"description": "The name of the carrier (e.g., \"UPS\"). Always present.",
"type": "string"
},
"country": {
"description": "The CLDR country code of the carrier (e.g., \"US\"). Always present.",
"type": "string"
},
"serviceName": {
"description": "The name of the pickup service (e.g., \"Access point\"). Always present.",
"type": "string"
}
},
"type": "object"
},
"PosCustomBatchRequest": {
"id": "PosCustomBatchRequest",
"properties": {
"entries": {
"description": "The request entries to be processed in the batch.",
"items": {
"$ref": "PosCustomBatchRequestEntry"
},
"type": "array"
}
},
"type": "object"
},
"PosCustomBatchRequestEntry": {
"id": "PosCustomBatchRequestEntry",
"properties": {
"batchId": {
"description": "An entry ID, unique within the batch request.",
"format": "uint32",
"type": "integer"
},
"inventory": {
"$ref": "PosInventory",
"description": "The inventory to submit. Set this only if the method is inventory."
},
"merchantId": {
"description": "The ID of the POS data provider.",
"format": "uint64",
"type": "string"
},
"method": {
"type": "string"
},
"sale": {
"$ref": "PosSale",
"description": "The sale information to submit. Set this only if the method is sale."
},
"store": {
"$ref": "PosStore",
"description": "The store information to submit. Set this only if the method is insert."
},
"storeCode": {
"description": "The store code. Set this only if the method is delete or get.",
"type": "string"
},
"targetMerchantId": {
"description": "The ID of the account for which to get/submit data.",
"format": "uint64",
"type": "string"
}
},
"type": "object"
},
"PosCustomBatchResponse": {
"id": "PosCustomBatchResponse",
"properties": {
"entries": {
"description": "The result of the execution of the batch requests.",
"items": {
"$ref": "PosCustomBatchResponseEntry"
},
"type": "array"
},
"kind": {
"default": "content#posCustomBatchResponse",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#posCustomBatchResponse\".",
"type": "string"
}
},
"type": "object"
},
"PosCustomBatchResponseEntry": {
"id": "PosCustomBatchResponseEntry",
"properties": {
"batchId": {
"description": "The ID of the request entry to which this entry responds.",
"format": "uint32",
"type": "integer"
},
"errors": {
"$ref": "Errors",
"description": "A list of errors defined if, and only if, the request failed."
},
"inventory": {
"$ref": "PosInventory",
"description": "The updated inventory information."
},
"kind": {
"default": "content#posCustomBatchResponseEntry",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#posCustomBatchResponseEntry\".",
"type": "string"
},
"sale": {
"$ref": "PosSale",
"description": "The updated sale information."
},
"store": {
"$ref": "PosStore",
"description": "The retrieved or updated store information."
}
},
"type": "object"
},
"PosDataProviders": {
"id": "PosDataProviders",
"properties": {
"country": {
"description": "Country code.",
"type": "string"
},
"posDataProviders": {
"description": "A list of POS data providers.",
"items": {
"$ref": "PosDataProvidersPosDataProvider"
},
"type": "array"
}
},
"type": "object"
},
"PosDataProvidersPosDataProvider": {
"id": "PosDataProvidersPosDataProvider",
"properties": {
"displayName": {
"description": "The display name of Pos data Provider.",
"type": "string"
},
"fullName": {
"description": "The full name of this POS data Provider.",
"type": "string"
},
"providerId": {
"description": "The ID of the account.",
"format": "uint64",
"type": "string"
}
},
"type": "object"
},
"PosInventory": {
"description": "The absolute quantity of an item available at the given store.",
"id": "PosInventory",
"properties": {
"contentLanguage": {
"annotations": {
"required": [
"content.pos.inventory"
]
},
"description": "The two-letter ISO 639-1 language code for the item.",
"type": "string"
},
"gtin": {
"description": "Global Trade Item Number.",
"type": "string"
},
"itemId": {
"annotations": {
"required": [
"content.pos.inventory"
]
},
"description": "A unique identifier for the item.",
"type": "string"
},
"kind": {
"default": "content#posInventory",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#posInventory\".",
"type": "string"
},
"price": {
"$ref": "Price",
"annotations": {
"required": [
"content.pos.inventory"
]
},
"description": "The current price of the item."
},
"quantity": {
"annotations": {
"required": [
"content.pos.inventory"
]
},
"description": "The available quantity of the item.",
"format": "int64",
"type": "string"
},
"storeCode": {
"annotations": {
"required": [
"content.pos.inventory"
]
},
"description": "The identifier of the merchant's store. Either a storeCode inserted via the API or the code of the store in Google My Business.",
"type": "string"
},
"targetCountry": {
"annotations": {
"required": [
"content.pos.inventory"
]
},
"description": "The CLDR territory code for the item.",
"type": "string"
},
"timestamp": {
"annotations": {
"required": [
"content.pos.inventory"
]
},
"description": "The inventory timestamp, in ISO 8601 format.",
"type": "string"
}
},
"type": "object"
},
"PosInventoryRequest": {
"id": "PosInventoryRequest",
"properties": {
"contentLanguage": {
"annotations": {
"required": [
"content.pos.inventory"
]
},
"description": "The two-letter ISO 639-1 language code for the item.",
"type": "string"
},
"gtin": {
"description": "Global Trade Item Number.",
"type": "string"
},
"itemId": {
"annotations": {
"required": [
"content.pos.inventory"
]
},
"description": "A unique identifier for the item.",
"type": "string"
},
"price": {
"$ref": "Price",
"annotations": {
"required": [
"content.pos.inventory"
]
},
"description": "The current price of the item."
},
"quantity": {
"annotations": {
"required": [
"content.pos.inventory"
]
},
"description": "The available quantity of the item.",
"format": "int64",
"type": "string"
},
"storeCode": {
"annotations": {
"required": [
"content.pos.inventory"
]
},
"description": "The identifier of the merchant's store. Either a storeCode inserted via the API or the code of the store in Google My Business.",
"type": "string"
},
"targetCountry": {
"annotations": {
"required": [
"content.pos.inventory"
]
},
"description": "The CLDR territory code for the item.",
"type": "string"
},
"timestamp": {
"annotations": {
"required": [
"content.pos.inventory"
]
},
"description": "The inventory timestamp, in ISO 8601 format.",
"type": "string"
}
},
"type": "object"
},
"PosInventoryResponse": {
"id": "PosInventoryResponse",
"properties": {
"contentLanguage": {
"annotations": {
"required": [
"content.pos.inventory"
]
},
"description": "The two-letter ISO 639-1 language code for the item.",
"type": "string"
},
"gtin": {
"description": "Global Trade Item Number.",
"type": "string"
},
"itemId": {
"annotations": {
"required": [
"content.pos.inventory"
]
},
"description": "A unique identifier for the item.",
"type": "string"
},
"kind": {
"default": "content#posInventoryResponse",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#posInventoryResponse\".",
"type": "string"
},
"price": {
"$ref": "Price",
"annotations": {
"required": [
"content.pos.inventory"
]
},
"description": "The current price of the item."
},
"quantity": {
"annotations": {
"required": [
"content.pos.inventory"
]
},
"description": "The available quantity of the item.",
"format": "int64",
"type": "string"
},
"storeCode": {
"annotations": {
"required": [
"content.pos.inventory"
]
},
"description": "The identifier of the merchant's store. Either a storeCode inserted via the API or the code of the store in Google My Business.",
"type": "string"
},
"targetCountry": {
"annotations": {
"required": [
"content.pos.inventory"
]
},
"description": "The CLDR territory code for the item.",
"type": "string"
},
"timestamp": {
"annotations": {
"required": [
"content.pos.inventory"
]
},
"description": "The inventory timestamp, in ISO 8601 format.",
"type": "string"
}
},
"type": "object"
},
"PosListResponse": {
"id": "PosListResponse",
"properties": {
"kind": {
"default": "content#posListResponse",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#posListResponse\".",
"type": "string"
},
"resources": {
"items": {
"$ref": "PosStore"
},
"type": "array"
}
},
"type": "object"
},
"PosSale": {
"description": "The change of the available quantity of an item at the given store.",
"id": "PosSale",
"properties": {
"contentLanguage": {
"annotations": {
"required": [
"content.pos.sale"
]
},
"description": "The two-letter ISO 639-1 language code for the item.",
"type": "string"
},
"gtin": {
"description": "Global Trade Item Number.",
"type": "string"
},
"itemId": {
"annotations": {
"required": [
"content.pos.sale"
]
},
"description": "A unique identifier for the item.",
"type": "string"
},
"kind": {
"default": "content#posSale",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#posSale\".",
"type": "string"
},
"price": {
"$ref": "Price",
"annotations": {
"required": [
"content.pos.sale"
]
},
"description": "The price of the item."
},
"quantity": {
"annotations": {
"required": [
"content.pos.sale"
]
},
"description": "The relative change of the available quantity. Negative for items returned.",
"format": "int64",
"type": "string"
},
"saleId": {
"description": "A unique ID to group items from the same sale event.",
"type": "string"
},
"storeCode": {
"annotations": {
"required": [
"content.pos.sale"
]
},
"description": "The identifier of the merchant's store. Either a storeCode inserted via the API or the code of the store in Google My Business.",
"type": "string"
},
"targetCountry": {
"annotations": {
"required": [
"content.pos.sale"
]
},
"description": "The CLDR territory code for the item.",
"type": "string"
},
"timestamp": {
"annotations": {
"required": [
"content.pos.sale"
]
},
"description": "The inventory timestamp, in ISO 8601 format.",
"type": "string"
}
},
"type": "object"
},
"PosSaleRequest": {
"id": "PosSaleRequest",
"properties": {
"contentLanguage": {
"annotations": {
"required": [
"content.pos.sale"
]
},
"description": "The two-letter ISO 639-1 language code for the item.",
"type": "string"
},
"gtin": {
"description": "Global Trade Item Number.",
"type": "string"
},
"itemId": {
"annotations": {
"required": [
"content.pos.sale"
]
},
"description": "A unique identifier for the item.",
"type": "string"
},
"price": {
"$ref": "Price",
"annotations": {
"required": [
"content.pos.sale"
]
},
"description": "The price of the item."
},
"quantity": {
"annotations": {
"required": [
"content.pos.sale"
]
},
"description": "The relative change of the available quantity. Negative for items returned.",
"format": "int64",
"type": "string"
},
"saleId": {
"description": "A unique ID to group items from the same sale event.",
"type": "string"
},
"storeCode": {
"annotations": {
"required": [
"content.pos.sale"
]
},
"description": "The identifier of the merchant's store. Either a storeCode inserted via the API or the code of the store in Google My Business.",
"type": "string"
},
"targetCountry": {
"annotations": {
"required": [
"content.pos.sale"
]
},
"description": "The CLDR territory code for the item.",
"type": "string"
},
"timestamp": {
"annotations": {
"required": [
"content.pos.sale"
]
},
"description": "The inventory timestamp, in ISO 8601 format.",
"type": "string"
}
},
"type": "object"
},
"PosSaleResponse": {
"id": "PosSaleResponse",
"properties": {
"contentLanguage": {
"annotations": {
"required": [
"content.pos.sale"
]
},
"description": "The two-letter ISO 639-1 language code for the item.",
"type": "string"
},
"gtin": {
"description": "Global Trade Item Number.",
"type": "string"
},
"itemId": {
"annotations": {
"required": [
"content.pos.sale"
]
},
"description": "A unique identifier for the item.",
"type": "string"
},
"kind": {
"default": "content#posSaleResponse",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#posSaleResponse\".",
"type": "string"
},
"price": {
"$ref": "Price",
"annotations": {
"required": [
"content.pos.sale"
]
},
"description": "The price of the item."
},
"quantity": {
"annotations": {
"required": [
"content.pos.sale"
]
},
"description": "The relative change of the available quantity. Negative for items returned.",
"format": "int64",
"type": "string"
},
"saleId": {
"description": "A unique ID to group items from the same sale event.",
"type": "string"
},
"storeCode": {
"annotations": {
"required": [
"content.pos.sale"
]
},
"description": "The identifier of the merchant's store. Either a storeCode inserted via the API or the code of the store in Google My Business.",
"type": "string"
},
"targetCountry": {
"annotations": {
"required": [
"content.pos.sale"
]
},
"description": "The CLDR territory code for the item.",
"type": "string"
},
"timestamp": {
"annotations": {
"required": [
"content.pos.sale"
]
},
"description": "The inventory timestamp, in ISO 8601 format.",
"type": "string"
}
},
"type": "object"
},
"PosStore": {
"description": "Store resource.",
"id": "PosStore",
"properties": {
"kind": {
"default": "content#posStore",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#posStore\".",
"type": "string"
},
"storeAddress": {
"annotations": {
"required": [
"content.pos.insert"
]
},
"description": "The street address of the store.",
"type": "string"
},
"storeCode": {
"annotations": {
"required": [
"content.pos.insert"
]
},
"description": "A store identifier that is unique for the given merchant.",
"type": "string"
}
},
"type": "object"
},
"PostalCodeGroup": {
"id": "PostalCodeGroup",
"properties": {
"country": {
"description": "The CLDR territory code of the country the postal code group applies to. Required.",
"type": "string"
},
"name": {
"description": "The name of the postal code group, referred to in headers. Required.",
"type": "string"
},
"postalCodeRanges": {
"description": "A range of postal codes. Required.",
"items": {
"$ref": "PostalCodeRange"
},
"type": "array"
}
},
"type": "object"
},
"PostalCodeRange": {
"id": "PostalCodeRange",
"properties": {
"postalCodeRangeBegin": {
"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.",
"type": "string"
},
"postalCodeRangeEnd": {
"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.",
"type": "string"
}
},
"type": "object"
},
"Price": {
"id": "Price",
"properties": {
"currency": {
"description": "The currency of the price.",
"type": "string"
},
"value": {
"description": "The price represented as a number.",
"type": "string"
}
},
"type": "object"
},
"Product": {
"description": "Product data. After inserting, updating, or deleting a product, it may take several minutes before changes take effect.",
"id": "Product",
"properties": {
"additionalImageLinks": {
"description": "Additional URLs of images of the item.",
"items": {
"type": "string"
},
"type": "array"
},
"adsGrouping": {
"description": "Used to group items in an arbitrary way. Only for CPA%, discouraged otherwise.",
"type": "string"
},
"adsLabels": {
"description": "Similar to ads_grouping, but only works on CPC.",
"items": {
"type": "string"
},
"type": "array"
},
"adsRedirect": {
"description": "Allows advertisers to override the item URL when the product is shown within the context of Product Ads.",
"type": "string"
},
"adult": {
"description": "Set to true if the item is targeted towards adults.",
"type": "boolean"
},
"ageGroup": {
"description": "Target age group of the item.",
"type": "string"
},
"availability": {
"description": "Availability status of the item.",
"type": "string"
},
"availabilityDate": {
"description": "The day a pre-ordered product becomes available for delivery, in ISO 8601 format.",
"type": "string"
},
"brand": {
"description": "Brand of the item.",
"type": "string"
},
"channel": {
"annotations": {
"required": [
"content.products.insert"
]
},
"description": "The item's channel (online or local).",
"type": "string"
},
"color": {
"description": "Color of the item.",
"type": "string"
},
"condition": {
"description": "Condition or state of the item.",
"type": "string"
},
"contentLanguage": {
"annotations": {
"required": [
"content.products.insert"
]
},
"description": "The two-letter ISO 639-1 language code for the item.",
"type": "string"
},
"costOfGoodsSold": {
"$ref": "Price",
"description": "Cost of goods sold. Used for gross profit reporting."
},
"customAttributes": {
"description": "A list of custom (merchant-provided) attributes. It can also be used for submitting any attribute of the feed specification in its generic form (e.g., { \"name\": \"size type\", \"value\": \"regular\" }). This is useful for submitting attributes not explicitly exposed by the API, such as additional attributes used for Shopping Actions.",
"items": {
"$ref": "CustomAttribute"
},
"type": "array"
},
"customLabel0": {
"description": "Custom label 0 for custom grouping of items in a Shopping campaign.",
"type": "string"
},
"customLabel1": {
"description": "Custom label 1 for custom grouping of items in a Shopping campaign.",
"type": "string"
},
"customLabel2": {
"description": "Custom label 2 for custom grouping of items in a Shopping campaign.",
"type": "string"
},
"customLabel3": {
"description": "Custom label 3 for custom grouping of items in a Shopping campaign.",
"type": "string"
},
"customLabel4": {
"description": "Custom label 4 for custom grouping of items in a Shopping campaign.",
"type": "string"
},
"description": {
"description": "Description of the item.",
"type": "string"
},
"displayAdsId": {
"description": "An identifier for an item for dynamic remarketing campaigns.",
"type": "string"
},
"displayAdsLink": {
"description": "URL directly to your item's landing page for dynamic remarketing campaigns.",
"type": "string"
},
"displayAdsSimilarIds": {
"description": "Advertiser-specified recommendations.",
"items": {
"type": "string"
},
"type": "array"
},
"displayAdsTitle": {
"description": "Title of an item for dynamic remarketing campaigns.",
"type": "string"
},
"displayAdsValue": {
"description": "Offer margin for dynamic remarketing campaigns.",
"format": "double",
"type": "number"
},
"energyEfficiencyClass": {
"description": "The energy efficiency class as defined in EU directive 2010/30/EU.",
"type": "string"
},
"excludedDestinations": {
"description": "The list of destinations to exclude for this target (corresponds to unchecked check boxes in Merchant Center).",
"items": {
"type": "string"
},
"type": "array"
},
"expirationDate": {
"description": "Date on which the item should expire, as specified upon insertion, in ISO 8601 format. The actual expiration date in Google Shopping is exposed in productstatuses as googleExpirationDate and might be earlier if expirationDate is too far in the future.",
"type": "string"
},
"gender": {
"description": "Target gender of the item.",
"type": "string"
},
"googleProductCategory": {
"description": "Google's category of the item (see Google product taxonomy).",
"type": "string"
},
"gtin": {
"description": "Global Trade Item Number (GTIN) of the item.",
"type": "string"
},
"id": {
"description": "The REST ID of the product. Content API methods that operate on products take this as their productId parameter.\nThe REST ID for a product is of the form channel:contentLanguage:targetCountry:offerId.",
"type": "string"
},
"identifierExists": {
"description": "False when the item does not have unique product identifiers appropriate to its category, such as GTIN, MPN, and brand. Required according to the Unique Product Identifier Rules for all target countries except for Canada.",
"type": "boolean"
},
"imageLink": {
"description": "URL of an image of the item.",
"type": "string"
},
"includedDestinations": {
"description": "The list of destinations to include for this target (corresponds to checked check boxes in Merchant Center). Default destinations are always included unless provided in excludedDestinations.",
"items": {
"type": "string"
},
"type": "array"
},
"installment": {
"$ref": "Installment",
"description": "Number and amount of installments to pay for an item. Brazil only."
},
"isBundle": {
"description": "Whether the item is a merchant-defined bundle. A bundle is a custom grouping of different products sold by a merchant for a single price.",
"type": "boolean"
},
"itemGroupId": {
"description": "Shared identifier for all variants of the same product.",
"type": "string"
},
"kind": {
"default": "content#product",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#product\".",
"type": "string"
},
"link": {
"description": "URL directly linking to your item's page on your website.",
"type": "string"
},
"loyaltyPoints": {
"$ref": "LoyaltyPoints",
"description": "Loyalty points that users receive after purchasing the item. Japan only."
},
"material": {
"description": "The material of which the item is made.",
"type": "string"
},
"maxEnergyEfficiencyClass": {
"description": "The energy efficiency class as defined in EU directive 2010/30/EU.",
"type": "string"
},
"maxHandlingTime": {
"description": "Maximal product handling time (in business days).",
"format": "int64",
"type": "string"
},
"minEnergyEfficiencyClass": {
"description": "The energy efficiency class as defined in EU directive 2010/30/EU.",
"type": "string"
},
"minHandlingTime": {
"description": "Minimal product handling time (in business days).",
"format": "int64",
"type": "string"
},
"mobileLink": {
"description": "Link to a mobile-optimized version of the landing page.",
"type": "string"
},
"mpn": {
"description": "Manufacturer Part Number (MPN) of the item.",
"type": "string"
},
"multipack": {
"description": "The number of identical products in a merchant-defined multipack.",
"format": "int64",
"type": "string"
},
"offerId": {
"annotations": {
"required": [
"content.products.insert"
]
},
"description": "A unique identifier for 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.\nNote: Content API methods that operate on products take the REST ID of the product, not this identifier.",
"type": "string"
},
"pattern": {
"description": "The item's pattern (e.g. polka dots).",
"type": "string"
},
"price": {
"$ref": "Price",
"description": "Price of the item."
},
"productTypes": {
"description": "Categories of the item (formatted as in products data specification).",
"items": {
"type": "string"
},
"type": "array"
},
"promotionIds": {
"description": "The unique ID of a promotion.",
"items": {
"type": "string"
},
"type": "array"
},
"salePrice": {
"$ref": "Price",
"description": "Advertised sale price of the item."
},
"salePriceEffectiveDate": {
"description": "Date range during which the item is on sale (see products data specification).",
"type": "string"
},
"sellOnGoogleQuantity": {
"description": "The quantity of the product that is available for selling on Google. Supported only for online products.",
"format": "int64",
"type": "string"
},
"shipping": {
"description": "Shipping rules.",
"items": {
"$ref": "ProductShipping"
},
"type": "array"
},
"shippingHeight": {
"$ref": "ProductShippingDimension",
"description": "Height of the item for shipping."
},
"shippingLabel": {
"description": "The shipping label of the product, used to group product in account-level shipping rules.",
"type": "string"
},
"shippingLength": {
"$ref": "ProductShippingDimension",
"description": "Length of the item for shipping."
},
"shippingWeight": {
"$ref": "ProductShippingWeight",
"description": "Weight of the item for shipping."
},
"shippingWidth": {
"$ref": "ProductShippingDimension",
"description": "Width of the item for shipping."
},
"sizeSystem": {
"description": "System in which the size is specified. Recommended for apparel items.",
"type": "string"
},
"sizeType": {
"description": "The cut of the item. Recommended for apparel items.",
"type": "string"
},
"sizes": {
"description": "Size of the item. Only one value is allowed. For variants with different sizes, insert a separate product for each size with the same itemGroupId value (see size definition).",
"items": {
"type": "string"
},
"type": "array"
},
"source": {
"description": "The source of the offer, i.e., how the offer was created.",
"type": "string"
},
"targetCountry": {
"annotations": {
"required": [
"content.products.insert"
]
},
"description": "The CLDR territory code for the item.",
"type": "string"
},
"taxCategory": {
"description": "The tax category of the product, used to configure detailed tax nexus in account-level tax settings.",
"type": "string"
},
"taxes": {
"description": "Tax information.",
"items": {
"$ref": "ProductTax"
},
"type": "array"
},
"title": {
"description": "Title of the item.",
"type": "string"
},
"transitTimeLabel": {
"description": "The transit time label of the product, used to group product in account-level transit time tables.",
"type": "string"
},
"unitPricingBaseMeasure": {
"$ref": "ProductUnitPricingBaseMeasure",
"description": "The preference of the denominator of the unit price."
},
"unitPricingMeasure": {
"$ref": "ProductUnitPricingMeasure",
"description": "The measure and dimension of an item."
}
},
"type": "object"
},
"ProductAmount": {
"id": "ProductAmount",
"properties": {
"priceAmount": {
"$ref": "Price",
"description": "The pre-tax or post-tax price depending on the location of the order."
},
"remittedTaxAmount": {
"$ref": "Price",
"description": "Remitted tax value."
},
"taxAmount": {
"$ref": "Price",
"description": "Tax value."
}
},
"type": "object"
},
"ProductShipping": {
"id": "ProductShipping",
"properties": {
"country": {
"description": "The CLDR territory code of the country to which an item will ship.",
"type": "string"
},
"locationGroupName": {
"description": "The location where the shipping is applicable, represented by a location group name.",
"type": "string"
},
"locationId": {
"description": "The numeric ID of a location that the shipping rate applies to as defined in the AdWords API.",
"format": "int64",
"type": "string"
},
"postalCode": {
"description": "The postal code range that the shipping rate applies to, represented by a postal code, a postal code prefix followed by a * wildcard, a range between two postal codes or two postal code prefixes of equal length.",
"type": "string"
},
"price": {
"$ref": "Price",
"description": "Fixed shipping price, represented as a number."
},
"region": {
"description": "The geographic region to which a shipping rate applies.",
"type": "string"
},
"service": {
"description": "A free-form description of the service class or delivery speed.",
"type": "string"
}
},
"type": "object"
},
"ProductShippingDimension": {
"id": "ProductShippingDimension",
"properties": {
"unit": {
"description": "The unit of value.",
"type": "string"
},
"value": {
"description": "The dimension of the product used to calculate the shipping cost of the item.",
"format": "double",
"type": "number"
}
},
"type": "object"
},
"ProductShippingWeight": {
"id": "ProductShippingWeight",
"properties": {
"unit": {
"description": "The unit of value.",
"type": "string"
},
"value": {
"description": "The weight of the product used to calculate the shipping cost of the item.",
"format": "double",
"type": "number"
}
},
"type": "object"
},
"ProductStatus": {
"description": "The status of a product, i.e., information about a product computed asynchronously.",
"id": "ProductStatus",
"properties": {
"creationDate": {
"description": "Date on which the item has been created, in ISO 8601 format.",
"type": "string"
},
"destinationStatuses": {
"description": "The intended destinations for the product.",
"items": {
"$ref": "ProductStatusDestinationStatus"
},
"type": "array"
},
"googleExpirationDate": {
"description": "Date on which the item expires in Google Shopping, in ISO 8601 format.",
"type": "string"
},
"itemLevelIssues": {
"description": "A list of all issues associated with the product.",
"items": {
"$ref": "ProductStatusItemLevelIssue"
},
"type": "array"
},
"kind": {
"default": "content#productStatus",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#productStatus\".",
"type": "string"
},
"lastUpdateDate": {
"description": "Date on which the item has been last updated, in ISO 8601 format.",
"type": "string"
},
"link": {
"description": "The link to the product.",
"type": "string"
},
"productId": {
"description": "The ID of the product for which status is reported.",
"type": "string"
},
"title": {
"description": "The title of the product.",
"type": "string"
}
},
"type": "object"
},
"ProductStatusDestinationStatus": {
"id": "ProductStatusDestinationStatus",
"properties": {
"destination": {
"description": "The name of the destination",
"type": "string"
},
"status": {
"type": "string"
}
},
"type": "object"
},
"ProductStatusItemLevelIssue": {
"id": "ProductStatusItemLevelIssue",
"properties": {
"attributeName": {
"description": "The attribute's name, if the issue is caused by a single attribute.",
"type": "string"
},
"code": {
"description": "The error code of the issue.",
"type": "string"
},
"description": {
"description": "A short issue description in English.",
"type": "string"
},
"destination": {
"description": "The destination the issue applies to.",
"type": "string"
},
"detail": {
"description": "A detailed issue description in English.",
"type": "string"
},
"documentation": {
"description": "The URL of a web page to help with resolving this issue.",
"type": "string"
},
"resolution": {
"description": "Whether the issue can be resolved by the merchant.",
"type": "string"
},
"servability": {
"description": "How this issue affects serving of the offer.",
"type": "string"
}
},
"type": "object"
},
"ProductTax": {
"id": "ProductTax",
"properties": {
"country": {
"description": "The country within which the item is taxed, specified as a CLDR territory code.",
"type": "string"
},
"locationId": {
"description": "The numeric ID of a location that the tax rate applies to as defined in the AdWords API.",
"format": "int64",
"type": "string"
},
"postalCode": {
"description": "The postal code range that the tax rate applies to, represented by a ZIP code, a ZIP code prefix using * wildcard, a range between two ZIP codes or two ZIP code prefixes of equal length. Examples: 94114, 94*, 94002-95460, 94*-95*.",
"type": "string"
},
"rate": {
"description": "The percentage of tax rate that applies to the item price.",
"format": "double",
"type": "number"
},
"region": {
"description": "The geographic region to which the tax rate applies.",
"type": "string"
},
"taxShip": {
"description": "Set to true if tax is charged on shipping.",
"type": "boolean"
}
},
"type": "object"
},
"ProductUnitPricingBaseMeasure": {
"id": "ProductUnitPricingBaseMeasure",
"properties": {
"unit": {
"description": "The unit of the denominator.",
"type": "string"
},
"value": {
"description": "The denominator of the unit price.",
"format": "int64",
"type": "string"
}
},
"type": "object"
},
"ProductUnitPricingMeasure": {
"id": "ProductUnitPricingMeasure",
"properties": {
"unit": {
"description": "The unit of the measure.",
"type": "string"
},
"value": {
"description": "The measure of an item.",
"format": "double",
"type": "number"
}
},
"type": "object"
},
"ProductsCustomBatchRequest": {
"id": "ProductsCustomBatchRequest",
"properties": {
"entries": {
"description": "The request entries to be processed in the batch.",
"items": {
"$ref": "ProductsCustomBatchRequestEntry"
},
"type": "array"
}
},
"type": "object"
},
"ProductsCustomBatchRequestEntry": {
"description": "A batch entry encoding a single non-batch products request.",
"id": "ProductsCustomBatchRequestEntry",
"properties": {
"batchId": {
"description": "An entry ID, unique within the batch request.",
"format": "uint32",
"type": "integer"
},
"feedId": {
"description": "The Content API feed id.",
"format": "uint64",
"type": "string"
},
"merchantId": {
"description": "The ID of the managing account.",
"format": "uint64",
"type": "string"
},
"method": {
"type": "string"
},
"product": {
"$ref": "Product",
"description": "The product to insert. Only required if the method is insert."
},
"productId": {
"description": "The ID of the product to get or delete. Only defined if the method is get or delete.",
"type": "string"
}
},
"type": "object"
},
"ProductsCustomBatchResponse": {
"id": "ProductsCustomBatchResponse",
"properties": {
"entries": {
"description": "The result of the execution of the batch requests.",
"items": {
"$ref": "ProductsCustomBatchResponseEntry"
},
"type": "array"
},
"kind": {
"default": "content#productsCustomBatchResponse",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#productsCustomBatchResponse\".",
"type": "string"
}
},
"type": "object"
},
"ProductsCustomBatchResponseEntry": {
"description": "A batch entry encoding a single non-batch products response.",
"id": "ProductsCustomBatchResponseEntry",
"properties": {
"batchId": {
"description": "The ID of the request entry this entry responds to.",
"format": "uint32",
"type": "integer"
},
"errors": {
"$ref": "Errors",
"description": "A list of errors defined if and only if the request failed."
},
"kind": {
"default": "content#productsCustomBatchResponseEntry",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#productsCustomBatchResponseEntry\".",
"type": "string"
},
"product": {
"$ref": "Product",
"description": "The inserted product. Only defined if the method is insert and if the request was successful."
}
},
"type": "object"
},
"ProductsListResponse": {
"id": "ProductsListResponse",
"properties": {
"kind": {
"default": "content#productsListResponse",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#productsListResponse\".",
"type": "string"
},
"nextPageToken": {
"description": "The token for the retrieval of the next page of products.",
"type": "string"
},
"resources": {
"items": {
"$ref": "Product"
},
"type": "array"
}
},
"type": "object"
},
"ProductstatusesCustomBatchRequest": {
"id": "ProductstatusesCustomBatchRequest",
"properties": {
"entries": {
"description": "The request entries to be processed in the batch.",
"items": {
"$ref": "ProductstatusesCustomBatchRequestEntry"
},
"type": "array"
}
},
"type": "object"
},
"ProductstatusesCustomBatchRequestEntry": {
"description": "A batch entry encoding a single non-batch productstatuses request.",
"id": "ProductstatusesCustomBatchRequestEntry",
"properties": {
"batchId": {
"description": "An entry ID, unique within the batch request.",
"format": "uint32",
"type": "integer"
},
"destinations": {
"description": "If set, only issues for the specified destinations are returned, otherwise only issues for the Shopping destination.",
"items": {
"type": "string"
},
"type": "array"
},
"includeAttributes": {
"type": "boolean"
},
"merchantId": {
"description": "The ID of the managing account.",
"format": "uint64",
"type": "string"
},
"method": {
"type": "string"
},
"productId": {
"description": "The ID of the product whose status to get.",
"type": "string"
}
},
"type": "object"
},
"ProductstatusesCustomBatchResponse": {
"id": "ProductstatusesCustomBatchResponse",
"properties": {
"entries": {
"description": "The result of the execution of the batch requests.",
"items": {
"$ref": "ProductstatusesCustomBatchResponseEntry"
},
"type": "array"
},
"kind": {
"default": "content#productstatusesCustomBatchResponse",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#productstatusesCustomBatchResponse\".",
"type": "string"
}
},
"type": "object"
},
"ProductstatusesCustomBatchResponseEntry": {
"description": "A batch entry encoding a single non-batch productstatuses response.",
"id": "ProductstatusesCustomBatchResponseEntry",
"properties": {
"batchId": {
"description": "The ID of the request entry this entry responds to.",
"format": "uint32",
"type": "integer"
},
"errors": {
"$ref": "Errors",
"description": "A list of errors, if the request failed."
},
"kind": {
"default": "content#productstatusesCustomBatchResponseEntry",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#productstatusesCustomBatchResponseEntry\".",
"type": "string"
},
"productStatus": {
"$ref": "ProductStatus",
"description": "The requested product status. Only defined if the request was successful."
}
},
"type": "object"
},
"ProductstatusesListResponse": {
"id": "ProductstatusesListResponse",
"properties": {
"kind": {
"default": "content#productstatusesListResponse",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#productstatusesListResponse\".",
"type": "string"
},
"nextPageToken": {
"description": "The token for the retrieval of the next page of products statuses.",
"type": "string"
},
"resources": {
"items": {
"$ref": "ProductStatus"
},
"type": "array"
}
},
"type": "object"
},
"PubsubNotificationSettings": {
"description": "Settings for Pub/Sub notifications, all methods require that the caller is a direct user of the merchant center account.",
"id": "PubsubNotificationSettings",
"properties": {
"cloudTopicName": {
"description": "Cloud pub/sub topic to which notifications are sent (read-only).",
"type": "string"
},
"kind": {
"default": "content#pubsubNotificationSettings",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#pubsubNotificationSettings\".",
"type": "string"
},
"registeredEvents": {
"description": "List of event types. Supported event types: orderPendingShipment.",
"items": {
"type": "string"
},
"type": "array"
}
},
"type": "object"
},
"RateGroup": {
"id": "RateGroup",
"properties": {
"applicableShippingLabels": {
"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"
},
"type": "array"
},
"carrierRates": {
"description": "A list of carrier rates that can be referred to by mainTable or singleValue.",
"items": {
"$ref": "CarrierRate"
},
"type": "array"
},
"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."
},
"name": {
"description": "Name of the rate group. Optional. If set has to be unique within shipping service.",
"type": "string"
},
"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": {
"description": "A list of subtables referred to by mainTable. Can only be set if mainTable is set.",
"items": {
"$ref": "Table"
},
"type": "array"
}
},
"type": "object"
},
"RefundReason": {
"id": "RefundReason",
"properties": {
"description": {
"description": "Description of the reason.",
"type": "string"
},
"reasonCode": {
"description": "Code of the refund reason.",
"type": "string"
}
},
"type": "object"
},
"RegionalInventory": {
"description": "Regional inventory resource. contains the regional name and all attributes which are overridden for the specified region.",
"id": "RegionalInventory",
"properties": {
"availability": {
"description": "The availability of the product.",
"type": "string"
},
"customAttributes": {
"description": "A list of custom (merchant-provided) attributes. It can also be used for submitting any attribute of the feed specification in its generic form.",
"items": {
"$ref": "CustomAttribute"
},
"type": "array"
},
"kind": {
"default": "content#regionalInventory",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#regionalInventory\".",
"type": "string"
},
"price": {
"$ref": "Price",
"description": "The price of the product."
},
"regionId": {
"description": "The ID (name) of the region.",
"type": "string"
},
"salePrice": {
"$ref": "Price",
"description": "The sale price of the product. Mandatory if sale_price_effective_date is defined."
},
"salePriceEffectiveDate": {
"description": "A date range represented by a pair of ISO 8601 dates separated by a space, comma, or slash. Both dates might be specified as 'null' if undecided.",
"type": "string"
}
},
"type": "object"
},
"RegionalinventoryCustomBatchRequest": {
"id": "RegionalinventoryCustomBatchRequest",
"properties": {
"entries": {
"description": "The request entries to be processed in the batch.",
"items": {
"$ref": "RegionalinventoryCustomBatchRequestEntry"
},
"type": "array"
}
},
"type": "object"
},
"RegionalinventoryCustomBatchRequestEntry": {
"description": "A batch entry encoding a single non-batch regional inventory request.",
"id": "RegionalinventoryCustomBatchRequestEntry",
"properties": {
"batchId": {
"description": "An entry ID, unique within the batch request.",
"format": "uint32",
"type": "integer"
},
"merchantId": {
"description": "The ID of the managing account.",
"format": "uint64",
"type": "string"
},
"method": {
"type": "string"
},
"productId": {
"description": "The ID of the product for which to update price and availability.",
"type": "string"
},
"regionalInventory": {
"$ref": "RegionalInventory",
"description": "Price and availability of the product."
}
},
"type": "object"
},
"RegionalinventoryCustomBatchResponse": {
"id": "RegionalinventoryCustomBatchResponse",
"properties": {
"entries": {
"description": "The result of the execution of the batch requests.",
"items": {
"$ref": "RegionalinventoryCustomBatchResponseEntry"
},
"type": "array"
},
"kind": {
"default": "content#regionalinventoryCustomBatchResponse",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#regionalinventoryCustomBatchResponse\".",
"type": "string"
}
},
"type": "object"
},
"RegionalinventoryCustomBatchResponseEntry": {
"description": "A batch entry encoding a single non-batch regional inventory response.",
"id": "RegionalinventoryCustomBatchResponseEntry",
"properties": {
"batchId": {
"description": "The ID of the request entry this entry responds to.",
"format": "uint32",
"type": "integer"
},
"errors": {
"$ref": "Errors",
"description": "A list of errors defined if and only if the request failed."
},
"kind": {
"default": "content#regionalinventoryCustomBatchResponseEntry",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#regionalinventoryCustomBatchResponseEntry\".",
"type": "string"
},
"regionalInventory": {
"$ref": "RegionalInventory",
"description": "Price and availability of the product."
}
},
"type": "object"
},
"ReturnAddress": {
"description": "Return address resource.",
"id": "ReturnAddress",
"properties": {
"address": {
"$ref": "ReturnAddressAddress",
"annotations": {
"required": [
"content.returnaddress.insert"
]
},
"description": "The address."
},
"country": {
"annotations": {
"required": [
"content.returnaddress.insert"
]
},
"description": "The country of sale where the return address is applicable.",
"type": "string"
},
"kind": {
"default": "content#returnAddress",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#returnAddress\".",
"type": "string"
},
"label": {
"annotations": {
"required": [
"content.returnaddress.insert"
]
},
"description": "The user-defined label of the return address. For the default address, use the label \"default\".",
"type": "string"
},
"phoneNumber": {
"annotations": {
"required": [
"content.returnaddress.insert"
]
},
"description": "The merchant's contact phone number regarding the return.",
"type": "string"
},
"returnAddressId": {
"description": "Return address ID generated by Google.",
"type": "string"
}
},
"type": "object"
},
"ReturnAddressAddress": {
"id": "ReturnAddressAddress",
"properties": {
"country": {
"description": "CLDR country code (e.g. \"US\").",
"type": "string"
},
"locality": {
"description": "City, town or commune. May also include dependent localities or sublocalities (e.g. neighborhoods or suburbs).",
"type": "string"
},
"postalCode": {
"description": "Postal code or ZIP (e.g. \"94043\").",
"type": "string"
},
"recipientName": {
"description": "Name of the recipient to address returns to.",
"type": "string"
},
"region": {
"description": "Top-level administrative subdivision of the country. For example, a state like California (\"CA\") or a province like Quebec (\"QC\").",
"type": "string"
},
"streetAddress": {
"description": "Street-level part of the address. May be up to two lines, each line specified as an array element.",
"items": {
"type": "string"
},
"type": "array"
}
},
"type": "object"
},
"ReturnPolicy": {
"description": "Return policy resource.",
"id": "ReturnPolicy",
"properties": {
"country": {
"annotations": {
"required": [
"content.returnpolicy.insert"
]
},
"description": "The country of sale where the return policy is applicable.",
"type": "string"
},
"kind": {
"default": "content#returnPolicy",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#returnPolicy\".",
"type": "string"
},
"label": {
"annotations": {
"required": [
"content.returnpolicy.insert"
]
},
"description": "The user-defined label of the return policy. For the default policy, use the label \"default\".",
"type": "string"
},
"name": {
"annotations": {
"required": [
"content.returnpolicy.insert"
]
},
"description": "The name of the policy as shown in Merchant Center.",
"type": "string"
},
"nonFreeReturnReasons": {
"description": "Return reasons that will incur return fees.",
"items": {
"type": "string"
},
"type": "array"
},
"policy": {
"$ref": "ReturnPolicyPolicy",
"annotations": {
"required": [
"content.returnpolicy.insert"
]
},
"description": "The policy."
},
"returnPolicyId": {
"description": "Return policy ID generated by Google.",
"type": "string"
},
"seasonalOverrides": {
"description": "An optional list of seasonal overrides.",
"items": {
"$ref": "ReturnPolicySeasonalOverride"
},
"type": "array"
}
},
"type": "object"
},
"ReturnPolicyPolicy": {
"id": "ReturnPolicyPolicy",
"properties": {
"lastReturnDate": {
"annotations": {
"required": [
"content.returnpolicy.insert"
]
},
"description": "Last day for returning the items. In ISO 8601 format. When specifying the return window like this, set the policy type to \"lastReturnDate\". Use this for seasonal overrides only.",
"type": "string"
},
"numberOfDays": {
"description": "The number of days items can be returned after delivery, where one day is defined to be 24 hours after the delivery timestamp. When specifying the return window like this, set the policy type to \"numberOfDaysAfterDelivery\". Acceptable values are 30, 45, 60, 90, 100, 180, 270 and 365 for the default policy. Additional policies further allow 14, 15, 21 and 28 days, but note that for most items a minimum of 30 days is required for returns. Exceptions may be made for electronics. A policy of less than 30 days can only be applied to those items.",
"format": "int64",
"type": "string"
},
"type": {
"description": "Policy type. Use \"lastReturnDate\" for seasonal overrides only. Note that for most items a minimum of 30 days is required for returns. Exceptions may be made for electronics or non-returnable items such as food, perishables, and living things. A policy of less than 30 days can only be applied to those items.",
"type": "string"
}
},
"type": "object"
},
"ReturnPolicySeasonalOverride": {
"id": "ReturnPolicySeasonalOverride",
"properties": {
"endDate": {
"annotations": {
"required": [
"content.returnpolicy.insert"
]
},
"description": "Last day on which the override applies. In ISO 8601 format.",
"type": "string"
},
"name": {
"annotations": {
"required": [
"content.returnpolicy.insert"
]
},
"description": "The name of the seasonal override as shown in Merchant Center.",
"type": "string"
},
"policy": {
"$ref": "ReturnPolicyPolicy",
"annotations": {
"required": [
"content.returnpolicy.insert"
]
},
"description": "The policy which is in effect during that time."
},
"startDate": {
"annotations": {
"required": [
"content.returnpolicy.insert"
]
},
"description": "First day on which the override applies. In ISO 8601 format.",
"type": "string"
}
},
"type": "object"
},
"ReturnShipment": {
"id": "ReturnShipment",
"properties": {
"creationDate": {
"description": "The date of creation of the shipment, in ISO 8601 format.",
"type": "string"
},
"deliveryDate": {
"description": "The date of delivery of the shipment, in ISO 8601 format.",
"type": "string"
},
"returnMethodType": {
"description": "Type of the return method.",
"type": "string"
},
"shipmentId": {
"description": "Shipment ID generated by Google.",
"type": "string"
},
"shipmentTrackingInfos": {
"description": "Tracking information of the shipment. One return shipment might be handled by several shipping carriers sequentially.",
"items": {
"$ref": "ShipmentTrackingInfo"
},
"type": "array"
},
"shippingDate": {
"description": "The date of shipping of the shipment, in ISO 8601 format.",
"type": "string"
},
"state": {
"description": "State of the shipment.",
"type": "string"
}
},
"type": "object"
},
"ReturnaddressCustomBatchRequest": {
"id": "ReturnaddressCustomBatchRequest",
"properties": {
"entries": {
"description": "The request entries to be processed in the batch.",
"items": {
"$ref": "ReturnaddressCustomBatchRequestEntry"
},
"type": "array"
}
},
"type": "object"
},
"ReturnaddressCustomBatchRequestEntry": {
"id": "ReturnaddressCustomBatchRequestEntry",
"properties": {
"batchId": {
"description": "An entry ID, unique within the batch request.",
"format": "uint32",
"type": "integer"
},
"merchantId": {
"description": "The Merchant Center account ID.",
"format": "uint64",
"type": "string"
},
"method": {
"type": "string"
},
"returnAddress": {
"$ref": "ReturnAddress",
"description": "The return address to submit. Set this only if the method is insert."
},
"returnAddressId": {
"description": "The return address ID. Set this only if the method is delete or get.",
"type": "string"
}
},
"type": "object"
},
"ReturnaddressCustomBatchResponse": {
"id": "ReturnaddressCustomBatchResponse",
"properties": {
"entries": {
"description": "The result of the execution of the batch requests.",
"items": {
"$ref": "ReturnaddressCustomBatchResponseEntry"
},
"type": "array"
},
"kind": {
"default": "content#returnaddressCustomBatchResponse",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#returnaddressCustomBatchResponse\".",
"type": "string"
}
},
"type": "object"
},
"ReturnaddressCustomBatchResponseEntry": {
"id": "ReturnaddressCustomBatchResponseEntry",
"properties": {
"batchId": {
"description": "The ID of the request entry to which this entry responds.",
"format": "uint32",
"type": "integer"
},
"errors": {
"$ref": "Errors",
"description": "A list of errors defined if, and only if, the request failed."
},
"kind": {
"default": "content#returnaddressCustomBatchResponseEntry",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#returnaddressCustomBatchResponseEntry\".",
"type": "string"
},
"returnAddress": {
"$ref": "ReturnAddress",
"description": "The retrieved return address."
}
},
"type": "object"
},
"ReturnaddressListResponse": {
"id": "ReturnaddressListResponse",
"properties": {
"kind": {
"default": "content#returnaddressListResponse",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#returnaddressListResponse\".",
"type": "string"
},
"nextPageToken": {
"description": "The token for the retrieval of the next page of addresses.",
"type": "string"
},
"resources": {
"items": {
"$ref": "ReturnAddress"
},
"type": "array"
}
},
"type": "object"
},
"ReturnpolicyCustomBatchRequest": {
"id": "ReturnpolicyCustomBatchRequest",
"properties": {
"entries": {
"description": "The request entries to be processed in the batch.",
"items": {
"$ref": "ReturnpolicyCustomBatchRequestEntry"
},
"type": "array"
}
},
"type": "object"
},
"ReturnpolicyCustomBatchRequestEntry": {
"id": "ReturnpolicyCustomBatchRequestEntry",
"properties": {
"batchId": {
"description": "An entry ID, unique within the batch request.",
"format": "uint32",
"type": "integer"
},
"merchantId": {
"description": "The Merchant Center account ID.",
"format": "uint64",
"type": "string"
},
"method": {
"type": "string"
},
"returnPolicy": {
"$ref": "ReturnPolicy",
"description": "The return policy to submit. Set this only if the method is insert."
},
"returnPolicyId": {
"description": "The return policy ID. Set this only if the method is delete or get.",
"type": "string"
}
},
"type": "object"
},
"ReturnpolicyCustomBatchResponse": {
"id": "ReturnpolicyCustomBatchResponse",
"properties": {
"entries": {
"description": "The result of the execution of the batch requests.",
"items": {
"$ref": "ReturnpolicyCustomBatchResponseEntry"
},
"type": "array"
},
"kind": {
"default": "content#returnpolicyCustomBatchResponse",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#returnpolicyCustomBatchResponse\".",
"type": "string"
}
},
"type": "object"
},
"ReturnpolicyCustomBatchResponseEntry": {
"id": "ReturnpolicyCustomBatchResponseEntry",
"properties": {
"batchId": {
"description": "The ID of the request entry to which this entry responds.",
"format": "uint32",
"type": "integer"
},
"errors": {
"$ref": "Errors",
"description": "A list of errors defined if, and only if, the request failed."
},
"kind": {
"default": "content#returnpolicyCustomBatchResponseEntry",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#returnpolicyCustomBatchResponseEntry\".",
"type": "string"
},
"returnPolicy": {
"$ref": "ReturnPolicy",
"description": "The retrieved return policy."
}
},
"type": "object"
},
"ReturnpolicyListResponse": {
"id": "ReturnpolicyListResponse",
"properties": {
"kind": {
"default": "content#returnpolicyListResponse",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#returnpolicyListResponse\".",
"type": "string"
},
"resources": {
"items": {
"$ref": "ReturnPolicy"
},
"type": "array"
}
},
"type": "object"
},
"Row": {
"id": "Row",
"properties": {
"cells": {
"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"
},
"type": "array"
}
},
"type": "object"
},
"Service": {
"id": "Service",
"properties": {
"active": {
"description": "A boolean exposing the active status of the shipping service. Required.",
"type": "boolean"
},
"currency": {
"description": "The CLDR code of the currency to which this service applies. Must match that of the prices in rate groups.",
"type": "string"
},
"deliveryCountry": {
"description": "The CLDR territory code of the country to which the service applies. Required.",
"type": "string"
},
"deliveryTime": {
"$ref": "DeliveryTime",
"description": "Time spent in various aspects from order to the delivery of the product. Required."
},
"eligibility": {
"description": "Eligibility for this service.",
"type": "string"
},
"minimumOrderValue": {
"$ref": "Price",
"description": "Minimum order value for this service. If set, indicates that customers will have to spend at least this amount. All prices within a service must have the same currency."
},
"name": {
"description": "Free-form name of the service. Must be unique within target account. Required.",
"type": "string"
},
"pickupService": {
"$ref": "PickupCarrierService",
"description": "The carrier-service pair delivering items to collection points. The list of supported pickup services can be retrieved via the getSupportedPickupServices method. Required if and only if the service delivery type is pickup."
},
"rateGroups": {
"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"
},
"type": "array"
},
"shipmentType": {
"description": "Type of locations this service ships orders to.",
"type": "string"
}
},
"type": "object"
},
"ShipmentInvoice": {
"id": "ShipmentInvoice",
"properties": {
"invoiceSummary": {
"$ref": "InvoiceSummary",
"description": "[required] Invoice summary."
},
"lineItemInvoices": {
"description": "[required] Invoice details per line item.",
"items": {
"$ref": "ShipmentInvoiceLineItemInvoice"
},
"type": "array"
},
"shipmentGroupId": {
"description": "[required] ID of the shipment group. It is assigned by the merchant in the shipLineItems method and is used to group multiple line items that have the same kind of shipping charges.",
"type": "string"
}
},
"type": "object"
},
"ShipmentInvoiceLineItemInvoice": {
"id": "ShipmentInvoiceLineItemInvoice",
"properties": {
"lineItemId": {
"description": "ID of the line item. Either lineItemId or productId must be set.",
"type": "string"
},
"productId": {
"description": "ID of the product. This is the REST ID used in the products service. Either lineItemId or productId must be set.",
"type": "string"
},
"shipmentUnitIds": {
"description": "[required] The shipment unit ID is assigned by the merchant and defines individual quantities within a line item. The same ID can be assigned to units that are the same while units that differ must be assigned a different ID (for example: free or promotional units).",
"items": {
"type": "string"
},
"type": "array"
},
"unitInvoice": {
"$ref": "UnitInvoice",
"description": "[required] Invoice details for a single unit."
}
},
"type": "object"
},
"ShipmentTrackingInfo": {
"id": "ShipmentTrackingInfo",
"properties": {
"carrier": {
"description": "The shipping carrier that handles the package.",
"type": "string"
},
"trackingNumber": {
"description": "The tracking number for the package.",
"type": "string"
}
},
"type": "object"
},
"ShippingSettings": {
"description": "The merchant account's shipping settings. All methods except getsupportedcarriers and getsupportedholidays require the admin role.",
"id": "ShippingSettings",
"properties": {
"accountId": {
"description": "The ID of the account to which these account shipping settings belong. Ignored upon update, always present in get request responses.",
"format": "uint64",
"type": "string"
},
"postalCodeGroups": {
"description": "A list of postal code groups that can be referred to in services. Optional.",
"items": {
"$ref": "PostalCodeGroup"
},
"type": "array"
},
"services": {
"description": "The target account's list of services. Optional.",
"items": {
"$ref": "Service"
},
"type": "array"
}
},
"type": "object"
},
"ShippingsettingsCustomBatchRequest": {
"id": "ShippingsettingsCustomBatchRequest",
"properties": {
"entries": {
"description": "The request entries to be processed in the batch.",
"items": {
"$ref": "ShippingsettingsCustomBatchRequestEntry"
},
"type": "array"
}
},
"type": "object"
},
"ShippingsettingsCustomBatchRequestEntry": {
"description": "A batch entry encoding a single non-batch shippingsettings request.",
"id": "ShippingsettingsCustomBatchRequestEntry",
"properties": {
"accountId": {
"description": "The ID of the account for which to get/update account shipping settings.",
"format": "uint64",
"type": "string"
},
"batchId": {
"description": "An entry ID, unique within the batch request.",
"format": "uint32",
"type": "integer"
},
"merchantId": {
"description": "The ID of the managing account.",
"format": "uint64",
"type": "string"
},
"method": {
"type": "string"
},
"shippingSettings": {
"$ref": "ShippingSettings",
"description": "The account shipping settings to update. Only defined if the method is update."
}
},
"type": "object"
},
"ShippingsettingsCustomBatchResponse": {
"id": "ShippingsettingsCustomBatchResponse",
"properties": {
"entries": {
"description": "The result of the execution of the batch requests.",
"items": {
"$ref": "ShippingsettingsCustomBatchResponseEntry"
},
"type": "array"
},
"kind": {
"default": "content#shippingsettingsCustomBatchResponse",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#shippingsettingsCustomBatchResponse\".",
"type": "string"
}
},
"type": "object"
},
"ShippingsettingsCustomBatchResponseEntry": {
"description": "A batch entry encoding a single non-batch shipping settings response.",
"id": "ShippingsettingsCustomBatchResponseEntry",
"properties": {
"batchId": {
"description": "The ID of the request entry to which this entry responds.",
"format": "uint32",
"type": "integer"
},
"errors": {
"$ref": "Errors",
"description": "A list of errors defined if, and only if, the request failed."
},
"kind": {
"default": "content#shippingsettingsCustomBatchResponseEntry",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#shippingsettingsCustomBatchResponseEntry\".",
"type": "string"
},
"shippingSettings": {
"$ref": "ShippingSettings",
"description": "The retrieved or updated account shipping settings."
}
},
"type": "object"
},
"ShippingsettingsGetSupportedCarriersResponse": {
"id": "ShippingsettingsGetSupportedCarriersResponse",
"properties": {
"carriers": {
"description": "A list of supported carriers. May be empty.",
"items": {
"$ref": "CarriersCarrier"
},
"type": "array"
},
"kind": {
"default": "content#shippingsettingsGetSupportedCarriersResponse",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#shippingsettingsGetSupportedCarriersResponse\".",
"type": "string"
}
},
"type": "object"
},
"ShippingsettingsGetSupportedHolidaysResponse": {
"id": "ShippingsettingsGetSupportedHolidaysResponse",
"properties": {
"holidays": {
"description": "A list of holidays applicable for delivery guarantees. May be empty.",
"items": {
"$ref": "HolidaysHoliday"
},
"type": "array"
},
"kind": {
"default": "content#shippingsettingsGetSupportedHolidaysResponse",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#shippingsettingsGetSupportedHolidaysResponse\".",
"type": "string"
}
},
"type": "object"
},
"ShippingsettingsGetSupportedPickupServicesResponse": {
"id": "ShippingsettingsGetSupportedPickupServicesResponse",
"properties": {
"kind": {
"default": "content#shippingsettingsGetSupportedPickupServicesResponse",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#shippingsettingsGetSupportedPickupServicesResponse\".",
"type": "string"
},
"pickupServices": {
"description": "A list of supported pickup services. May be empty.",
"items": {
"$ref": "PickupServicesPickupService"
},
"type": "array"
}
},
"type": "object"
},
"ShippingsettingsListResponse": {
"id": "ShippingsettingsListResponse",
"properties": {
"kind": {
"default": "content#shippingsettingsListResponse",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#shippingsettingsListResponse\".",
"type": "string"
},
"nextPageToken": {
"description": "The token for the retrieval of the next page of shipping settings.",
"type": "string"
},
"resources": {
"items": {
"$ref": "ShippingSettings"
},
"type": "array"
}
},
"type": "object"
},
"Table": {
"id": "Table",
"properties": {
"columnHeaders": {
"$ref": "Headers",
"description": "Headers of the table's columns. Optional: if not set then the table has only one dimension."
},
"name": {
"description": "Name of the table. Required for subtables, ignored for the main table.",
"type": "string"
},
"rowHeaders": {
"$ref": "Headers",
"description": "Headers of the table's rows. Required."
},
"rows": {
"description": "The list of rows that constitute the table. Must have the same length as rowHeaders. Required.",
"items": {
"$ref": "Row"
},
"type": "array"
}
},
"type": "object"
},
"TestOrder": {
"id": "TestOrder",
"properties": {
"enableOrderinvoices": {
"description": "Whether the orderinvoices service should support this order.",
"type": "boolean"
},
"kind": {
"default": "content#testOrder",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#testOrder\".",
"type": "string"
},
"lineItems": {
"annotations": {
"required": [
"content.orders.createtestorder"
]
},
"description": "Line items that are ordered. At least one line item must be provided.",
"items": {
"$ref": "TestOrderLineItem"
},
"type": "array"
},
"notificationMode": {
"description": "Determines if test order must be pulled by merchant or pushed to merchant via push integration.",
"type": "string"
},
"predefinedBillingAddress": {
"annotations": {
"required": [
"content.orders.createtestorder"
]
},
"description": "The billing address.",
"type": "string"
},
"predefinedDeliveryAddress": {
"annotations": {
"required": [
"content.orders.createtestorder"
]
},
"description": "Identifier of one of the predefined delivery addresses for the delivery.",
"type": "string"
},
"predefinedEmail": {
"annotations": {
"required": [
"content.orders.createtestorder"
]
},
"description": "Email address of the customer.",
"type": "string"
},
"predefinedPickupDetails": {
"description": "Identifier of one of the predefined pickup details. Required for orders containing line items with shipping type pickup.",
"type": "string"
},
"promotions": {
"description": "Promotions associated with the order.",
"items": {
"$ref": "OrderPromotion"
},
"type": "array"
},
"shippingCost": {
"$ref": "Price",
"annotations": {
"required": [
"content.orders.createtestorder"
]
},
"description": "The price of shipping for all items. Shipping tax is automatically calculated for orders where marketplace facilitator tax laws are applicable. Otherwise, tax settings from Merchant Center are applied. Note that shipping is not taxed in certain states."
},
"shippingOption": {
"annotations": {
"required": [
"content.orders.createtestorder"
]
},
"description": "The requested shipping option.",
"type": "string"
}
},
"type": "object"
},
"TestOrderLineItem": {
"id": "TestOrderLineItem",
"properties": {
"product": {
"$ref": "TestOrderLineItemProduct",
"description": "Product data from the time of the order placement."
},
"quantityOrdered": {
"annotations": {
"required": [
"content.orders.createtestorder"
]
},
"description": "Number of items ordered.",
"format": "uint32",
"type": "integer"
},
"returnInfo": {
"$ref": "OrderLineItemReturnInfo",
"annotations": {
"required": [
"content.orders.createtestorder"
]
},
"description": "Details of the return policy for the line item."
},
"shippingDetails": {
"$ref": "OrderLineItemShippingDetails",
"annotations": {
"required": [
"content.orders.createtestorder"
]
},
"description": "Details of the requested shipping for the line item."
}
},
"type": "object"
},
"TestOrderLineItemProduct": {
"id": "TestOrderLineItemProduct",
"properties": {
"brand": {
"annotations": {
"required": [
"content.orders.createtestorder"
]
},
"description": "Brand of the item.",
"type": "string"
},
"condition": {
"annotations": {
"required": [
"content.orders.createtestorder"
]
},
"description": "Condition or state of the item.",
"type": "string"
},
"contentLanguage": {
"annotations": {
"required": [
"content.orders.createtestorder"
]
},
"description": "The two-letter ISO 639-1 language code for the item.",
"type": "string"
},
"fees": {
"description": "Fees for the item. Optional.",
"items": {
"$ref": "OrderLineItemProductFee"
},
"type": "array"
},
"gtin": {
"description": "Global Trade Item Number (GTIN) of the item. Optional.",
"type": "string"
},
"imageLink": {
"annotations": {
"required": [
"content.orders.createtestorder"
]
},
"description": "URL of an image of the item.",
"type": "string"
},
"itemGroupId": {
"description": "Shared identifier for all variants of the same product. Optional.",
"type": "string"
},
"mpn": {
"description": "Manufacturer Part Number (MPN) of the item. Optional.",
"type": "string"
},
"offerId": {
"annotations": {
"required": [
"content.orders.createtestorder"
]
},
"description": "An identifier of the item.",
"type": "string"
},
"price": {
"$ref": "Price",
"annotations": {
"required": [
"content.orders.createtestorder"
]
},
"description": "The price for the product. Tax is automatically calculated for orders where marketplace facilitator tax laws are applicable. Otherwise, tax settings from Merchant Center are applied."
},
"targetCountry": {
"annotations": {
"required": [
"content.orders.createtestorder"
]
},
"description": "The CLDR territory code of the target country of the product.",
"type": "string"
},
"title": {
"annotations": {
"required": [
"content.orders.createtestorder"
]
},
"description": "The title of the product.",
"type": "string"
},
"variantAttributes": {
"description": "Variant attributes for the item. Optional.",
"items": {
"$ref": "OrderLineItemProductVariantAttribute"
},
"type": "array"
}
},
"type": "object"
},
"TransitTable": {
"id": "TransitTable",
"properties": {
"postalCodeGroupNames": {
"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.",
"items": {
"type": "string"
},
"type": "array"
},
"rows": {
"items": {
"$ref": "TransitTableTransitTimeRow"
},
"type": "array"
},
"transitTimeLabels": {
"description": "A list of transit time labels. The last value can be \"all other labels\". Example: [\"food\", \"electronics\", \"all other labels\"].",
"items": {
"type": "string"
},
"type": "array"
}
},
"type": "object"
},
"TransitTableTransitTimeRow": {
"id": "TransitTableTransitTimeRow",
"properties": {
"values": {
"items": {
"$ref": "TransitTableTransitTimeRowTransitTimeValue"
},
"type": "array"
}
},
"type": "object"
},
"TransitTableTransitTimeRowTransitTimeValue": {
"id": "TransitTableTransitTimeRowTransitTimeValue",
"properties": {
"maxTransitTimeInDays": {
"description": "Must be greater than or equal to minTransitTimeInDays.",
"format": "uint32",
"type": "integer"
},
"minTransitTimeInDays": {
"description": "Transit time range (min-max) in business days. 0 means same day delivery, 1 means next day delivery.",
"format": "uint32",
"type": "integer"
}
},
"type": "object"
},
"UnitInvoice": {
"id": "UnitInvoice",
"properties": {
"additionalCharges": {
"description": "Additional charges for a unit, e.g. shipping costs.",
"items": {
"$ref": "UnitInvoiceAdditionalCharge"
},
"type": "array"
},
"unitPrice": {
"$ref": "Price",
"description": "[required] Pre-tax or post-tax price of the unit depending on the locality of the order."
},
"unitPriceTaxes": {
"description": "Tax amounts to apply to the unit price.",
"items": {
"$ref": "UnitInvoiceTaxLine"
},
"type": "array"
}
},
"type": "object"
},
"UnitInvoiceAdditionalCharge": {
"id": "UnitInvoiceAdditionalCharge",
"properties": {
"additionalChargeAmount": {
"$ref": "Amount",
"description": "[required] Amount of the additional charge."
},
"type": {
"description": "[required] Type of the additional charge.",
"type": "string"
}
},
"type": "object"
},
"UnitInvoiceTaxLine": {
"id": "UnitInvoiceTaxLine",
"properties": {
"taxAmount": {
"$ref": "Price",
"description": "[required] Tax amount for the tax type."
},
"taxName": {
"description": "Optional name of the tax type. This should only be provided if taxType is otherFeeTax.",
"type": "string"
},
"taxType": {
"description": "[required] Type of the tax.",
"type": "string"
}
},
"type": "object"
},
"Value": {
"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.",
"id": "Value",
"properties": {
"carrierRateName": {
"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.",
"type": "string"
},
"flatRate": {
"$ref": "Price",
"description": "A flat rate. Can only be set if all other fields are not set."
},
"noShipping": {
"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.",
"type": "boolean"
},
"pricePercentage": {
"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.",
"type": "string"
},
"subtableName": {
"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.",
"type": "string"
}
},
"type": "object"
},
"Weight": {
"id": "Weight",
"properties": {
"unit": {
"description": "The weight unit.",
"type": "string"
},
"value": {
"description": "The weight represented as a number.",
"type": "string"
}
},
"type": "object"
}
},
"servicePath": "content/v2.1/",
"title": "Content API for Shopping",
"version": "v2.1"
}