{ "resources": { "accounts": { "methods": { "authinfo": { "id": "content.accounts.authinfo", "path": "accounts/authinfo", "flatPath": "accounts/authinfo", "httpMethod": "GET", "parameters": {}, "parameterOrder": [], "response": { "$ref": "AccountsAuthInfoResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Returns information about the authenticated user." }, "claimwebsite": { "id": "content.accounts.claimwebsite", "path": "{merchantId}/accounts/{accountId}/claimwebsite", "flatPath": "{merchantId}/accounts/{accountId}/claimwebsite", "httpMethod": "POST", "parameters": { "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.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "accountId": { "description": "The ID of the account whose website is claimed.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "overwrite": { "description": "Only available to selected merchants, for example multi-client accounts (MCAs) and their sub-accounts. When set to `True`, this option removes any existing claim on the requested website and replaces it with a claim from the account that makes the request.", "location": "query", "type": "boolean" } }, "parameterOrder": [ "merchantId", "accountId" ], "response": { "$ref": "AccountsClaimWebsiteResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Claims the website of a Merchant Center sub-account. Merchant accounts with approved third-party CSSs aren't required to claim a website." }, "custombatch": { "id": "content.accounts.custombatch", "path": "accounts/batch", "flatPath": "accounts/batch", "httpMethod": "POST", "parameters": {}, "parameterOrder": [], "request": { "$ref": "AccountsCustomBatchRequest" }, "response": { "$ref": "AccountsCustomBatchResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Retrieves, inserts, updates, and deletes multiple Merchant Center (sub-)accounts in a single request." }, "delete": { "id": "content.accounts.delete", "path": "{merchantId}/accounts/{accountId}", "flatPath": "{merchantId}/accounts/{accountId}", "httpMethod": "DELETE", "parameters": { "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.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "accountId": { "description": "The ID of the account.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "force": { "description": "Option to delete sub-accounts with products. The default value is false.", "default": "false", "location": "query", "type": "boolean" } }, "parameterOrder": [ "merchantId", "accountId" ], "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Deletes a Merchant Center sub-account." }, "get": { "id": "content.accounts.get", "path": "{merchantId}/accounts/{accountId}", "flatPath": "{merchantId}/accounts/{accountId}", "httpMethod": "GET", "parameters": { "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.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "accountId": { "description": "The ID of the account.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "view": { "description": "Controls which fields will be populated. Acceptable values are: \"merchant\" and \"css\". The default value is \"merchant\".", "location": "query", "type": "string", "enumDescriptions": [ "Default. View is populated with Merchant Center fields.", "View is populated with Comparison Shopping Services fields." ], "enum": [ "MERCHANT", "CSS" ] } }, "parameterOrder": [ "merchantId", "accountId" ], "response": { "$ref": "Account" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Retrieves a Merchant Center account." }, "insert": { "id": "content.accounts.insert", "path": "{merchantId}/accounts", "flatPath": "{merchantId}/accounts", "httpMethod": "POST", "parameters": { "merchantId": { "description": "The ID of the managing account. This must be a multi-client account.", "location": "path", "required": true, "type": "string", "format": "uint64" } }, "parameterOrder": [ "merchantId" ], "request": { "$ref": "Account" }, "response": { "$ref": "Account" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Creates a Merchant Center sub-account." }, "link": { "id": "content.accounts.link", "path": "{merchantId}/accounts/{accountId}/link", "flatPath": "{merchantId}/accounts/{accountId}/link", "httpMethod": "POST", "parameters": { "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.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "accountId": { "description": "The ID of the account that should be linked.", "location": "path", "required": true, "type": "string", "format": "uint64" } }, "parameterOrder": [ "merchantId", "accountId" ], "request": { "$ref": "AccountsLinkRequest" }, "response": { "$ref": "AccountsLinkResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Performs an action on a link between two Merchant Center accounts, namely accountId and linkedAccountId." }, "list": { "id": "content.accounts.list", "path": "{merchantId}/accounts", "flatPath": "{merchantId}/accounts", "httpMethod": "GET", "parameters": { "merchantId": { "description": "The ID of the managing account. This must be a multi-client account.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "maxResults": { "description": "The maximum number of accounts to return in the response, used for paging.", "location": "query", "type": "integer", "format": "uint32" }, "pageToken": { "description": "The token returned by the previous request.", "location": "query", "type": "string" }, "view": { "description": "Controls which fields will be populated. Acceptable values are: \"merchant\" and \"css\". The default value is \"merchant\".", "location": "query", "type": "string", "enumDescriptions": [ "Default. View is populated with Merchant Center fields.", "View is populated with Comparison Shopping Services fields." ], "enum": [ "MERCHANT", "CSS" ] }, "label": { "description": "If view is set to \"css\", only return accounts that are assigned label with given ID.", "location": "query", "type": "string", "format": "uint64" }, "name": { "description": "If set, only the accounts with the given name (case sensitive) will be returned.", "location": "query", "type": "string" } }, "parameterOrder": [ "merchantId" ], "response": { "$ref": "AccountsListResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Lists the sub-accounts in your Merchant Center account." }, "listlinks": { "id": "content.accounts.listlinks", "path": "{merchantId}/accounts/{accountId}/listlinks", "flatPath": "{merchantId}/accounts/{accountId}/listlinks", "httpMethod": "GET", "parameters": { "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.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "accountId": { "description": "The ID of the account for which to list links.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "maxResults": { "description": "The maximum number of links to return in the response, used for pagination. The minimum allowed value is 5 results per page. If provided value is lower than 5, it will be automatically increased to 5.", "location": "query", "type": "integer", "format": "uint32" }, "pageToken": { "description": "The token returned by the previous request.", "location": "query", "type": "string" } }, "parameterOrder": [ "merchantId", "accountId" ], "response": { "$ref": "AccountsListLinksResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Returns the list of accounts linked to your Merchant Center account." }, "update": { "id": "content.accounts.update", "path": "{merchantId}/accounts/{accountId}", "flatPath": "{merchantId}/accounts/{accountId}", "httpMethod": "PUT", "parameters": { "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.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "accountId": { "description": "The ID of the account.", "location": "path", "required": true, "type": "string", "format": "uint64" } }, "parameterOrder": [ "merchantId", "accountId" ], "request": { "$ref": "Account" }, "response": { "$ref": "Account" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Updates a Merchant Center account. Any fields that are not provided are deleted from the resource." }, "updatelabels": { "id": "content.accounts.updatelabels", "path": "{merchantId}/accounts/{accountId}/updatelabels", "flatPath": "{merchantId}/accounts/{accountId}/updatelabels", "httpMethod": "POST", "parameters": { "merchantId": { "description": "The ID of the managing account.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "accountId": { "description": "The ID of the account whose labels are updated.", "location": "path", "required": true, "type": "string", "format": "uint64" } }, "parameterOrder": [ "merchantId", "accountId" ], "request": { "$ref": "AccountsUpdateLabelsRequest" }, "response": { "$ref": "AccountsUpdateLabelsResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Updates labels that are assigned to the Merchant Center account by CSS user." }, "requestphoneverification": { "id": "content.accounts.requestphoneverification", "path": "{merchantId}/accounts/{accountId}/requestphoneverification", "flatPath": "{merchantId}/accounts/{accountId}/requestphoneverification", "httpMethod": "POST", "parameters": { "merchantId": { "description": "Required. 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.", "location": "path", "required": true, "type": "string", "format": "int64" }, "accountId": { "description": "Required. The ID of the account.", "location": "path", "required": true, "type": "string", "format": "int64" } }, "parameterOrder": [ "merchantId", "accountId" ], "request": { "$ref": "RequestPhoneVerificationRequest" }, "response": { "$ref": "RequestPhoneVerificationResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Request verification code to start phone verification." }, "verifyphonenumber": { "id": "content.accounts.verifyphonenumber", "path": "{merchantId}/accounts/{accountId}/verifyphonenumber", "flatPath": "{merchantId}/accounts/{accountId}/verifyphonenumber", "httpMethod": "POST", "parameters": { "merchantId": { "description": "Required. 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.", "location": "path", "required": true, "type": "string", "format": "int64" }, "accountId": { "description": "Required. The ID of the account.", "location": "path", "required": true, "type": "string", "format": "int64" } }, "parameterOrder": [ "merchantId", "accountId" ], "request": { "$ref": "VerifyPhoneNumberRequest" }, "response": { "$ref": "VerifyPhoneNumberResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Validates verification code to verify phone number for the account. If successful this will overwrite the value of `accounts.businessinformation.phoneNumber`. Only verified phone number will replace an existing verified phone number." } }, "resources": { "credentials": { "methods": { "create": { "id": "content.accounts.credentials.create", "path": "accounts/{accountId}/credentials", "flatPath": "accounts/{accountId}/credentials", "httpMethod": "POST", "parameters": { "accountId": { "description": "Required. The merchant id of the account these credentials belong to.", "location": "path", "required": true, "type": "string", "format": "int64" } }, "parameterOrder": [ "accountId" ], "request": { "$ref": "AccountCredentials" }, "response": { "$ref": "AccountCredentials" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Uploads credentials for the Merchant Center account. If credentials already exist for this Merchant Center account and purpose, this method updates them." } } }, "labels": { "methods": { "list": { "id": "content.accounts.labels.list", "path": "accounts/{accountId}/labels", "flatPath": "accounts/{accountId}/labels", "httpMethod": "GET", "parameters": { "accountId": { "description": "Required. The account id for whose labels are to be listed.", "location": "path", "required": true, "type": "string", "format": "int64" }, "pageSize": { "description": "The maximum number of labels to return. The service may return fewer than this value. If unspecified, at most 50 labels will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.", "location": "query", "type": "integer", "format": "int32" }, "pageToken": { "description": "A page token, received from a previous `ListAccountLabels` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListAccountLabels` must match the call that provided the page token.", "location": "query", "type": "string" } }, "parameterOrder": [ "accountId" ], "response": { "$ref": "ListAccountLabelsResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Lists the labels assigned to an account." }, "create": { "id": "content.accounts.labels.create", "path": "accounts/{accountId}/labels", "flatPath": "accounts/{accountId}/labels", "httpMethod": "POST", "parameters": { "accountId": { "description": "Required. The id of the account this label belongs to.", "location": "path", "required": true, "type": "string", "format": "int64" } }, "parameterOrder": [ "accountId" ], "request": { "$ref": "AccountLabel" }, "response": { "$ref": "AccountLabel" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Creates a new label, not assigned to any account." }, "patch": { "id": "content.accounts.labels.patch", "path": "accounts/{accountId}/labels/{labelId}", "flatPath": "accounts/{accountId}/labels/{labelId}", "httpMethod": "PATCH", "parameters": { "accountId": { "description": "Required. The id of the account this label belongs to.", "location": "path", "required": true, "type": "string", "format": "int64" }, "labelId": { "description": "Required. The id of the label to update.", "location": "path", "required": true, "type": "string", "format": "int64" } }, "parameterOrder": [ "accountId", "labelId" ], "request": { "$ref": "AccountLabel" }, "response": { "$ref": "AccountLabel" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Updates a label." }, "delete": { "id": "content.accounts.labels.delete", "path": "accounts/{accountId}/labels/{labelId}", "flatPath": "accounts/{accountId}/labels/{labelId}", "httpMethod": "DELETE", "parameters": { "accountId": { "description": "Required. The id of the account that owns the label.", "location": "path", "required": true, "type": "string", "format": "int64" }, "labelId": { "description": "Required. The id of the label to delete.", "location": "path", "required": true, "type": "string", "format": "int64" } }, "parameterOrder": [ "accountId", "labelId" ], "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Deletes a label and removes it from all accounts to which it was assigned." } } }, "returncarrier": { "methods": { "create": { "id": "content.accounts.returncarrier.create", "path": "accounts/{accountId}/returncarrier", "flatPath": "accounts/{accountId}/returncarrier", "httpMethod": "POST", "parameters": { "accountId": { "description": "Required. The Merchant Center Account Id under which the Return Carrier is to be linked.", "location": "path", "required": true, "type": "string", "format": "int64" } }, "parameterOrder": [ "accountId" ], "request": { "$ref": "AccountReturnCarrier" }, "response": { "$ref": "AccountReturnCarrier" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Links return carrier to a merchant account." }, "patch": { "id": "content.accounts.returncarrier.patch", "path": "accounts/{accountId}/returncarrier/{carrierAccountId}", "flatPath": "accounts/{accountId}/returncarrier/{carrierAccountId}", "httpMethod": "PATCH", "parameters": { "accountId": { "description": "Required. The Merchant Center Account Id under which the Return Carrier is to be linked.", "location": "path", "required": true, "type": "string", "format": "int64" }, "carrierAccountId": { "description": "Required. The Google-provided unique carrier ID, used to update the resource.", "location": "path", "required": true, "type": "string", "format": "int64" } }, "parameterOrder": [ "accountId", "carrierAccountId" ], "request": { "$ref": "AccountReturnCarrier" }, "response": { "$ref": "AccountReturnCarrier" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Updates a return carrier in the merchant account." }, "delete": { "id": "content.accounts.returncarrier.delete", "path": "accounts/{accountId}/returncarrier/{carrierAccountId}", "flatPath": "accounts/{accountId}/returncarrier/{carrierAccountId}", "httpMethod": "DELETE", "parameters": { "accountId": { "description": "Required. The Merchant Center Account Id under which the Return Carrier is to be linked.", "location": "path", "required": true, "type": "string", "format": "int64" }, "carrierAccountId": { "description": "Required. The Google-provided unique carrier ID, used to update the resource.", "location": "path", "required": true, "type": "string", "format": "int64" } }, "parameterOrder": [ "accountId", "carrierAccountId" ], "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Delete a return carrier in the merchant account." }, "list": { "id": "content.accounts.returncarrier.list", "path": "accounts/{accountId}/returncarrier", "flatPath": "accounts/{accountId}/returncarrier", "httpMethod": "GET", "parameters": { "accountId": { "description": "Required. The Merchant Center Account Id under which the Return Carrier is to be linked.", "location": "path", "required": true, "type": "string", "format": "int64" } }, "parameterOrder": [ "accountId" ], "response": { "$ref": "ListAccountReturnCarrierResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Lists available return carriers in the merchant account." } } } } }, "accountstatuses": { "methods": { "custombatch": { "id": "content.accountstatuses.custombatch", "path": "accountstatuses/batch", "flatPath": "accountstatuses/batch", "httpMethod": "POST", "parameters": {}, "parameterOrder": [], "request": { "$ref": "AccountstatusesCustomBatchRequest" }, "response": { "$ref": "AccountstatusesCustomBatchResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Retrieves multiple Merchant Center account statuses in a single request." }, "get": { "id": "content.accountstatuses.get", "path": "{merchantId}/accountstatuses/{accountId}", "flatPath": "{merchantId}/accountstatuses/{accountId}", "httpMethod": "GET", "parameters": { "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.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "accountId": { "description": "The ID of the account.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "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" } }, "parameterOrder": [ "merchantId", "accountId" ], "response": { "$ref": "AccountStatus" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Retrieves the status of a Merchant Center account. No itemLevelIssues are returned for multi-client accounts." }, "list": { "id": "content.accountstatuses.list", "path": "{merchantId}/accountstatuses", "flatPath": "{merchantId}/accountstatuses", "httpMethod": "GET", "parameters": { "merchantId": { "description": "The ID of the managing account. This must be a multi-client account.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "maxResults": { "description": "The maximum number of account statuses to return in the response, used for paging.", "location": "query", "type": "integer", "format": "uint32" }, "pageToken": { "description": "The token returned by the previous request.", "location": "query", "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" }, "name": { "description": "If set, only the accounts with the given name (case sensitive) will be returned.", "location": "query", "type": "string" } }, "parameterOrder": [ "merchantId" ], "response": { "$ref": "AccountstatusesListResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Lists the statuses of the sub-accounts in your Merchant Center account." } } }, "accounttax": { "methods": { "custombatch": { "id": "content.accounttax.custombatch", "path": "accounttax/batch", "flatPath": "accounttax/batch", "httpMethod": "POST", "parameters": {}, "parameterOrder": [], "request": { "$ref": "AccounttaxCustomBatchRequest" }, "response": { "$ref": "AccounttaxCustomBatchResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Retrieves and updates tax settings of multiple accounts in a single request." }, "get": { "id": "content.accounttax.get", "path": "{merchantId}/accounttax/{accountId}", "flatPath": "{merchantId}/accounttax/{accountId}", "httpMethod": "GET", "parameters": { "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.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "accountId": { "description": "The ID of the account for which to get/update account tax settings.", "location": "path", "required": true, "type": "string", "format": "uint64" } }, "parameterOrder": [ "merchantId", "accountId" ], "response": { "$ref": "AccountTax" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Retrieves the tax settings of the account." }, "list": { "id": "content.accounttax.list", "path": "{merchantId}/accounttax", "flatPath": "{merchantId}/accounttax", "httpMethod": "GET", "parameters": { "merchantId": { "description": "The ID of the managing account. This must be a multi-client account.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "maxResults": { "description": "The maximum number of tax settings to return in the response, used for paging.", "location": "query", "type": "integer", "format": "uint32" }, "pageToken": { "description": "The token returned by the previous request.", "location": "query", "type": "string" } }, "parameterOrder": [ "merchantId" ], "response": { "$ref": "AccounttaxListResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Lists the tax settings of the sub-accounts in your Merchant Center account." }, "update": { "id": "content.accounttax.update", "path": "{merchantId}/accounttax/{accountId}", "flatPath": "{merchantId}/accounttax/{accountId}", "httpMethod": "PUT", "parameters": { "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.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "accountId": { "description": "The ID of the account for which to get/update account tax settings.", "location": "path", "required": true, "type": "string", "format": "uint64" } }, "parameterOrder": [ "merchantId", "accountId" ], "request": { "$ref": "AccountTax" }, "response": { "$ref": "AccountTax" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Updates the tax settings of the account. Any fields that are not provided are deleted from the resource." } } }, "datafeeds": { "methods": { "custombatch": { "id": "content.datafeeds.custombatch", "path": "datafeeds/batch", "flatPath": "datafeeds/batch", "httpMethod": "POST", "parameters": {}, "parameterOrder": [], "request": { "$ref": "DatafeedsCustomBatchRequest" }, "response": { "$ref": "DatafeedsCustomBatchResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Deletes, fetches, gets, inserts and updates multiple datafeeds in a single request." }, "delete": { "id": "content.datafeeds.delete", "path": "{merchantId}/datafeeds/{datafeedId}", "flatPath": "{merchantId}/datafeeds/{datafeedId}", "httpMethod": "DELETE", "parameters": { "merchantId": { "description": "The ID of the account that manages the datafeed. This account cannot be a multi-client account.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "datafeedId": { "description": "The ID of the datafeed.", "location": "path", "required": true, "type": "string", "format": "uint64" } }, "parameterOrder": [ "merchantId", "datafeedId" ], "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Deletes a datafeed configuration from your Merchant Center account." }, "fetchnow": { "id": "content.datafeeds.fetchnow", "path": "{merchantId}/datafeeds/{datafeedId}/fetchNow", "flatPath": "{merchantId}/datafeeds/{datafeedId}/fetchNow", "httpMethod": "POST", "parameters": { "merchantId": { "description": "The ID of the account that manages the datafeed. This account cannot be a multi-client account.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "datafeedId": { "description": "The ID of the datafeed to be fetched.", "location": "path", "required": true, "type": "string", "format": "uint64" } }, "parameterOrder": [ "merchantId", "datafeedId" ], "response": { "$ref": "DatafeedsFetchNowResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Invokes a fetch for the datafeed in your Merchant Center account. If you need to call this method more than once per day, we recommend you use the [Products service](https://developers.google.com/shopping-content/reference/rest/v2.1/products) to update your product data." }, "get": { "id": "content.datafeeds.get", "path": "{merchantId}/datafeeds/{datafeedId}", "flatPath": "{merchantId}/datafeeds/{datafeedId}", "httpMethod": "GET", "parameters": { "merchantId": { "description": "The ID of the account that manages the datafeed. This account cannot be a multi-client account.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "datafeedId": { "description": "The ID of the datafeed.", "location": "path", "required": true, "type": "string", "format": "uint64" } }, "parameterOrder": [ "merchantId", "datafeedId" ], "response": { "$ref": "Datafeed" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Retrieves a datafeed configuration from your Merchant Center account." }, "insert": { "id": "content.datafeeds.insert", "path": "{merchantId}/datafeeds", "flatPath": "{merchantId}/datafeeds", "httpMethod": "POST", "parameters": { "merchantId": { "description": "The ID of the account that manages the datafeed. This account cannot be a multi-client account.", "location": "path", "required": true, "type": "string", "format": "uint64" } }, "parameterOrder": [ "merchantId" ], "request": { "$ref": "Datafeed" }, "response": { "$ref": "Datafeed" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Registers a datafeed configuration with your Merchant Center account." }, "list": { "id": "content.datafeeds.list", "path": "{merchantId}/datafeeds", "flatPath": "{merchantId}/datafeeds", "httpMethod": "GET", "parameters": { "merchantId": { "description": "The ID of the account that manages the datafeeds. This account cannot be a multi-client account.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "maxResults": { "description": "The maximum number of products to return in the response, used for paging.", "location": "query", "type": "integer", "format": "uint32" }, "pageToken": { "description": "The token returned by the previous request.", "location": "query", "type": "string" } }, "parameterOrder": [ "merchantId" ], "response": { "$ref": "DatafeedsListResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Lists the configurations for datafeeds in your Merchant Center account." }, "update": { "id": "content.datafeeds.update", "path": "{merchantId}/datafeeds/{datafeedId}", "flatPath": "{merchantId}/datafeeds/{datafeedId}", "httpMethod": "PUT", "parameters": { "merchantId": { "description": "The ID of the account that manages the datafeed. This account cannot be a multi-client account.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "datafeedId": { "description": "The ID of the datafeed.", "location": "path", "required": true, "type": "string", "format": "uint64" } }, "parameterOrder": [ "merchantId", "datafeedId" ], "request": { "$ref": "Datafeed" }, "response": { "$ref": "Datafeed" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Updates a datafeed configuration of your Merchant Center account. Any fields that are not provided are deleted from the resource." } } }, "datafeedstatuses": { "methods": { "custombatch": { "id": "content.datafeedstatuses.custombatch", "path": "datafeedstatuses/batch", "flatPath": "datafeedstatuses/batch", "httpMethod": "POST", "parameters": {}, "parameterOrder": [], "request": { "$ref": "DatafeedstatusesCustomBatchRequest" }, "response": { "$ref": "DatafeedstatusesCustomBatchResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Gets multiple Merchant Center datafeed statuses in a single request." }, "get": { "id": "content.datafeedstatuses.get", "path": "{merchantId}/datafeedstatuses/{datafeedId}", "flatPath": "{merchantId}/datafeedstatuses/{datafeedId}", "httpMethod": "GET", "parameters": { "merchantId": { "description": "The ID of the account that manages the datafeed. This account cannot be a multi-client account.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "datafeedId": { "description": "The ID of the datafeed.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "country": { "description": "Deprecated. Use `feedLabel` instead. The country to get the datafeed status for. 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" }, "feedLabel": { "description": "The feed label to get the datafeed status for. 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" }, "language": { "description": "The language to get the datafeed status for. 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" } }, "parameterOrder": [ "merchantId", "datafeedId" ], "response": { "$ref": "DatafeedStatus" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Retrieves the status of a datafeed from your Merchant Center account." }, "list": { "id": "content.datafeedstatuses.list", "path": "{merchantId}/datafeedstatuses", "flatPath": "{merchantId}/datafeedstatuses", "httpMethod": "GET", "parameters": { "merchantId": { "description": "The ID of the account that manages the datafeeds. This account cannot be a multi-client account.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "maxResults": { "description": "The maximum number of products to return in the response, used for paging.", "location": "query", "type": "integer", "format": "uint32" }, "pageToken": { "description": "The token returned by the previous request.", "location": "query", "type": "string" } }, "parameterOrder": [ "merchantId" ], "response": { "$ref": "DatafeedstatusesListResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Lists the statuses of the datafeeds in your Merchant Center account." } } }, "liasettings": { "methods": { "custombatch": { "id": "content.liasettings.custombatch", "path": "liasettings/batch", "flatPath": "liasettings/batch", "httpMethod": "POST", "parameters": {}, "parameterOrder": [], "request": { "$ref": "LiasettingsCustomBatchRequest" }, "response": { "$ref": "LiasettingsCustomBatchResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Retrieves and/or updates the LIA settings of multiple accounts in a single request." }, "get": { "id": "content.liasettings.get", "path": "{merchantId}/liasettings/{accountId}", "flatPath": "{merchantId}/liasettings/{accountId}", "httpMethod": "GET", "parameters": { "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.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "accountId": { "description": "The ID of the account for which to get or update LIA settings.", "location": "path", "required": true, "type": "string", "format": "uint64" } }, "parameterOrder": [ "merchantId", "accountId" ], "response": { "$ref": "LiaSettings" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Retrieves the LIA settings of the account." }, "getaccessiblegmbaccounts": { "id": "content.liasettings.getaccessiblegmbaccounts", "path": "{merchantId}/liasettings/{accountId}/accessiblegmbaccounts", "flatPath": "{merchantId}/liasettings/{accountId}/accessiblegmbaccounts", "httpMethod": "GET", "parameters": { "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.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "accountId": { "description": "The ID of the account for which to retrieve accessible Business Profiles.", "location": "path", "required": true, "type": "string", "format": "uint64" } }, "parameterOrder": [ "merchantId", "accountId" ], "response": { "$ref": "LiasettingsGetAccessibleGmbAccountsResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Retrieves the list of accessible Business Profiles." }, "list": { "id": "content.liasettings.list", "path": "{merchantId}/liasettings", "flatPath": "{merchantId}/liasettings", "httpMethod": "GET", "parameters": { "merchantId": { "description": "The ID of the managing account. This must be a multi-client account.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "maxResults": { "description": "The maximum number of LIA settings to return in the response, used for paging.", "location": "query", "type": "integer", "format": "uint32" }, "pageToken": { "description": "The token returned by the previous request.", "location": "query", "type": "string" } }, "parameterOrder": [ "merchantId" ], "response": { "$ref": "LiasettingsListResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Lists the LIA settings of the sub-accounts in your Merchant Center account." }, "listposdataproviders": { "id": "content.liasettings.listposdataproviders", "path": "liasettings/posdataproviders", "flatPath": "liasettings/posdataproviders", "httpMethod": "GET", "parameters": {}, "parameterOrder": [], "response": { "$ref": "LiasettingsListPosDataProvidersResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Retrieves the list of POS data providers that have active settings for the all eiligible countries." }, "requestgmbaccess": { "id": "content.liasettings.requestgmbaccess", "path": "{merchantId}/liasettings/{accountId}/requestgmbaccess", "flatPath": "{merchantId}/liasettings/{accountId}/requestgmbaccess", "httpMethod": "POST", "parameters": { "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.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "accountId": { "description": "The ID of the account for which Business Profile access is requested.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "gmbEmail": { "description": "The email of the Business Profile.", "location": "query", "required": true, "type": "string" } }, "parameterOrder": [ "merchantId", "accountId", "gmbEmail" ], "response": { "$ref": "LiasettingsRequestGmbAccessResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Requests access to a specified Business Profile." }, "requestinventoryverification": { "id": "content.liasettings.requestinventoryverification", "path": "{merchantId}/liasettings/{accountId}/requestinventoryverification/{country}", "flatPath": "{merchantId}/liasettings/{accountId}/requestinventoryverification/{country}", "httpMethod": "POST", "parameters": { "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.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "accountId": { "description": "The ID of the account that manages the order. This cannot be a multi-client account.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "country": { "description": "The country for which inventory validation is requested.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "merchantId", "accountId", "country" ], "response": { "$ref": "LiasettingsRequestInventoryVerificationResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Requests inventory validation for the specified country." }, "setinventoryverificationcontact": { "id": "content.liasettings.setinventoryverificationcontact", "path": "{merchantId}/liasettings/{accountId}/setinventoryverificationcontact", "flatPath": "{merchantId}/liasettings/{accountId}/setinventoryverificationcontact", "httpMethod": "POST", "parameters": { "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.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "accountId": { "description": "The ID of the account that manages the order. This cannot be a multi-client account.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "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" }, "contactName": { "description": "The name of the inventory verification contact.", "location": "query", "required": true, "type": "string" }, "contactEmail": { "description": "The email of the inventory verification contact.", "location": "query", "required": true, "type": "string" } }, "parameterOrder": [ "merchantId", "accountId", "country", "language", "contactName", "contactEmail" ], "response": { "$ref": "LiasettingsSetInventoryVerificationContactResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Sets the inventory verification contract for the specified country." }, "setomnichannelexperience": { "id": "content.liasettings.setomnichannelexperience", "path": "{merchantId}/liasettings/{accountId}/setomnichannelexperience", "flatPath": "{merchantId}/liasettings/{accountId}/setomnichannelexperience", "httpMethod": "POST", "parameters": { "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.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "accountId": { "description": "The ID of the account for which to retrieve accessible Business Profiles.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "country": { "description": "The CLDR country code (for example, \"US\") for which the omnichannel experience is selected.", "location": "query", "type": "string" }, "lsfType": { "description": "The Local Store Front (LSF) type for this country. Acceptable values are: - \"`ghlsf`\" (Google-Hosted Local Store Front) - \"`mhlsfBasic`\" (Merchant-Hosted Local Store Front Basic) - \"`mhlsfFull`\" (Merchant-Hosted Local Store Front Full) More details about these types can be found here.", "location": "query", "type": "string" }, "pickupTypes": { "description": "The Pickup types for this country. Acceptable values are: - \"`pickupToday`\" - \"`pickupLater`\" ", "location": "query", "repeated": true, "type": "string" } }, "parameterOrder": [ "merchantId", "accountId" ], "response": { "$ref": "LiaOmnichannelExperience" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Sets the omnichannel experience for the specified country. Only supported for merchants whose POS data provider is trusted to enable the corresponding experience. For more context, see these help articles [about LFP](https://support.google.com/merchants/answer/7676652) and [how to get started](https://support.google.com/merchants/answer/7676578) with it." }, "setposdataprovider": { "id": "content.liasettings.setposdataprovider", "path": "{merchantId}/liasettings/{accountId}/setposdataprovider", "flatPath": "{merchantId}/liasettings/{accountId}/setposdataprovider", "httpMethod": "POST", "parameters": { "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.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "accountId": { "description": "The ID of the account for which to retrieve accessible Business Profiles.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "country": { "description": "The country for which the POS data provider is selected.", "location": "query", "required": true, "type": "string" }, "posDataProviderId": { "description": "The ID of POS data provider.", "location": "query", "type": "string", "format": "uint64" }, "posExternalAccountId": { "description": "The account ID by which this merchant is known to the POS data provider.", "location": "query", "type": "string" } }, "parameterOrder": [ "merchantId", "accountId", "country" ], "response": { "$ref": "LiasettingsSetPosDataProviderResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Sets the POS data provider for the specified country." }, "update": { "id": "content.liasettings.update", "path": "{merchantId}/liasettings/{accountId}", "flatPath": "{merchantId}/liasettings/{accountId}", "httpMethod": "PUT", "parameters": { "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.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "accountId": { "description": "The ID of the account for which to get or update LIA settings.", "location": "path", "required": true, "type": "string", "format": "uint64" } }, "parameterOrder": [ "merchantId", "accountId" ], "request": { "$ref": "LiaSettings" }, "response": { "$ref": "LiaSettings" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Updates the LIA settings of the account. Any fields that are not provided are deleted from the resource." } } }, "localinventory": { "methods": { "custombatch": { "id": "content.localinventory.custombatch", "path": "localinventory/batch", "flatPath": "localinventory/batch", "httpMethod": "POST", "parameters": {}, "parameterOrder": [], "request": { "$ref": "LocalinventoryCustomBatchRequest" }, "response": { "$ref": "LocalinventoryCustomBatchResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Updates local inventory for multiple products or stores in a single request." }, "insert": { "id": "content.localinventory.insert", "path": "{merchantId}/products/{productId}/localinventory", "flatPath": "{merchantId}/products/{productId}/localinventory", "httpMethod": "POST", "parameters": { "merchantId": { "description": "The ID of the account that contains the product. This account cannot be a multi-client account.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "productId": { "description": "The REST ID of the product for which to update local inventory.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "merchantId", "productId" ], "request": { "$ref": "LocalInventory" }, "response": { "$ref": "LocalInventory" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Updates the local inventory of a product in your Merchant Center account." } } }, "orderinvoices": { "methods": { "createchargeinvoice": { "id": "content.orderinvoices.createchargeinvoice", "path": "{merchantId}/orderinvoices/{orderId}/createChargeInvoice", "flatPath": "{merchantId}/orderinvoices/{orderId}/createChargeInvoice", "httpMethod": "POST", "parameters": { "merchantId": { "description": "The ID of the account that manages the order. This cannot be a multi-client account.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "orderId": { "description": "The ID of the order.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "merchantId", "orderId" ], "request": { "$ref": "OrderinvoicesCreateChargeInvoiceRequest" }, "response": { "$ref": "OrderinvoicesCreateChargeInvoiceResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Creates a charge invoice for a shipment group, and triggers a charge capture for orderinvoice enabled orders." }, "createrefundinvoice": { "id": "content.orderinvoices.createrefundinvoice", "path": "{merchantId}/orderinvoices/{orderId}/createRefundInvoice", "flatPath": "{merchantId}/orderinvoices/{orderId}/createRefundInvoice", "httpMethod": "POST", "parameters": { "merchantId": { "description": "The ID of the account that manages the order. This cannot be a multi-client account.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "orderId": { "description": "The ID of the order.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "merchantId", "orderId" ], "request": { "$ref": "OrderinvoicesCreateRefundInvoiceRequest" }, "response": { "$ref": "OrderinvoicesCreateRefundInvoiceResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "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." } } }, "orderreports": { "methods": { "listdisbursements": { "id": "content.orderreports.listdisbursements", "path": "{merchantId}/orderreports/disbursements", "flatPath": "{merchantId}/orderreports/disbursements", "httpMethod": "GET", "parameters": { "merchantId": { "description": "The ID of the account that manages the order. This cannot be a multi-client account.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "maxResults": { "description": "The maximum number of disbursements to return in the response, used for paging.", "location": "query", "type": "integer", "format": "uint32" }, "pageToken": { "description": "The token returned by the previous request.", "location": "query", "type": "string" }, "disbursementStartDate": { "description": "The first date which disbursements occurred. In ISO 8601 format.", "location": "query", "type": "string" }, "disbursementEndDate": { "description": "The last date which disbursements occurred. In ISO 8601 format. Default: current date.", "location": "query", "type": "string" } }, "parameterOrder": [ "merchantId" ], "response": { "$ref": "OrderreportsListDisbursementsResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Retrieves a report for disbursements from your Merchant Center account." }, "listtransactions": { "id": "content.orderreports.listtransactions", "path": "{merchantId}/orderreports/disbursements/{disbursementId}/transactions", "flatPath": "{merchantId}/orderreports/disbursements/{disbursementId}/transactions", "httpMethod": "GET", "parameters": { "merchantId": { "description": "The ID of the account that manages the order. This cannot be a multi-client account.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "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.", "location": "query", "type": "integer", "format": "uint32" }, "pageToken": { "description": "The token returned by the previous request.", "location": "query", "type": "string" }, "transactionStartDate": { "description": "The first date in which transaction occurred. In ISO 8601 format.", "location": "query", "type": "string" }, "transactionEndDate": { "description": "The last date in which transaction occurred. In ISO 8601 format. Default: current date.", "location": "query", "type": "string" } }, "parameterOrder": [ "merchantId", "disbursementId" ], "response": { "$ref": "OrderreportsListTransactionsResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Retrieves a list of transactions for a disbursement from your Merchant Center account." } } }, "orderreturns": { "methods": { "acknowledge": { "id": "content.orderreturns.acknowledge", "path": "{merchantId}/orderreturns/{returnId}/acknowledge", "flatPath": "{merchantId}/orderreturns/{returnId}/acknowledge", "httpMethod": "POST", "parameters": { "merchantId": { "description": "The ID of the account that manages the order. This cannot be a multi-client account.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "returnId": { "description": "The ID of the return.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "merchantId", "returnId" ], "request": { "$ref": "OrderreturnsAcknowledgeRequest" }, "response": { "$ref": "OrderreturnsAcknowledgeResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Acks an order return in your Merchant Center account." }, "createorderreturn": { "id": "content.orderreturns.createorderreturn", "path": "{merchantId}/orderreturns/createOrderReturn", "flatPath": "{merchantId}/orderreturns/createOrderReturn", "httpMethod": "POST", "parameters": { "merchantId": { "description": "The ID of the account that manages the order. This cannot be a multi-client account.", "location": "path", "required": true, "type": "string", "format": "uint64" } }, "parameterOrder": [ "merchantId" ], "request": { "$ref": "OrderreturnsCreateOrderReturnRequest" }, "response": { "$ref": "OrderreturnsCreateOrderReturnResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Create return in your Merchant Center account." }, "get": { "id": "content.orderreturns.get", "path": "{merchantId}/orderreturns/{returnId}", "flatPath": "{merchantId}/orderreturns/{returnId}", "httpMethod": "GET", "parameters": { "merchantId": { "description": "The ID of the account that manages the order. This cannot be a multi-client account.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "returnId": { "description": "Merchant order return ID generated by Google.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "merchantId", "returnId" ], "response": { "$ref": "MerchantOrderReturn" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Retrieves an order return from your Merchant Center account." }, "list": { "id": "content.orderreturns.list", "path": "{merchantId}/orderreturns", "flatPath": "{merchantId}/orderreturns", "httpMethod": "GET", "parameters": { "merchantId": { "description": "The ID of the account that manages the order. This cannot be a multi-client account.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "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.", "location": "query", "type": "integer", "format": "uint32" }, "orderBy": { "description": "Return the results in the specified order.", "location": "query", "type": "string", "enumDescriptions": [ "Return results in descending order.", "Return results in ascending order." ], "enum": [ "RETURN_CREATION_TIME_DESC", "RETURN_CREATION_TIME_ASC" ] }, "createdStartDate": { "description": "Obtains order returns created after this date (inclusively), in ISO 8601 format.", "location": "query", "type": "string" }, "createdEndDate": { "description": "Obtains order returns created before this date (inclusively), in ISO 8601 format.", "location": "query", "type": "string" }, "pageToken": { "description": "The token returned by the previous request.", "location": "query", "type": "string" }, "shipmentTypes": { "description": "Obtains order returns that match any shipment type provided in this parameter. When this parameter is not provided, order returns are obtained regardless of their shipment types.", "location": "query", "repeated": true, "type": "string", "enumDescriptions": [ "Return shipments with type `byMail` only.", "Return shipments with type `returnless` only.", "Return shipments with type `contactCustomerSupport` only." ], "enum": [ "BY_MAIL", "RETURNLESS", "CONTACT_CUSTOMER_SUPPORT" ] }, "shipmentStatus": { "description": "Obtains order returns that match any shipment status provided in this parameter. When this parameter is not provided, order returns are obtained regardless of their shipment statuses.", "location": "query", "repeated": true, "type": "string", "enumDescriptions": [ "Return shipments with `new` status only.", "Return shipments with `inProgress` status only.", "Return shipments with `processed` status only." ], "enum": [ "NEW", "IN_PROGRESS", "PROCESSED" ] }, "shipmentStates": { "description": "Obtains order returns that match any shipment state provided in this parameter. When this parameter is not provided, order returns are obtained regardless of their shipment states.", "location": "query", "repeated": true, "type": "string", "enumDescriptions": [ "Return shipments with `new` state only.", "Return shipments with `shipped` state only.", "Return shipments with `completed` state only.", "Return shipments with `undeliverable` state only.", "Return shipments with `pending` state only." ], "enum": [ "NEW", "SHIPPED", "COMPLETED", "UNDELIVERABLE", "PENDING" ] }, "acknowledged": { "description": "Obtains order returns that match the acknowledgement status. When set to true, obtains order returns that have been acknowledged. When false, obtains order returns that have not been acknowledged. When not provided, obtains order returns regardless of their acknowledgement status. We recommend using this filter set to `false`, in conjunction with the `acknowledge` call, such that only un-acknowledged order returns are returned. ", "location": "query", "type": "boolean" }, "googleOrderIds": { "description": "Obtains order returns with the specified order ids. If this parameter is provided, createdStartDate, createdEndDate, shipmentType, shipmentStatus, shipmentState and acknowledged parameters must be not set. Note: if googleOrderId and shipmentTrackingNumber parameters are provided, the obtained results will include all order returns that either match the specified order id or the specified tracking number.", "location": "query", "repeated": true, "type": "string" }, "shipmentTrackingNumbers": { "description": "Obtains order returns with the specified tracking numbers. If this parameter is provided, createdStartDate, createdEndDate, shipmentType, shipmentStatus, shipmentState and acknowledged parameters must be not set. Note: if googleOrderId and shipmentTrackingNumber parameters are provided, the obtained results will include all order returns that either match the specified order id or the specified tracking number.", "location": "query", "repeated": true, "type": "string" } }, "parameterOrder": [ "merchantId" ], "response": { "$ref": "OrderreturnsListResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Lists order returns in your Merchant Center account." }, "process": { "id": "content.orderreturns.process", "path": "{merchantId}/orderreturns/{returnId}/process", "flatPath": "{merchantId}/orderreturns/{returnId}/process", "httpMethod": "POST", "parameters": { "merchantId": { "description": "The ID of the account that manages the order. This cannot be a multi-client account.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "returnId": { "description": "The ID of the return.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "merchantId", "returnId" ], "request": { "$ref": "OrderreturnsProcessRequest" }, "response": { "$ref": "OrderreturnsProcessResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Processes return in your Merchant Center account." } }, "resources": { "labels": { "methods": { "create": { "id": "content.orderreturns.labels.create", "path": "{merchantId}/orderreturns/{returnId}/labels", "flatPath": "{merchantId}/orderreturns/{returnId}/labels", "httpMethod": "POST", "parameters": { "merchantId": { "description": "Required. The merchant the Return Shipping Label belongs to.", "location": "path", "required": true, "type": "string", "format": "int64" }, "returnId": { "description": "Required. Provide the Google-generated merchant order return ID.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "merchantId", "returnId" ], "request": { "$ref": "ReturnShippingLabel" }, "response": { "$ref": "ReturnShippingLabel" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Links a return shipping label to a return id. You can only create one return label per return id. Since the label is sent to the buyer, the linked return label cannot be updated or deleted. If you try to create multiple return shipping labels for a single return id, every create request except the first will fail." } } } } }, "orders": { "methods": { "acknowledge": { "id": "content.orders.acknowledge", "path": "{merchantId}/orders/{orderId}/acknowledge", "flatPath": "{merchantId}/orders/{orderId}/acknowledge", "httpMethod": "POST", "parameters": { "merchantId": { "description": "The ID of the account that manages the order. This cannot be a multi-client account.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "orderId": { "description": "The ID of the order.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "merchantId", "orderId" ], "request": { "$ref": "OrdersAcknowledgeRequest" }, "response": { "$ref": "OrdersAcknowledgeResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Marks an order as acknowledged." }, "advancetestorder": { "id": "content.orders.advancetestorder", "path": "{merchantId}/testorders/{orderId}/advance", "flatPath": "{merchantId}/testorders/{orderId}/advance", "httpMethod": "POST", "parameters": { "merchantId": { "description": "The ID of the account that manages the order. This cannot be a multi-client account.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "orderId": { "description": "The ID of the test order to modify.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "merchantId", "orderId" ], "response": { "$ref": "OrdersAdvanceTestOrderResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Sandbox only. Moves a test order from state \"`inProgress`\" to state \"`pendingShipment`\"." }, "cancel": { "id": "content.orders.cancel", "path": "{merchantId}/orders/{orderId}/cancel", "flatPath": "{merchantId}/orders/{orderId}/cancel", "httpMethod": "POST", "parameters": { "merchantId": { "description": "The ID of the account that manages the order. This cannot be a multi-client account.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "orderId": { "description": "The ID of the order to cancel.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "merchantId", "orderId" ], "request": { "$ref": "OrdersCancelRequest" }, "response": { "$ref": "OrdersCancelResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Cancels all line items in an order, making a full refund." }, "cancellineitem": { "id": "content.orders.cancellineitem", "path": "{merchantId}/orders/{orderId}/cancelLineItem", "flatPath": "{merchantId}/orders/{orderId}/cancelLineItem", "httpMethod": "POST", "parameters": { "merchantId": { "description": "The ID of the account that manages the order. This cannot be a multi-client account.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "orderId": { "description": "The ID of the order.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "merchantId", "orderId" ], "request": { "$ref": "OrdersCancelLineItemRequest" }, "response": { "$ref": "OrdersCancelLineItemResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Cancels a line item, making a full refund." }, "canceltestorderbycustomer": { "id": "content.orders.canceltestorderbycustomer", "path": "{merchantId}/testorders/{orderId}/cancelByCustomer", "flatPath": "{merchantId}/testorders/{orderId}/cancelByCustomer", "httpMethod": "POST", "parameters": { "merchantId": { "description": "The ID of the account that manages the order. This cannot be a multi-client account.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "orderId": { "description": "The ID of the test order to cancel.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "merchantId", "orderId" ], "request": { "$ref": "OrdersCancelTestOrderByCustomerRequest" }, "response": { "$ref": "OrdersCancelTestOrderByCustomerResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Sandbox only. Cancels a test order for customer-initiated cancellation." }, "createtestorder": { "id": "content.orders.createtestorder", "path": "{merchantId}/testorders", "flatPath": "{merchantId}/testorders", "httpMethod": "POST", "parameters": { "merchantId": { "description": "The ID of the account that should manage the order. This cannot be a multi-client account.", "location": "path", "required": true, "type": "string", "format": "uint64" } }, "parameterOrder": [ "merchantId" ], "request": { "$ref": "OrdersCreateTestOrderRequest" }, "response": { "$ref": "OrdersCreateTestOrderResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Sandbox only. Creates a test order." }, "createtestreturn": { "id": "content.orders.createtestreturn", "path": "{merchantId}/orders/{orderId}/testreturn", "flatPath": "{merchantId}/orders/{orderId}/testreturn", "httpMethod": "POST", "parameters": { "merchantId": { "description": "The ID of the account that manages the order. This cannot be a multi-client account.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "orderId": { "description": "The ID of the order.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "merchantId", "orderId" ], "request": { "$ref": "OrdersCreateTestReturnRequest" }, "response": { "$ref": "OrdersCreateTestReturnResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Sandbox only. Creates a test return." }, "get": { "id": "content.orders.get", "path": "{merchantId}/orders/{orderId}", "flatPath": "{merchantId}/orders/{orderId}", "httpMethod": "GET", "parameters": { "merchantId": { "description": "The ID of the account that manages the order. This cannot be a multi-client account.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "orderId": { "description": "The ID of the order.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "merchantId", "orderId" ], "response": { "$ref": "Order" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Retrieves an order from your Merchant Center account." }, "getbymerchantorderid": { "id": "content.orders.getbymerchantorderid", "path": "{merchantId}/ordersbymerchantid/{merchantOrderId}", "flatPath": "{merchantId}/ordersbymerchantid/{merchantOrderId}", "httpMethod": "GET", "parameters": { "merchantId": { "description": "The ID of the account that manages the order. This cannot be a multi-client account.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "merchantOrderId": { "description": "The merchant order ID to be looked for.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "merchantId", "merchantOrderId" ], "response": { "$ref": "OrdersGetByMerchantOrderIdResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Retrieves an order using merchant order ID." }, "gettestordertemplate": { "id": "content.orders.gettestordertemplate", "path": "{merchantId}/testordertemplates/{templateName}", "flatPath": "{merchantId}/testordertemplates/{templateName}", "httpMethod": "GET", "parameters": { "merchantId": { "description": "The ID of the account that should manage the order. This cannot be a multi-client account.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "templateName": { "description": "The name of the template to retrieve.", "location": "path", "required": true, "type": "string", "enumDescriptions": [ "Get `template1`.", "Get `template2`.", "Get `template1A`.", "Get `template1B`.", "Get `template3`.", "Get `template4`." ], "enum": [ "TEMPLATE1", "TEMPLATE2", "TEMPLATE1A", "TEMPLATE1B", "TEMPLATE3", "TEMPLATE4" ] }, "country": { "description": "The country of the template to retrieve. Defaults to \"`US`\".", "location": "query", "type": "string" } }, "parameterOrder": [ "merchantId", "templateName" ], "response": { "$ref": "OrdersGetTestOrderTemplateResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Sandbox only. Retrieves an order template that can be used to quickly create a new order in sandbox." }, "instorerefundlineitem": { "id": "content.orders.instorerefundlineitem", "path": "{merchantId}/orders/{orderId}/inStoreRefundLineItem", "flatPath": "{merchantId}/orders/{orderId}/inStoreRefundLineItem", "httpMethod": "POST", "parameters": { "merchantId": { "description": "The ID of the account that manages the order. This cannot be a multi-client account.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "orderId": { "description": "The ID of the order.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "merchantId", "orderId" ], "request": { "$ref": "OrdersInStoreRefundLineItemRequest" }, "response": { "$ref": "OrdersInStoreRefundLineItemResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Deprecated. Notifies that item return and refund was handled directly by merchant outside of Google payments processing (for example, cash refund done in store). Note: 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 through Google then through an in-store return." }, "list": { "id": "content.orders.list", "path": "{merchantId}/orders", "flatPath": "{merchantId}/orders", "httpMethod": "GET", "parameters": { "merchantId": { "description": "The ID of the account that manages the order. This cannot be a multi-client account.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "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.", "location": "query", "type": "integer", "format": "uint32" }, "pageToken": { "description": "The token returned by the previous request.", "location": "query", "type": "string" }, "statuses": { "description": "Obtains orders that match any of the specified statuses. Note that `active` is a shortcut for `pendingShipment` and `partiallyShipped`, and `completed` is a shortcut for `shipped`, `partiallyDelivered`, `delivered`, `partiallyReturned`, `returned`, and `canceled`.", "location": "query", "repeated": true, "type": "string", "enumDescriptions": [ "Return orders with status `active`. The `active` status includes `pendingShipment` and `partiallyShipped` orders.", "Return orders with status `completed`. The `completed` status includes `shipped`, `partiallyDelivered`, `delivered`, `partiallyReturned`, `returned`, and `canceled` orders.", "Return orders with status `canceled`.", "Return orders with status `inProgress`.", "Return orders with status `pendingShipment`.", "Return orders with status `partiallyShipped`.", "Return orders with status `shipped`.", "Return orders with status `partiallyDelivered`.", "Return orders with status `delivered`.", "Return orders with status `partiallyReturned`.", "Return orders with status `returned`." ], "enum": [ "ACTIVE", "COMPLETED", "CANCELED", "IN_PROGRESS", "PENDING_SHIPMENT", "PARTIALLY_SHIPPED", "SHIPPED", "PARTIALLY_DELIVERED", "DELIVERED", "PARTIALLY_RETURNED", "RETURNED" ] }, "placedDateStart": { "description": "Obtains orders placed after this date (inclusively), in ISO 8601 format.", "location": "query", "type": "string" }, "placedDateEnd": { "description": "Obtains orders placed before this date (exclusively), in ISO 8601 format.", "location": "query", "type": "string" }, "orderBy": { "description": "Order results by placement date in descending or ascending order. Acceptable values are: - placedDateAsc - placedDateDesc ", "location": "query", "type": "string" }, "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. We 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" } }, "parameterOrder": [ "merchantId" ], "response": { "$ref": "OrdersListResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Lists the orders in your Merchant Center account." }, "refunditem": { "id": "content.orders.refunditem", "path": "{merchantId}/orders/{orderId}/refunditem", "flatPath": "{merchantId}/orders/{orderId}/refunditem", "httpMethod": "POST", "parameters": { "merchantId": { "description": "The ID of the account that manages the order. This cannot be a multi-client account.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "orderId": { "description": "The ID of the order to refund.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "merchantId", "orderId" ], "request": { "$ref": "OrdersRefundItemRequest" }, "response": { "$ref": "OrdersRefundItemResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Issues a partial or total refund for items and shipment." }, "refundorder": { "id": "content.orders.refundorder", "path": "{merchantId}/orders/{orderId}/refundorder", "flatPath": "{merchantId}/orders/{orderId}/refundorder", "httpMethod": "POST", "parameters": { "merchantId": { "description": "The ID of the account that manages the order. This cannot be a multi-client account.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "orderId": { "description": "The ID of the order to refund.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "merchantId", "orderId" ], "request": { "$ref": "OrdersRefundOrderRequest" }, "response": { "$ref": "OrdersRefundOrderResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Issues a partial or total refund for an order." }, "rejectreturnlineitem": { "id": "content.orders.rejectreturnlineitem", "path": "{merchantId}/orders/{orderId}/rejectReturnLineItem", "flatPath": "{merchantId}/orders/{orderId}/rejectReturnLineItem", "httpMethod": "POST", "parameters": { "merchantId": { "description": "The ID of the account that manages the order. This cannot be a multi-client account.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "orderId": { "description": "The ID of the order.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "merchantId", "orderId" ], "request": { "$ref": "OrdersRejectReturnLineItemRequest" }, "response": { "$ref": "OrdersRejectReturnLineItemResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Rejects return on an line item." }, "returnrefundlineitem": { "id": "content.orders.returnrefundlineitem", "path": "{merchantId}/orders/{orderId}/returnRefundLineItem", "flatPath": "{merchantId}/orders/{orderId}/returnRefundLineItem", "httpMethod": "POST", "parameters": { "merchantId": { "description": "The ID of the account that manages the order. This cannot be a multi-client account.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "orderId": { "description": "The ID of the order.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "merchantId", "orderId" ], "request": { "$ref": "OrdersReturnRefundLineItemRequest" }, "response": { "$ref": "OrdersReturnRefundLineItemResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Returns and refunds a line item. Note that this method can only be called on fully shipped orders. The Orderreturns API is the preferred way to handle returns after you receive a return from a customer. You can use Orderreturns.list or Orderreturns.get to search for the return, and then use Orderreturns.processreturn to issue the refund. If the return cannot be found, then we recommend using this API to issue a refund." }, "setlineitemmetadata": { "id": "content.orders.setlineitemmetadata", "path": "{merchantId}/orders/{orderId}/setLineItemMetadata", "flatPath": "{merchantId}/orders/{orderId}/setLineItemMetadata", "httpMethod": "POST", "parameters": { "merchantId": { "description": "The ID of the account that manages the order. This cannot be a multi-client account.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "orderId": { "description": "The ID of the order.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "merchantId", "orderId" ], "request": { "$ref": "OrdersSetLineItemMetadataRequest" }, "response": { "$ref": "OrdersSetLineItemMetadataResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "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 through other methods. Submitted key-value pairs can be retrieved as part of the orders resource." }, "shiplineitems": { "id": "content.orders.shiplineitems", "path": "{merchantId}/orders/{orderId}/shipLineItems", "flatPath": "{merchantId}/orders/{orderId}/shipLineItems", "httpMethod": "POST", "parameters": { "merchantId": { "description": "The ID of the account that manages the order. This cannot be a multi-client account.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "orderId": { "description": "The ID of the order.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "merchantId", "orderId" ], "request": { "$ref": "OrdersShipLineItemsRequest" }, "response": { "$ref": "OrdersShipLineItemsResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Marks line item(s) as shipped." }, "updatelineitemshippingdetails": { "id": "content.orders.updatelineitemshippingdetails", "path": "{merchantId}/orders/{orderId}/updateLineItemShippingDetails", "flatPath": "{merchantId}/orders/{orderId}/updateLineItemShippingDetails", "httpMethod": "POST", "parameters": { "merchantId": { "description": "The ID of the account that manages the order. This cannot be a multi-client account.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "orderId": { "description": "The ID of the order.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "merchantId", "orderId" ], "request": { "$ref": "OrdersUpdateLineItemShippingDetailsRequest" }, "response": { "$ref": "OrdersUpdateLineItemShippingDetailsResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Updates ship by and delivery by dates for a line item." }, "updatemerchantorderid": { "id": "content.orders.updatemerchantorderid", "path": "{merchantId}/orders/{orderId}/updateMerchantOrderId", "flatPath": "{merchantId}/orders/{orderId}/updateMerchantOrderId", "httpMethod": "POST", "parameters": { "merchantId": { "description": "The ID of the account that manages the order. This cannot be a multi-client account.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "orderId": { "description": "The ID of the order.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "merchantId", "orderId" ], "request": { "$ref": "OrdersUpdateMerchantOrderIdRequest" }, "response": { "$ref": "OrdersUpdateMerchantOrderIdResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Updates the merchant order ID for a given order." }, "updateshipment": { "id": "content.orders.updateshipment", "path": "{merchantId}/orders/{orderId}/updateShipment", "flatPath": "{merchantId}/orders/{orderId}/updateShipment", "httpMethod": "POST", "parameters": { "merchantId": { "description": "The ID of the account that manages the order. This cannot be a multi-client account.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "orderId": { "description": "The ID of the order.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "merchantId", "orderId" ], "request": { "$ref": "OrdersUpdateShipmentRequest" }, "response": { "$ref": "OrdersUpdateShipmentResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Updates a shipment's status, carrier, and/or tracking ID." }, "captureOrder": { "id": "content.orders.captureOrder", "path": "{merchantId}/orders/{orderId}/captureOrder", "flatPath": "{merchantId}/orders/{orderId}/captureOrder", "httpMethod": "POST", "parameters": { "merchantId": { "description": "Required. The ID of the account that manages the order. This cannot be a multi-client account.", "location": "path", "required": true, "type": "string", "format": "int64" }, "orderId": { "description": "Required. The ID of the Order.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "merchantId", "orderId" ], "request": { "$ref": "CaptureOrderRequest" }, "response": { "$ref": "CaptureOrderResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Capture funds from the customer for the current order total. This method should be called after the merchant verifies that they are able and ready to start shipping the order. This method blocks until a response is received from the payment processsor. If this method succeeds, the merchant is guaranteed to receive funds for the order after shipment. If the request fails, it can be retried or the order may be cancelled. This method cannot be called after the entire order is already shipped. A rejected error code is returned when the payment service provider has declined the charge. This indicates a problem between the PSP and either the merchant's or customer's account. Sometimes this error will be resolved by the customer. We recommend retrying these errors once per day or cancelling the order with reason `failedToCaptureFunds` if the items cannot be held." } } }, "pos": { "methods": { "custombatch": { "id": "content.pos.custombatch", "path": "pos/batch", "flatPath": "pos/batch", "httpMethod": "POST", "parameters": {}, "parameterOrder": [], "request": { "$ref": "PosCustomBatchRequest" }, "response": { "$ref": "PosCustomBatchResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Batches multiple POS-related calls in a single request." }, "delete": { "id": "content.pos.delete", "path": "{merchantId}/pos/{targetMerchantId}/store/{storeCode}", "flatPath": "{merchantId}/pos/{targetMerchantId}/store/{storeCode}", "httpMethod": "DELETE", "parameters": { "merchantId": { "description": "The ID of the POS or inventory data provider.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "targetMerchantId": { "description": "The ID of the target merchant.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "storeCode": { "description": "A store code that is unique per merchant.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "merchantId", "targetMerchantId", "storeCode" ], "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Deletes a store for the given merchant." }, "get": { "id": "content.pos.get", "path": "{merchantId}/pos/{targetMerchantId}/store/{storeCode}", "flatPath": "{merchantId}/pos/{targetMerchantId}/store/{storeCode}", "httpMethod": "GET", "parameters": { "merchantId": { "description": "The ID of the POS or inventory data provider.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "targetMerchantId": { "description": "The ID of the target merchant.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "storeCode": { "description": "A store code that is unique per merchant.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "merchantId", "targetMerchantId", "storeCode" ], "response": { "$ref": "PosStore" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Retrieves information about the given store." }, "insert": { "id": "content.pos.insert", "path": "{merchantId}/pos/{targetMerchantId}/store", "flatPath": "{merchantId}/pos/{targetMerchantId}/store", "httpMethod": "POST", "parameters": { "merchantId": { "description": "The ID of the POS or inventory data provider.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "targetMerchantId": { "description": "The ID of the target merchant.", "location": "path", "required": true, "type": "string", "format": "uint64" } }, "parameterOrder": [ "merchantId", "targetMerchantId" ], "request": { "$ref": "PosStore" }, "response": { "$ref": "PosStore" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Creates a store for the given merchant." }, "inventory": { "id": "content.pos.inventory", "path": "{merchantId}/pos/{targetMerchantId}/inventory", "flatPath": "{merchantId}/pos/{targetMerchantId}/inventory", "httpMethod": "POST", "parameters": { "merchantId": { "description": "The ID of the POS or inventory data provider.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "targetMerchantId": { "description": "The ID of the target merchant.", "location": "path", "required": true, "type": "string", "format": "uint64" } }, "parameterOrder": [ "merchantId", "targetMerchantId" ], "request": { "$ref": "PosInventoryRequest" }, "response": { "$ref": "PosInventoryResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Submit inventory for the given merchant." }, "list": { "id": "content.pos.list", "path": "{merchantId}/pos/{targetMerchantId}/store", "flatPath": "{merchantId}/pos/{targetMerchantId}/store", "httpMethod": "GET", "parameters": { "merchantId": { "description": "The ID of the POS or inventory data provider.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "targetMerchantId": { "description": "The ID of the target merchant.", "location": "path", "required": true, "type": "string", "format": "uint64" } }, "parameterOrder": [ "merchantId", "targetMerchantId" ], "response": { "$ref": "PosListResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Lists the stores of the target merchant." }, "sale": { "id": "content.pos.sale", "path": "{merchantId}/pos/{targetMerchantId}/sale", "flatPath": "{merchantId}/pos/{targetMerchantId}/sale", "httpMethod": "POST", "parameters": { "merchantId": { "description": "The ID of the POS or inventory data provider.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "targetMerchantId": { "description": "The ID of the target merchant.", "location": "path", "required": true, "type": "string", "format": "uint64" } }, "parameterOrder": [ "merchantId", "targetMerchantId" ], "request": { "$ref": "PosSaleRequest" }, "response": { "$ref": "PosSaleResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Submit a sale event for the given merchant." } } }, "products": { "methods": { "custombatch": { "id": "content.products.custombatch", "path": "products/batch", "flatPath": "products/batch", "httpMethod": "POST", "parameters": {}, "parameterOrder": [], "request": { "$ref": "ProductsCustomBatchRequest" }, "response": { "$ref": "ProductsCustomBatchResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Retrieves, inserts, and deletes multiple products in a single request." }, "delete": { "id": "content.products.delete", "path": "{merchantId}/products/{productId}", "flatPath": "{merchantId}/products/{productId}", "httpMethod": "DELETE", "parameters": { "merchantId": { "description": "The ID of the account that contains the product. This account cannot be a multi-client account.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "productId": { "description": "The REST ID of the product.", "location": "path", "required": true, "type": "string" }, "feedId": { "description": "The Content API Supplemental Feed ID. If present then product deletion applies to the data in a supplemental feed. If absent, entire product will be deleted.", "location": "query", "type": "string", "format": "uint64" } }, "parameterOrder": [ "merchantId", "productId" ], "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Deletes a product from your Merchant Center account." }, "get": { "id": "content.products.get", "path": "{merchantId}/products/{productId}", "flatPath": "{merchantId}/products/{productId}", "httpMethod": "GET", "parameters": { "merchantId": { "description": "The ID of the account that contains the product. This account cannot be a multi-client account.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "productId": { "description": "The REST ID of the product.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "merchantId", "productId" ], "response": { "$ref": "Product" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Retrieves a product from your Merchant Center account." }, "insert": { "id": "content.products.insert", "path": "{merchantId}/products", "flatPath": "{merchantId}/products", "httpMethod": "POST", "parameters": { "merchantId": { "description": "The ID of the account that contains the product. This account cannot be a multi-client account.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "feedId": { "description": "The Content API Supplemental Feed ID. If present then product insertion applies to the data in a supplemental feed.", "location": "query", "type": "string", "format": "uint64" } }, "parameterOrder": [ "merchantId" ], "request": { "$ref": "Product" }, "response": { "$ref": "Product" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "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." }, "update": { "id": "content.products.update", "path": "{merchantId}/products/{productId}", "flatPath": "{merchantId}/products/{productId}", "httpMethod": "PATCH", "parameters": { "merchantId": { "description": "The ID of the account that contains the product. This account cannot be a multi-client account.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "productId": { "description": "The REST ID of the product for which to update.", "location": "path", "required": true, "type": "string" }, "updateMask": { "description": "The comma-separated list of product attributes to be updated. Example: `\"title,salePrice\"`. Attributes specified in the update mask without a value specified in the body will be deleted from the product. *You must specify the update mask to delete attributes.* Only top-level product attributes can be updated. If not defined, product attributes with set values will be updated and other attributes will stay unchanged.", "location": "query", "type": "string", "format": "google-fieldmask" } }, "parameterOrder": [ "merchantId", "productId" ], "request": { "$ref": "Product" }, "response": { "$ref": "Product" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Updates an existing product in your Merchant Center account. Only updates attributes provided in the request." }, "list": { "id": "content.products.list", "path": "{merchantId}/products", "flatPath": "{merchantId}/products", "httpMethod": "GET", "parameters": { "merchantId": { "description": "The ID of the account that contains the products. This account cannot be a multi-client account.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "maxResults": { "description": "The maximum number of products to return in the response, used for paging. The default value is 25. The maximum value is 250.", "location": "query", "type": "integer", "format": "uint32" }, "pageToken": { "description": "The token returned by the previous request.", "location": "query", "type": "string" } }, "parameterOrder": [ "merchantId" ], "response": { "$ref": "ProductsListResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "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." } } }, "productstatuses": { "methods": { "custombatch": { "id": "content.productstatuses.custombatch", "path": "productstatuses/batch", "flatPath": "productstatuses/batch", "httpMethod": "POST", "parameters": {}, "parameterOrder": [], "request": { "$ref": "ProductstatusesCustomBatchRequest" }, "response": { "$ref": "ProductstatusesCustomBatchResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Gets the statuses of multiple products in a single request." }, "get": { "id": "content.productstatuses.get", "path": "{merchantId}/productstatuses/{productId}", "flatPath": "{merchantId}/productstatuses/{productId}", "httpMethod": "GET", "parameters": { "merchantId": { "description": "The ID of the account that contains the product. This account cannot be a multi-client account.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "productId": { "description": "The REST ID of the product.", "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" } }, "parameterOrder": [ "merchantId", "productId" ], "response": { "$ref": "ProductStatus" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Gets the status of a product from your Merchant Center account." }, "list": { "id": "content.productstatuses.list", "path": "{merchantId}/productstatuses", "flatPath": "{merchantId}/productstatuses", "httpMethod": "GET", "parameters": { "merchantId": { "description": "The ID of the account that contains the products. This account cannot be a multi-client account.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "maxResults": { "description": "The maximum number of product statuses to return in the response, used for paging. The default value is 25. The maximum value is 250.", "location": "query", "type": "integer", "format": "uint32" }, "pageToken": { "description": "The token returned by the previous request.", "location": "query", "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" } }, "parameterOrder": [ "merchantId" ], "response": { "$ref": "ProductstatusesListResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Lists the statuses of the products in your Merchant Center account." } } }, "pubsubnotificationsettings": { "methods": { "get": { "id": "content.pubsubnotificationsettings.get", "path": "{merchantId}/pubsubnotificationsettings", "flatPath": "{merchantId}/pubsubnotificationsettings", "httpMethod": "GET", "parameters": { "merchantId": { "description": "The ID of the account for which to get pubsub notification settings.", "location": "path", "required": true, "type": "string", "format": "uint64" } }, "parameterOrder": [ "merchantId" ], "response": { "$ref": "PubsubNotificationSettings" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Retrieves a Merchant Center account's pubsub notification settings." }, "update": { "id": "content.pubsubnotificationsettings.update", "path": "{merchantId}/pubsubnotificationsettings", "flatPath": "{merchantId}/pubsubnotificationsettings", "httpMethod": "PUT", "parameters": { "merchantId": { "description": "The ID of the account.", "location": "path", "required": true, "type": "string", "format": "uint64" } }, "parameterOrder": [ "merchantId" ], "request": { "$ref": "PubsubNotificationSettings" }, "response": { "$ref": "PubsubNotificationSettings" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Register a Merchant Center account for pubsub notifications. Note that cloud topic name shouldn't be provided as part of the request." } } }, "regionalinventory": { "methods": { "custombatch": { "id": "content.regionalinventory.custombatch", "path": "regionalinventory/batch", "flatPath": "regionalinventory/batch", "httpMethod": "POST", "parameters": {}, "parameterOrder": [], "request": { "$ref": "RegionalinventoryCustomBatchRequest" }, "response": { "$ref": "RegionalinventoryCustomBatchResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Updates regional inventory for multiple products or regions in a single request." }, "insert": { "id": "content.regionalinventory.insert", "path": "{merchantId}/products/{productId}/regionalinventory", "flatPath": "{merchantId}/products/{productId}/regionalinventory", "httpMethod": "POST", "parameters": { "merchantId": { "description": "The ID of the account that contains the product. This account cannot be a multi-client account.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "productId": { "description": "The REST ID of the product for which to update the regional inventory.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "merchantId", "productId" ], "request": { "$ref": "RegionalInventory" }, "response": { "$ref": "RegionalInventory" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Updates 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." } } }, "returnaddress": { "methods": { "custombatch": { "id": "content.returnaddress.custombatch", "path": "returnaddress/batch", "flatPath": "returnaddress/batch", "httpMethod": "POST", "parameters": {}, "parameterOrder": [], "request": { "$ref": "ReturnaddressCustomBatchRequest" }, "response": { "$ref": "ReturnaddressCustomBatchResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Batches multiple return address related calls in a single request." }, "delete": { "id": "content.returnaddress.delete", "path": "{merchantId}/returnaddress/{returnAddressId}", "flatPath": "{merchantId}/returnaddress/{returnAddressId}", "httpMethod": "DELETE", "parameters": { "merchantId": { "description": "The Merchant Center account from which to delete the given return address.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "returnAddressId": { "description": "Return address ID generated by Google.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "merchantId", "returnAddressId" ], "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Deletes a return address for the given Merchant Center account." }, "get": { "id": "content.returnaddress.get", "path": "{merchantId}/returnaddress/{returnAddressId}", "flatPath": "{merchantId}/returnaddress/{returnAddressId}", "httpMethod": "GET", "parameters": { "merchantId": { "description": "The Merchant Center account to get a return address for.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "returnAddressId": { "description": "Return address ID generated by Google.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "merchantId", "returnAddressId" ], "response": { "$ref": "ReturnAddress" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Gets a return address of the Merchant Center account." }, "insert": { "id": "content.returnaddress.insert", "path": "{merchantId}/returnaddress", "flatPath": "{merchantId}/returnaddress", "httpMethod": "POST", "parameters": { "merchantId": { "description": "The Merchant Center account to insert a return address for.", "location": "path", "required": true, "type": "string", "format": "uint64" } }, "parameterOrder": [ "merchantId" ], "request": { "$ref": "ReturnAddress" }, "response": { "$ref": "ReturnAddress" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Inserts a return address for the Merchant Center account." }, "list": { "id": "content.returnaddress.list", "path": "{merchantId}/returnaddress", "flatPath": "{merchantId}/returnaddress", "httpMethod": "GET", "parameters": { "merchantId": { "description": "The Merchant Center account to list return addresses for.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "maxResults": { "description": "The maximum number of addresses in the response, used for paging.", "location": "query", "type": "integer", "format": "uint32" }, "pageToken": { "description": "The token returned by the previous request.", "location": "query", "type": "string" }, "country": { "description": "List only return addresses applicable to the given country of sale. When omitted, all return addresses are listed.", "location": "query", "type": "string" } }, "parameterOrder": [ "merchantId" ], "response": { "$ref": "ReturnaddressListResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Lists the return addresses of the Merchant Center account." } } }, "returnpolicy": { "methods": { "custombatch": { "id": "content.returnpolicy.custombatch", "path": "returnpolicy/batch", "flatPath": "returnpolicy/batch", "httpMethod": "POST", "parameters": {}, "parameterOrder": [], "request": { "$ref": "ReturnpolicyCustomBatchRequest" }, "response": { "$ref": "ReturnpolicyCustomBatchResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Batches multiple return policy related calls in a single request." }, "delete": { "id": "content.returnpolicy.delete", "path": "{merchantId}/returnpolicy/{returnPolicyId}", "flatPath": "{merchantId}/returnpolicy/{returnPolicyId}", "httpMethod": "DELETE", "parameters": { "merchantId": { "description": "The Merchant Center account from which to delete the given return policy.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "returnPolicyId": { "description": "Return policy ID generated by Google.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "merchantId", "returnPolicyId" ], "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Deletes a return policy for the given Merchant Center account." }, "get": { "id": "content.returnpolicy.get", "path": "{merchantId}/returnpolicy/{returnPolicyId}", "flatPath": "{merchantId}/returnpolicy/{returnPolicyId}", "httpMethod": "GET", "parameters": { "merchantId": { "description": "The Merchant Center account to get a return policy for.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "returnPolicyId": { "description": "Return policy ID generated by Google.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "merchantId", "returnPolicyId" ], "response": { "$ref": "ReturnPolicy" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Gets a return policy of the Merchant Center account." }, "insert": { "id": "content.returnpolicy.insert", "path": "{merchantId}/returnpolicy", "flatPath": "{merchantId}/returnpolicy", "httpMethod": "POST", "parameters": { "merchantId": { "description": "The Merchant Center account to insert a return policy for.", "location": "path", "required": true, "type": "string", "format": "uint64" } }, "parameterOrder": [ "merchantId" ], "request": { "$ref": "ReturnPolicy" }, "response": { "$ref": "ReturnPolicy" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Inserts a return policy for the Merchant Center account." }, "list": { "id": "content.returnpolicy.list", "path": "{merchantId}/returnpolicy", "flatPath": "{merchantId}/returnpolicy", "httpMethod": "GET", "parameters": { "merchantId": { "description": "The Merchant Center account to list return policies for.", "location": "path", "required": true, "type": "string", "format": "uint64" } }, "parameterOrder": [ "merchantId" ], "response": { "$ref": "ReturnpolicyListResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Lists the return policies of the Merchant Center account." } } }, "settlementreports": { "methods": { "get": { "id": "content.settlementreports.get", "path": "{merchantId}/settlementreports/{settlementId}", "flatPath": "{merchantId}/settlementreports/{settlementId}", "httpMethod": "GET", "parameters": { "merchantId": { "description": "The Merchant Center account of the settlement report.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "settlementId": { "description": "The Google-provided ID of the settlement.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "merchantId", "settlementId" ], "response": { "$ref": "SettlementReport" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Retrieves a settlement report from your Merchant Center account." }, "list": { "id": "content.settlementreports.list", "path": "{merchantId}/settlementreports", "flatPath": "{merchantId}/settlementreports", "httpMethod": "GET", "parameters": { "merchantId": { "description": "The Merchant Center account to list settlements for.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "maxResults": { "description": "The maximum number of settlements to return in the response, used for paging. The default value is 200 returns per page, and the maximum allowed value is 5000 returns per page.", "location": "query", "type": "integer", "format": "uint32" }, "pageToken": { "description": "The token returned by the previous request.", "location": "query", "type": "string" }, "transferStartDate": { "description": "Obtains settlements which have transactions after this date (inclusively), in ISO 8601 format.", "location": "query", "type": "string" }, "transferEndDate": { "description": "Obtains settlements which have transactions before this date (inclusively), in ISO 8601 format.", "location": "query", "type": "string" } }, "parameterOrder": [ "merchantId" ], "response": { "$ref": "SettlementreportsListResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Retrieves a list of settlement reports from your Merchant Center account." } } }, "settlementtransactions": { "methods": { "list": { "id": "content.settlementtransactions.list", "path": "{merchantId}/settlementreports/{settlementId}/transactions", "flatPath": "{merchantId}/settlementreports/{settlementId}/transactions", "httpMethod": "GET", "parameters": { "merchantId": { "description": "The Merchant Center account to list transactions for.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "settlementId": { "description": "The Google-provided ID of the settlement.", "location": "path", "required": true, "type": "string" }, "maxResults": { "description": "The maximum number of transactions to return in the response, used for paging. The default value is 200 transactions per page, and the maximum allowed value is 5000 transactions per page.", "location": "query", "type": "integer", "format": "uint32" }, "pageToken": { "description": "The token returned by the previous request.", "location": "query", "type": "string" }, "transactionIds": { "description": "The list of transactions to return. If not set, all transactions will be returned.", "location": "query", "repeated": true, "type": "string" } }, "parameterOrder": [ "merchantId", "settlementId" ], "response": { "$ref": "SettlementtransactionsListResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Retrieves a list of transactions for the settlement." } } }, "shippingsettings": { "methods": { "custombatch": { "id": "content.shippingsettings.custombatch", "path": "shippingsettings/batch", "flatPath": "shippingsettings/batch", "httpMethod": "POST", "parameters": {}, "parameterOrder": [], "request": { "$ref": "ShippingsettingsCustomBatchRequest" }, "response": { "$ref": "ShippingsettingsCustomBatchResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Retrieves and updates the shipping settings of multiple accounts in a single request." }, "get": { "id": "content.shippingsettings.get", "path": "{merchantId}/shippingsettings/{accountId}", "flatPath": "{merchantId}/shippingsettings/{accountId}", "httpMethod": "GET", "parameters": { "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.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "accountId": { "description": "The ID of the account for which to get/update shipping settings.", "location": "path", "required": true, "type": "string", "format": "uint64" } }, "parameterOrder": [ "merchantId", "accountId" ], "response": { "$ref": "ShippingSettings" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Retrieves the shipping settings of the account." }, "getsupportedcarriers": { "id": "content.shippingsettings.getsupportedcarriers", "path": "{merchantId}/supportedCarriers", "flatPath": "{merchantId}/supportedCarriers", "httpMethod": "GET", "parameters": { "merchantId": { "description": "The ID of the account for which to retrieve the supported carriers.", "location": "path", "required": true, "type": "string", "format": "uint64" } }, "parameterOrder": [ "merchantId" ], "response": { "$ref": "ShippingsettingsGetSupportedCarriersResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Retrieves supported carriers and carrier services for an account." }, "getsupportedholidays": { "id": "content.shippingsettings.getsupportedholidays", "path": "{merchantId}/supportedHolidays", "flatPath": "{merchantId}/supportedHolidays", "httpMethod": "GET", "parameters": { "merchantId": { "description": "The ID of the account for which to retrieve the supported holidays.", "location": "path", "required": true, "type": "string", "format": "uint64" } }, "parameterOrder": [ "merchantId" ], "response": { "$ref": "ShippingsettingsGetSupportedHolidaysResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Retrieves supported holidays for an account." }, "getsupportedpickupservices": { "id": "content.shippingsettings.getsupportedpickupservices", "path": "{merchantId}/supportedPickupServices", "flatPath": "{merchantId}/supportedPickupServices", "httpMethod": "GET", "parameters": { "merchantId": { "description": "The ID of the account for which to retrieve the supported pickup services.", "location": "path", "required": true, "type": "string", "format": "uint64" } }, "parameterOrder": [ "merchantId" ], "response": { "$ref": "ShippingsettingsGetSupportedPickupServicesResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Retrieves supported pickup services for an account." }, "list": { "id": "content.shippingsettings.list", "path": "{merchantId}/shippingsettings", "flatPath": "{merchantId}/shippingsettings", "httpMethod": "GET", "parameters": { "merchantId": { "description": "The ID of the managing account. This must be a multi-client account.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "maxResults": { "description": "The maximum number of shipping settings to return in the response, used for paging.", "location": "query", "type": "integer", "format": "uint32" }, "pageToken": { "description": "The token returned by the previous request.", "location": "query", "type": "string" } }, "parameterOrder": [ "merchantId" ], "response": { "$ref": "ShippingsettingsListResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Lists the shipping settings of the sub-accounts in your Merchant Center account." }, "update": { "id": "content.shippingsettings.update", "path": "{merchantId}/shippingsettings/{accountId}", "flatPath": "{merchantId}/shippingsettings/{accountId}", "httpMethod": "PUT", "parameters": { "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.", "location": "path", "required": true, "type": "string", "format": "uint64" }, "accountId": { "description": "The ID of the account for which to get/update shipping settings.", "location": "path", "required": true, "type": "string", "format": "uint64" } }, "parameterOrder": [ "merchantId", "accountId" ], "request": { "$ref": "ShippingSettings" }, "response": { "$ref": "ShippingSettings" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Updates the shipping settings of the account. Any fields that are not provided are deleted from the resource." } } }, "collections": { "methods": { "get": { "id": "content.collections.get", "path": "{merchantId}/collections/{collectionId}", "flatPath": "{merchantId}/collections/{collectionId}", "httpMethod": "GET", "parameters": { "merchantId": { "description": "Required. The ID of the account that contains the collection. This account cannot be a multi-client account.", "location": "path", "required": true, "type": "string", "format": "int64" }, "collectionId": { "description": "Required. The REST ID of the collection.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "merchantId", "collectionId" ], "response": { "$ref": "Collection" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Retrieves a collection from your Merchant Center account." }, "list": { "id": "content.collections.list", "path": "{merchantId}/collections", "flatPath": "{merchantId}/collections", "httpMethod": "GET", "parameters": { "merchantId": { "description": "Required. The ID of the account that contains the collection. This account cannot be a multi-client account.", "location": "path", "required": true, "type": "string", "format": "int64" }, "pageSize": { "description": "The maximum number of collections to return in the response, used for paging. Defaults to 50; values above 1000 will be coerced to 1000.", "location": "query", "type": "integer", "format": "int32" }, "pageToken": { "description": "Token (if provided) to retrieve the subsequent page. All other parameters must match the original call that provided the page token.", "location": "query", "type": "string" } }, "parameterOrder": [ "merchantId" ], "response": { "$ref": "ListCollectionsResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Lists the collections in your Merchant Center account. The response might contain fewer items than specified by page_size. Rely on next_page_token to determine if there are more items to be requested." }, "create": { "id": "content.collections.create", "path": "{merchantId}/collections", "flatPath": "{merchantId}/collections", "httpMethod": "POST", "parameters": { "merchantId": { "description": "Required. The ID of the account that contains the collection. This account cannot be a multi-client account.", "location": "path", "required": true, "type": "string", "format": "int64" } }, "parameterOrder": [ "merchantId" ], "request": { "$ref": "Collection" }, "response": { "$ref": "Collection" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Uploads a collection to your Merchant Center account. If a collection with the same collectionId already exists, this method updates that entry. In each update, the collection is completely replaced by the fields in the body of the update request." }, "delete": { "id": "content.collections.delete", "path": "{merchantId}/collections/{collectionId}", "flatPath": "{merchantId}/collections/{collectionId}", "httpMethod": "DELETE", "parameters": { "merchantId": { "description": "Required. The ID of the account that contains the collection. This account cannot be a multi-client account.", "location": "path", "required": true, "type": "string", "format": "int64" }, "collectionId": { "description": "Required. The collectionId of the collection. CollectionId is the same as the REST ID of the collection.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "merchantId", "collectionId" ], "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Deletes a collection from your Merchant Center account." } } }, "quotas": { "methods": { "list": { "id": "content.quotas.list", "path": "{merchantId}/quotas", "flatPath": "{merchantId}/quotas", "httpMethod": "GET", "parameters": { "merchantId": { "description": "Required. The ID of the account that has quota. This account must be an admin.", "location": "path", "required": true, "type": "string", "format": "int64" }, "pageSize": { "description": "The maximum number of quotas to return in the response, used for paging. Defaults to 500; values above 1000 will be coerced to 1000.", "location": "query", "type": "integer", "format": "int32" }, "pageToken": { "description": "Token (if provided) to retrieve the subsequent page. All other parameters must match the original call that provided the page token.", "location": "query", "type": "string" } }, "parameterOrder": [ "merchantId" ], "response": { "$ref": "ListMethodQuotasResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Lists the daily call quota and usage per method for your Merchant Center account." } } }, "collectionstatuses": { "methods": { "get": { "id": "content.collectionstatuses.get", "path": "{merchantId}/collectionstatuses/{collectionId}", "flatPath": "{merchantId}/collectionstatuses/{collectionId}", "httpMethod": "GET", "parameters": { "merchantId": { "description": "Required. The ID of the account that contains the collection. This account cannot be a multi-client account.", "location": "path", "required": true, "type": "string", "format": "int64" }, "collectionId": { "description": "Required. The collectionId of the collection. CollectionId is the same as the REST ID of the collection.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "merchantId", "collectionId" ], "response": { "$ref": "CollectionStatus" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Gets the status of a collection from your Merchant Center account." }, "list": { "id": "content.collectionstatuses.list", "path": "{merchantId}/collectionstatuses", "flatPath": "{merchantId}/collectionstatuses", "httpMethod": "GET", "parameters": { "merchantId": { "description": "Required. The ID of the account that contains the collection. This account cannot be a multi-client account.", "location": "path", "required": true, "type": "string", "format": "int64" }, "pageSize": { "description": "The maximum number of collection statuses to return in the response, used for paging. Defaults to 50; values above 1000 will be coerced to 1000.", "location": "query", "type": "integer", "format": "int32" }, "pageToken": { "description": "Token (if provided) to retrieve the subsequent page. All other parameters must match the original call that provided the page token.", "location": "query", "type": "string" } }, "parameterOrder": [ "merchantId" ], "response": { "$ref": "ListCollectionStatusesResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Lists the statuses of the collections in your Merchant Center account." } } }, "conversionsources": { "methods": { "create": { "id": "content.conversionsources.create", "path": "{merchantId}/conversionsources", "flatPath": "{merchantId}/conversionsources", "httpMethod": "POST", "parameters": { "merchantId": { "description": "Required. The ID of the account that owns the new conversion source.", "location": "path", "required": true, "type": "string", "format": "int64" } }, "parameterOrder": [ "merchantId" ], "request": { "$ref": "ConversionSource" }, "response": { "$ref": "ConversionSource" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Creates a new conversion source." }, "patch": { "id": "content.conversionsources.patch", "path": "{merchantId}/conversionsources/{conversionSourceId}", "flatPath": "{merchantId}/conversionsources/{conversionSourceId}", "httpMethod": "PATCH", "parameters": { "merchantId": { "description": "Required. The ID of the account that owns the new conversion source.", "location": "path", "required": true, "type": "string", "format": "int64" }, "conversionSourceId": { "description": "Required. The ID of the conversion source to be updated.", "location": "path", "required": true, "type": "string" }, "updateMask": { "description": "Required. List of fields being updated.", "location": "query", "type": "string", "format": "google-fieldmask" } }, "parameterOrder": [ "merchantId", "conversionSourceId" ], "request": { "$ref": "ConversionSource" }, "response": { "$ref": "ConversionSource" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Updates information of an existing conversion source." }, "delete": { "id": "content.conversionsources.delete", "path": "{merchantId}/conversionsources/{conversionSourceId}", "flatPath": "{merchantId}/conversionsources/{conversionSourceId}", "httpMethod": "DELETE", "parameters": { "merchantId": { "description": "Required. The ID of the account that owns the new conversion source.", "location": "path", "required": true, "type": "string", "format": "int64" }, "conversionSourceId": { "description": "Required. The ID of the conversion source to be deleted.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "merchantId", "conversionSourceId" ], "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Archives an existing conversion source. It will be recoverable for 30 days. This archiving behavior is not typical in the Content API and unique to this service." }, "undelete": { "id": "content.conversionsources.undelete", "path": "{merchantId}/conversionsources/{conversionSourceId}:undelete", "flatPath": "{merchantId}/conversionsources/{conversionSourceId}:undelete", "httpMethod": "POST", "parameters": { "merchantId": { "description": "Required. The ID of the account that owns the new conversion source.", "location": "path", "required": true, "type": "string", "format": "int64" }, "conversionSourceId": { "description": "Required. The ID of the conversion source to be undeleted.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "merchantId", "conversionSourceId" ], "request": { "$ref": "UndeleteConversionSourceRequest" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Re-enables an archived conversion source." }, "get": { "id": "content.conversionsources.get", "path": "{merchantId}/conversionsources/{conversionSourceId}", "flatPath": "{merchantId}/conversionsources/{conversionSourceId}", "httpMethod": "GET", "parameters": { "merchantId": { "description": "Required. The ID of the account that owns the new conversion source.", "location": "path", "required": true, "type": "string", "format": "int64" }, "conversionSourceId": { "description": "Required. The REST ID of the collection.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "merchantId", "conversionSourceId" ], "response": { "$ref": "ConversionSource" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Fetches a conversion source." }, "list": { "id": "content.conversionsources.list", "path": "{merchantId}/conversionsources", "flatPath": "{merchantId}/conversionsources", "httpMethod": "GET", "parameters": { "merchantId": { "description": "Required. The ID of the account that owns the new conversion source.", "location": "path", "required": true, "type": "string", "format": "int64" }, "pageSize": { "description": "The maximum number of conversion sources to return in a page. If no `page_size` is specified, `100` is used as the default value. The maximum value is `200`. Values above `200` will be coerced to `200`. Regardless of pagination, at most `200` conversion sources are returned in total.", "location": "query", "type": "integer", "format": "int32" }, "pageToken": { "description": "Page token.", "location": "query", "type": "string" }, "showDeleted": { "description": "If true, also returns archived conversion sources.", "location": "query", "type": "boolean" } }, "parameterOrder": [ "merchantId" ], "response": { "$ref": "ListConversionSourcesResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Retrieves the list of conversion sources the caller has access to." } } }, "buyongoogleprograms": { "methods": { "get": { "id": "content.buyongoogleprograms.get", "path": "{merchantId}/buyongoogleprograms/{regionCode}", "flatPath": "{merchantId}/buyongoogleprograms/{regionCode}", "httpMethod": "GET", "parameters": { "merchantId": { "description": "Required. The ID of the account.", "location": "path", "required": true, "type": "string", "format": "int64" }, "regionCode": { "description": "Required. The Program region code [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). Currently only US is available.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "merchantId", "regionCode" ], "response": { "$ref": "BuyOnGoogleProgramStatus" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Retrieves a status of the BoG program for your Merchant Center account." }, "patch": { "id": "content.buyongoogleprograms.patch", "path": "{merchantId}/buyongoogleprograms/{regionCode}", "flatPath": "{merchantId}/buyongoogleprograms/{regionCode}", "httpMethod": "PATCH", "parameters": { "merchantId": { "description": "Required. The ID of the account.", "location": "path", "required": true, "type": "string", "format": "int64" }, "regionCode": { "description": "Required. The program region code [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). Currently only US is available.", "location": "path", "required": true, "type": "string" }, "updateMask": { "description": "The list of fields to update. If the update mask is not provided, then all the fields set in buyOnGoogleProgramStatus will be updated. Clearing fields is only possible if update mask is provided.", "location": "query", "type": "string", "format": "google-fieldmask" } }, "parameterOrder": [ "merchantId", "regionCode" ], "request": { "$ref": "BuyOnGoogleProgramStatus" }, "response": { "$ref": "BuyOnGoogleProgramStatus" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Updates the status of the BoG program for your Merchant Center account." }, "onboard": { "id": "content.buyongoogleprograms.onboard", "path": "{merchantId}/buyongoogleprograms/{regionCode}/onboard", "flatPath": "{merchantId}/buyongoogleprograms/{regionCode}/onboard", "httpMethod": "POST", "parameters": { "merchantId": { "description": "Required. The ID of the account.", "location": "path", "required": true, "type": "string", "format": "int64" }, "regionCode": { "description": "Required. The program region code [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). Currently only US is available.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "merchantId", "regionCode" ], "request": { "$ref": "OnboardBuyOnGoogleProgramRequest" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Onboards the BoG program in your Merchant Center account. By using this method, you agree to the [Terms of Service](https://merchants.google.com/mc/termsofservice/transactions/US/latest). Calling this method is only possible if the authenticated account is the same as the merchant id in the request. Calling this method multiple times will only accept Terms of Service if the latest version is not currently signed." }, "requestreview": { "id": "content.buyongoogleprograms.requestreview", "path": "{merchantId}/buyongoogleprograms/{regionCode}/requestreview", "flatPath": "{merchantId}/buyongoogleprograms/{regionCode}/requestreview", "httpMethod": "POST", "parameters": { "merchantId": { "description": "Required. The ID of the account.", "location": "path", "required": true, "type": "string", "format": "int64" }, "regionCode": { "description": "Required. The program region code [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). Currently only US is available.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "merchantId", "regionCode" ], "request": { "$ref": "RequestReviewBuyOnGoogleProgramRequest" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Requests review and then activates the BoG program in your Merchant Center account for the first time. Moves the program to the REVIEW_PENDING state. This method is only available to selected merchants." }, "activate": { "id": "content.buyongoogleprograms.activate", "path": "{merchantId}/buyongoogleprograms/{regionCode}/activate", "flatPath": "{merchantId}/buyongoogleprograms/{regionCode}/activate", "httpMethod": "POST", "parameters": { "merchantId": { "description": "Required. The ID of the account.", "location": "path", "required": true, "type": "string", "format": "int64" }, "regionCode": { "description": "Required. The program region code [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). Currently only US is available.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "merchantId", "regionCode" ], "request": { "$ref": "ActivateBuyOnGoogleProgramRequest" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Reactivates the BoG program in your Merchant Center account. Moves the program to the active state when allowed, for example, when paused. This method is only available to selected merchants." }, "pause": { "id": "content.buyongoogleprograms.pause", "path": "{merchantId}/buyongoogleprograms/{regionCode}/pause", "flatPath": "{merchantId}/buyongoogleprograms/{regionCode}/pause", "httpMethod": "POST", "parameters": { "merchantId": { "description": "Required. The ID of the account.", "location": "path", "required": true, "type": "string", "format": "int64" }, "regionCode": { "description": "Required. The program region code [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). Currently only US is available.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "merchantId", "regionCode" ], "request": { "$ref": "PauseBuyOnGoogleProgramRequest" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Pauses the BoG program in your Merchant Center account. This method is only available to selected merchants." } } }, "freelistingsprogram": { "methods": { "get": { "id": "content.freelistingsprogram.get", "path": "{merchantId}/freelistingsprogram", "flatPath": "{merchantId}/freelistingsprogram", "httpMethod": "GET", "parameters": { "merchantId": { "description": "Required. The ID of the account.", "location": "path", "required": true, "type": "string", "format": "int64" } }, "parameterOrder": [ "merchantId" ], "response": { "$ref": "FreeListingsProgramStatus" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Retrieves the status and review eligibility for the free listing program. Returns errors and warnings if they require action to resolve, will become disapprovals, or impact impressions. Use `accountstatuses` to view all issues for an account." }, "requestreview": { "id": "content.freelistingsprogram.requestreview", "path": "{merchantId}/freelistingsprogram/requestreview", "flatPath": "{merchantId}/freelistingsprogram/requestreview", "httpMethod": "POST", "parameters": { "merchantId": { "description": "Required. The ID of the account.", "location": "path", "required": true, "type": "string", "format": "int64" } }, "parameterOrder": [ "merchantId" ], "request": { "$ref": "RequestReviewFreeListingsRequest" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Requests a review of free listings in a specific region. This method deprecated. Use the `MerchantSupportService` to view product and account issues and request a review." } }, "resources": { "checkoutsettings": { "methods": { "get": { "id": "content.freelistingsprogram.checkoutsettings.get", "path": "{merchantId}/freelistingsprogram/checkoutsettings", "flatPath": "{merchantId}/freelistingsprogram/checkoutsettings", "httpMethod": "GET", "parameters": { "merchantId": { "description": "Required. The ID of the account.", "location": "path", "required": true, "type": "string", "format": "int64" } }, "parameterOrder": [ "merchantId" ], "response": { "$ref": "CheckoutSettings" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Gets Checkout settings for the given merchant. This includes information about review state, enrollment state and URL settings." }, "insert": { "id": "content.freelistingsprogram.checkoutsettings.insert", "path": "{merchantId}/freelistingsprogram/checkoutsettings", "flatPath": "{merchantId}/freelistingsprogram/checkoutsettings", "httpMethod": "POST", "parameters": { "merchantId": { "description": "Required. The ID of the account.", "location": "path", "required": true, "type": "string", "format": "int64" } }, "parameterOrder": [ "merchantId" ], "request": { "$ref": "InsertCheckoutSettingsRequest" }, "response": { "$ref": "CheckoutSettings" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Enrolls merchant in `Checkout` program." }, "delete": { "id": "content.freelistingsprogram.checkoutsettings.delete", "path": "{merchantId}/freelistingsprogram/checkoutsettings", "flatPath": "{merchantId}/freelistingsprogram/checkoutsettings", "httpMethod": "DELETE", "parameters": { "merchantId": { "description": "Required. The ID of the account.", "location": "path", "required": true, "type": "string", "format": "int64" } }, "parameterOrder": [ "merchantId" ], "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Deletes `Checkout` settings and unenrolls merchant from `Checkout` program." } } } } }, "shoppingadsprogram": { "methods": { "get": { "id": "content.shoppingadsprogram.get", "path": "{merchantId}/shoppingadsprogram", "flatPath": "{merchantId}/shoppingadsprogram", "httpMethod": "GET", "parameters": { "merchantId": { "description": "Required. The ID of the account.", "location": "path", "required": true, "type": "string", "format": "int64" } }, "parameterOrder": [ "merchantId" ], "response": { "$ref": "ShoppingAdsProgramStatus" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Retrieves the status and review eligibility for the Shopping Ads program. Returns errors and warnings if they require action to resolve, will become disapprovals, or impact impressions. Use `accountstatuses` to view all issues for an account." }, "requestreview": { "id": "content.shoppingadsprogram.requestreview", "path": "{merchantId}/shoppingadsprogram/requestreview", "flatPath": "{merchantId}/shoppingadsprogram/requestreview", "httpMethod": "POST", "parameters": { "merchantId": { "description": "Required. The ID of the account.", "location": "path", "required": true, "type": "string", "format": "int64" } }, "parameterOrder": [ "merchantId" ], "request": { "$ref": "RequestReviewShoppingAdsRequest" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Requests a review of Shopping ads in a specific region. This method deprecated. Use the `MerchantSupportService` to view product and account issues and request a review." } } }, "csses": { "methods": { "list": { "id": "content.csses.list", "path": "{cssGroupId}/csses", "flatPath": "{cssGroupId}/csses", "httpMethod": "GET", "parameters": { "cssGroupId": { "description": "Required. The CSS group ID of CSS domains to be listed.", "location": "path", "required": true, "type": "string", "format": "int64" }, "pageSize": { "description": "The maximum number of CSS domains to return. The service may return fewer than this value. If unspecified, at most 50 CSS domains will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.", "location": "query", "type": "integer", "format": "int32" }, "pageToken": { "description": "A page token, received from a previous `ListCsses` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListCsses` must match the call that provided the page token.", "location": "query", "type": "string" } }, "parameterOrder": [ "cssGroupId" ], "response": { "$ref": "ListCssesResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Lists CSS domains affiliated with a CSS group." }, "get": { "id": "content.csses.get", "path": "{cssGroupId}/csses/{cssDomainId}", "flatPath": "{cssGroupId}/csses/{cssDomainId}", "httpMethod": "GET", "parameters": { "cssGroupId": { "description": "Required. The ID of the managing account. If this parameter is not the same as [cssDomainId](#cssDomainId), then this ID must be a CSS group ID and `cssDomainId` must be the ID of a CSS domain affiliated with this group.", "location": "path", "required": true, "type": "string", "format": "int64" }, "cssDomainId": { "description": "Required. The ID of the CSS domain to return.", "location": "path", "required": true, "type": "string", "format": "int64" } }, "parameterOrder": [ "cssGroupId", "cssDomainId" ], "response": { "$ref": "Css" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Retrieves a single CSS domain by ID." }, "updatelabels": { "id": "content.csses.updatelabels", "path": "{cssGroupId}/csses/{cssDomainId}/updatelabels", "flatPath": "{cssGroupId}/csses/{cssDomainId}/updatelabels", "httpMethod": "POST", "parameters": { "cssGroupId": { "description": "Required. The CSS group ID of the updated CSS domain.", "location": "path", "required": true, "type": "string", "format": "int64" }, "cssDomainId": { "description": "Required. The ID of the updated CSS domain.", "location": "path", "required": true, "type": "string", "format": "int64" } }, "parameterOrder": [ "cssGroupId", "cssDomainId" ], "request": { "$ref": "LabelIds" }, "response": { "$ref": "Css" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Updates labels that are assigned to a CSS domain by its CSS group." } } }, "reports": { "methods": { "search": { "id": "content.reports.search", "path": "{merchantId}/reports/search", "flatPath": "{merchantId}/reports/search", "httpMethod": "POST", "parameters": { "merchantId": { "description": "Required. Id of the merchant making the call. Must be a standalone account or an MCA subaccount.", "location": "path", "required": true, "type": "string", "format": "int64" } }, "parameterOrder": [ "merchantId" ], "request": { "$ref": "SearchRequest" }, "response": { "$ref": "SearchResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Retrieves merchant performance metrics matching the search query and optionally segmented by selected dimensions." } } }, "merchantsupport": { "methods": { "renderaccountissues": { "id": "content.merchantsupport.renderaccountissues", "path": "{merchantId}/merchantsupport/renderaccountissues", "flatPath": "{merchantId}/merchantsupport/renderaccountissues", "httpMethod": "POST", "parameters": { "merchantId": { "description": "Required. The ID of the account to fetch issues for.", "location": "path", "required": true, "type": "string", "format": "int64" }, "languageCode": { "description": "Optional. The [IETF BCP-47](https://tools.ietf.org/html/bcp47) language code used to localize support content. If not set, the result will be in default language `en-US`.", "location": "query", "type": "string" }, "timeZone": { "description": "Optional. The [IANA](https://www.iana.org/time-zones) timezone used to localize times in support content. For example 'America/Los_Angeles'. If not set, results will use as a default UTC.", "location": "query", "type": "string" } }, "parameterOrder": [ "merchantId" ], "request": { "$ref": "RenderAccountIssuesRequestPayload" }, "response": { "$ref": "RenderAccountIssuesResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Provide a list of merchant's issues with a support content and available actions. This content and actions are meant to be rendered and shown in third-party applications." }, "renderproductissues": { "id": "content.merchantsupport.renderproductissues", "path": "{merchantId}/merchantsupport/renderproductissues/{productId}", "flatPath": "{merchantId}/merchantsupport/renderproductissues/{productId}", "httpMethod": "POST", "parameters": { "merchantId": { "description": "Required. The ID of the account that contains the product.", "location": "path", "required": true, "type": "string", "format": "int64" }, "productId": { "description": "Required. The [REST_ID](https://developers.google.com/shopping-content/reference/rest/v2.1/products#Product.FIELDS.id) of the product to fetch issues for.", "location": "path", "required": true, "type": "string" }, "languageCode": { "description": "Optional. The [IETF BCP-47](https://tools.ietf.org/html/bcp47) language code used to localize support content. If not set, the result will be in default language `en-US`.", "location": "query", "type": "string" }, "timeZone": { "description": "Optional. The [IANA](https://www.iana.org/time-zones) timezone used to localize times in support content. For example 'America/Los_Angeles'. If not set, results will use as a default UTC.", "location": "query", "type": "string" } }, "parameterOrder": [ "merchantId", "productId" ], "request": { "$ref": "RenderProductIssuesRequestPayload" }, "response": { "$ref": "RenderProductIssuesResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Provide a list of issues for merchant's product with a support content and available actions. This content and actions are meant to be rendered and shown in third-party applications." }, "triggeraction": { "id": "content.merchantsupport.triggeraction", "path": "{merchantId}/merchantsupport/triggeraction", "flatPath": "{merchantId}/merchantsupport/triggeraction", "httpMethod": "POST", "parameters": { "merchantId": { "description": "Required. The ID of the merchant's account.", "location": "path", "required": true, "type": "string", "format": "int64" }, "languageCode": { "description": "Optional. Language code [IETF BCP 47 syntax](https://tools.ietf.org/html/bcp47) used to localize the response. If not set, the result will be in default language `en-US`.", "location": "query", "type": "string" } }, "parameterOrder": [ "merchantId" ], "request": { "$ref": "TriggerActionPayload" }, "response": { "$ref": "TriggerActionResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Start an action. The action can be requested by merchants in third-party application. Before merchants can request the action, the third-party application needs to show them action specific content and display a user input form. The action can be successfully started only once all `required` inputs are provided. If any `required` input is missing, or invalid value was provided, the service will return 400 error. Validation errors will contain Ids for all problematic field together with translated, human readable error messages that can be shown to the user." } } }, "regions": { "methods": { "get": { "id": "content.regions.get", "path": "{merchantId}/regions/{regionId}", "flatPath": "{merchantId}/regions/{regionId}", "httpMethod": "GET", "parameters": { "merchantId": { "description": "Required. The id of the merchant for which to retrieve region definition.", "location": "path", "required": true, "type": "string", "format": "int64" }, "regionId": { "description": "Required. The id of the region to retrieve.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "merchantId", "regionId" ], "response": { "$ref": "Region" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Retrieves a region defined in your Merchant Center account." }, "create": { "id": "content.regions.create", "path": "{merchantId}/regions", "flatPath": "{merchantId}/regions", "httpMethod": "POST", "parameters": { "merchantId": { "description": "Required. The id of the merchant for which to create region definition.", "location": "path", "required": true, "type": "string", "format": "int64" }, "regionId": { "description": "Required. The id of the region to create.", "location": "query", "type": "string" } }, "parameterOrder": [ "merchantId" ], "request": { "$ref": "Region" }, "response": { "$ref": "Region" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Creates a region definition in your Merchant Center account." }, "patch": { "id": "content.regions.patch", "path": "{merchantId}/regions/{regionId}", "flatPath": "{merchantId}/regions/{regionId}", "httpMethod": "PATCH", "parameters": { "merchantId": { "description": "Required. The id of the merchant for which to update region definition.", "location": "path", "required": true, "type": "string", "format": "int64" }, "regionId": { "description": "Required. The id of the region to update.", "location": "path", "required": true, "type": "string" }, "updateMask": { "description": "Optional. The comma-separated field mask indicating the fields to update. Example: `\"displayName,postalCodeArea.regionCode\"`.", "location": "query", "type": "string", "format": "google-fieldmask" } }, "parameterOrder": [ "merchantId", "regionId" ], "request": { "$ref": "Region" }, "response": { "$ref": "Region" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Updates a region definition in your Merchant Center account." }, "delete": { "id": "content.regions.delete", "path": "{merchantId}/regions/{regionId}", "flatPath": "{merchantId}/regions/{regionId}", "httpMethod": "DELETE", "parameters": { "merchantId": { "description": "Required. The id of the merchant for which to delete region definition.", "location": "path", "required": true, "type": "string", "format": "int64" }, "regionId": { "description": "Required. The id of the region to delete.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "merchantId", "regionId" ], "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Deletes a region definition from your Merchant Center account." }, "list": { "id": "content.regions.list", "path": "{merchantId}/regions", "flatPath": "{merchantId}/regions", "httpMethod": "GET", "parameters": { "merchantId": { "description": "Required. The id of the merchant for which to list region definitions.", "location": "path", "required": true, "type": "string", "format": "int64" }, "pageSize": { "description": "The maximum number of regions to return. The service may return fewer than this value. If unspecified, at most 50 rules will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.", "location": "query", "type": "integer", "format": "int32" }, "pageToken": { "description": "A page token, received from a previous `ListRegions` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListRegions` must match the call that provided the page token.", "location": "query", "type": "string" } }, "parameterOrder": [ "merchantId" ], "response": { "$ref": "ListRegionsResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Lists the regions in your Merchant Center account." } } }, "promotions": { "methods": { "create": { "id": "content.promotions.create", "path": "{merchantId}/promotions", "flatPath": "{merchantId}/promotions", "httpMethod": "POST", "parameters": { "merchantId": { "description": "Required. The ID of the account that contains the collection.", "location": "path", "required": true, "type": "string", "format": "int64" } }, "parameterOrder": [ "merchantId" ], "request": { "$ref": "Promotion" }, "response": { "$ref": "Promotion" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Inserts a promotion for your Merchant Center account. If the promotion already exists, then it updates the promotion instead. To [end or delete] (https://developers.google.com/shopping-content/guides/promotions#end_a_promotion) a promotion update the time period of the promotion to a time that has already passed." }, "get": { "id": "content.promotions.get", "path": "{merchantId}/promotions/{id}", "flatPath": "{merchantId}/promotions/{id}", "httpMethod": "GET", "parameters": { "merchantId": { "description": "Required. The ID of the account that contains the collection.", "location": "path", "required": true, "type": "string", "format": "int64" }, "id": { "description": "Required. REST ID of the promotion to retrieve.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "merchantId", "id" ], "response": { "$ref": "Promotion" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Retrieves a promotion from your Merchant Center account." }, "list": { "id": "content.promotions.list", "path": "{merchantId}/promotions", "flatPath": "{merchantId}/promotions", "httpMethod": "GET", "parameters": { "merchantId": { "description": "Required. The ID of the account that contains the collection.", "location": "path", "required": true, "type": "string", "format": "int64" }, "pageSize": { "description": "The maximum number of promotions to return. The service may return fewer than this value. If unspecified, at most 50 labels will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.", "location": "query", "type": "integer", "format": "int32" }, "pageToken": { "description": "A page token, received from a previous `ListPromotion` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListPromotion` must match the call that provided the page token.", "location": "query", "type": "string" }, "countryCode": { "description": "[CLDR country code](http://www.unicode.org/repos/cldr/tags/latest/common/main/en.xml) (for example, \"US\"), used as a filter on promotions target country.", "location": "query", "type": "string" }, "languageCode": { "description": "The two-letter ISO 639-1 language code associated with the promotions, used as a filter.", "location": "query", "type": "string" } }, "parameterOrder": [ "merchantId" ], "response": { "$ref": "ListPromotionResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "List all promotions from your Merchant Center account." } } }, "recommendations": { "methods": { "generate": { "id": "content.recommendations.generate", "path": "{merchantId}/recommendations/generate", "flatPath": "{merchantId}/recommendations/generate", "httpMethod": "GET", "parameters": { "merchantId": { "description": "Required. The ID of the account to fetch recommendations for.", "location": "path", "required": true, "type": "string", "format": "int64" }, "languageCode": { "description": "Optional. Language code of the client. If not set, the result will be in default language (English). This language code affects all fields prefixed with \"localized\". This should be set to ISO 639-1 country code. List of currently verified supported language code: en, fr, cs, da, de, es, it, nl, no, pl, pt, pt, fi, sv, vi, tr, th, ko, zh-CN, zh-TW, ja, id, hi", "location": "query", "type": "string" }, "allowedTag": { "description": "Optional. List of allowed tags. Tags are a set of predefined strings that describe the category that individual recommendation types belong to. User can specify zero or more tags in this field to indicate what categories of recommendations they want to receive. Current list of supported tags: - TREND", "location": "query", "repeated": true, "type": "string" } }, "parameterOrder": [ "merchantId" ], "response": { "$ref": "GenerateRecommendationsResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Generates recommendations for a merchant." }, "reportInteraction": { "id": "content.recommendations.reportInteraction", "path": "{merchantId}/recommendations/reportInteraction", "flatPath": "{merchantId}/recommendations/reportInteraction", "httpMethod": "POST", "parameters": { "merchantId": { "description": "Required. The ID of the account that wants to report an interaction.", "location": "path", "required": true, "type": "string", "format": "int64" } }, "parameterOrder": [ "merchantId" ], "request": { "$ref": "ReportInteractionRequest" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Reports an interaction on a recommendation for a merchant." } } }, "returnpolicyonline": { "methods": { "get": { "id": "content.returnpolicyonline.get", "path": "{merchantId}/returnpolicyonline/{returnPolicyId}", "flatPath": "{merchantId}/returnpolicyonline/{returnPolicyId}", "httpMethod": "GET", "parameters": { "merchantId": { "description": "Required. The id of the merchant for which to retrieve the return policy online object.", "location": "path", "required": true, "type": "string", "format": "int64" }, "returnPolicyId": { "description": "Required. The id of the return policy to retrieve.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "merchantId", "returnPolicyId" ], "response": { "$ref": "ReturnPolicyOnline" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Gets an existing return policy." }, "create": { "id": "content.returnpolicyonline.create", "path": "{merchantId}/returnpolicyonline", "flatPath": "{merchantId}/returnpolicyonline", "httpMethod": "POST", "parameters": { "merchantId": { "description": "Required. The id of the merchant for which to retrieve the return policy online object.", "location": "path", "required": true, "type": "string", "format": "int64" } }, "parameterOrder": [ "merchantId" ], "request": { "$ref": "ReturnPolicyOnline" }, "response": { "$ref": "ReturnPolicyOnline" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Creates a new return policy." }, "delete": { "id": "content.returnpolicyonline.delete", "path": "{merchantId}/returnpolicyonline/{returnPolicyId}", "flatPath": "{merchantId}/returnpolicyonline/{returnPolicyId}", "httpMethod": "DELETE", "parameters": { "merchantId": { "description": "Required. The id of the merchant for which to retrieve the return policy online object.", "location": "path", "required": true, "type": "string", "format": "int64" }, "returnPolicyId": { "description": "Required. The id of the return policy to delete.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "merchantId", "returnPolicyId" ], "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Deletes an existing return policy." }, "patch": { "id": "content.returnpolicyonline.patch", "path": "{merchantId}/returnpolicyonline/{returnPolicyId}", "flatPath": "{merchantId}/returnpolicyonline/{returnPolicyId}", "httpMethod": "PATCH", "parameters": { "merchantId": { "description": "Required. The id of the merchant for which to retrieve the return policy online object.", "location": "path", "required": true, "type": "string", "format": "int64" }, "returnPolicyId": { "description": "Required. The id of the return policy to update.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "merchantId", "returnPolicyId" ], "request": { "$ref": "ReturnPolicyOnline" }, "response": { "$ref": "ReturnPolicyOnline" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Updates an existing return policy." }, "list": { "id": "content.returnpolicyonline.list", "path": "{merchantId}/returnpolicyonline", "flatPath": "{merchantId}/returnpolicyonline", "httpMethod": "GET", "parameters": { "merchantId": { "description": "Required. The id of the merchant for which to retrieve the return policy online object.", "location": "path", "required": true, "type": "string", "format": "int64" } }, "parameterOrder": [ "merchantId" ], "response": { "$ref": "ListReturnPolicyOnlineResponse" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Lists all existing return policies." } } }, "ordertrackingsignals": { "methods": { "create": { "id": "content.ordertrackingsignals.create", "path": "{merchantId}/ordertrackingsignals", "flatPath": "{merchantId}/ordertrackingsignals", "httpMethod": "POST", "parameters": { "merchantId": { "description": "The ID of the merchant for which the order signal is created.", "location": "path", "required": true, "type": "string", "format": "int64" } }, "parameterOrder": [ "merchantId" ], "request": { "$ref": "OrderTrackingSignal" }, "response": { "$ref": "OrderTrackingSignal" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Creates new order tracking signal." } } }, "productdeliverytime": { "methods": { "create": { "id": "content.productdeliverytime.create", "path": "{merchantId}/productdeliverytime", "flatPath": "{merchantId}/productdeliverytime", "httpMethod": "POST", "parameters": { "merchantId": { "description": "The Google merchant ID of the account that contains the product. This account cannot be a multi-client account.", "location": "path", "required": true, "type": "string", "format": "int64" } }, "parameterOrder": [ "merchantId" ], "request": { "$ref": "ProductDeliveryTime" }, "response": { "$ref": "ProductDeliveryTime" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Creates or updates the delivery time of a product." }, "get": { "id": "content.productdeliverytime.get", "path": "{merchantId}/productdeliverytime/{productId}", "flatPath": "{merchantId}/productdeliverytime/{productId}", "httpMethod": "GET", "parameters": { "merchantId": { "description": "Required. The Google merchant ID of the account that contains the product. This account cannot be a multi-client account.", "location": "path", "required": true, "type": "string", "format": "int64" }, "productId": { "description": "Required. The Content API ID of the product, in the form `channel:contentLanguage:targetCountry:offerId`.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "merchantId", "productId" ], "response": { "$ref": "ProductDeliveryTime" }, "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Gets `productDeliveryTime` by `productId`." }, "delete": { "id": "content.productdeliverytime.delete", "path": "{merchantId}/productdeliverytime/{productId}", "flatPath": "{merchantId}/productdeliverytime/{productId}", "httpMethod": "DELETE", "parameters": { "merchantId": { "description": "Required. The Google merchant ID of the account that contains the product. This account cannot be a multi-client account.", "location": "path", "required": true, "type": "string", "format": "int64" }, "productId": { "description": "Required. The Content API ID of the product, in the form `channel:contentLanguage:targetCountry:offerId`.", "location": "path", "required": true, "type": "string" } }, "parameterOrder": [ "merchantId", "productId" ], "scopes": [ "https://www.googleapis.com/auth/content" ], "description": "Deletes the delivery time of a product." } } } }, "description": "Manage your product listings and accounts for Google Shopping", "servicePath": "content/v2.1/", "id": "content:v2.1", "protocol": "rest", "rootUrl": "https://shoppingcontent.googleapis.com/", "baseUrl": "https://shoppingcontent.googleapis.com/content/v2.1/", "ownerName": "Google", "discoveryVersion": "v1", "kind": "discovery#restDescription", "canonicalName": "Shopping Content", "name": "content", "parameters": { "access_token": { "type": "string", "description": "OAuth access token.", "location": "query" }, "alt": { "type": "string", "description": "Data format for response.", "default": "json", "enum": [ "json", "media", "proto" ], "enumDescriptions": [ "Responses with Content-Type of application/json", "Media download with context-dependent Content-Type", "Responses with Content-Type of application/x-protobuf" ], "location": "query" }, "callback": { "type": "string", "description": "JSONP", "location": "query" }, "fields": { "type": "string", "description": "Selector specifying which fields to include in a partial response.", "location": "query" }, "key": { "type": "string", "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" }, "oauth_token": { "type": "string", "description": "OAuth 2.0 token for the current user.", "location": "query" }, "prettyPrint": { "type": "boolean", "description": "Returns response with indentations and line breaks.", "default": "true", "location": "query" }, "quotaUser": { "type": "string", "description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.", "location": "query" }, "upload_protocol": { "type": "string", "description": "Upload protocol for media (e.g. \"raw\", \"multipart\").", "location": "query" }, "uploadType": { "type": "string", "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").", "location": "query" }, "$.xgafv": { "type": "string", "description": "V1 error format.", "enum": [ "1", "2" ], "enumDescriptions": [ "v1 error format", "v2 error format" ], "location": "query" } }, "basePath": "/content/v2.1/", "revision": "20240423", "mtlsRootUrl": "https://shoppingcontent.mtls.googleapis.com/", "version": "v2.1", "icons": { "x16": "http://www.google.com/images/icons/product/search-16.gif", "x32": "http://www.google.com/images/icons/product/search-32.gif" }, "batchPath": "batch", "ownerDomain": "google.com", "fullyEncodeReservedExpansion": true, "documentationLink": "https://developers.google.com/shopping-content/v2/", "auth": { "oauth2": { "scopes": { "https://www.googleapis.com/auth/content": { "description": "Manage your product listings and accounts for Google Shopping" } } } }, "title": "Content API for Shopping", "schemas": { "AccountsAuthInfoResponse": { "id": "AccountsAuthInfoResponse", "type": "object", "properties": { "accountIdentifiers": { "description": "The account identifiers corresponding to the authenticated user. - For an individual account: only the merchant ID is defined - For an aggregator: only the aggregator ID is defined - For a subaccount of an MCA: both the merchant ID and the aggregator ID are defined. ", "type": "array", "items": { "$ref": "AccountIdentifier" } }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#accountsAuthInfoResponse`\".", "type": "string" } } }, "AccountIdentifier": { "id": "AccountIdentifier", "type": "object", "properties": { "aggregatorId": { "description": "The aggregator ID, set for aggregators and subaccounts (in that case, it represents the aggregator of the subaccount).", "type": "string", "format": "uint64" }, "merchantId": { "description": "The merchant account ID, set for individual accounts and subaccounts.", "type": "string", "format": "uint64" } } }, "AccountsClaimWebsiteResponse": { "id": "AccountsClaimWebsiteResponse", "type": "object", "properties": { "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#accountsClaimWebsiteResponse`\".", "type": "string" } } }, "AccountsCustomBatchRequest": { "id": "AccountsCustomBatchRequest", "type": "object", "properties": { "entries": { "description": "The request entries to be processed in the batch.", "type": "array", "items": { "$ref": "AccountsCustomBatchRequestEntry" } } } }, "AccountsCustomBatchRequestEntry": { "id": "AccountsCustomBatchRequestEntry", "description": "A batch entry encoding a single non-batch accounts request.", "type": "object", "properties": { "batchId": { "description": "An entry ID, unique within the batch request.", "type": "integer", "format": "uint32" }, "merchantId": { "description": "The ID of the managing account.", "type": "string", "format": "uint64" }, "method": { "description": "The method of the batch entry. Acceptable values are: - \"`claimWebsite`\" - \"`delete`\" - \"`get`\" - \"`insert`\" - \"`link`\" - \"`update`\" ", "type": "string" }, "accountId": { "description": "The ID of the targeted account. Only defined if the method is not `insert`.", "type": "string", "format": "uint64" }, "account": { "description": "The account to create or update. Only defined if the method is `insert` or `update`.", "$ref": "Account" }, "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" }, "force": { "description": "Whether the account should be deleted if the account has offers. Only applicable if the method is `delete`.", "type": "boolean" }, "linkRequest": { "description": "Details about the `link` request.", "$ref": "AccountsCustomBatchRequestEntryLinkRequest" }, "view": { "description": "Controls which fields are visible. Only applicable if the method is 'get'.", "type": "string" }, "labelIds": { "description": "Label IDs for the 'updatelabels' request.", "type": "array", "items": { "type": "string", "format": "uint64" } } } }, "Account": { "id": "Account", "description": "Account data. After the creation of a new account it may take a few minutes before it's fully operational. The methods delete, insert, and update require the admin role.", "type": "object", "properties": { "name": { "description": "Required. Display name for the account.", "type": "string" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#account`\".", "type": "string" }, "websiteUrl": { "description": "The merchant's website.", "type": "string" }, "adultContent": { "description": "Indicates whether the merchant sells adult content.", "type": "boolean" }, "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.", "type": "array", "items": { "$ref": "AccountUser" } }, "id": { "description": "Required. 64-bit Merchant Center account ID.", "type": "string", "format": "uint64" }, "youtubeChannelLinks": { "description": "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.", "type": "array", "items": { "$ref": "AccountYouTubeChannelLink" } }, "googleMyBusinessLink": { "description": "The Business Profile which is linked or in the process of being linked with the Merchant Center account.", "$ref": "AccountGoogleMyBusinessLink" }, "businessInformation": { "description": "The business information of the account.", "$ref": "AccountBusinessInformation" }, "businessIdentity": { "description": "The business identity attributes can be used to self-declare attributes that let customers know more about your business.", "$ref": "AccountBusinessIdentity" }, "automaticImprovements": { "description": "The automatic improvements of the account can be used to automatically update items, improve images and shipping. Each section inside AutomaticImprovements is updated separately.", "$ref": "AccountAutomaticImprovements" }, "adsLinks": { "description": "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 Google Ads API. To delete an active link, or to cancel a link request, remove it from the list.", "type": "array", "items": { "$ref": "AccountAdsLink" } }, "cssId": { "description": "ID of CSS the account belongs to.", "type": "string", "format": "uint64" }, "labelIds": { "description": "Manually created label IDs that are assigned to the account by CSS.", "type": "array", "items": { "type": "string", "format": "uint64" } }, "accountManagement": { "description": "Output only. How the account is managed. Acceptable values are: - \"`manual`\" - \"`automatic`\" ", "readOnly": true, "type": "string" }, "automaticLabelIds": { "description": "Automatically created label IDs that are assigned to the account by CSS Center.", "type": "array", "items": { "type": "string", "format": "uint64" } }, "conversionSettings": { "description": "Settings for conversion tracking.", "$ref": "AccountConversionSettings" } } }, "AccountUser": { "id": "AccountUser", "type": "object", "properties": { "emailAddress": { "description": "User's email address.", "type": "string" }, "admin": { "description": "Whether user is an admin.", "type": "boolean" }, "orderManager": { "description": "Whether user is an order manager.", "type": "boolean" }, "paymentsManager": { "description": "Whether user can manage payment settings.", "type": "boolean" }, "paymentsAnalyst": { "description": "Whether user can access payment statements.", "type": "boolean" }, "reportingManager": { "description": "Whether user is a reporting manager. This role is equivalent to the Performance and insights role in Merchant Center.", "type": "boolean" } } }, "AccountYouTubeChannelLink": { "id": "AccountYouTubeChannelLink", "type": "object", "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" } } }, "AccountGoogleMyBusinessLink": { "id": "AccountGoogleMyBusinessLink", "type": "object", "properties": { "gmbEmail": { "description": "The Business Profile email address of a specific account within a Business Profile. A sample account within a Business Profile could be a business account with set of locations, managed under the Business Profile.", "type": "string" }, "status": { "description": "Status of the link between this Merchant Center account and the Business Profile. Acceptable values are: - \"`active`\" - \"`pending`\" ", "type": "string" }, "gmbAccountId": { "description": "The ID of the Business Profile. If this is provided, then `gmbEmail` is ignored. The value of this field should match the `accountId` used by the Business Profile API.", "type": "string" } } }, "AccountBusinessInformation": { "id": "AccountBusinessInformation", "type": "object", "properties": { "address": { "description": "The address of the business. Use `\\n` to add a second address line.", "$ref": "AccountAddress" }, "phoneNumber": { "description": "The phone number of the business in [E.164](https://en.wikipedia.org/wiki/E.164) format. This can only be updated if a verified phone number is not already set. To replace a verified phone number use the `Accounts.requestphoneverification` and `Accounts.verifyphonenumber`.", "type": "string" }, "phoneVerificationStatus": { "description": "Verification status of the phone number of the business. This status is read only and can be updated only by successful phone verification. Acceptable values are: - \"`verified`\" - \"`unverified`\" ", "type": "string" }, "customerService": { "description": "The customer service information of the business.", "$ref": "AccountCustomerService" }, "koreanBusinessRegistrationNumber": { "description": "The 10-digit [Korean business registration number](https://support.google.com/merchants/answer/9037766) separated with dashes in the format: XXX-XX-XXXXX. This field will only be updated if explicitly set.", "type": "string" } } }, "AccountAddress": { "id": "AccountAddress", "type": "object", "properties": { "streetAddress": { "description": "Street-level part of the address. Use `\\n` to add a second line.", "type": "string" }, "locality": { "description": "City, town or commune. May also include dependent localities or sublocalities (for example, neighborhoods or suburbs).", "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" }, "postalCode": { "description": "Postal code or ZIP (for example, \"94043\").", "type": "string" }, "country": { "description": "CLDR country code (for example, \"US\"). All MCA sub-accounts inherit the country of their parent MCA by default, however the country can be updated for individual sub-accounts.", "type": "string" } } }, "AccountCustomerService": { "id": "AccountCustomerService", "type": "object", "properties": { "url": { "description": "Customer service URL.", "type": "string" }, "email": { "description": "Customer service email.", "type": "string" }, "phoneNumber": { "description": "Customer service phone number.", "type": "string" } } }, "AccountBusinessIdentity": { "id": "AccountBusinessIdentity", "description": "The [business identity attributes](https://support.google.com/merchants/answer/10342414) can be used to self-declare attributes that let customers know more about your business.", "type": "object", "properties": { "blackOwned": { "description": "Specifies whether the business identifies itself as being black-owned. This optional field is only available for merchants with a business country set to \"US\". This field is not allowed for marketplaces or marketplace sellers.", "$ref": "AccountIdentityType" }, "womenOwned": { "description": "Specifies whether the business identifies itself as being women-owned. This optional field is only available for merchants with a business country set to \"US\". This field is not allowed for marketplaces or marketplace sellers.", "$ref": "AccountIdentityType" }, "veteranOwned": { "description": "Specifies whether the business identifies itself as being veteran-owned. This optional field is only available for merchants with a business country set to \"US\". This field is not allowed for marketplaces or marketplace sellers.", "$ref": "AccountIdentityType" }, "latinoOwned": { "description": "Specifies whether the business identifies itself as being latino-owned. This optional field is only available for merchants with a business country set to \"US\". This field is not allowed for marketplaces or marketplace sellers.", "$ref": "AccountIdentityType" }, "smallBusiness": { "description": "Specifies whether the business identifies itself as a small business. This optional field is only available for merchants with a business country set to \"US\". It is also not allowed for marketplaces, but it is allowed to marketplace sellers.", "$ref": "AccountIdentityType" }, "includeForPromotions": { "description": "Required. By setting this field, your business may be included in promotions for all the selected attributes. If you clear this option, it won't affect your identification with any of the attributes. For this field to be set, the merchant must self identify with at least one of the `AccountIdentityType`. If none are included, the request will be considered invalid.", "type": "boolean" } } }, "AccountIdentityType": { "id": "AccountIdentityType", "description": "The account identity type used to specify attributes.", "type": "object", "properties": { "selfIdentified": { "description": "Optional. Indicates that the business identifies itself with a given identity type. Setting this field does not automatically mean eligibility for promotions.", "type": "boolean" } } }, "AccountAutomaticImprovements": { "id": "AccountAutomaticImprovements", "description": "The automatic improvements of the account can be used to automatically update items, improve images and shipping.", "type": "object", "properties": { "itemUpdates": { "description": "Turning on [item updates](https://support.google.com/merchants/answer/3246284) allows Google to automatically update items for you. When item updates are on, Google uses the structured data markup on the website and advanced data extractors to update the price and availability of the items. When the item updates are off, items with mismatched data aren't shown. This field is only updated (cleared) if provided.", "$ref": "AccountItemUpdates" }, "imageImprovements": { "description": "This improvement will attempt to automatically correct submitted images if they don't meet the [image requirements](https://support.google.com/merchants/answer/6324350), for example, removing overlays. If successful, the image will be replaced and approved. This improvement is only applied to images of disapproved offers. For more information see: [Automatic image improvements](https://support.google.com/merchants/answer/9242973) This field is only updated (cleared) if provided.", "$ref": "AccountImageImprovements" }, "shippingImprovements": { "description": "Not available for MCAs [accounts](https://support.google.com/merchants/answer/188487). By turning on [automatic shipping improvements](https://support.google.com/merchants/answer/10027038), you are allowing Google to improve the accuracy of your delivery times shown to shoppers using Google. More accurate delivery times, especially when faster, typically lead to better conversion rates. Google will improve your estimated delivery times based on various factors: - Delivery address of an order - Current handling time and shipping time settings - Estimated weekdays or business days - Parcel tracking data This field is only updated (cleared) if provided.", "$ref": "AccountShippingImprovements" } } }, "AccountItemUpdates": { "id": "AccountItemUpdates", "description": "Turning on [item updates](https://support.google.com/merchants/answer/3246284) allows Google to automatically update items for you. When item updates are on, Google uses the structured data markup on the website and advanced data extractors to update the price and availability of the items. When the item updates are off, items with mismatched data aren't shown.", "type": "object", "properties": { "accountItemUpdatesSettings": { "description": "Determines which attributes of the items should be automatically updated. If this field is not present, then the settings will be deleted. If there are no settings for subaccount, they are inherited from aggregator.", "$ref": "AccountItemUpdatesSettings" }, "effectiveAllowPriceUpdates": { "description": "Output only. The effective value of allow_price_updates. If account_item_updates_settings is present, then this value is the same. Otherwise, it represents the inherited value of the parent account. Read-only.", "readOnly": true, "type": "boolean" }, "effectiveAllowAvailabilityUpdates": { "description": "Output only. The effective value of allow_availability_updates. If account_item_updates_settings is present, then this value is the same. Otherwise, it represents the inherited value of the parent account. Read-only.", "readOnly": true, "type": "boolean" }, "effectiveAllowStrictAvailabilityUpdates": { "description": "Output only. The effective value of allow_strict_availability_updates. If account_item_updates_settings is present, then this value is the same. Otherwise, it represents the inherited value of the parent account. Read-only.", "readOnly": true, "type": "boolean" }, "effectiveAllowConditionUpdates": { "description": "Output only. The effective value of allow_condition_updates. If account_item_updates_settings is present, then this value is the same. Otherwise, it represents the inherited value of the parent account. Read-only.", "readOnly": true, "type": "boolean" } } }, "AccountItemUpdatesSettings": { "id": "AccountItemUpdatesSettings", "description": "Settings for the Automatic Item Updates.", "type": "object", "properties": { "allowPriceUpdates": { "description": "If price updates are enabled, Google always updates the active price with the crawled information.", "type": "boolean" }, "allowAvailabilityUpdates": { "description": "If availability updates are enabled, any previous availability values get overwritten if Google finds an out-of-stock annotation on the offer's page. If additionally `allow_availability_updates` field is set to true, values get overwritten if Google finds an in-stock annotation on the offer’s page.", "type": "boolean" }, "allowStrictAvailabilityUpdates": { "description": "If allow_availability_updates is enabled, items are automatically updated in all your Shopping target countries. By default, availability updates will only be applied to items that are 'out of stock' on your website but 'in stock' on Shopping. Set this to true to also update items that are 'in stock' on your website, but 'out of stock' on Google Shopping. In order for this field to have an effect, you must also allow availability updates.", "type": "boolean" }, "allowConditionUpdates": { "description": "If condition updates are enabled, Google always updates item condition with the condition detected from the details of your product.", "type": "boolean" } } }, "AccountImageImprovements": { "id": "AccountImageImprovements", "description": "This improvement will attempt to automatically correct submitted images if they don't meet the [image requirements](https://support.google.com/merchants/answer/6324350), for example, removing overlays. If successful, the image will be replaced and approved. This improvement is only applied to images of disapproved offers. For more information see: [Automatic image improvements](https://support.google.com/merchants/answer/9242973)", "type": "object", "properties": { "accountImageImprovementsSettings": { "description": "Determines how the images should be automatically updated. If this field is not present, then the settings will be deleted. If there are no settings for subaccount, they are inherited from aggregator.", "$ref": "AccountImageImprovementsSettings" }, "effectiveAllowAutomaticImageImprovements": { "description": "Output only. The effective value of allow_automatic_image_improvements. If account_image_improvements_settings is present, then this value is the same. Otherwise, it represents the inherited value of the parent account. Read-only.", "readOnly": true, "type": "boolean" } } }, "AccountImageImprovementsSettings": { "id": "AccountImageImprovementsSettings", "description": "Settings for the Automatic Image Improvements.", "type": "object", "properties": { "allowAutomaticImageImprovements": { "description": "Enables automatic image improvements.", "type": "boolean" } } }, "AccountShippingImprovements": { "id": "AccountShippingImprovements", "description": "Not available for MCAs [accounts](https://support.google.com/merchants/answer/188487). By turning on [automatic shipping improvements](https://support.google.com/merchants/answer/10027038), you are allowing Google to improve the accuracy of your delivery times shown to shoppers using Google. More accurate delivery times, especially when faster, typically lead to better conversion rates. Google will improve your estimated delivery times based on various factors: * Delivery address of an order * Current handling time and shipping time settings * Estimated weekdays or business days * Parcel tracking data", "type": "object", "properties": { "allowShippingImprovements": { "description": "Enables automatic shipping improvements.", "type": "boolean" } } }, "AccountAdsLink": { "id": "AccountAdsLink", "type": "object", "properties": { "adsId": { "description": "Customer ID of the Ads account.", "type": "string", "format": "uint64" }, "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. Acceptable values are: - \"`active`\" - \"`pending`\" ", "type": "string" } } }, "AccountConversionSettings": { "id": "AccountConversionSettings", "description": "Settings for conversion tracking.", "type": "object", "properties": { "freeListingsAutoTaggingEnabled": { "description": "When enabled, free listing URLs have a parameter to enable conversion tracking for products owned by the current merchant account. See [auto-tagging](https://support.google.com/merchants/answer/11127659).", "type": "boolean" } } }, "AccountsCustomBatchRequestEntryLinkRequest": { "id": "AccountsCustomBatchRequestEntryLinkRequest", "type": "object", "properties": { "action": { "description": "Action to perform for this link. The `\"request\"` action is only available to select merchants. Acceptable values are: - \"`approve`\" - \"`remove`\" - \"`request`\" ", "type": "string" }, "linkedAccountId": { "description": "The ID of the linked account.", "type": "string" }, "linkType": { "description": "Type of the link between the two accounts. Acceptable values are: - \"`channelPartner`\" - \"`eCommercePlatform`\" - \"`paymentServiceProvider`\" - \"`localProductManager`\" ", "type": "string" }, "services": { "description": "Provided services. Acceptable values are: - \"`shoppingAdsProductManagement`\" - \"`shoppingActionsProductManagement`\" - \"`shoppingActionsOrderManagement`\" - \"`paymentProcessing`\" - \"`localProductManagement`\" ", "type": "array", "items": { "type": "string" } } } }, "AccountsCustomBatchResponse": { "id": "AccountsCustomBatchResponse", "type": "object", "properties": { "entries": { "description": "The result of the execution of the batch requests.", "type": "array", "items": { "$ref": "AccountsCustomBatchResponseEntry" } }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#accountsCustomBatchResponse`\".", "type": "string" } } }, "AccountsCustomBatchResponseEntry": { "id": "AccountsCustomBatchResponseEntry", "description": "A batch entry encoding a single non-batch accounts response.", "type": "object", "properties": { "batchId": { "description": "The ID of the request entry this entry responds to.", "type": "integer", "format": "uint32" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#accountsCustomBatchResponseEntry`\"", "type": "string" }, "account": { "description": "The retrieved, created, or updated account. Not defined if the method was `delete`, `claimwebsite` or `link`.", "$ref": "Account" }, "errors": { "description": "A list of errors for failed custombatch entries. *Note:* Schema errors fail the whole request.", "$ref": "Errors" } } }, "Errors": { "id": "Errors", "description": "A list of errors returned by a failed batch entry.", "type": "object", "properties": { "errors": { "description": "A list of errors.", "type": "array", "items": { "$ref": "Error" } }, "code": { "description": "The HTTP status of the first error in `errors`.", "type": "integer", "format": "uint32" }, "message": { "description": "The message of the first error in `errors`.", "type": "string" } } }, "Error": { "id": "Error", "description": "An error returned by the API.", "type": "object", "properties": { "domain": { "description": "The domain of the error.", "type": "string" }, "reason": { "description": "The error code.", "type": "string" }, "message": { "description": "A description of the error.", "type": "string" } } }, "AccountsLinkRequest": { "id": "AccountsLinkRequest", "type": "object", "properties": { "action": { "description": "Action to perform for this link. The `\"request\"` action is only available to select merchants. Acceptable values are: - \"`approve`\" - \"`remove`\" - \"`request`\" ", "type": "string" }, "linkedAccountId": { "description": "The ID of the linked account.", "type": "string" }, "linkType": { "description": "Type of the link between the two accounts. Acceptable values are: - \"`channelPartner`\" - \"`eCommercePlatform`\" - \"`paymentServiceProvider`\" ", "type": "string" }, "services": { "description": " Acceptable values are: - \"`shoppingAdsProductManagement`\" - \"`shoppingActionsProductManagement`\" - \"`shoppingActionsOrderManagement`\" - \"`paymentProcessing`\" ", "type": "array", "items": { "type": "string" } }, "paymentServiceProviderLinkInfo": { "description": "Additional information required for `paymentServiceProvider` link type.", "$ref": "PaymentServiceProviderLinkInfo" }, "eCommercePlatformLinkInfo": { "description": "Additional information required for `eCommercePlatform` link type.", "$ref": "ECommercePlatformLinkInfo" } } }, "PaymentServiceProviderLinkInfo": { "id": "PaymentServiceProviderLinkInfo", "description": "Additional information required for PAYMENT_SERVICE_PROVIDER link type.", "type": "object", "properties": { "externalAccountId": { "description": "The id used by the third party service provider to identify the merchant.", "type": "string" }, "externalAccountBusinessCountry": { "description": "The business country of the merchant account as identified by the third party service provider.", "type": "string" } } }, "ECommercePlatformLinkInfo": { "id": "ECommercePlatformLinkInfo", "description": "Additional information required for E_COMMERCE_PLATFORM link type.", "type": "object", "properties": { "externalAccountId": { "description": "The id used by the third party service provider to identify the merchant.", "type": "string" } } }, "AccountsLinkResponse": { "id": "AccountsLinkResponse", "type": "object", "properties": { "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#accountsLinkResponse`\".", "type": "string" } } }, "AccountsListResponse": { "id": "AccountsListResponse", "type": "object", "properties": { "nextPageToken": { "description": "The token for the retrieval of the next page of accounts.", "type": "string" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#accountsListResponse`\".", "type": "string" }, "resources": { "type": "array", "items": { "$ref": "Account" } } } }, "AccountsListLinksResponse": { "id": "AccountsListLinksResponse", "type": "object", "properties": { "nextPageToken": { "description": "The token for the retrieval of the next page of links.", "type": "string" }, "links": { "description": "The list of available links.", "type": "array", "items": { "$ref": "LinkedAccount" } }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#accountsListLinksResponse`\".", "type": "string" } } }, "LinkedAccount": { "id": "LinkedAccount", "type": "object", "properties": { "linkedAccountId": { "description": "The ID of the linked account.", "type": "string" }, "services": { "description": "List of provided services.", "type": "array", "items": { "$ref": "LinkService" } } } }, "LinkService": { "id": "LinkService", "type": "object", "properties": { "service": { "description": "Service provided to or by the linked account. Acceptable values are: - \"`shoppingActionsOrderManagement`\" - \"`shoppingActionsProductManagement`\" - \"`shoppingAdsProductManagement`\" - \"`paymentProcessing`\" ", "type": "string" }, "status": { "description": "Status of the link Acceptable values are: - \"`active`\" - \"`inactive`\" - \"`pending`\" ", "type": "string" } } }, "AccountsUpdateLabelsRequest": { "id": "AccountsUpdateLabelsRequest", "type": "object", "properties": { "labelIds": { "description": "The IDs of labels that should be assigned to the account.", "type": "array", "items": { "type": "string", "format": "uint64" } } } }, "AccountsUpdateLabelsResponse": { "id": "AccountsUpdateLabelsResponse", "type": "object", "properties": { "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#accountsUpdateLabelsResponse`\".", "type": "string" } } }, "AccountstatusesCustomBatchRequest": { "id": "AccountstatusesCustomBatchRequest", "type": "object", "properties": { "entries": { "description": "The request entries to be processed in the batch.", "type": "array", "items": { "$ref": "AccountstatusesCustomBatchRequestEntry" } } } }, "AccountstatusesCustomBatchRequestEntry": { "id": "AccountstatusesCustomBatchRequestEntry", "description": "A batch entry encoding a single non-batch accountstatuses request.", "type": "object", "properties": { "batchId": { "description": "An entry ID, unique within the batch request.", "type": "integer", "format": "uint32" }, "merchantId": { "description": "The ID of the managing account.", "type": "string", "format": "uint64" }, "method": { "description": "The method of the batch entry. Acceptable values are: - \"`get`\" ", "type": "string" }, "accountId": { "description": "The ID of the (sub-)account whose status to get.", "type": "string", "format": "uint64" }, "destinations": { "description": "If set, only issues for the specified destinations are returned, otherwise only issues for the Shopping destination.", "type": "array", "items": { "type": "string" } } } }, "AccountstatusesCustomBatchResponse": { "id": "AccountstatusesCustomBatchResponse", "type": "object", "properties": { "entries": { "description": "The result of the execution of the batch requests.", "type": "array", "items": { "$ref": "AccountstatusesCustomBatchResponseEntry" } }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#accountstatusesCustomBatchResponse`\".", "type": "string" } } }, "AccountstatusesCustomBatchResponseEntry": { "id": "AccountstatusesCustomBatchResponseEntry", "description": "A batch entry encoding a single non-batch accountstatuses response.", "type": "object", "properties": { "batchId": { "description": "The ID of the request entry this entry responds to.", "type": "integer", "format": "uint32" }, "accountStatus": { "description": "The requested account status. Defined if and only if the request was successful.", "$ref": "AccountStatus" }, "errors": { "description": "A list of errors for failed custombatch entries. *Note:* Schema errors fail the whole request.", "$ref": "Errors" } } }, "AccountStatus": { "id": "AccountStatus", "description": "The status of an account, that is, information about its products, which is computed offline and not returned immediately at insertion time.", "type": "object", "properties": { "accountId": { "description": "The ID of the account for which the status is reported.", "type": "string" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#accountStatus`\"", "type": "string" }, "websiteClaimed": { "description": "Whether the account's website is claimed or not.", "type": "boolean" }, "accountLevelIssues": { "description": "A list of account level issues.", "type": "array", "items": { "$ref": "AccountStatusAccountLevelIssue" } }, "products": { "description": "List of product-related data by channel, destination, and country. Data in this field may be delayed by up to 30 minutes.", "type": "array", "items": { "$ref": "AccountStatusProducts" } }, "accountManagement": { "description": "How the account is managed. Acceptable values are: - \"`manual`\" - \"`automatic`\" ", "type": "string" } } }, "AccountStatusAccountLevelIssue": { "id": "AccountStatusAccountLevelIssue", "type": "object", "properties": { "id": { "description": "Issue identifier.", "type": "string" }, "title": { "description": "Short description of the issue.", "type": "string" }, "country": { "description": "Country for which this issue is reported.", "type": "string" }, "severity": { "description": "Severity of the issue. Acceptable values are: - \"`critical`\" - \"`error`\" - \"`suggestion`\" ", "type": "string" }, "detail": { "description": "Additional details about the issue.", "type": "string" }, "destination": { "description": "The destination the issue applies to. If this field is empty then the issue applies to all available destinations.", "type": "string" }, "documentation": { "description": "The URL of a web page to help resolving this issue.", "type": "string" } } }, "AccountStatusProducts": { "id": "AccountStatusProducts", "type": "object", "properties": { "channel": { "description": "The channel the data applies to. Acceptable values are: - \"`local`\" - \"`online`\" ", "type": "string" }, "destination": { "description": "The destination the data applies to.", "type": "string" }, "country": { "description": "The country the data applies to.", "type": "string" }, "statistics": { "description": "Aggregated product statistics.", "$ref": "AccountStatusStatistics" }, "itemLevelIssues": { "description": "List of item-level issues.", "type": "array", "items": { "$ref": "AccountStatusItemLevelIssue" } } } }, "AccountStatusStatistics": { "id": "AccountStatusStatistics", "type": "object", "properties": { "active": { "description": "Number of active offers.", "type": "string", "format": "int64" }, "pending": { "description": "Number of pending offers.", "type": "string", "format": "int64" }, "disapproved": { "description": "Number of disapproved offers.", "type": "string", "format": "int64" }, "expiring": { "description": "Number of expiring offers.", "type": "string", "format": "int64" } } }, "AccountStatusItemLevelIssue": { "id": "AccountStatusItemLevelIssue", "type": "object", "properties": { "code": { "description": "The error code of the issue.", "type": "string" }, "servability": { "description": "How this issue affects serving of the offer.", "type": "string" }, "resolution": { "description": "Whether the issue can be resolved by the merchant.", "type": "string" }, "attributeName": { "description": "The attribute's name, if the issue is caused by a single attribute.", "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.", "type": "string", "format": "int64" } } }, "AccountstatusesListResponse": { "id": "AccountstatusesListResponse", "type": "object", "properties": { "nextPageToken": { "description": "The token for the retrieval of the next page of account statuses.", "type": "string" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#accountstatusesListResponse`\".", "type": "string" }, "resources": { "type": "array", "items": { "$ref": "AccountStatus" } } } }, "AccounttaxCustomBatchRequest": { "id": "AccounttaxCustomBatchRequest", "type": "object", "properties": { "entries": { "description": "The request entries to be processed in the batch.", "type": "array", "items": { "$ref": "AccounttaxCustomBatchRequestEntry" } } } }, "AccounttaxCustomBatchRequestEntry": { "id": "AccounttaxCustomBatchRequestEntry", "description": "A batch entry encoding a single non-batch accounttax request.", "type": "object", "properties": { "batchId": { "description": "An entry ID, unique within the batch request.", "type": "integer", "format": "uint32" }, "merchantId": { "description": "The ID of the managing account.", "type": "string", "format": "uint64" }, "method": { "description": "The method of the batch entry. Acceptable values are: - \"`get`\" - \"`update`\" ", "type": "string" }, "accountId": { "description": "The ID of the account for which to get/update account tax settings.", "type": "string", "format": "uint64" }, "accountTax": { "description": "The account tax settings to update. Only defined if the method is `update`.", "$ref": "AccountTax" } } }, "AccountTax": { "id": "AccountTax", "description": "The tax settings of a merchant account. All methods require the admin role.", "type": "object", "properties": { "accountId": { "description": "Required. The ID of the account to which these account tax settings belong.", "type": "string", "format": "uint64" }, "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.", "type": "array", "items": { "$ref": "AccountTaxTaxRule" } }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#accountTax`\".", "type": "string" } } }, "AccountTaxTaxRule": { "id": "AccountTaxTaxRule", "description": "Tax calculation rule to apply in a state or province (US only).", "type": "object", "properties": { "country": { "description": "Country code in which tax is applicable.", "type": "string" }, "locationId": { "description": "Required. State (or province) is which the tax is applicable, described by its location ID (also called criteria ID).", "type": "string", "format": "uint64" }, "useGlobalRate": { "description": "Whether the tax rate is taken from a global tax table or specified explicitly.", "type": "boolean" }, "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" } } }, "AccounttaxCustomBatchResponse": { "id": "AccounttaxCustomBatchResponse", "type": "object", "properties": { "entries": { "description": "The result of the execution of the batch requests.", "type": "array", "items": { "$ref": "AccounttaxCustomBatchResponseEntry" } }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#accounttaxCustomBatchResponse`\".", "type": "string" } } }, "AccounttaxCustomBatchResponseEntry": { "id": "AccounttaxCustomBatchResponseEntry", "description": "A batch entry encoding a single non-batch accounttax response.", "type": "object", "properties": { "batchId": { "description": "The ID of the request entry this entry responds to.", "type": "integer", "format": "uint32" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#accounttaxCustomBatchResponseEntry`\"", "type": "string" }, "accountTax": { "description": "The retrieved or updated account tax settings.", "$ref": "AccountTax" }, "errors": { "description": "A list of errors for failed custombatch entries. *Note:* Schema errors fail the whole request.", "$ref": "Errors" } } }, "AccounttaxListResponse": { "id": "AccounttaxListResponse", "type": "object", "properties": { "nextPageToken": { "description": "The token for the retrieval of the next page of account tax settings.", "type": "string" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#accounttaxListResponse`\".", "type": "string" }, "resources": { "type": "array", "items": { "$ref": "AccountTax" } } } }, "DatafeedsCustomBatchRequest": { "id": "DatafeedsCustomBatchRequest", "type": "object", "properties": { "entries": { "description": "The request entries to be processed in the batch.", "type": "array", "items": { "$ref": "DatafeedsCustomBatchRequestEntry" } } } }, "DatafeedsCustomBatchRequestEntry": { "id": "DatafeedsCustomBatchRequestEntry", "description": "A batch entry encoding a single non-batch datafeeds request.", "type": "object", "properties": { "batchId": { "description": "An entry ID, unique within the batch request.", "type": "integer", "format": "uint32" }, "merchantId": { "description": "The ID of the managing account.", "type": "string", "format": "uint64" }, "method": { "description": "The method of the batch entry. Acceptable values are: - \"`delete`\" - \"`fetchNow`\" - \"`get`\" - \"`insert`\" - \"`update`\" ", "type": "string" }, "datafeedId": { "description": "The ID of the data feed to get, delete or fetch.", "type": "string", "format": "uint64" }, "datafeed": { "description": "The data feed to insert.", "$ref": "Datafeed" } } }, "Datafeed": { "id": "Datafeed", "description": "Datafeed configuration data.", "type": "object", "properties": { "id": { "description": "Required for update. The ID of the data feed.", "type": "string", "format": "int64" }, "name": { "description": "Required for insert. A descriptive name of the data feed.", "type": "string" }, "contentType": { "description": "Required. The type of data feed. For product inventory feeds, only feeds for local stores, not online stores, are supported. Acceptable values are: - \"`local products`\" - \"`product inventory`\" - \"`products`\" ", "type": "string" }, "attributeLanguage": { "description": "The two-letter ISO 639-1 language in which the attributes are defined in the data feed.", "type": "string" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#datafeed`\"", "type": "string" }, "fileName": { "description": "Required. The filename of the feed. All feeds must have a unique file name.", "type": "string" }, "fetchSchedule": { "description": "Fetch schedule for the feed file.", "$ref": "DatafeedFetchSchedule" }, "format": { "description": "Format of the feed file.", "$ref": "DatafeedFormat" }, "targets": { "description": "The targets this feed should apply to (country, language, destinations).", "type": "array", "items": { "$ref": "DatafeedTarget" } } } }, "DatafeedFetchSchedule": { "id": "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.", "type": "object", "properties": { "dayOfMonth": { "description": "The day of the month the feed file should be fetched (1-31).", "type": "integer", "format": "uint32" }, "weekday": { "description": "The day of the week the feed file should be fetched. Acceptable values are: - \"`monday`\" - \"`tuesday`\" - \"`wednesday`\" - \"`thursday`\" - \"`friday`\" - \"`saturday`\" - \"`sunday`\" ", "type": "string" }, "hour": { "description": "The hour of the day the feed file should be fetched (0-23).", "type": "integer", "format": "uint32" }, "timeZone": { "description": "Time zone used for schedule. UTC by default. For example, \"America/Los_Angeles\".", "type": "string" }, "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" }, "username": { "description": "An optional user name for fetch_url.", "type": "string" }, "password": { "description": "An optional password for fetch_url.", "type": "string" }, "minuteOfHour": { "description": "The minute of the hour the feed file should be fetched (0-59). Read-only.", "type": "integer", "format": "uint32" }, "paused": { "description": "Whether the scheduled fetch is paused or not.", "type": "boolean" } } }, "DatafeedFormat": { "id": "DatafeedFormat", "type": "object", "properties": { "fileEncoding": { "description": "Character encoding scheme of the data feed. If not specified, the encoding will be auto-detected. Acceptable values are: - \"`latin-1`\" - \"`utf-16be`\" - \"`utf-16le`\" - \"`utf-8`\" - \"`windows-1252`\" ", "type": "string" }, "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. Acceptable values are: - \"`pipe`\" - \"`tab`\" - \"`tilde`\" ", "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. Acceptable values are: - \"`normal character`\" - \"`value quoting`\" ", "type": "string" } } }, "DatafeedTarget": { "id": "DatafeedTarget", "type": "object", "properties": { "country": { "description": "Deprecated. Use `feedLabel` instead. The country where the items in the feed will be included in the search index, represented as a CLDR territory code.", "type": "string" }, "feedLabel": { "description": "Feed label for the DatafeedTarget. Either `country` or `feedLabel` is required. If both `feedLabel` and `country` is specified, the values must match. Must be less than or equal to 20 uppercase letters (A-Z), numbers (0-9), and dashes (-).", "type": "string" }, "targetCountries": { "description": "The countries where the items may be displayed. Represented as a CLDR territory code. Will be ignored for \"product inventory\" feeds.", "type": "array", "items": { "type": "string" } }, "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" }, "includedDestinations": { "description": "The list of [destinations to include](//support.google.com/merchants/answer/7501026) for this target (corresponds to checked check boxes in Merchant Center). Default destinations are always included unless provided in `excludedDestinations`.", "type": "array", "items": { "type": "string" } }, "excludedDestinations": { "description": "The list of [destinations to exclude](//support.google.com/merchants/answer/6324486) for this target (corresponds to cleared check boxes in Merchant Center). Products that are excluded from all destinations for more than 7 days are automatically deleted.", "type": "array", "items": { "type": "string" } } } }, "DatafeedsCustomBatchResponse": { "id": "DatafeedsCustomBatchResponse", "type": "object", "properties": { "entries": { "description": "The result of the execution of the batch requests.", "type": "array", "items": { "$ref": "DatafeedsCustomBatchResponseEntry" } }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#datafeedsCustomBatchResponse`\".", "type": "string" } } }, "DatafeedsCustomBatchResponseEntry": { "id": "DatafeedsCustomBatchResponseEntry", "description": "A batch entry encoding a single non-batch datafeeds response.", "type": "object", "properties": { "batchId": { "description": "The ID of the request entry this entry responds to.", "type": "integer", "format": "uint32" }, "datafeed": { "description": "The requested data feed. Defined if and only if the request was successful.", "$ref": "Datafeed" }, "errors": { "description": "A list of errors for failed custombatch entries. *Note:* Schema errors fail the whole request.", "$ref": "Errors" } } }, "DatafeedsFetchNowResponse": { "id": "DatafeedsFetchNowResponse", "type": "object", "properties": { "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#datafeedsFetchNowResponse`\".", "type": "string" } } }, "DatafeedsListResponse": { "id": "DatafeedsListResponse", "type": "object", "properties": { "nextPageToken": { "description": "The token for the retrieval of the next page of datafeeds.", "type": "string" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#datafeedsListResponse`\".", "type": "string" }, "resources": { "type": "array", "items": { "$ref": "Datafeed" } } } }, "DatafeedstatusesCustomBatchRequest": { "id": "DatafeedstatusesCustomBatchRequest", "type": "object", "properties": { "entries": { "description": "The request entries to be processed in the batch.", "type": "array", "items": { "$ref": "DatafeedstatusesCustomBatchRequestEntry" } } } }, "DatafeedstatusesCustomBatchRequestEntry": { "id": "DatafeedstatusesCustomBatchRequestEntry", "description": "A batch entry encoding a single non-batch datafeedstatuses request.", "type": "object", "properties": { "batchId": { "description": "An entry ID, unique within the batch request.", "type": "integer", "format": "uint32" }, "merchantId": { "description": "The ID of the managing account.", "type": "string", "format": "uint64" }, "method": { "description": "The method of the batch entry. Acceptable values are: - \"`get`\" ", "type": "string" }, "datafeedId": { "description": "The ID of the data feed to get.", "type": "string", "format": "uint64" }, "country": { "description": "Deprecated. Use `feedLabel` instead. The country to get the datafeed status for. If this parameter is provided, then `language` must also be provided. Note that for multi-target datafeeds this parameter is required.", "type": "string" }, "feedLabel": { "description": "The feed label to get the datafeed status for. If this parameter is provided, then `language` must also be provided. Note that for multi-target datafeeds this parameter is required.", "type": "string" }, "language": { "description": "The language to get the datafeed status for. If this parameter is provided then `country` must also be provided. Note that for multi-target datafeeds this parameter is required.", "type": "string" } } }, "DatafeedstatusesCustomBatchResponse": { "id": "DatafeedstatusesCustomBatchResponse", "type": "object", "properties": { "entries": { "description": "The result of the execution of the batch requests.", "type": "array", "items": { "$ref": "DatafeedstatusesCustomBatchResponseEntry" } }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#datafeedstatusesCustomBatchResponse`\".", "type": "string" } } }, "DatafeedstatusesCustomBatchResponseEntry": { "id": "DatafeedstatusesCustomBatchResponseEntry", "description": "A batch entry encoding a single non-batch datafeedstatuses response.", "type": "object", "properties": { "batchId": { "description": "The ID of the request entry this entry responds to.", "type": "integer", "format": "uint32" }, "datafeedStatus": { "description": "The requested data feed status. Defined if and only if the request was successful.", "$ref": "DatafeedStatus" }, "errors": { "description": "A list of errors for failed custombatch entries. *Note:* Schema errors fail the whole request.", "$ref": "Errors" } } }, "DatafeedStatus": { "id": "DatafeedStatus", "description": "The status of a datafeed, that is, the result of the last retrieval of the datafeed computed asynchronously when the feed processing is finished.", "type": "object", "properties": { "datafeedId": { "description": "The ID of the feed for which the status is reported.", "type": "string", "format": "uint64" }, "processingStatus": { "description": "The processing status of the feed. Acceptable values are: - \"`\"`failure`\": The feed could not be processed or all items had errors.`\" - \"`in progress`\": The feed is being processed. - \"`none`\": The feed has not yet been processed. For example, a feed that has never been uploaded will have this processing status. - \"`success`\": The feed was processed successfully, though some items might have had errors. ", "type": "string" }, "errors": { "description": "The list of errors occurring in the feed.", "type": "array", "items": { "$ref": "DatafeedStatusError" } }, "warnings": { "description": "The list of errors occurring in the feed.", "type": "array", "items": { "$ref": "DatafeedStatusError" } }, "itemsTotal": { "description": "The number of items in the feed that were processed.", "type": "string", "format": "uint64" }, "itemsValid": { "description": "The number of items in the feed that were valid.", "type": "string", "format": "uint64" }, "lastUploadDate": { "description": "The last date at which the feed was uploaded.", "type": "string" }, "country": { "description": "The country for which the status is reported, represented as a CLDR territory code.", "type": "string" }, "feedLabel": { "description": "The feed label status is reported for.", "type": "string" }, "language": { "description": "The two-letter ISO 639-1 language for which the status is reported.", "type": "string" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#datafeedStatus`\"", "type": "string" } } }, "DatafeedStatusError": { "id": "DatafeedStatusError", "description": "An error occurring in the feed, like \"invalid price\".", "type": "object", "properties": { "code": { "description": "The code of the error, for example, \"validation/invalid_value\".", "type": "string" }, "count": { "description": "The number of occurrences of the error in the feed.", "type": "string", "format": "uint64" }, "message": { "description": "The error message, for example, \"Invalid price\".", "type": "string" }, "examples": { "description": "A list of example occurrences of the error, grouped by product.", "type": "array", "items": { "$ref": "DatafeedStatusExample" } } } }, "DatafeedStatusExample": { "id": "DatafeedStatusExample", "description": "An example occurrence for a particular error.", "type": "object", "properties": { "lineNumber": { "description": "Line number in the data feed where the example is found.", "type": "string", "format": "uint64" }, "itemId": { "description": "The ID of the example item.", "type": "string" }, "value": { "description": "The problematic value.", "type": "string" } } }, "DatafeedstatusesListResponse": { "id": "DatafeedstatusesListResponse", "type": "object", "properties": { "nextPageToken": { "description": "The token for the retrieval of the next page of datafeed statuses.", "type": "string" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#datafeedstatusesListResponse`\".", "type": "string" }, "resources": { "type": "array", "items": { "$ref": "DatafeedStatus" } } } }, "LiasettingsCustomBatchRequest": { "id": "LiasettingsCustomBatchRequest", "type": "object", "properties": { "entries": { "description": "The request entries to be processed in the batch.", "type": "array", "items": { "$ref": "LiasettingsCustomBatchRequestEntry" } } } }, "LiasettingsCustomBatchRequestEntry": { "id": "LiasettingsCustomBatchRequestEntry", "type": "object", "properties": { "batchId": { "description": "An entry ID, unique within the batch request.", "type": "integer", "format": "uint32" }, "merchantId": { "description": "The ID of the managing account.", "type": "string", "format": "uint64" }, "method": { "description": "The method of the batch entry. Acceptable values are: - \"`get`\" - \"`getAccessibleGmbAccounts`\" - \"`requestGmbAccess`\" - \"`requestInventoryVerification`\" - \"`setInventoryVerificationContact`\" - \"`update`\" ", "type": "string" }, "accountId": { "description": "The ID of the account for which to get/update account LIA settings.", "type": "string", "format": "uint64" }, "country": { "description": "The country code. Required only for RequestInventoryVerification.", "type": "string" }, "liaSettings": { "description": "The account Lia settings to update. Only defined if the method is `update`.", "$ref": "LiaSettings" }, "gmbEmail": { "description": "The Business Profile. Required only for RequestGmbAccess.", "type": "string" }, "contactName": { "description": "Inventory validation contact name. Required only for SetInventoryValidationContact.", "type": "string" }, "contactEmail": { "description": "Inventory validation contact email. Required only for SetInventoryValidationContact.", "type": "string" }, "posDataProviderId": { "description": "The ID of POS data provider. Required only for SetPosProvider.", "type": "string", "format": "uint64" }, "posExternalAccountId": { "description": "The account ID by which this merchant is known to the POS provider.", "type": "string" }, "omnichannelExperience": { "description": "The omnichannel experience for a country. Required only for SetOmnichannelExperience.", "$ref": "LiaOmnichannelExperience" } } }, "LiaSettings": { "id": "LiaSettings", "description": "Local Inventory ads (LIA) settings. All methods except listposdataproviders require the admin role.", "type": "object", "properties": { "accountId": { "description": "The ID of the account to which these LIA settings belong. Ignored upon update, always present in get request responses.", "type": "string", "format": "uint64" }, "countrySettings": { "description": "The LIA settings for each country.", "type": "array", "items": { "$ref": "LiaCountrySettings" } }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#liaSettings`\"", "type": "string" } } }, "LiaCountrySettings": { "id": "LiaCountrySettings", "type": "object", "properties": { "country": { "description": "Required. CLDR country code (for example, \"US\").", "type": "string" }, "inventory": { "description": "LIA inventory verification settings.", "$ref": "LiaInventorySettings" }, "onDisplayToOrder": { "description": "LIA \"On Display To Order\" settings.", "$ref": "LiaOnDisplayToOrderSettings" }, "hostedLocalStorefrontActive": { "description": "The status of the \"Merchant hosted local storefront\" feature.", "type": "boolean" }, "storePickupActive": { "description": "The status of the \"Store pickup\" feature.", "type": "boolean" }, "about": { "description": "The settings for the About page.", "$ref": "LiaAboutPageSettings" }, "posDataProvider": { "description": "The POS data provider linked with this country.", "$ref": "LiaPosDataProvider" }, "omnichannelExperience": { "description": "The omnichannel experience configured for this country.", "$ref": "LiaOmnichannelExperience" } } }, "LiaInventorySettings": { "id": "LiaInventorySettings", "type": "object", "properties": { "status": { "description": "The status of the inventory verification process. Acceptable values are: - \"`active`\" - \"`inactive`\" - \"`pending`\" ", "type": "string" }, "inventoryVerificationContactName": { "description": "The name of the contact for the inventory verification process.", "type": "string" }, "inventoryVerificationContactEmail": { "description": "The email of the contact for the inventory verification process.", "type": "string" }, "inventoryVerificationContactStatus": { "description": "The status of the verification contact. Acceptable values are: - \"`active`\" - \"`inactive`\" - \"`pending`\" ", "type": "string" } } }, "LiaOnDisplayToOrderSettings": { "id": "LiaOnDisplayToOrderSettings", "type": "object", "properties": { "status": { "description": "The status of the ?On display to order? feature. Acceptable values are: - \"`active`\" - \"`inactive`\" - \"`pending`\" ", "type": "string" }, "shippingCostPolicyUrl": { "description": "Shipping cost and policy URL.", "type": "string" } } }, "LiaAboutPageSettings": { "id": "LiaAboutPageSettings", "type": "object", "properties": { "status": { "description": "The status of the verification process for the About page. Supported values are: - \"`active`\" - \"`inactive`\" - \"`pending`\" ", "type": "string" }, "url": { "description": "The URL for the About page.", "type": "string" } } }, "LiaPosDataProvider": { "id": "LiaPosDataProvider", "type": "object", "properties": { "posDataProviderId": { "description": "The ID of the POS data provider.", "type": "string", "format": "uint64" }, "posExternalAccountId": { "description": "The account ID by which this merchant is known to the POS data provider.", "type": "string" } } }, "LiaOmnichannelExperience": { "id": "LiaOmnichannelExperience", "description": "Omnichannel experience details.", "type": "object", "properties": { "country": { "description": "The CLDR country code (for example, \"US\").", "type": "string" }, "lsfType": { "description": "The Local Store Front (LSF) type for this country. Acceptable values are: - \"`ghlsf`\" (Google-Hosted Local Store Front) - \"`mhlsfBasic`\" (Merchant-Hosted Local Store Front Basic) - \"`mhlsfFull`\" (Merchant-Hosted Local Store Front Full) More details about these types can be found here.", "type": "string" }, "pickupTypes": { "description": "The Pickup types for this country. Acceptable values are: - \"`pickupToday`\" - \"`pickupLater`\" ", "type": "array", "items": { "type": "string" } } } }, "LiasettingsCustomBatchResponse": { "id": "LiasettingsCustomBatchResponse", "type": "object", "properties": { "entries": { "description": "The result of the execution of the batch requests.", "type": "array", "items": { "$ref": "LiasettingsCustomBatchResponseEntry" } }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#liasettingsCustomBatchResponse`\".", "type": "string" } } }, "LiasettingsCustomBatchResponseEntry": { "id": "LiasettingsCustomBatchResponseEntry", "type": "object", "properties": { "batchId": { "description": "The ID of the request entry to which this entry responds.", "type": "integer", "format": "uint32" }, "liaSettings": { "description": "The retrieved or updated Lia settings.", "$ref": "LiaSettings" }, "errors": { "description": "A list of errors defined if, and only if, the request failed.", "$ref": "Errors" }, "gmbAccounts": { "description": "The list of accessible Business Profiles.", "$ref": "GmbAccounts" }, "posDataProviders": { "description": "The list of POS data providers.", "type": "array", "items": { "$ref": "PosDataProviders" } }, "omnichannelExperience": { "description": "The updated omnichannel experience for a country.", "$ref": "LiaOmnichannelExperience" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#liasettingsCustomBatchResponseEntry`\"", "type": "string" } } }, "GmbAccounts": { "id": "GmbAccounts", "type": "object", "properties": { "accountId": { "description": "The ID of the Merchant Center account.", "type": "string", "format": "uint64" }, "gmbAccounts": { "description": "A list of Business Profiles which are available to the merchant.", "type": "array", "items": { "$ref": "GmbAccountsGmbAccount" } } } }, "GmbAccountsGmbAccount": { "id": "GmbAccountsGmbAccount", "type": "object", "properties": { "type": { "description": "The type of the Business Profile (User or Business).", "type": "string" }, "email": { "description": "The email which identifies the Business Profile.", "type": "string" }, "name": { "description": "The name of the Business Profile.", "type": "string" }, "listingCount": { "description": "Number of listings under this account.", "type": "string", "format": "uint64" } } }, "PosDataProviders": { "id": "PosDataProviders", "type": "object", "properties": { "country": { "description": "Country code.", "type": "string" }, "posDataProviders": { "description": "A list of POS data providers.", "type": "array", "items": { "$ref": "PosDataProvidersPosDataProvider" } } } }, "PosDataProvidersPosDataProvider": { "id": "PosDataProvidersPosDataProvider", "type": "object", "properties": { "providerId": { "description": "The ID of the account.", "type": "string", "format": "uint64" }, "displayName": { "description": "The display name of Pos data Provider.", "type": "string" }, "fullName": { "description": "The full name of this POS data Provider.", "type": "string" } } }, "LiasettingsGetAccessibleGmbAccountsResponse": { "id": "LiasettingsGetAccessibleGmbAccountsResponse", "type": "object", "properties": { "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#liasettingsGetAccessibleGmbAccountsResponse`\".", "type": "string" }, "accountId": { "description": "The ID of the Merchant Center account.", "type": "string", "format": "uint64" }, "gmbAccounts": { "description": "A list of Business Profiles which are available to the merchant.", "type": "array", "items": { "$ref": "GmbAccountsGmbAccount" } } } }, "LiasettingsListResponse": { "id": "LiasettingsListResponse", "type": "object", "properties": { "nextPageToken": { "description": "The token for the retrieval of the next page of LIA settings.", "type": "string" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#liasettingsListResponse`\".", "type": "string" }, "resources": { "type": "array", "items": { "$ref": "LiaSettings" } } } }, "LiasettingsListPosDataProvidersResponse": { "id": "LiasettingsListPosDataProvidersResponse", "type": "object", "properties": { "posDataProviders": { "description": "The list of POS data providers for each eligible country", "type": "array", "items": { "$ref": "PosDataProviders" } }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#liasettingsListPosDataProvidersResponse`\".", "type": "string" } } }, "LiasettingsRequestGmbAccessResponse": { "id": "LiasettingsRequestGmbAccessResponse", "type": "object", "properties": { "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#liasettingsRequestGmbAccessResponse`\".", "type": "string" } } }, "LiasettingsRequestInventoryVerificationResponse": { "id": "LiasettingsRequestInventoryVerificationResponse", "type": "object", "properties": { "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#liasettingsRequestInventoryVerificationResponse`\".", "type": "string" } } }, "LiasettingsSetInventoryVerificationContactResponse": { "id": "LiasettingsSetInventoryVerificationContactResponse", "type": "object", "properties": { "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#liasettingsSetInventoryVerificationContactResponse`\".", "type": "string" } } }, "LiasettingsSetPosDataProviderResponse": { "id": "LiasettingsSetPosDataProviderResponse", "type": "object", "properties": { "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#liasettingsSetPosDataProviderResponse`\".", "type": "string" } } }, "LocalinventoryCustomBatchRequest": { "id": "LocalinventoryCustomBatchRequest", "type": "object", "properties": { "entries": { "description": "The request entries to be processed in the batch.", "type": "array", "items": { "$ref": "LocalinventoryCustomBatchRequestEntry" } } } }, "LocalinventoryCustomBatchRequestEntry": { "id": "LocalinventoryCustomBatchRequestEntry", "description": "Batch entry encoding a single local inventory update request.", "type": "object", "properties": { "batchId": { "description": "An entry ID, unique within the batch request.", "type": "integer", "format": "uint32" }, "merchantId": { "description": "The ID of the managing account.", "type": "string", "format": "uint64" }, "method": { "description": "Method of the batch request entry. Acceptable values are: - \"`insert`\" ", "type": "string" }, "productId": { "description": "The ID of the product for which to update local inventory.", "type": "string" }, "localInventory": { "description": "Local inventory of the product.", "$ref": "LocalInventory" } } }, "LocalInventory": { "id": "LocalInventory", "description": "Local inventory resource. For accepted attribute values, see the local product inventory feed specification.", "type": "object", "properties": { "storeCode": { "description": "Required. The store code of this local inventory resource.", "type": "string" }, "price": { "description": "The price of the product.", "$ref": "Price" }, "salePrice": { "description": "The sale price of the product. Mandatory if `sale_price_effective_date` is defined.", "$ref": "Price" }, "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" }, "availability": { "description": "The availability of the product. For accepted attribute values, see the local product inventory feed specification.", "type": "string" }, "quantity": { "description": "The quantity of the product. Must be nonnegative.", "type": "integer", "format": "uint32" }, "pickupMethod": { "description": "The supported pickup method for this offer. Unless the value is \"not supported\", this field must be submitted together with `pickupSla`. For accepted attribute values, see the local product inventory feed specification.", "type": "string" }, "pickupSla": { "description": "The expected date that an order will be ready for pickup relative to the order date. Must be submitted together with `pickupMethod`. For accepted attribute values, see the local product inventory feed specification.", "type": "string" }, "instoreProductLocation": { "description": "The in-store product location.", "type": "string" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#localInventory`\"", "type": "string" }, "customAttributes": { "description": "A list of custom (merchant-provided) attributes. Can also be used to submit any attribute of the feed specification in its generic form, for example, `{ \"name\": \"size type\", \"value\": \"regular\" }`.", "type": "array", "items": { "$ref": "CustomAttribute" } } } }, "Price": { "id": "Price", "type": "object", "properties": { "value": { "description": "The price represented as a number.", "type": "string" }, "currency": { "description": "The currency of the price.", "type": "string" } } }, "CustomAttribute": { "id": "CustomAttribute", "description": "A message that represents custom attributes. Exactly one of `value` or `groupValues` must be provided. Maximum allowed number of characters for each custom attribute is 10240 (represents sum of characters for name and value). Maximum 2500 custom attributes can be set per merchant, with total size of 102.4kB.", "type": "object", "properties": { "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" }, "groupValues": { "description": "Subattributes within this attribute group. Exactly one of value or groupValues must be provided.", "type": "array", "items": { "$ref": "CustomAttribute" } } } }, "LocalinventoryCustomBatchResponse": { "id": "LocalinventoryCustomBatchResponse", "type": "object", "properties": { "entries": { "description": "The result of the execution of the batch requests.", "type": "array", "items": { "$ref": "LocalinventoryCustomBatchResponseEntry" } }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#localinventoryCustomBatchResponse`\".", "type": "string" } } }, "LocalinventoryCustomBatchResponseEntry": { "id": "LocalinventoryCustomBatchResponseEntry", "description": "Batch entry encoding a single local inventory update response.", "type": "object", "properties": { "batchId": { "description": "The ID of the request entry this entry responds to.", "type": "integer", "format": "uint32" }, "errors": { "description": "A list of errors for failed custombatch entries. *Note:* Schema errors fail the whole request.", "$ref": "Errors" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#localinventoryCustomBatchResponseEntry`\"", "type": "string" } } }, "OrderinvoicesCreateChargeInvoiceRequest": { "id": "OrderinvoicesCreateChargeInvoiceRequest", "type": "object", "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" }, "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" }, "lineItemInvoices": { "description": "[required] Invoice details per line item.", "type": "array", "items": { "$ref": "ShipmentInvoiceLineItemInvoice" } }, "invoiceSummary": { "description": "[required] Invoice summary.", "$ref": "InvoiceSummary" } } }, "ShipmentInvoiceLineItemInvoice": { "id": "ShipmentInvoiceLineItemInvoice", "type": "object", "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).", "type": "array", "items": { "type": "string" } }, "unitInvoice": { "description": "[required] Invoice details for a single unit.", "$ref": "UnitInvoice" } } }, "UnitInvoice": { "id": "UnitInvoice", "type": "object", "properties": { "unitPriceTaxes": { "description": "Tax amounts to apply to the unit price.", "type": "array", "items": { "$ref": "UnitInvoiceTaxLine" } }, "additionalCharges": { "description": "Additional charges for a unit, for example, shipping costs.", "type": "array", "items": { "$ref": "UnitInvoiceAdditionalCharge" } }, "unitPrice": { "description": "[required] Pre-tax or post-tax price of one unit depending on the locality of the order. *Note:* Invoicing works on a per unit basis. The `unitPrice` is the price of a single unit, and will be multiplied by the number of entries in `shipmentUnitId`.", "$ref": "Price" } } }, "UnitInvoiceTaxLine": { "id": "UnitInvoiceTaxLine", "type": "object", "properties": { "taxType": { "description": "[required] Type of the tax. Acceptable values are: - \"`otherFee`\" - \"`otherFeeTax`\" - \"`sales`\" ", "type": "string" }, "taxAmount": { "description": "[required] Tax amount for the tax type.", "$ref": "Price" }, "taxName": { "description": "Optional name of the tax type. This should only be provided if `taxType` is `otherFeeTax`.", "type": "string" } } }, "UnitInvoiceAdditionalCharge": { "id": "UnitInvoiceAdditionalCharge", "type": "object", "properties": { "type": { "description": "[required] Type of the additional charge. Acceptable values are: - \"`shipping`\" ", "type": "string" }, "additionalChargeAmount": { "description": "[required] Amount of the additional charge per unit. *Note:* Invoicing works on a per unit bases. The `additionalChargeAmount` is the amount charged per unit, and will be multiplied by the number of entries in `shipmentUnitID`.", "$ref": "Amount" } } }, "Amount": { "id": "Amount", "type": "object", "properties": { "priceAmount": { "description": "[required] The pre-tax or post-tax price depending on the location of the order.", "$ref": "Price" }, "taxAmount": { "description": "[required] Tax value.", "$ref": "Price" } } }, "InvoiceSummary": { "id": "InvoiceSummary", "type": "object", "properties": { "productTotal": { "description": "[required] Total price for the product.", "$ref": "Amount" }, "additionalChargeSummaries": { "description": "Summary of the total amounts of the additional charges.", "type": "array", "items": { "$ref": "InvoiceSummaryAdditionalChargeSummary" } } } }, "InvoiceSummaryAdditionalChargeSummary": { "id": "InvoiceSummaryAdditionalChargeSummary", "type": "object", "properties": { "type": { "description": "[required] Type of the additional charge. Acceptable values are: - \"`shipping`\" ", "type": "string" }, "totalAmount": { "description": "[required] Total additional charge for this type.", "$ref": "Amount" } } }, "OrderinvoicesCreateChargeInvoiceResponse": { "id": "OrderinvoicesCreateChargeInvoiceResponse", "type": "object", "properties": { "executionStatus": { "description": "The status of the execution. Acceptable values are: - \"`duplicate`\" - \"`executed`\" ", "type": "string" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#orderinvoicesCreateChargeInvoiceResponse`\".", "type": "string" } } }, "OrderinvoicesCreateRefundInvoiceRequest": { "id": "OrderinvoicesCreateRefundInvoiceRequest", "type": "object", "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": { "description": "Option to create a refund-only invoice. Exactly one of `refundOnlyOption` or `returnOption` must be provided.", "$ref": "OrderinvoicesCustomBatchRequestEntryCreateRefundInvoiceRefundOption" }, "shipmentInvoices": { "description": "Invoice details for different shipment groups.", "type": "array", "items": { "$ref": "ShipmentInvoice" } }, "returnOption": { "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.", "$ref": "OrderinvoicesCustomBatchRequestEntryCreateRefundInvoiceReturnOption" } } }, "OrderinvoicesCustomBatchRequestEntryCreateRefundInvoiceRefundOption": { "id": "OrderinvoicesCustomBatchRequestEntryCreateRefundInvoiceRefundOption", "type": "object", "properties": { "reason": { "description": "[required] Reason for the refund. Acceptable values are: - \"`adjustment`\" - \"`autoPostInternal`\" - \"`autoPostInvalidBillingAddress`\" - \"`autoPostNoInventory`\" - \"`autoPostPriceError`\" - \"`autoPostUndeliverableShippingAddress`\" - \"`couponAbuse`\" - \"`courtesyAdjustment`\" - \"`customerCanceled`\" - \"`customerDiscretionaryReturn`\" - \"`customerInitiatedMerchantCancel`\" - \"`customerSupportRequested`\" - \"`deliveredLateByCarrier`\" - \"`deliveredTooLate`\" - \"`expiredItem`\" - \"`failToPushOrderGoogleError`\" - \"`failToPushOrderMerchantError`\" - \"`failToPushOrderMerchantFulfillmentError`\" - \"`failToPushOrderToMerchant`\" - \"`failToPushOrderToMerchantOutOfStock`\" - \"`feeAdjustment`\" - \"`invalidCoupon`\" - \"`lateShipmentCredit`\" - \"`malformedShippingAddress`\" - \"`merchantDidNotShipOnTime`\" - \"`noInventory`\" - \"`orderTimeout`\" - \"`other`\" - \"`paymentAbuse`\" - \"`paymentDeclined`\" - \"`priceAdjustment`\" - \"`priceError`\" - \"`productArrivedDamaged`\" - \"`productNotAsDescribed`\" - \"`promoReallocation`\" - \"`qualityNotAsExpected`\" - \"`returnRefundAbuse`\" - \"`shippingCostAdjustment`\" - \"`shippingPriceError`\" - \"`taxAdjustment`\" - \"`taxError`\" - \"`undeliverableShippingAddress`\" - \"`unsupportedPoBoxAddress`\" - \"`wrongProductShipped`\" ", "type": "string" }, "description": { "description": "Optional description of the refund reason.", "type": "string" } } }, "ShipmentInvoice": { "id": "ShipmentInvoice", "type": "object", "properties": { "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" }, "lineItemInvoices": { "description": "[required] Invoice details per line item.", "type": "array", "items": { "$ref": "ShipmentInvoiceLineItemInvoice" } }, "invoiceSummary": { "description": "[required] Invoice summary.", "$ref": "InvoiceSummary" } } }, "OrderinvoicesCustomBatchRequestEntryCreateRefundInvoiceReturnOption": { "id": "OrderinvoicesCustomBatchRequestEntryCreateRefundInvoiceReturnOption", "type": "object", "properties": { "reason": { "description": "[required] Reason for the return. Acceptable values are: - \"`customerDiscretionaryReturn`\" - \"`customerInitiatedMerchantCancel`\" - \"`deliveredTooLate`\" - \"`expiredItem`\" - \"`invalidCoupon`\" - \"`malformedShippingAddress`\" - \"`other`\" - \"`productArrivedDamaged`\" - \"`productNotAsDescribed`\" - \"`qualityNotAsExpected`\" - \"`undeliverableShippingAddress`\" - \"`unsupportedPoBoxAddress`\" - \"`wrongProductShipped`\" ", "type": "string" }, "description": { "description": "Optional description of the return reason.", "type": "string" } } }, "OrderinvoicesCreateRefundInvoiceResponse": { "id": "OrderinvoicesCreateRefundInvoiceResponse", "type": "object", "properties": { "executionStatus": { "description": "The status of the execution. Acceptable values are: - \"`duplicate`\" - \"`executed`\" ", "type": "string" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#orderinvoicesCreateRefundInvoiceResponse`\".", "type": "string" } } }, "OrderreportsListDisbursementsResponse": { "id": "OrderreportsListDisbursementsResponse", "type": "object", "properties": { "nextPageToken": { "description": "The token for the retrieval of the next page of disbursements.", "type": "string" }, "disbursements": { "description": "The list of disbursements.", "type": "array", "items": { "$ref": "OrderReportDisbursement" } }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#orderreportsListDisbursementsResponse`\".", "type": "string" } } }, "OrderReportDisbursement": { "id": "OrderReportDisbursement", "description": "Order disbursement. All methods require the payment analyst role.", "type": "object", "properties": { "merchantId": { "description": "The ID of the managing account.", "type": "string", "format": "uint64" }, "disbursementId": { "description": "The ID of the disbursement.", "type": "string" }, "disbursementDate": { "description": "The date the disbursement was initiated, in ISO 8601 format.", "type": "string" }, "disbursementCreationDate": { "description": "The disbursement date, in ISO 8601 format.", "type": "string" }, "disbursementAmount": { "description": "The disbursement amount.", "$ref": "Price" } } }, "OrderreportsListTransactionsResponse": { "id": "OrderreportsListTransactionsResponse", "type": "object", "properties": { "nextPageToken": { "description": "The token for the retrieval of the next page of transactions.", "type": "string" }, "transactions": { "description": "The list of transactions.", "type": "array", "items": { "$ref": "OrderReportTransaction" } }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#orderreportsListTransactionsResponse`\".", "type": "string" } } }, "OrderReportTransaction": { "id": "OrderReportTransaction", "type": "object", "properties": { "merchantId": { "description": "The ID of the managing account.", "type": "string", "format": "uint64" }, "disbursementId": { "description": "The ID of the disbursement.", "type": "string" }, "disbursementDate": { "description": "The date the disbursement was initiated, in ISO 8601 format.", "type": "string" }, "disbursementCreationDate": { "description": "The date the disbursement was created, in ISO 8601 format.", "type": "string" }, "disbursementAmount": { "description": "The disbursement amount.", "$ref": "Price" }, "orderId": { "description": "The ID of the order.", "type": "string" }, "merchantOrderId": { "description": "Merchant-provided ID of the order.", "type": "string" }, "transactionDate": { "description": "The date of the transaction, in ISO 8601 format.", "type": "string" }, "productAmount": { "description": "Total amount for the items.", "$ref": "ProductAmount" } } }, "ProductAmount": { "id": "ProductAmount", "type": "object", "properties": { "priceAmount": { "description": "The pre-tax or post-tax price depending on the location of the order.", "$ref": "Price" }, "taxAmount": { "description": "Tax value.", "$ref": "Price" }, "remittedTaxAmount": { "description": "Remitted tax value.", "$ref": "Price" } } }, "OrderreturnsAcknowledgeRequest": { "id": "OrderreturnsAcknowledgeRequest", "type": "object", "properties": { "operationId": { "description": "[required] The ID of the operation, unique across all operations for a given order return.", "type": "string" } } }, "OrderreturnsAcknowledgeResponse": { "id": "OrderreturnsAcknowledgeResponse", "type": "object", "properties": { "executionStatus": { "description": "The status of the execution. Acceptable values are: - \"`duplicate`\" - \"`executed`\" ", "type": "string" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#orderreturnsAcknowledgeResponse`\".", "type": "string" } } }, "OrderreturnsCreateOrderReturnRequest": { "id": "OrderreturnsCreateOrderReturnRequest", "type": "object", "properties": { "orderId": { "description": "The ID of the order.", "type": "string" }, "operationId": { "description": "The ID of the operation. Unique across all operations for a given order.", "type": "string" }, "lineItems": { "description": "The list of line items to return.", "type": "array", "items": { "$ref": "OrderreturnsLineItem" } }, "returnMethodType": { "description": "The way of the package being returned.", "type": "string" } } }, "OrderreturnsLineItem": { "id": "OrderreturnsLineItem", "type": "object", "properties": { "lineItemId": { "description": "The ID of the line item. 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 cancel. This is the REST ID used in the products service. Either lineItemId or productId is required.", "type": "string" }, "quantity": { "description": "The quantity of this line item.", "type": "integer", "format": "uint32" } } }, "OrderreturnsCreateOrderReturnResponse": { "id": "OrderreturnsCreateOrderReturnResponse", "type": "object", "properties": { "executionStatus": { "description": "The status of the execution. Acceptable values are: - \"`duplicate`\" - \"`executed`\" ", "type": "string" }, "orderReturn": { "description": "Created order return.", "$ref": "MerchantOrderReturn" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#orderreturnsCreateOrderReturnResponse`\".", "type": "string" } } }, "MerchantOrderReturn": { "id": "MerchantOrderReturn", "description": "Order return. Production access (all methods) requires the order manager role. Sandbox access does not.", "type": "object", "properties": { "orderReturnId": { "description": "Order return ID generated by Google.", "type": "string" }, "orderId": { "description": "Google order ID.", "type": "string" }, "merchantOrderId": { "description": "Merchant defined order ID.", "type": "string" }, "creationDate": { "description": "The date of creation of the return, in ISO 8601 format.", "type": "string" }, "returnShipments": { "description": "Shipments of the return.", "type": "array", "items": { "$ref": "ReturnShipment" } }, "returnItems": { "description": "Items of the return.", "type": "array", "items": { "$ref": "MerchantOrderReturnItem" } }, "returnPricingInfo": { "description": "Information about shipping costs.", "$ref": "ReturnPricingInfo" } } }, "ReturnShipment": { "id": "ReturnShipment", "type": "object", "properties": { "shipmentId": { "description": "Shipment ID generated by Google.", "type": "string" }, "state": { "description": "State of the shipment. Acceptable values are: - \"`completed`\" - \"`new`\" - \"`shipped`\" - \"`undeliverable`\" - \"`pending`\" ", "type": "string" }, "creationDate": { "description": "The date of creation of the shipment, in ISO 8601 format.", "type": "string" }, "shippingDate": { "description": "The date of shipping of the shipment, in ISO 8601 format.", "type": "string" }, "deliveryDate": { "description": "The date of delivery of the shipment, in ISO 8601 format.", "type": "string" }, "shipmentTrackingInfos": { "description": "Tracking information of the shipment. One return shipment might be handled by several shipping carriers sequentially.", "type": "array", "items": { "$ref": "ShipmentTrackingInfo" } }, "returnMethodType": { "description": "Type of the return method. Acceptable values are: - \"`byMail`\" - \"`contactCustomerSupport`\" - \"`returnless`\" - \"`inStore`\" ", "type": "string" } } }, "ShipmentTrackingInfo": { "id": "ShipmentTrackingInfo", "type": "object", "properties": { "carrier": { "description": "The shipping carrier that handles the package. Acceptable values are: - \"`boxtal`\" - \"`bpost`\" - \"`chronopost`\" - \"`colisPrive`\" - \"`colissimo`\" - \"`cxt`\" - \"`deliv`\" - \"`dhl`\" - \"`dpd`\" - \"`dynamex`\" - \"`eCourier`\" - \"`easypost`\" - \"`efw`\" - \"`fedex`\" - \"`fedexSmartpost`\" - \"`geodis`\" - \"`gls`\" - \"`googleCourier`\" - \"`gsx`\" - \"`jdLogistics`\" - \"`laPoste`\" - \"`lasership`\" - \"`manual`\" - \"`mpx`\" - \"`onTrac`\" - \"`other`\" - \"`tnt`\" - \"`uds`\" - \"`ups`\" - \"`usps`\" ", "type": "string" }, "trackingNumber": { "description": "The tracking number for the package.", "type": "string" } } }, "MerchantOrderReturnItem": { "id": "MerchantOrderReturnItem", "type": "object", "properties": { "itemId": { "description": "Product level item ID. If the returned items are of the same product, they will have the same ID.", "type": "string" }, "returnShipmentIds": { "description": "IDs of the return shipments that this return item belongs to.", "type": "array", "items": { "type": "string" } }, "product": { "description": "Product data from the time of the order placement.", "$ref": "OrderLineItemProduct" }, "state": { "description": "State of the item. Acceptable values are: - \"`canceled`\" - \"`new`\" - \"`received`\" - \"`refunded`\" - \"`rejected`\" ", "type": "string" }, "customerReturnReason": { "description": "The reason that the customer chooses to return an item.", "$ref": "CustomerReturnReason" }, "merchantReturnReason": { "description": "The reason that merchant chooses to accept a return item.", "$ref": "RefundReason" }, "merchantRejectionReason": { "description": "The reason that the merchant chose to reject an item return.", "$ref": "MerchantRejectionReason" }, "shipmentGroupId": { "description": "ID of the original shipment group. Provided for shipments with invoice support.", "type": "string" }, "shipmentUnitId": { "description": "ID of the shipment unit assigned by the merchant. Provided for shipments with invoice support.", "type": "string" }, "refundableAmount": { "description": "Maximum amount that can be refunded for this return item.", "$ref": "MonetaryAmount" }, "returnItemId": { "description": "Unit level ID for the return item. Different units of the same product will have different IDs.", "type": "string" } } }, "OrderLineItemProduct": { "id": "OrderLineItemProduct", "type": "object", "properties": { "id": { "description": "The REST ID of the product.", "type": "string" }, "offerId": { "description": "An identifier of the item.", "type": "string" }, "targetCountry": { "description": "The CLDR territory code of the target country of the product.", "type": "string" }, "contentLanguage": { "description": "The two-letter ISO 639-1 language code for the item.", "type": "string" }, "price": { "description": "Price of the item.", "$ref": "Price" }, "title": { "description": "The title of the product.", "type": "string" }, "gtin": { "description": "Global Trade Item Number (GTIN) of the item.", "type": "string" }, "brand": { "description": "Brand of the item.", "type": "string" }, "mpn": { "description": "Manufacturer Part Number (MPN) of the item.", "type": "string" }, "condition": { "description": "Condition or state of the item. Acceptable values are: - \"`new`\" - \"`refurbished`\" - \"`used`\" ", "type": "string" }, "itemGroupId": { "description": "Shared identifier for all variants of the same product.", "type": "string" }, "imageLink": { "description": "URL of an image of the item.", "type": "string" }, "shownImage": { "description": "URL to the cached image shown to the user when order was placed.", "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.", "type": "array", "items": { "$ref": "OrderLineItemProductVariantAttribute" } }, "fees": { "description": "Associated fees at order creation time.", "type": "array", "items": { "$ref": "OrderLineItemProductFee" } } } }, "OrderLineItemProductVariantAttribute": { "id": "OrderLineItemProductVariantAttribute", "type": "object", "properties": { "dimension": { "description": "The dimension of the variant.", "type": "string" }, "value": { "description": "The value for the dimension.", "type": "string" } } }, "OrderLineItemProductFee": { "id": "OrderLineItemProductFee", "type": "object", "properties": { "name": { "description": "Name of the fee.", "type": "string" }, "amount": { "description": "Amount of the fee.", "$ref": "Price" } } }, "CustomerReturnReason": { "id": "CustomerReturnReason", "type": "object", "properties": { "reasonCode": { "description": "Code of the return reason. Acceptable values are: - \"`betterPriceFound`\" - \"`changedMind`\" - \"`damagedOrDefectiveItem`\" - \"`didNotMatchDescription`\" - \"`doesNotFit`\" - \"`expiredItem`\" - \"`incorrectItemReceived`\" - \"`noLongerNeeded`\" - \"`notSpecified`\" - \"`orderedWrongItem`\" - \"`other`\" - \"`qualityNotExpected`\" - \"`receivedTooLate`\" - \"`undeliverable`\" ", "type": "string" }, "description": { "description": "Description of the reason.", "type": "string" } } }, "RefundReason": { "id": "RefundReason", "type": "object", "properties": { "reasonCode": { "description": "Code of the refund reason. Acceptable values are: - \"`adjustment`\" - \"`autoPostInternal`\" - \"`autoPostInvalidBillingAddress`\" - \"`autoPostNoInventory`\" - \"`autoPostPriceError`\" - \"`autoPostUndeliverableShippingAddress`\" - \"`couponAbuse`\" - \"`courtesyAdjustment`\" - \"`customerCanceled`\" - \"`customerDiscretionaryReturn`\" - \"`customerInitiatedMerchantCancel`\" - \"`customerSupportRequested`\" - \"`deliveredLateByCarrier`\" - \"`deliveredTooLate`\" - \"`expiredItem`\" - \"`failToPushOrderGoogleError`\" - \"`failToPushOrderMerchantError`\" - \"`failToPushOrderMerchantFulfillmentError`\" - \"`failToPushOrderToMerchant`\" - \"`failToPushOrderToMerchantOutOfStock`\" - \"`feeAdjustment`\" - \"`invalidCoupon`\" - \"`lateShipmentCredit`\" - \"`malformedShippingAddress`\" - \"`merchantDidNotShipOnTime`\" - \"`noInventory`\" - \"`orderTimeout`\" - \"`other`\" - \"`paymentAbuse`\" - \"`paymentDeclined`\" - \"`priceAdjustment`\" - \"`priceError`\" - \"`productArrivedDamaged`\" - \"`productNotAsDescribed`\" - \"`promoReallocation`\" - \"`qualityNotAsExpected`\" - \"`returnRefundAbuse`\" - \"`shippingCostAdjustment`\" - \"`shippingPriceError`\" - \"`taxAdjustment`\" - \"`taxError`\" - \"`undeliverableShippingAddress`\" - \"`unsupportedPoBoxAddress`\" - \"`wrongProductShipped`\" ", "type": "string" }, "description": { "description": "Description of the reason.", "type": "string" } } }, "MerchantRejectionReason": { "id": "MerchantRejectionReason", "type": "object", "properties": { "reasonCode": { "description": "Code of the rejection reason.", "type": "string" }, "description": { "description": "Description of the reason.", "type": "string" } } }, "MonetaryAmount": { "id": "MonetaryAmount", "type": "object", "properties": { "priceAmount": { "description": "The pre-tax or post-tax price depends on the location of the order. - For countries (for example, \"US\". where price attribute excludes tax, this field corresponds to the pre-tax value. - For coutries (for example, \"France\") where price attribute includes tax, this field corresponds to the post-tax value .", "$ref": "Price" }, "taxAmount": { "description": "Tax value, present only for countries where price attribute excludes tax (for example, \"US\". No tax is referenced as 0 value with the corresponding `currency`.", "$ref": "Price" } } }, "ReturnPricingInfo": { "id": "ReturnPricingInfo", "type": "object", "properties": { "refundableItemsTotalAmount": { "description": "Total amount that can be refunded for the items in this return. It represents the total amount received by the merchant for the items, after applying merchant coupons.", "$ref": "MonetaryAmount" }, "refundableShippingAmount": { "description": "Maximum amount that can be refunded for the original shipping fee.", "$ref": "MonetaryAmount" }, "chargeReturnShippingFee": { "description": "Default option for whether merchant should charge the customer for return shipping costs, based on customer selected return reason and merchant's return policy for the items being returned.", "type": "boolean" }, "maxReturnShippingFee": { "description": "Maximum return shipping costs that may be charged to the customer depending on merchant's assessment of the return reason and the merchant's return policy for the items being returned.", "$ref": "MonetaryAmount" }, "totalRefundedAmount": { "description": "Total amount already refunded by the merchant. It includes all types of refunds (items, shipping, etc.) Not provided if no refund has been applied yet.", "$ref": "MonetaryAmount" } } }, "OrderreturnsListResponse": { "id": "OrderreturnsListResponse", "type": "object", "properties": { "nextPageToken": { "description": "The token for the retrieval of the next page of returns.", "type": "string" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#orderreturnsListResponse`\".", "type": "string" }, "resources": { "type": "array", "items": { "$ref": "MerchantOrderReturn" } } } }, "OrderreturnsProcessRequest": { "id": "OrderreturnsProcessRequest", "type": "object", "properties": { "operationId": { "description": "[required] The ID of the operation, unique across all operations for a given order return.", "type": "string" }, "returnItems": { "description": "The list of items to return.", "type": "array", "items": { "$ref": "OrderreturnsReturnItem" } }, "fullChargeReturnShippingCost": { "description": "Option to charge the customer return shipping cost.", "type": "boolean" }, "refundShippingFee": { "description": "Refunds for original shipping fee.", "$ref": "OrderreturnsRefundOperation" } } }, "OrderreturnsReturnItem": { "id": "OrderreturnsReturnItem", "type": "object", "properties": { "returnItemId": { "description": "Unit level ID for the return item. Different units of the same product will have different IDs.", "type": "string" }, "refund": { "description": "Refunds the item.", "$ref": "OrderreturnsRefundOperation" }, "reject": { "description": "Rejects the item.", "$ref": "OrderreturnsRejectOperation" } } }, "OrderreturnsRefundOperation": { "id": "OrderreturnsRefundOperation", "type": "object", "properties": { "returnRefundReason": { "description": "Code of the refund reason.", "type": "string" }, "fullRefund": { "description": "If true, the item will be fully refunded. Allowed only when payment_type is FOP. Merchant can choose this refund option to indicate the full remaining amount of corresponding object to be refunded to the customer through FOP.", "type": "boolean" }, "partialRefund": { "description": "If this is set, the item will be partially refunded. Merchant can choose this refund option to specify the customized amount that to be refunded to the customer.", "$ref": "OrderreturnsPartialRefund" }, "reasonText": { "description": "The explanation of the reason.", "type": "string" }, "paymentType": { "description": "The payment way of issuing refund. Default value is ORIGINAL_FOP if not set.", "type": "string" } } }, "OrderreturnsPartialRefund": { "id": "OrderreturnsPartialRefund", "type": "object", "properties": { "priceAmount": { "description": "The pre-tax or post-tax amount to be refunded, depending on the location of the order.", "$ref": "Price" }, "taxAmount": { "description": "Tax amount to be refunded. Note: This has different meaning depending on the location of the order.", "$ref": "Price" } } }, "OrderreturnsRejectOperation": { "id": "OrderreturnsRejectOperation", "type": "object", "properties": { "reason": { "description": "The reason for the return.", "type": "string" }, "reasonText": { "description": "The explanation of the reason.", "type": "string" } } }, "OrderreturnsProcessResponse": { "id": "OrderreturnsProcessResponse", "type": "object", "properties": { "executionStatus": { "description": "The status of the execution. Acceptable values are: - \"`duplicate`\" - \"`executed`\" ", "type": "string" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#orderreturnsProcessResponse`\".", "type": "string" } } }, "OrdersAcknowledgeRequest": { "id": "OrdersAcknowledgeRequest", "type": "object", "properties": { "operationId": { "description": "The ID of the operation. Unique across all operations for a given order.", "type": "string" } } }, "OrdersAcknowledgeResponse": { "id": "OrdersAcknowledgeResponse", "type": "object", "properties": { "executionStatus": { "description": "The status of the execution. Acceptable values are: - \"`duplicate`\" - \"`executed`\" ", "type": "string" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#ordersAcknowledgeResponse`\".", "type": "string" } } }, "OrdersAdvanceTestOrderResponse": { "id": "OrdersAdvanceTestOrderResponse", "type": "object", "properties": { "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#ordersAdvanceTestOrderResponse`\".", "type": "string" } } }, "OrdersCancelRequest": { "id": "OrdersCancelRequest", "type": "object", "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. Acceptable values are: - \"`customerInitiatedCancel`\" - \"`invalidCoupon`\" - \"`malformedShippingAddress`\" - \"`noInventory`\" - \"`other`\" - \"`priceError`\" - \"`shippingPriceError`\" - \"`taxError`\" - \"`undeliverableShippingAddress`\" - \"`unsupportedPoBoxAddress`\" - \"`failedToCaptureFunds`\" ", "type": "string" }, "reasonText": { "description": "The explanation of the reason.", "type": "string" } } }, "OrdersCancelResponse": { "id": "OrdersCancelResponse", "type": "object", "properties": { "executionStatus": { "description": "The status of the execution. Acceptable values are: - \"`duplicate`\" - \"`executed`\" ", "type": "string" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#ordersCancelResponse`\".", "type": "string" } } }, "OrdersCancelLineItemRequest": { "id": "OrdersCancelLineItemRequest", "type": "object", "properties": { "operationId": { "description": "The ID of the operation. Unique across all operations for a given order.", "type": "string" }, "lineItemId": { "description": "The ID of the line item to cancel. Either lineItemId or productId is required.", "type": "string" }, "quantity": { "description": "The quantity to cancel.", "type": "integer", "format": "uint32" }, "reason": { "description": "The reason for the cancellation. Acceptable values are: - \"`customerInitiatedCancel`\" - \"`invalidCoupon`\" - \"`malformedShippingAddress`\" - \"`noInventory`\" - \"`other`\" - \"`priceError`\" - \"`shippingPriceError`\" - \"`taxError`\" - \"`undeliverableShippingAddress`\" - \"`unsupportedPoBoxAddress`\" - \"`failedToCaptureFunds`\" ", "type": "string" }, "reasonText": { "description": "The explanation of the reason.", "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" } } }, "OrdersCancelLineItemResponse": { "id": "OrdersCancelLineItemResponse", "type": "object", "properties": { "executionStatus": { "description": "The status of the execution. Acceptable values are: - \"`duplicate`\" - \"`executed`\" ", "type": "string" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#ordersCancelLineItemResponse`\".", "type": "string" } } }, "OrdersCancelTestOrderByCustomerRequest": { "id": "OrdersCancelTestOrderByCustomerRequest", "type": "object", "properties": { "reason": { "description": "The reason for the cancellation. Acceptable values are: - \"`changedMind`\" - \"`orderedWrongItem`\" - \"`other`\" ", "type": "string" } } }, "OrdersCancelTestOrderByCustomerResponse": { "id": "OrdersCancelTestOrderByCustomerResponse", "type": "object", "properties": { "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#ordersCancelTestOrderByCustomerResponse`\".", "type": "string" } } }, "OrdersCreateTestOrderRequest": { "id": "OrdersCreateTestOrderRequest", "type": "object", "properties": { "testOrder": { "description": "The test order to create.", "$ref": "TestOrder" }, "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. Acceptable values are: - \"`template1`\" - \"`template1a`\" - \"`template1b`\" - \"`template2`\" - \"`template3`\" ", "type": "string" }, "country": { "description": "The CLDR territory code of the country of the test order to create. Affects the currency and addresses of orders created through `template_name`, or the addresses of orders created through `test_order`. Acceptable values are: - \"`US`\" - \"`FR`\" Defaults to \"`US`\".", "type": "string" } } }, "TestOrder": { "id": "TestOrder", "type": "object", "properties": { "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#testOrder`\"", "type": "string" }, "lineItems": { "description": "Required. Line items that are ordered. At least one line item must be provided.", "type": "array", "items": { "$ref": "TestOrderLineItem" } }, "shippingOption": { "description": "Required. The requested shipping option. Acceptable values are: - \"`economy`\" - \"`expedited`\" - \"`oneDay`\" - \"`sameDay`\" - \"`standard`\" - \"`twoDay`\" ", "type": "string" }, "predefinedDeliveryAddress": { "description": "Required. Identifier of one of the predefined delivery addresses for the delivery. Acceptable values are: - \"`dwight`\" - \"`jim`\" - \"`pam`\" ", "type": "string" }, "shippingCost": { "description": "Required. 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.", "$ref": "Price" }, "notificationMode": { "description": "Restricted. Do not use.", "type": "string" }, "enableOrderinvoices": { "description": "Whether the orderinvoices service should support this order.", "type": "boolean" }, "predefinedBillingAddress": { "description": "Required. The billing address. Acceptable values are: - \"`dwight`\" - \"`jim`\" - \"`pam`\" ", "type": "string" }, "promotions": { "description": "Promotions associated with the order.", "type": "array", "items": { "$ref": "OrderPromotion" } }, "predefinedEmail": { "description": "Required. Email address of the customer. Acceptable values are: - \"`pog.dwight.schrute@gmail.com`\" - \"`pog.jim.halpert@gmail.com`\" - \"`penpog.pam.beesly@gmail.comding`\" ", "type": "string" }, "predefinedPickupDetails": { "description": "Identifier of one of the predefined pickup details. Required for orders containing line items with shipping type `pickup`. Acceptable values are: - \"`dwight`\" - \"`jim`\" - \"`pam`\" ", "type": "string" }, "pickupDetails": { "description": "Overrides the predefined pickup details if provided.", "$ref": "TestOrderPickupDetails" }, "deliveryDetails": { "description": "Overrides the predefined delivery details if provided.", "$ref": "TestOrderDeliveryDetails" } } }, "TestOrderLineItem": { "id": "TestOrderLineItem", "type": "object", "properties": { "product": { "description": "Required. Product data from the time of the order placement.", "$ref": "TestOrderLineItemProduct" }, "quantityOrdered": { "description": "Required. Number of items ordered.", "type": "integer", "format": "uint32" }, "shippingDetails": { "description": "Required. Details of the requested shipping for the line item.", "$ref": "OrderLineItemShippingDetails" }, "returnInfo": { "description": "Required. Details of the return policy for the line item.", "$ref": "OrderLineItemReturnInfo" } } }, "TestOrderLineItemProduct": { "id": "TestOrderLineItemProduct", "type": "object", "properties": { "offerId": { "description": "Required. An identifier of the item.", "type": "string" }, "targetCountry": { "description": "Required. The CLDR territory code of the target country of the product.", "type": "string" }, "contentLanguage": { "description": "Required. The two-letter ISO 639-1 language code for the item. Acceptable values are: - \"`en`\" - \"`fr`\" ", "type": "string" }, "title": { "description": "Required. The title of the product.", "type": "string" }, "price": { "description": "Required. 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.", "$ref": "Price" }, "condition": { "description": "Required. Condition or state of the item. Acceptable values are: - \"`new`\" ", "type": "string" }, "gtin": { "description": "Global Trade Item Number (GTIN) of the item. Optional.", "type": "string" }, "brand": { "description": "Required. Brand of the item.", "type": "string" }, "mpn": { "description": "Manufacturer Part Number (MPN) of the item. Optional.", "type": "string" }, "variantAttributes": { "description": "Variant attributes for the item. Optional.", "type": "array", "items": { "$ref": "OrderLineItemProductVariantAttribute" } }, "itemGroupId": { "description": "Shared identifier for all variants of the same product. Optional.", "type": "string" }, "imageLink": { "description": "Required. URL of an image of the item.", "type": "string" }, "fees": { "description": "Fees for the item. Optional.", "type": "array", "items": { "$ref": "OrderLineItemProductFee" } } } }, "OrderLineItemShippingDetails": { "id": "OrderLineItemShippingDetails", "type": "object", "properties": { "method": { "description": "Required. Details of the shipping method.", "$ref": "OrderLineItemShippingDetailsMethod" }, "shipByDate": { "description": "Required. The ship by date, in ISO 8601 format.", "type": "string" }, "deliverByDate": { "description": "Required. The delivery by date, in ISO 8601 format.", "type": "string" }, "type": { "description": "Type of shipment. Indicates whether `deliveryDetails` or `pickupDetails` is applicable for this shipment. Acceptable values are: - \"`delivery`\" - \"`pickup`\" ", "type": "string" }, "pickupPromiseInMinutes": { "description": "The promised time in minutes in which the order will be ready for pickup. This only applies to buy-online-pickup-in-store same-day order.", "type": "integer", "format": "uint32" } } }, "OrderLineItemShippingDetailsMethod": { "id": "OrderLineItemShippingDetailsMethod", "type": "object", "properties": { "methodName": { "description": "Required. The name of the shipping method.", "type": "string" }, "carrier": { "description": "The carrier for the shipping. Optional. See `shipments[].carrier` for a list of acceptable values.", "type": "string" }, "minDaysInTransit": { "description": "Required. Minimum transit time.", "type": "integer", "format": "uint32" }, "maxDaysInTransit": { "description": "Required. Maximum transit time.", "type": "integer", "format": "uint32" } } }, "OrderLineItemReturnInfo": { "id": "OrderLineItemReturnInfo", "type": "object", "properties": { "isReturnable": { "description": "Required. Whether the item is returnable.", "type": "boolean" }, "daysToReturn": { "description": "Required. How many days later the item can be returned.", "type": "integer", "format": "int32" }, "policyUrl": { "description": "Required. URL of the item return policy.", "type": "string" } } }, "OrderPromotion": { "id": "OrderPromotion", "type": "object", "properties": { "merchantPromotionId": { "description": "Required. This field is used to identify promotions within merchants' own systems.", "type": "string" }, "type": { "description": "Required. The scope of the promotion. Only `product` is supported for `orders.createtestorder`. Acceptable values are: - \"`product`\" - \"`shipping`\" ", "type": "string" }, "subtype": { "description": "Required. The category of the promotion. Only `moneyOff` is supported for `orders.createtestorder`. Acceptable values are: - \"`buyMGetMoneyOff`\" - \"`buyMGetNMoneyOff`\" - \"`buyMGetNPercentOff`\" - \"`buyMGetPercentOff`\" - \"`freeGift`\" - \"`freeGiftWithItemId`\" - \"`freeGiftWithValue`\" - \"`freeShippingOvernight`\" - \"`freeShippingStandard`\" - \"`freeShippingTwoDay`\" - \"`moneyOff`\" - \"`percentOff`\" - \"`rewardPoints`\" - \"`salePrice`\" ", "type": "string" }, "funder": { "description": "Required. The party funding the promotion. Only `merchant` is supported for `orders.createtestorder`. Acceptable values are: - \"`google`\" - \"`merchant`\" ", "type": "string" }, "title": { "description": "Required. The title of the promotion.", "type": "string" }, "shortTitle": { "description": "A short title of the promotion to be shown on the checkout page. Do not provide for `orders.createtestorder`.", "type": "string" }, "priceValue": { "description": "Estimated discount applied to price. Amount is pre-tax or post-tax depending on location of order.", "$ref": "Price" }, "taxValue": { "description": "Estimated discount applied to tax (if allowed by law). Do not provide for `orders.createtestorder`.", "$ref": "Price" }, "applicableItems": { "description": "Items that this promotion may be applied to. If empty, there are no restrictions on applicable items and quantity. This field will also be empty for shipping promotions because shipping is not tied to any specific item.", "type": "array", "items": { "$ref": "OrderPromotionItem" } }, "appliedItems": { "description": "Items that this promotion have been applied to. Do not provide for `orders.createtestorder`. This field will be empty for shipping promotions because shipping is not tied to any specific item.", "type": "array", "items": { "$ref": "OrderPromotionItem" } }, "startTime": { "description": "Promotion start time in ISO 8601 format. Date, time, and offset required, for example, \"2020-01-02T09:00:00+01:00\" or \"2020-01-02T09:00:00Z\".", "type": "string" }, "endTime": { "description": "Promotion end time in ISO 8601 format. Date, time, and offset required, for example, \"2020-01-02T09:00:00+01:00\" or \"2020-01-02T09:00:00Z\".", "type": "string" } } }, "OrderPromotionItem": { "id": "OrderPromotionItem", "type": "object", "properties": { "lineItemId": { "description": "The line item ID of a product. Do not provide 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`.", "type": "integer", "format": "int32" }, "offerId": { "description": "Required. Offer ID of a product. Only for `orders.createtestorder`.", "type": "string" } } }, "TestOrderPickupDetails": { "id": "TestOrderPickupDetails", "type": "object", "properties": { "pickupPersons": { "description": "Required. all pickup persons set by users.", "type": "array", "items": { "$ref": "TestOrderPickupDetailsPickupPerson" } }, "locationCode": { "description": "Required. Code of the location defined by provider or merchant.", "type": "string" }, "pickupLocationAddress": { "description": "Required. Pickup location address.", "$ref": "TestOrderAddress" }, "pickupLocationType": { "description": "Pickup location type. Acceptable values are: - \"`locker`\" - \"`store`\" - \"`curbside`\" ", "type": "string" } } }, "TestOrderPickupDetailsPickupPerson": { "id": "TestOrderPickupDetailsPickupPerson", "type": "object", "properties": { "name": { "description": "Required. Full name of the pickup person.", "type": "string" }, "phoneNumber": { "description": "Required. The phone number of the person picking up the items.", "type": "string" } } }, "TestOrderAddress": { "id": "TestOrderAddress", "type": "object", "properties": { "recipientName": { "description": "Name of the recipient.", "type": "string" }, "streetAddress": { "description": "Street-level part of the address. Use `\\n` to add a second line.", "type": "array", "items": { "type": "string" } }, "locality": { "description": "City, town or commune. May also include dependent localities or sublocalities (for example, neighborhoods or suburbs).", "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" }, "country": { "description": "CLDR country code (for example, \"US\").", "type": "string" }, "postalCode": { "description": "Postal Code or ZIP (for example, \"94043\").", "type": "string" }, "isPostOfficeBox": { "description": "Whether the address is a post office box.", "type": "boolean" }, "fullAddress": { "description": "Strings representing the lines of the printed label for mailing the order, for example: John Smith 1600 Amphitheatre Parkway Mountain View, CA, 94043 United States ", "type": "array", "items": { "type": "string" } } } }, "TestOrderDeliveryDetails": { "id": "TestOrderDeliveryDetails", "type": "object", "properties": { "address": { "description": "The delivery address", "$ref": "TestOrderAddress" }, "phoneNumber": { "description": "The phone number of the person receiving the delivery.", "type": "string" }, "isScheduledDelivery": { "description": "Whether the order is scheduled delivery order.", "type": "boolean" } } }, "OrdersCreateTestOrderResponse": { "id": "OrdersCreateTestOrderResponse", "type": "object", "properties": { "orderId": { "description": "The ID of the newly created test order.", "type": "string" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#ordersCreateTestOrderResponse`\".", "type": "string" } } }, "OrdersCreateTestReturnRequest": { "id": "OrdersCreateTestReturnRequest", "type": "object", "properties": { "items": { "description": "Returned items.", "type": "array", "items": { "$ref": "OrdersCustomBatchRequestEntryCreateTestReturnReturnItem" } } } }, "OrdersCustomBatchRequestEntryCreateTestReturnReturnItem": { "id": "OrdersCustomBatchRequestEntryCreateTestReturnReturnItem", "type": "object", "properties": { "lineItemId": { "description": "The ID of the line item to return.", "type": "string" }, "quantity": { "description": "Quantity that is returned.", "type": "integer", "format": "uint32" } } }, "OrdersCreateTestReturnResponse": { "id": "OrdersCreateTestReturnResponse", "type": "object", "properties": { "returnId": { "description": "The ID of the newly created test order return.", "type": "string" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#ordersCreateTestReturnResponse`\".", "type": "string" } } }, "Order": { "id": "Order", "description": "Order. Production access (all methods) requires the order manager role. Sandbox access does not.", "type": "object", "properties": { "id": { "description": "The REST ID of the order. Globally unique.", "type": "string" }, "merchantId": { "type": "string", "format": "uint64" }, "merchantOrderId": { "description": "Merchant-provided ID of the order.", "type": "string" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#order`\"", "type": "string" }, "lineItems": { "description": "Line items that are ordered.", "type": "array", "items": { "$ref": "OrderLineItem" } }, "status": { "description": "The status of the order. Acceptable values are: - \"`canceled`\" - \"`delivered`\" - \"`inProgress`\" - \"`partiallyDelivered`\" - \"`partiallyReturned`\" - \"`partiallyShipped`\" - \"`pendingShipment`\" - \"`returned`\" - \"`shipped`\" ", "type": "string" }, "paymentStatus": { "description": "The status of the payment. Acceptable values are: - \"`paymentCaptured`\" - \"`paymentRejected`\" - \"`paymentSecured`\" - \"`pendingAuthorization`\" ", "type": "string" }, "acknowledged": { "description": "Whether the order was acknowledged.", "type": "boolean" }, "placedDate": { "description": "The date when the order was placed, in ISO 8601 format.", "type": "string" }, "deliveryDetails": { "description": "Delivery details for shipments of type `delivery`.", "$ref": "OrderDeliveryDetails" }, "customer": { "description": "The details of the customer who placed the order.", "$ref": "OrderCustomer" }, "shippingCost": { "description": "The total cost of shipping for all items.", "$ref": "Price" }, "shippingCostTax": { "description": "The tax for the total shipping cost.", "$ref": "Price" }, "refunds": { "description": "Refunds for the order.", "type": "array", "items": { "$ref": "OrderRefund" } }, "shipments": { "description": "Shipments of the order.", "type": "array", "items": { "$ref": "OrderShipment" } }, "billingAddress": { "description": "The billing address.", "$ref": "OrderAddress" }, "promotions": { "description": "Promotions associated with the order. To 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. Examples: 1. 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`. 2. 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. Only 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. More details about the program are here.", "type": "array", "items": { "$ref": "OrderPromotion" } }, "taxCollector": { "description": "The party responsible for collecting and remitting taxes. Acceptable values are: - \"`marketplaceFacilitator`\" - \"`merchant`\" ", "type": "string" }, "netPriceAmount": { "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.", "$ref": "Price" }, "netTaxAmount": { "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.", "$ref": "Price" }, "pickupDetails": { "description": "Pickup details for shipments of type `pickup`.", "$ref": "OrderPickupDetails" }, "annotations": { "description": "List of key-value pairs that are attached to a given order.", "type": "array", "items": { "$ref": "OrderOrderAnnotation" } } } }, "OrderLineItem": { "id": "OrderLineItem", "type": "object", "properties": { "id": { "description": "The ID of the line item.", "type": "string" }, "quantityOrdered": { "description": "Number of items ordered.", "type": "integer", "format": "uint32" }, "quantityPending": { "description": "Number of items pending.", "type": "integer", "format": "uint32" }, "quantityShipped": { "description": "Number of items shipped.", "type": "integer", "format": "uint32" }, "quantityDelivered": { "description": "Number of items delivered.", "type": "integer", "format": "uint32" }, "quantityReturned": { "description": "Number of items returned.", "type": "integer", "format": "uint32" }, "quantityCanceled": { "description": "Number of items canceled.", "type": "integer", "format": "uint32" }, "price": { "description": "Total price for the line item. For example, if two items for $10 are purchased, the total price will be $20.", "$ref": "Price" }, "tax": { "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.", "$ref": "Price" }, "shippingDetails": { "description": "Details of the requested shipping for the line item.", "$ref": "OrderLineItemShippingDetails" }, "returnInfo": { "description": "Details of the return policy for the line item.", "$ref": "OrderLineItemReturnInfo" }, "product": { "description": "Product data as seen by customer from the time of the order placement. Note that certain attributes values (for example, title or gtin) might be reformatted and no longer match values submitted through product feed.", "$ref": "OrderLineItemProduct" }, "returns": { "description": "Returns of the line item.", "type": "array", "items": { "$ref": "OrderReturn" } }, "cancellations": { "description": "Cancellations of the line item.", "type": "array", "items": { "$ref": "OrderCancellation" } }, "annotations": { "description": "Annotations that are attached to the line item.", "type": "array", "items": { "$ref": "OrderMerchantProvidedAnnotation" } }, "adjustments": { "description": "Price and tax adjustments applied on the line item.", "type": "array", "items": { "$ref": "OrderLineItemAdjustment" } }, "quantityUndeliverable": { "description": "Number of items undeliverable.", "type": "integer", "format": "uint32" }, "quantityReadyForPickup": { "description": "Number of items ready for pickup.", "type": "integer", "format": "uint32" } } }, "OrderReturn": { "id": "OrderReturn", "type": "object", "properties": { "creationDate": { "description": "Date on which the item has been created, in ISO 8601 format.", "type": "string" }, "actor": { "description": "The actor that created the refund. Acceptable values are: - \"`customer`\" - \"`googleBot`\" - \"`googleCustomerService`\" - \"`googlePayments`\" - \"`googleSabre`\" - \"`merchant`\" ", "type": "string" }, "quantity": { "description": "Quantity that is returned.", "type": "integer", "format": "uint32" }, "reason": { "description": "The reason for the return. Acceptable values are: - \"`customerDiscretionaryReturn`\" - \"`customerInitiatedMerchantCancel`\" - \"`deliveredTooLate`\" - \"`expiredItem`\" - \"`invalidCoupon`\" - \"`malformedShippingAddress`\" - \"`other`\" - \"`productArrivedDamaged`\" - \"`productNotAsDescribed`\" - \"`qualityNotAsExpected`\" - \"`undeliverableShippingAddress`\" - \"`unsupportedPoBoxAddress`\" - \"`wrongProductShipped`\" ", "type": "string" }, "reasonText": { "description": "The explanation of the reason.", "type": "string" } } }, "OrderCancellation": { "id": "OrderCancellation", "type": "object", "properties": { "creationDate": { "description": "Date on which the cancellation has been created, in ISO 8601 format.", "type": "string" }, "actor": { "description": "The actor that created the cancellation. Acceptable values are: - \"`customer`\" - \"`googleBot`\" - \"`googleCustomerService`\" - \"`googlePayments`\" - \"`googleSabre`\" - \"`merchant`\" ", "type": "string" }, "quantity": { "description": "The quantity that was canceled.", "type": "integer", "format": "uint32" }, "reason": { "description": "The reason for the cancellation. Orders that are canceled with a noInventory reason will lead to the removal of the product from Buy on Google until you make an update to that product. This won't affect your Shopping ads. Acceptable values are: - \"`autoPostInternal`\" - \"`autoPostInvalidBillingAddress`\" - \"`autoPostNoInventory`\" - \"`autoPostPriceError`\" - \"`autoPostUndeliverableShippingAddress`\" - \"`couponAbuse`\" - \"`customerCanceled`\" - \"`customerInitiatedCancel`\" - \"`customerSupportRequested`\" - \"`failToPushOrderGoogleError`\" - \"`failToPushOrderMerchantError`\" - \"`failToPushOrderMerchantFulfillmentError`\" - \"`failToPushOrderToMerchant`\" - \"`failToPushOrderToMerchantOutOfStock`\" - \"`invalidCoupon`\" - \"`malformedShippingAddress`\" - \"`merchantDidNotShipOnTime`\" - \"`noInventory`\" - \"`orderTimeout`\" - \"`other`\" - \"`paymentAbuse`\" - \"`paymentDeclined`\" - \"`priceError`\" - \"`returnRefundAbuse`\" - \"`shippingPriceError`\" - \"`taxError`\" - \"`undeliverableShippingAddress`\" - \"`unsupportedPoBoxAddress`\" - \"`failedToCaptureFunds`\" ", "type": "string" }, "reasonText": { "description": "The explanation of the reason.", "type": "string" } } }, "OrderMerchantProvidedAnnotation": { "id": "OrderMerchantProvidedAnnotation", "type": "object", "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" } } }, "OrderLineItemAdjustment": { "id": "OrderLineItemAdjustment", "type": "object", "properties": { "type": { "description": "Type of this adjustment. Acceptable values are: - \"`promotion`\" ", "type": "string" }, "priceAdjustment": { "description": "Adjustment for total price of the line item.", "$ref": "Price" }, "taxAdjustment": { "description": "Adjustment for total tax of the line item.", "$ref": "Price" } } }, "OrderDeliveryDetails": { "id": "OrderDeliveryDetails", "type": "object", "properties": { "address": { "description": "The delivery address", "$ref": "OrderAddress" }, "phoneNumber": { "description": "The phone number of the person receiving the delivery.", "type": "string" } } }, "OrderAddress": { "id": "OrderAddress", "type": "object", "properties": { "recipientName": { "description": "Name of the recipient.", "type": "string" }, "streetAddress": { "description": "Street-level part of the address. Use `\\n` to add a second line.", "type": "array", "items": { "type": "string" } }, "locality": { "description": "City, town or commune. May also include dependent localities or sublocalities (for example, neighborhoods or suburbs).", "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" }, "country": { "description": "CLDR country code (for example, \"US\").", "type": "string" }, "postalCode": { "description": "Postal Code or ZIP (for example, \"94043\").", "type": "string" }, "isPostOfficeBox": { "description": "Whether the address is a post office box.", "type": "boolean" }, "fullAddress": { "description": "Strings representing the lines of the printed label for mailing the order, for example: John Smith 1600 Amphitheatre Parkway Mountain View, CA, 94043 United States ", "type": "array", "items": { "type": "string" } } } }, "OrderCustomer": { "id": "OrderCustomer", "type": "object", "properties": { "fullName": { "description": "Full name of the customer.", "type": "string" }, "marketingRightsInfo": { "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.", "$ref": "OrderCustomerMarketingRightsInfo" }, "loyaltyInfo": { "description": "Loyalty program information.", "$ref": "OrderCustomerLoyaltyInfo" }, "invoiceReceivingEmail": { "description": "Email address for the merchant to send value-added tax or invoice documentation of the order. Only the last document sent is made available to the customer. For more information, see About automated VAT invoicing for Buy on Google.", "type": "string" } } }, "OrderCustomerMarketingRightsInfo": { "id": "OrderCustomerMarketingRightsInfo", "type": "object", "properties": { "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" }, "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. Acceptable values are: - \"`denied`\" - \"`granted`\" ", "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" } } }, "OrderCustomerLoyaltyInfo": { "id": "OrderCustomerLoyaltyInfo", "type": "object", "properties": { "name": { "description": "Name of card/membership holder, this field will be populated when", "type": "string" }, "loyaltyNumber": { "description": "The loyalty card/membership number.", "type": "string" } } }, "OrderRefund": { "id": "OrderRefund", "type": "object", "properties": { "creationDate": { "description": "Date on which the item has been created, in ISO 8601 format.", "type": "string" }, "actor": { "description": "The actor that created the refund. Acceptable values are: - \"`customer`\" - \"`googleBot`\" - \"`googleCustomerService`\" - \"`googlePayments`\" - \"`googleSabre`\" - \"`merchant`\" ", "type": "string" }, "amount": { "description": "The amount that is refunded.", "$ref": "Price" }, "reason": { "description": "The reason for the refund. Acceptable values are: - \"`adjustment`\" - \"`autoPostInternal`\" - \"`autoPostInvalidBillingAddress`\" - \"`autoPostNoInventory`\" - \"`autoPostPriceError`\" - \"`autoPostUndeliverableShippingAddress`\" - \"`couponAbuse`\" - \"`courtesyAdjustment`\" - \"`customerCanceled`\" - \"`customerDiscretionaryReturn`\" - \"`customerInitiatedMerchantCancel`\" - \"`customerSupportRequested`\" - \"`deliveredLateByCarrier`\" - \"`deliveredTooLate`\" - \"`expiredItem`\" - \"`failToPushOrderGoogleError`\" - \"`failToPushOrderMerchantError`\" - \"`failToPushOrderMerchantFulfillmentError`\" - \"`failToPushOrderToMerchant`\" - \"`failToPushOrderToMerchantOutOfStock`\" - \"`feeAdjustment`\" - \"`invalidCoupon`\" - \"`lateShipmentCredit`\" - \"`malformedShippingAddress`\" - \"`merchantDidNotShipOnTime`\" - \"`noInventory`\" - \"`orderTimeout`\" - \"`other`\" - \"`paymentAbuse`\" - \"`paymentDeclined`\" - \"`priceAdjustment`\" - \"`priceError`\" - \"`productArrivedDamaged`\" - \"`productNotAsDescribed`\" - \"`promoReallocation`\" - \"`qualityNotAsExpected`\" - \"`returnRefundAbuse`\" - \"`shippingCostAdjustment`\" - \"`shippingPriceError`\" - \"`taxAdjustment`\" - \"`taxError`\" - \"`undeliverableShippingAddress`\" - \"`unsupportedPoBoxAddress`\" - \"`wrongProductShipped`\" ", "type": "string" }, "reasonText": { "description": "The explanation of the reason.", "type": "string" } } }, "OrderShipment": { "id": "OrderShipment", "type": "object", "properties": { "id": { "description": "The ID of the shipment.", "type": "string" }, "creationDate": { "description": "Date on which the shipment has been created, in ISO 8601 format.", "type": "string" }, "lineItems": { "description": "The line items that are shipped.", "type": "array", "items": { "$ref": "OrderShipmentLineItemShipment" } }, "status": { "description": "The status of the shipment. Acceptable values are: - \"`delivered`\" - \"`readyForPickup`\" - \"`shipped`\" - \"`undeliverable`\" ", "type": "string" }, "carrier": { "description": "The carrier handling the shipment. For 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 won't include the carrier name or tracking URL, and there will be no automatic order status updates. Supported carriers for \"US\" are: - \"`ups`\" (United Parcel Service) *automatic status updates* - \"`usps`\" (United States Postal Service) *automatic status updates* - \"`fedex`\" (FedEx) *automatic status updates * - \"`dhl`\" (DHL eCommerce) *automatic status updates* (US only) - \"`ontrac`\" (OnTrac) *automatic status updates * - \"`dhl express`\" (DHL Express) - \"`deliv`\" (Deliv) - \"`dynamex`\" (TForce) - \"`lasership`\" (LaserShip) - \"`mpx`\" (Military Parcel Xpress) - \"`uds`\" (United Delivery Service) - \"`efw`\" (Estes Forwarding Worldwide) - \"`jd logistics`\" (JD Logistics) - \"`yunexpress`\" (YunExpress) - \"`china post`\" (China Post) - \"`china ems`\" (China Post Express Mail Service) - \"`singapore post`\" (Singapore Post) - \"`pos malaysia`\" (Pos Malaysia) - \"`postnl`\" (PostNL) - \"`ptt`\" (PTT Turkish Post) - \"`eub`\" (ePacket) - \"`chukou1`\" (Chukou1 Logistics) - \"`bestex`\" (Best Express) - \"`canada post`\" (Canada Post) - \"`purolator`\" (Purolator) - \"`canpar`\" (Canpar) - \"`india post`\" (India Post) - \"`blue dart`\" (Blue Dart) - \"`delhivery`\" (Delhivery) - \"`dtdc`\" (DTDC) - \"`tpc india`\" (TPC India) - \"`lso`\" (Lone Star Overnight) - \"`tww`\" (Team Worldwide) - \"`deliver-it`\" (Deliver-IT) - \"`cdl last mile`\" (CDL Last Mile) Supported carriers for FR are: - \"`la poste`\" (La Poste) *automatic status updates * - \"`colissimo`\" (Colissimo by La Poste) *automatic status updates* - \"`ups`\" (United Parcel Service) *automatic status updates * - \"`chronopost`\" (Chronopost by La Poste) - \"`gls`\" (General Logistics Systems France) - \"`dpd`\" (DPD Group by GeoPost) - \"`bpost`\" (Belgian Post Group) - \"`colis prive`\" (Colis Privé) - \"`boxtal`\" (Boxtal) - \"`geodis`\" (GEODIS) - \"`tnt`\" (TNT) - \"`db schenker`\" (DB Schenker) - \"`aramex`\" (Aramex) ", "type": "string" }, "trackingId": { "description": "The tracking ID for the shipment.", "type": "string" }, "deliveryDate": { "description": "Date on which the shipment has been delivered, in ISO 8601 format. Present only if `status` is `delivered`", "type": "string" }, "shipmentGroupId": { "description": "The shipment group ID of the shipment. This is set in shiplineitems request.", "type": "string" }, "scheduledDeliveryDetails": { "description": "Delivery details of the shipment if scheduling is needed.", "$ref": "OrderShipmentScheduledDeliveryDetails" } } }, "OrderShipmentLineItemShipment": { "id": "OrderShipmentLineItemShipment", "type": "object", "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" }, "quantity": { "description": "The quantity that is shipped.", "type": "integer", "format": "uint32" }, "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" } } }, "OrderShipmentScheduledDeliveryDetails": { "id": "OrderShipmentScheduledDeliveryDetails", "type": "object", "properties": { "scheduledDate": { "description": "The date a shipment is scheduled for delivery, in ISO 8601 format.", "type": "string" }, "carrierPhoneNumber": { "description": "The phone number of the carrier fulfilling the delivery. The phone number is formatted as the international notation in ITU-T Recommendation E.123 (for example, \"+41 44 668 1800\").", "type": "string" } } }, "OrderPickupDetails": { "id": "OrderPickupDetails", "type": "object", "properties": { "locationId": { "description": "ID of the pickup location.", "type": "string" }, "address": { "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.", "$ref": "OrderAddress" }, "collectors": { "description": "Collectors authorized to pick up shipment from the pickup location.", "type": "array", "items": { "$ref": "OrderPickupDetailsCollector" } }, "pickupType": { "description": "The pickup type of this order. Acceptable values are: - \"`merchantStore`\" - \"`merchantStoreCurbside`\" - \"`merchantStoreLocker`\" - \"`thirdPartyPickupPoint`\" - \"`thirdPartyLocker`\" ", "type": "string" } } }, "OrderPickupDetailsCollector": { "id": "OrderPickupDetailsCollector", "type": "object", "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" } } }, "OrderOrderAnnotation": { "id": "OrderOrderAnnotation", "type": "object", "properties": { "key": { "description": "Key for additional google provided (as key-value pairs) annotation.", "type": "string" }, "value": { "description": "Value for additional google provided (as key-value pairs) annotation.", "type": "string" } } }, "OrdersGetByMerchantOrderIdResponse": { "id": "OrdersGetByMerchantOrderIdResponse", "type": "object", "properties": { "order": { "description": "The requested order.", "$ref": "Order" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#ordersGetByMerchantOrderIdResponse`\".", "type": "string" } } }, "OrdersGetTestOrderTemplateResponse": { "id": "OrdersGetTestOrderTemplateResponse", "type": "object", "properties": { "template": { "description": "The requested test order template.", "$ref": "TestOrder" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#ordersGetTestOrderTemplateResponse`\".", "type": "string" } } }, "OrdersInStoreRefundLineItemRequest": { "id": "OrdersInStoreRefundLineItemRequest", "type": "object", "properties": { "operationId": { "description": "The ID of the operation. Unique across all operations for a given order.", "type": "string" }, "lineItemId": { "description": "The ID of the line item to return. Either lineItemId or productId is required.", "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.", "type": "integer", "format": "uint32" }, "reason": { "description": "The reason for the return. Acceptable values are: - \"`customerDiscretionaryReturn`\" - \"`customerInitiatedMerchantCancel`\" - \"`deliveredTooLate`\" - \"`expiredItem`\" - \"`invalidCoupon`\" - \"`malformedShippingAddress`\" - \"`other`\" - \"`productArrivedDamaged`\" - \"`productNotAsDescribed`\" - \"`qualityNotAsExpected`\" - \"`undeliverableShippingAddress`\" - \"`unsupportedPoBoxAddress`\" - \"`wrongProductShipped`\" ", "type": "string" }, "reasonText": { "description": "The explanation of the reason.", "type": "string" }, "priceAmount": { "description": "The amount to be refunded. This may be pre-tax or post-tax depending on the location of the order. Required.", "$ref": "Price" }, "taxAmount": { "description": "The amount of tax to be refunded. Required.", "$ref": "Price" } } }, "OrdersInStoreRefundLineItemResponse": { "id": "OrdersInStoreRefundLineItemResponse", "type": "object", "properties": { "executionStatus": { "description": "The status of the execution. Acceptable values are: - \"`duplicate`\" - \"`executed`\" ", "type": "string" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#ordersInStoreRefundLineItemResponse`\".", "type": "string" } } }, "OrdersListResponse": { "id": "OrdersListResponse", "type": "object", "properties": { "nextPageToken": { "description": "The token for the retrieval of the next page of orders.", "type": "string" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#ordersListResponse`\".", "type": "string" }, "resources": { "type": "array", "items": { "$ref": "Order" } } } }, "OrdersRefundItemRequest": { "id": "OrdersRefundItemRequest", "type": "object", "properties": { "operationId": { "description": "The ID of the operation. Unique across all operations for a given order.", "type": "string" }, "reason": { "description": "The reason for the refund. Acceptable values are: - \"`shippingCostAdjustment`\" - \"`priceAdjustment`\" - \"`taxAdjustment`\" - \"`feeAdjustment`\" - \"`courtesyAdjustment`\" - \"`adjustment`\" - \"`customerCancelled`\" - \"`noInventory`\" - \"`productNotAsDescribed`\" - \"`undeliverableShippingAddress`\" - \"`wrongProductShipped`\" - \"`lateShipmentCredit`\" - \"`deliveredLateByCarrier`\" - \"`productArrivedDamaged`\" ", "type": "string" }, "reasonText": { "description": "The explanation of the reason.", "type": "string" }, "items": { "description": "The items that are refunded. Either Item or Shipping must be provided in the request.", "type": "array", "items": { "$ref": "OrdersCustomBatchRequestEntryRefundItemItem" } }, "shipping": { "description": "The refund on shipping. Optional, but either Item or Shipping must be provided in the request.", "$ref": "OrdersCustomBatchRequestEntryRefundItemShipping" } } }, "OrdersCustomBatchRequestEntryRefundItemItem": { "id": "OrdersCustomBatchRequestEntryRefundItemItem", "type": "object", "properties": { "lineItemId": { "description": "The ID of the line item. Either lineItemId or productId is required.", "type": "string" }, "productId": { "description": "The ID of the product. This is the REST ID used in the products service. Either lineItemId or productId is required.", "type": "string" }, "quantity": { "description": "The number of products that are refunded.", "type": "integer", "format": "int32" }, "fullRefund": { "description": "If true, the full item will be refunded. If this is true, amount shouldn't be provided and will be ignored.", "type": "boolean" }, "amount": { "description": "The total amount that is refunded. (for example, refunding $5 each for 2 products should be done by setting quantity to 2 and amount to 10$) In case of multiple refunds, this should be the amount you currently want to refund to the customer.", "$ref": "MonetaryAmount" } } }, "OrdersCustomBatchRequestEntryRefundItemShipping": { "id": "OrdersCustomBatchRequestEntryRefundItemShipping", "type": "object", "properties": { "fullRefund": { "description": "If set to true, all shipping costs for the order will be refunded. If this is true, amount shouldn't be provided and will be ignored. If set to false, submit the amount of the partial shipping refund, excluding the shipping tax. The shipping tax is calculated and handled on Google's side.", "type": "boolean" }, "amount": { "description": "The amount that is refunded. If this is not the first refund for the shipment, this should be the newly refunded amount.", "$ref": "Price" } } }, "OrdersRefundItemResponse": { "id": "OrdersRefundItemResponse", "type": "object", "properties": { "executionStatus": { "description": "The status of the execution. Acceptable values are: - \"`duplicate`\" - \"`executed`\" ", "type": "string" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#ordersRefundItemResponse`\".", "type": "string" } } }, "OrdersRefundOrderRequest": { "id": "OrdersRefundOrderRequest", "type": "object", "properties": { "operationId": { "description": "The ID of the operation. Unique across all operations for a given order.", "type": "string" }, "reason": { "description": "The reason for the refund. Acceptable values are: - \"`courtesyAdjustment`\" - \"`other`\" ", "type": "string" }, "reasonText": { "description": "The explanation of the reason.", "type": "string" }, "fullRefund": { "description": "If true, the full order will be refunded, including shipping. If this is true, amount shouldn't be provided and will be ignored.", "type": "boolean" }, "amount": { "description": "The amount that is refunded. If this is not the first refund for the order, this should be the newly refunded amount.", "$ref": "MonetaryAmount" } } }, "OrdersRefundOrderResponse": { "id": "OrdersRefundOrderResponse", "type": "object", "properties": { "executionStatus": { "description": "The status of the execution. Acceptable values are: - \"`duplicate`\" - \"`executed`\" ", "type": "string" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#ordersRefundOrderResponse`\".", "type": "string" } } }, "OrdersRejectReturnLineItemRequest": { "id": "OrdersRejectReturnLineItemRequest", "type": "object", "properties": { "operationId": { "description": "The ID of the operation. Unique across all operations for a given order.", "type": "string" }, "lineItemId": { "description": "The ID of the line item to return. Either lineItemId or productId is required.", "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.", "type": "integer", "format": "uint32" }, "reason": { "description": "The reason for the return. Acceptable values are: - \"`damagedOrUsed`\" - \"`missingComponent`\" - \"`notEligible`\" - \"`other`\" - \"`outOfReturnWindow`\" ", "type": "string" }, "reasonText": { "description": "The explanation of the reason.", "type": "string" } } }, "OrdersRejectReturnLineItemResponse": { "id": "OrdersRejectReturnLineItemResponse", "type": "object", "properties": { "executionStatus": { "description": "The status of the execution. Acceptable values are: - \"`duplicate`\" - \"`executed`\" ", "type": "string" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#ordersRejectReturnLineItemResponse`\".", "type": "string" } } }, "OrdersReturnRefundLineItemRequest": { "id": "OrdersReturnRefundLineItemRequest", "type": "object", "properties": { "operationId": { "description": "The ID of the operation. Unique across all operations for a given order.", "type": "string" }, "lineItemId": { "description": "The ID of the line item to return. Either lineItemId or productId is required.", "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. Quantity is required.", "type": "integer", "format": "uint32" }, "reason": { "description": "The reason for the return. Acceptable values are: - \"`customerDiscretionaryReturn`\" - \"`customerInitiatedMerchantCancel`\" - \"`deliveredTooLate`\" - \"`expiredItem`\" - \"`invalidCoupon`\" - \"`malformedShippingAddress`\" - \"`other`\" - \"`productArrivedDamaged`\" - \"`productNotAsDescribed`\" - \"`qualityNotAsExpected`\" - \"`undeliverableShippingAddress`\" - \"`unsupportedPoBoxAddress`\" - \"`wrongProductShipped`\" ", "type": "string" }, "reasonText": { "description": "The explanation of the reason.", "type": "string" }, "priceAmount": { "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.", "$ref": "Price" }, "taxAmount": { "description": "The amount of tax to be refunded. Optional, but if filled, then priceAmount must be set. Calculated automatically if not provided.", "$ref": "Price" } } }, "OrdersReturnRefundLineItemResponse": { "id": "OrdersReturnRefundLineItemResponse", "type": "object", "properties": { "executionStatus": { "description": "The status of the execution. Acceptable values are: - \"`duplicate`\" - \"`executed`\" ", "type": "string" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#ordersReturnRefundLineItemResponse`\".", "type": "string" } } }, "OrdersSetLineItemMetadataRequest": { "id": "OrdersSetLineItemMetadataRequest", "type": "object", "properties": { "operationId": { "description": "The ID of the operation. Unique across all operations for a given order.", "type": "string" }, "lineItemId": { "description": "The ID of the line item to set metadata. Either lineItemId or productId is required.", "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" }, "annotations": { "type": "array", "items": { "$ref": "OrderMerchantProvidedAnnotation" } } } }, "OrdersSetLineItemMetadataResponse": { "id": "OrdersSetLineItemMetadataResponse", "type": "object", "properties": { "executionStatus": { "description": "The status of the execution. Acceptable values are: - \"`duplicate`\" - \"`executed`\" ", "type": "string" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#ordersSetLineItemMetadataResponse`\".", "type": "string" } } }, "OrdersShipLineItemsRequest": { "id": "OrdersShipLineItemsRequest", "type": "object", "properties": { "operationId": { "description": "The ID of the operation. Unique across all operations for a given order.", "type": "string" }, "lineItems": { "description": "Line items to ship.", "type": "array", "items": { "$ref": "OrderShipmentLineItemShipment" } }, "shipmentInfos": { "description": "Shipment information. This field is repeated because a single line item can be shipped in several packages (and have several tracking IDs).", "type": "array", "items": { "$ref": "OrdersCustomBatchRequestEntryShipLineItemsShipmentInfo" } }, "shipmentGroupId": { "description": "ID of the shipment group. Required for orders that use the orderinvoices service.", "type": "string" } } }, "OrdersCustomBatchRequestEntryShipLineItemsShipmentInfo": { "id": "OrdersCustomBatchRequestEntryShipLineItemsShipmentInfo", "type": "object", "properties": { "shipmentId": { "description": "Required. The ID of the shipment. This is assigned by the merchant and is unique to each shipment.", "type": "string" }, "carrier": { "description": "The carrier handling the shipment. See `shipments[].carrier` in the Orders resource representation for a list of acceptable values.", "type": "string" }, "trackingId": { "description": "The tracking ID for the shipment.", "type": "string" } } }, "OrdersShipLineItemsResponse": { "id": "OrdersShipLineItemsResponse", "type": "object", "properties": { "executionStatus": { "description": "The status of the execution. Acceptable values are: - \"`duplicate`\" - \"`executed`\" ", "type": "string" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#ordersShipLineItemsResponse`\".", "type": "string" } } }, "OrdersUpdateLineItemShippingDetailsRequest": { "id": "OrdersUpdateLineItemShippingDetailsRequest", "type": "object", "properties": { "operationId": { "description": "The ID of the operation. Unique across all operations for a given order.", "type": "string" }, "lineItemId": { "description": "The ID of the line item to set metadata. Either lineItemId or productId is required.", "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. Provided date should be within 1 year timeframe and can't be a date in the past.", "type": "string" }, "deliverByDate": { "description": "Updated delivery by date, in ISO 8601 format. If not specified only ship by date is updated. Provided date should be within 1 year timeframe and can't be a date in the past.", "type": "string" } } }, "OrdersUpdateLineItemShippingDetailsResponse": { "id": "OrdersUpdateLineItemShippingDetailsResponse", "type": "object", "properties": { "executionStatus": { "description": "The status of the execution. Acceptable values are: - \"`duplicate`\" - \"`executed`\" ", "type": "string" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#ordersUpdateLineItemShippingDetailsResponse`\".", "type": "string" } } }, "OrdersUpdateMerchantOrderIdRequest": { "id": "OrdersUpdateMerchantOrderIdRequest", "type": "object", "properties": { "operationId": { "description": "The ID of the operation. Unique across all operations for a given order.", "type": "string" }, "merchantOrderId": { "description": "The merchant order id to be assigned to the order. Must be unique per merchant.", "type": "string" } } }, "OrdersUpdateMerchantOrderIdResponse": { "id": "OrdersUpdateMerchantOrderIdResponse", "type": "object", "properties": { "executionStatus": { "description": "The status of the execution. Acceptable values are: - \"`duplicate`\" - \"`executed`\" ", "type": "string" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#ordersUpdateMerchantOrderIdResponse`\".", "type": "string" } } }, "OrdersUpdateShipmentRequest": { "id": "OrdersUpdateShipmentRequest", "type": "object", "properties": { "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. Acceptable values are: - \"`delivered`\" - \"`undeliverable`\" - \"`readyForPickup`\" ", "type": "string" }, "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" }, "trackingId": { "description": "The tracking ID for the shipment. Not updated if missing.", "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" }, "readyPickupDate": { "description": "Date on which the shipment has been ready for pickup, in ISO 8601 format. Optional and can be provided only if `status` is `ready for pickup`.", "type": "string" }, "undeliveredDate": { "description": "Date on which the shipment has been undeliverable, in ISO 8601 format. Optional and can be provided only if `status` is `undeliverable`.", "type": "string" }, "lastPickupDate": { "description": "Date after which the pickup will expire, in ISO 8601 format. Required only when order is buy-online-pickup-in-store(BOPIS) and `status` is `ready for pickup`.", "type": "string" }, "scheduledDeliveryDetails": { "description": "Delivery details of the shipment if scheduling is needed.", "$ref": "OrdersCustomBatchRequestEntryUpdateShipmentScheduledDeliveryDetails" } } }, "OrdersCustomBatchRequestEntryUpdateShipmentScheduledDeliveryDetails": { "id": "OrdersCustomBatchRequestEntryUpdateShipmentScheduledDeliveryDetails", "description": "ScheduledDeliveryDetails used to update the scheduled delivery order.", "type": "object", "properties": { "scheduledDate": { "description": "The date a shipment is scheduled for delivery, in ISO 8601 format.", "type": "string" }, "carrierPhoneNumber": { "description": "The phone number of the carrier fulfilling the delivery. The phone number should be formatted as the international notation in", "type": "string" } } }, "OrdersUpdateShipmentResponse": { "id": "OrdersUpdateShipmentResponse", "type": "object", "properties": { "executionStatus": { "description": "The status of the execution. Acceptable values are: - \"`duplicate`\" - \"`executed`\" ", "type": "string" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#ordersUpdateShipmentResponse`\".", "type": "string" } } }, "PosCustomBatchRequest": { "id": "PosCustomBatchRequest", "type": "object", "properties": { "entries": { "description": "The request entries to be processed in the batch.", "type": "array", "items": { "$ref": "PosCustomBatchRequestEntry" } } } }, "PosCustomBatchRequestEntry": { "id": "PosCustomBatchRequestEntry", "type": "object", "properties": { "batchId": { "description": "An entry ID, unique within the batch request.", "type": "integer", "format": "uint32" }, "merchantId": { "description": "The ID of the POS data provider.", "type": "string", "format": "uint64" }, "method": { "description": "The method of the batch entry. Acceptable values are: - \"`delete`\" - \"`get`\" - \"`insert`\" - \"`inventory`\" - \"`sale`\" ", "type": "string" }, "targetMerchantId": { "description": "The ID of the account for which to get/submit data.", "type": "string", "format": "uint64" }, "storeCode": { "description": "The store code. This should be set only if the method is `delete` or `get`.", "type": "string" }, "store": { "description": "The store information to submit. This should be set only if the method is `insert`.", "$ref": "PosStore" }, "inventory": { "description": "The inventory to submit. This should be set only if the method is `inventory`.", "$ref": "PosInventory" }, "sale": { "description": "The sale information to submit. This should be set only if the method is `sale`.", "$ref": "PosSale" } } }, "PosStore": { "id": "PosStore", "description": "Store resource.", "type": "object", "properties": { "storeCode": { "description": "Required. A store identifier that is unique for the given merchant.", "type": "string" }, "storeAddress": { "description": "Required. The street address of the store.", "type": "string" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#posStore`\"", "type": "string" }, "storeName": { "description": "The merchant or store name.", "type": "string" }, "phoneNumber": { "description": "The store phone number.", "type": "string" }, "websiteUrl": { "description": "The website url for the store or merchant.", "type": "string" }, "gcidCategory": { "description": "The business type of the store.", "type": "array", "items": { "type": "string" } }, "placeId": { "description": "The Google Place Id of the store location.", "type": "string" }, "matchingStatus": { "description": "Output only. The matching status of POS store and Google Business Profile store. Possible values are: - \"`matched`\": The POS store is successfully matched with the Google Business Profile store. - \"`failed`\": The POS store is not matched with the Google Business Profile store. See matching_status_hint for further details. Note that there is up to 48 hours propagation delay for changes in Merchant Center (e.g. creation of new account, accounts linking) and Google Business Profile (e.g. store address update) which may affect the matching status. In such cases, after a delay call [pos.list](https://developers.google.com/shopping-content/reference/rest/v2.1/pos/list) to retrieve the updated matching status. ", "readOnly": true, "type": "string" }, "matchingStatusHint": { "description": "Output only. The hint of why the matching has failed. This is only set when matching_status=failed. Possible values are: - \"`linked-store-not-found`\": There aren't any Google Business Profile stores available for matching. Connect your Merchant Center account with the Google Business Profile account. Or add a new Google Business Profile store corresponding to the POS store. - \"`store-match-not-found`\": The provided POS store couldn't be matched to any of the connected Google Business Profile stores. Merchant Center account is connected correctly and stores are available on Google Business Profile, but POS store location address does not match with Google Business Profile stores' addresses. Update POS store address or Google Business Profile store address to match correctly. - \"`store-match-unverified`\": The provided POS store couldn't be matched to any of the connected Google Business Profile stores, as the matched Google Business Profile store is unverified. Go through the Google Business Profile verification process to match correctly. ", "readOnly": true, "type": "string" } } }, "PosInventory": { "id": "PosInventory", "description": "The absolute quantity of an item available at the given store.", "type": "object", "properties": { "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#posInventory`\"", "type": "string" }, "storeCode": { "description": "Required. The identifier of the merchant's store. Either a `storeCode` inserted through the API or the code of the store in a Business Profile.", "type": "string" }, "itemId": { "description": "Required. A unique identifier for the item.", "type": "string" }, "targetCountry": { "description": "Required. The CLDR territory code for the item.", "type": "string" }, "contentLanguage": { "description": "Required. The two-letter ISO 639-1 language code for the item.", "type": "string" }, "gtin": { "description": "Global Trade Item Number.", "type": "string" }, "price": { "description": "Required. The current price of the item.", "$ref": "Price" }, "quantity": { "description": "Required. The available quantity of the item.", "type": "string", "format": "int64" }, "timestamp": { "description": "Required. The inventory timestamp, in ISO 8601 format.", "type": "string" }, "pickupMethod": { "description": "Optional. Supported pickup method for this offer. Unless the value is \"not supported\", this field must be submitted together with `pickupSla`. For accepted attribute values, see the [local product inventory feed specification](https://support.google.com/merchants/answer/3061342).", "type": "string" }, "pickupSla": { "description": "Optional. Expected date that an order will be ready for pickup relative to the order date. Must be submitted together with `pickupMethod`. For accepted attribute values, see the [local product inventory feed specification](https://support.google.com/merchants/answer/3061342).", "type": "string" } } }, "PosSale": { "id": "PosSale", "description": "The change of the available quantity of an item at the given store.", "type": "object", "properties": { "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#posSale`\"", "type": "string" }, "storeCode": { "description": "Required. The identifier of the merchant's store. Either a `storeCode` inserted through the API or the code of the store in a Business Profile.", "type": "string" }, "itemId": { "description": "Required. A unique identifier for the item.", "type": "string" }, "targetCountry": { "description": "Required. The CLDR territory code for the item.", "type": "string" }, "contentLanguage": { "description": "Required. The two-letter ISO 639-1 language code for the item.", "type": "string" }, "gtin": { "description": "Global Trade Item Number.", "type": "string" }, "price": { "description": "Required. The price of the item.", "$ref": "Price" }, "quantity": { "description": "Required. The relative change of the available quantity. Negative for items returned.", "type": "string", "format": "int64" }, "timestamp": { "description": "Required. The inventory timestamp, in ISO 8601 format.", "type": "string" }, "saleId": { "description": "A unique ID to group items from the same sale event.", "type": "string" } } }, "PosCustomBatchResponse": { "id": "PosCustomBatchResponse", "type": "object", "properties": { "entries": { "description": "The result of the execution of the batch requests.", "type": "array", "items": { "$ref": "PosCustomBatchResponseEntry" } }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#posCustomBatchResponse`\".", "type": "string" } } }, "PosCustomBatchResponseEntry": { "id": "PosCustomBatchResponseEntry", "type": "object", "properties": { "batchId": { "description": "The ID of the request entry to which this entry responds.", "type": "integer", "format": "uint32" }, "store": { "description": "The retrieved or updated store information.", "$ref": "PosStore" }, "errors": { "description": "A list of errors defined if, and only if, the request failed.", "$ref": "Errors" }, "inventory": { "description": "The updated inventory information.", "$ref": "PosInventory" }, "sale": { "description": "The updated sale information.", "$ref": "PosSale" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#posCustomBatchResponseEntry`\"", "type": "string" } } }, "PosInventoryRequest": { "id": "PosInventoryRequest", "type": "object", "properties": { "storeCode": { "description": "Required. The identifier of the merchant's store. Either a `storeCode` inserted through the API or the code of the store in a Business Profile.", "type": "string" }, "itemId": { "description": "Required. A unique identifier for the item.", "type": "string" }, "targetCountry": { "description": "Required. The CLDR territory code for the item.", "type": "string" }, "contentLanguage": { "description": "Required. The two-letter ISO 639-1 language code for the item.", "type": "string" }, "gtin": { "description": "Global Trade Item Number.", "type": "string" }, "price": { "description": "Required. The current price of the item.", "$ref": "Price" }, "quantity": { "description": "Required. The available quantity of the item.", "type": "string", "format": "int64" }, "timestamp": { "description": "Required. The inventory timestamp, in ISO 8601 format.", "type": "string" }, "pickupMethod": { "description": "Optional. Supported pickup method for this offer. Unless the value is \"not supported\", this field must be submitted together with `pickupSla`. For accepted attribute values, see the [local product inventory feed specification](https://support.google.com/merchants/answer/3061342).", "type": "string" }, "pickupSla": { "description": "Optional. Expected date that an order will be ready for pickup relative to the order date. Must be submitted together with `pickupMethod`. For accepted attribute values, see the [local product inventory feed specification](https://support.google.com/merchants/answer/3061342).", "type": "string" } } }, "PosInventoryResponse": { "id": "PosInventoryResponse", "type": "object", "properties": { "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#posInventoryResponse`\".", "type": "string" }, "storeCode": { "description": "Required. The identifier of the merchant's store. Either a `storeCode` inserted through the API or the code of the store in a Business Profile.", "type": "string" }, "itemId": { "description": "Required. A unique identifier for the item.", "type": "string" }, "targetCountry": { "description": "Required. The CLDR territory code for the item.", "type": "string" }, "contentLanguage": { "description": "Required. The two-letter ISO 639-1 language code for the item.", "type": "string" }, "gtin": { "description": "Global Trade Item Number.", "type": "string" }, "price": { "description": "Required. The current price of the item.", "$ref": "Price" }, "quantity": { "description": "Required. The available quantity of the item.", "type": "string", "format": "int64" }, "timestamp": { "description": "Required. The inventory timestamp, in ISO 8601 format.", "type": "string" }, "pickupMethod": { "description": "Optional. Supported pickup method for this offer. Unless the value is \"not supported\", this field must be submitted together with `pickupSla`. For accepted attribute values, see the [local product inventory feed specification](https://support.google.com/merchants/answer/3061342).", "type": "string" }, "pickupSla": { "description": "Optional. Expected date that an order will be ready for pickup relative to the order date. Must be submitted together with `pickupMethod`. For accepted attribute values, see the [local product inventory feed specification](https://support.google.com/merchants/answer/3061342).", "type": "string" } } }, "PosListResponse": { "id": "PosListResponse", "type": "object", "properties": { "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#posListResponse`\".", "type": "string" }, "resources": { "type": "array", "items": { "$ref": "PosStore" } } } }, "PosSaleRequest": { "id": "PosSaleRequest", "type": "object", "properties": { "storeCode": { "description": "Required. The identifier of the merchant's store. Either a `storeCode` inserted through the API or the code of the store in a Business Profile.", "type": "string" }, "itemId": { "description": "Required. A unique identifier for the item.", "type": "string" }, "targetCountry": { "description": "Required. The CLDR territory code for the item.", "type": "string" }, "contentLanguage": { "description": "Required. The two-letter ISO 639-1 language code for the item.", "type": "string" }, "gtin": { "description": "Global Trade Item Number.", "type": "string" }, "price": { "description": "Required. The price of the item.", "$ref": "Price" }, "quantity": { "description": "Required. The relative change of the available quantity. Negative for items returned.", "type": "string", "format": "int64" }, "timestamp": { "description": "Required. The inventory timestamp, in ISO 8601 format.", "type": "string" }, "saleId": { "description": "A unique ID to group items from the same sale event.", "type": "string" } } }, "PosSaleResponse": { "id": "PosSaleResponse", "type": "object", "properties": { "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#posSaleResponse`\".", "type": "string" }, "storeCode": { "description": "Required. The identifier of the merchant's store. Either a `storeCode` inserted through the API or the code of the store in a Business Profile.", "type": "string" }, "itemId": { "description": "Required. A unique identifier for the item.", "type": "string" }, "targetCountry": { "description": "Required. The CLDR territory code for the item.", "type": "string" }, "contentLanguage": { "description": "Required. The two-letter ISO 639-1 language code for the item.", "type": "string" }, "gtin": { "description": "Global Trade Item Number.", "type": "string" }, "price": { "description": "Required. The price of the item.", "$ref": "Price" }, "quantity": { "description": "Required. The relative change of the available quantity. Negative for items returned.", "type": "string", "format": "int64" }, "timestamp": { "description": "Required. The inventory timestamp, in ISO 8601 format.", "type": "string" }, "saleId": { "description": "A unique ID to group items from the same sale event.", "type": "string" } } }, "ProductsCustomBatchRequest": { "id": "ProductsCustomBatchRequest", "type": "object", "properties": { "entries": { "description": "The request entries to be processed in the batch.", "type": "array", "items": { "$ref": "ProductsCustomBatchRequestEntry" } } } }, "ProductsCustomBatchRequestEntry": { "id": "ProductsCustomBatchRequestEntry", "description": "A batch entry encoding a single non-batch products request.", "type": "object", "properties": { "batchId": { "description": "An entry ID, unique within the batch request.", "type": "integer", "format": "uint32" }, "merchantId": { "description": "The ID of the managing account.", "type": "string", "format": "uint64" }, "method": { "description": "The method of the batch entry. Acceptable values are: - \"`delete`\" - \"`get`\" - \"`insert`\" - \"`update`\" ", "type": "string" }, "productId": { "description": "The ID of the product to get or mutate. Only defined if the method is `get`, `delete`, or `update`.", "type": "string" }, "product": { "description": "The product to insert or update. Only required if the method is `insert` or `update`. If the `update` method is used with `updateMask` only to delete a field, then this isn't required. For example, setting `salePrice` on the `updateMask` and not providing a `product` will result in an existing sale price on the product specified by `productId` being deleted.", "$ref": "Product" }, "feedId": { "description": "The Content API Supplemental Feed ID. If present then product insertion or deletion applies to a supplemental feed instead of primary Content API feed.", "type": "string", "format": "uint64" }, "updateMask": { "description": "The comma-separated list of product attributes to be updated. Example: `\"title,salePrice\"`. Attributes specified in the update mask without a value specified in the body will be deleted from the product. *You must specify the update mask to delete attributes.* Only top-level product attributes can be updated. If not defined, product attributes with set values will be updated and other attributes will stay unchanged. Only defined if the method is `update`.", "type": "string", "format": "google-fieldmask" } } }, "Product": { "id": "Product", "description": " Required product attributes are primarily defined by the product data specification. See the Product Data Specification Help Center article for information. Product data. After inserting, updating, or deleting a product, it may take several minutes before changes take effect.", "type": "object", "properties": { "id": { "description": "The REST ID of the product. Content API methods that operate on products take this as their `productId` parameter. The REST ID for a product has one of the 2 forms channel:contentLanguage: targetCountry: offerId or channel:contentLanguage:feedLabel: offerId.", "type": "string" }, "offerId": { "description": "Required. 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. *Note:* Content API methods that operate on products take the REST ID of the product, *not* this identifier.", "type": "string" }, "title": { "description": "Title of the item.", "type": "string" }, "description": { "description": "Description of the item.", "type": "string" }, "link": { "description": "URL directly linking to your item's page on your website.", "type": "string" }, "imageLink": { "description": "URL of an image of the item.", "type": "string" }, "additionalImageLinks": { "description": "Additional URLs of images of the item.", "type": "array", "items": { "type": "string" } }, "lifestyleImageLinks": { "description": "Additional URLs of lifestyle images of the item. Used to explicitly identify images that showcase your item in a real-world context. See the Help Center article for more information.", "type": "array", "items": { "type": "string" } }, "contentLanguage": { "description": "Required. The two-letter ISO 639-1 language code for the item.", "type": "string" }, "targetCountry": { "description": "Required. The CLDR territory code for the item's country of sale.", "type": "string" }, "feedLabel": { "description": "Feed label for the item. Either `targetCountry` or `feedLabel` is required. Must be less than or equal to 20 uppercase letters (A-Z), numbers (0-9), and dashes (-).", "type": "string" }, "channel": { "description": "Required. The item's channel (online or local). Acceptable values are: - \"`local`\" - \"`online`\" ", "type": "string" }, "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" }, "disclosureDate": { "description": "The date time when an offer becomes visible in search results across Google’s YouTube surfaces, in [ISO 8601](http://en.wikipedia.org/wiki/ISO_8601) format. See [Disclosure date](https://support.google.com/merchants/answer/13034208) for more information.", "type": "string" }, "adult": { "description": "Should be set to true if the item is targeted towards adults.", "type": "boolean" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#product`\"", "type": "string" }, "brand": { "description": "Brand of the item.", "type": "string" }, "color": { "description": "Color of the item.", "type": "string" }, "googleProductCategory": { "description": "Google's category of the item (see [Google product taxonomy](https://support.google.com/merchants/answer/1705911)). When querying products, this field will contain the user provided value. There is currently no way to get back the auto assigned google product categories through the API.", "type": "string" }, "gtin": { "description": "Global Trade Item Number (GTIN) of the item.", "type": "string" }, "itemGroupId": { "description": "Shared identifier for all variants of the same product.", "type": "string" }, "material": { "description": "The material of which the item is made.", "type": "string" }, "mpn": { "description": "Manufacturer Part Number (MPN) of the item.", "type": "string" }, "pattern": { "description": "The item's pattern (for example, polka dots).", "type": "string" }, "price": { "description": "Price of the item.", "$ref": "Price" }, "salePrice": { "description": "Advertised sale price of the item.", "$ref": "Price" }, "salePriceEffectiveDate": { "description": "Date range during which the item is on sale (see product data specification ).", "type": "string" }, "productHeight": { "description": "The height of the product in the units provided. The value must be between 0 (exclusive) and 3000 (inclusive).", "$ref": "ProductDimension" }, "productLength": { "description": "The length of the product in the units provided. The value must be between 0 (exclusive) and 3000 (inclusive).", "$ref": "ProductDimension" }, "productWidth": { "description": "The width of the product in the units provided. The value must be between 0 (exclusive) and 3000 (inclusive).", "$ref": "ProductDimension" }, "productWeight": { "description": "The weight of the product in the units provided. The value must be between 0 (exclusive) and 2000 (inclusive).", "$ref": "ProductWeight" }, "shipping": { "description": "Shipping rules.", "type": "array", "items": { "$ref": "ProductShipping" } }, "freeShippingThreshold": { "description": "Optional. Conditions to be met for a product to have free shipping.", "type": "array", "items": { "$ref": "FreeShippingThreshold" } }, "shippingWeight": { "description": "Weight of the item for shipping.", "$ref": "ProductShippingWeight" }, "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).", "type": "array", "items": { "type": "string" } }, "taxes": { "description": "Tax information.", "type": "array", "items": { "$ref": "ProductTax" } }, "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 (for example, `{ \"name\": \"size type\", \"value\": \"regular\" }`). This is useful for submitting attributes not explicitly exposed by the API, such as additional attributes used for Buy on Google (formerly known as Shopping Actions).", "type": "array", "items": { "$ref": "CustomAttribute" } }, "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" }, "installment": { "description": "Number and amount of installments to pay for an item.", "$ref": "Installment" }, "loyaltyProgram": { "description": "Loyalty program information that is used to surface loyalty benefits ( for example pricing, points, etc) to the user for this item.", "$ref": "LoyaltyProgram" }, "multipack": { "description": "The number of identical products in a merchant-defined multipack.", "type": "string", "format": "int64" }, "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" }, "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" }, "mobileLink": { "description": "URL for the mobile-optimized version of your item's landing page.", "type": "string" }, "availabilityDate": { "description": "The day a pre-ordered product becomes available for delivery, in ISO 8601 format.", "type": "string" }, "shippingLabel": { "description": "The shipping label of the product, used to group product in account-level shipping rules.", "type": "string" }, "unitPricingMeasure": { "description": "The measure and dimension of an item.", "$ref": "ProductUnitPricingMeasure" }, "unitPricingBaseMeasure": { "description": "The preference of the denominator of the unit price.", "$ref": "ProductUnitPricingBaseMeasure" }, "shippingLength": { "description": "Length of the item for shipping.", "$ref": "ProductShippingDimension" }, "shippingWidth": { "description": "Width of the item for shipping.", "$ref": "ProductShippingDimension" }, "shippingHeight": { "description": "Height of the item for shipping.", "$ref": "ProductShippingDimension" }, "displayAdsId": { "description": "An identifier for an item for dynamic remarketing campaigns.", "type": "string" }, "displayAdsSimilarIds": { "description": "Advertiser-specified recommendations.", "type": "array", "items": { "type": "string" } }, "displayAdsTitle": { "description": "Title of an item for dynamic remarketing campaigns.", "type": "string" }, "displayAdsLink": { "description": "URL directly to your item's landing page for dynamic remarketing campaigns.", "type": "string" }, "displayAdsValue": { "description": "Offer margin for dynamic remarketing campaigns.", "type": "number", "format": "double" }, "sellOnGoogleQuantity": { "description": "The quantity of the product that is available for selling on Google. Supported only for online products.", "type": "string", "format": "int64" }, "promotionIds": { "description": "The unique ID of a promotion.", "type": "array", "items": { "type": "string" } }, "maxHandlingTime": { "description": "Maximal product handling time (in business days).", "type": "string", "format": "int64" }, "minHandlingTime": { "description": "Minimal product handling time (in business days).", "type": "string", "format": "int64" }, "costOfGoodsSold": { "description": "Cost of goods sold. Used for gross profit reporting.", "$ref": "Price" }, "autoPricingMinPrice": { "description": "A safeguard in the [Automated Discounts](//support.google.com/merchants/answer/10295759) and [Dynamic Promotions](//support.google.com/merchants/answer/13949249) projects, ensuring that discounts on merchants' offers do not fall below this value, thereby preserving the offer's value and profitability.", "$ref": "Price" }, "source": { "description": "The source of the offer, that is, how the offer was created. Acceptable values are: - \"`api`\" - \"`crawl`\" - \"`feed`\" ", "type": "string" }, "includedDestinations": { "description": "The list of [destinations to include](//support.google.com/merchants/answer/7501026) for this target (corresponds to checked check boxes in Merchant Center). Default destinations are always included unless provided in `excludedDestinations`.", "type": "array", "items": { "type": "string" } }, "excludedDestinations": { "description": "The list of [destinations to exclude](//support.google.com/merchants/answer/6324486) for this target (corresponds to cleared check boxes in Merchant Center). Products that are excluded from all destinations for more than 7 days are automatically deleted.", "type": "array", "items": { "type": "string" } }, "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.", "type": "array", "items": { "type": "string" } }, "adsRedirect": { "description": "Allows advertisers to override the item URL when the product is shown within the context of Product Ads.", "type": "string" }, "productTypes": { "description": "Categories of the item (formatted as in product data specification).", "type": "array", "items": { "type": "string" } }, "ageGroup": { "description": "Target age group of the item.", "type": "string" }, "availability": { "description": "Availability status of the item.", "type": "string" }, "condition": { "description": "Condition or state of the item.", "type": "string" }, "gender": { "description": "Target gender of the item.", "type": "string" }, "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" }, "additionalSizeType": { "description": "Additional cut of the item. Used together with size_type to represent combined size types for apparel items.", "type": "string" }, "energyEfficiencyClass": { "description": "The energy efficiency class as defined in EU directive 2010/30/EU.", "type": "string" }, "minEnergyEfficiencyClass": { "description": "The energy efficiency class as defined in EU directive 2010/30/EU.", "type": "string" }, "maxEnergyEfficiencyClass": { "description": "The energy efficiency class as defined in EU directive 2010/30/EU.", "type": "string" }, "taxCategory": { "description": "The tax category of the product, used to configure detailed tax nexus in account-level tax settings.", "type": "string" }, "transitTimeLabel": { "description": "The transit time label of the product, used to group product in account-level transit time tables.", "type": "string" }, "shoppingAdsExcludedCountries": { "description": "List of country codes (ISO 3166-1 alpha-2) to exclude the offer from Shopping Ads destination. Countries from this list are removed from countries configured in MC feed settings.", "type": "array", "items": { "type": "string" } }, "pickupMethod": { "description": "The pick up option for the item. Acceptable values are: - \"`buy`\" - \"`reserve`\" - \"`ship to store`\" - \"`not supported`\" ", "type": "string" }, "pickupSla": { "description": "Item store pickup timeline. Acceptable values are: - \"`same day`\" - \"`next day`\" - \"`2-day`\" - \"`3-day`\" - \"`4-day`\" - \"`5-day`\" - \"`6-day`\" - \"`7-day`\" - \"`multi-week`\" ", "type": "string" }, "linkTemplate": { "description": "URL template for merchant hosted local storefront.", "type": "string" }, "mobileLinkTemplate": { "description": "URL template for merchant hosted local storefront optimized for mobile devices.", "type": "string" }, "productDetails": { "description": "Technical specification or additional product details.", "type": "array", "items": { "$ref": "ProductProductDetail" } }, "productHighlights": { "description": "Bullet points describing the most relevant highlights of a product.", "type": "array", "items": { "type": "string" } }, "subscriptionCost": { "description": "Number of periods (months or years) and amount of payment per period for an item with an associated subscription contract.", "$ref": "ProductSubscriptionCost" }, "canonicalLink": { "description": "URL for the canonical version of your item's landing page.", "type": "string" }, "externalSellerId": { "description": "Required for multi-seller accounts. Use this attribute if you're a marketplace uploading products for various sellers to your multi-seller account.", "type": "string" }, "pause": { "description": "Publication of this item should be temporarily paused. Acceptable values are: - \"`ads`\" ", "type": "string" }, "virtualModelLink": { "description": "URL of the 3D model of the item to provide more visuals.", "type": "string" }, "cloudExportAdditionalProperties": { "description": "Extra fields to export to the Cloud Retail program.", "type": "array", "items": { "$ref": "CloudExportAdditionalProperties" } }, "certifications": { "description": "Product [certification](https://support.google.com/merchants/answer/13528839), introduced for EU energy efficiency labeling compliance using the [EU EPREL](https://eprel.ec.europa.eu/screen/home) database.", "type": "array", "items": { "$ref": "ProductCertification" } }, "structuredTitle": { "description": "Structured title, for algorithmically (AI)-generated titles.", "$ref": "ProductStructuredTitle" }, "structuredDescription": { "description": "Structured description, for algorithmically (AI)-generated descriptions.", "$ref": "ProductStructuredDescription" } } }, "ProductDimension": { "id": "ProductDimension", "type": "object", "properties": { "value": { "description": "Required. The length value represented as a number. The value can have a maximum precision of four decimal places.", "type": "number", "format": "double" }, "unit": { "description": "Required. The length units. Acceptable values are: - \"`in`\" - \"`cm`\" ", "type": "string" } } }, "ProductWeight": { "id": "ProductWeight", "type": "object", "properties": { "value": { "description": "Required. The weight represented as a number. The weight can have a maximum precision of four decimal places.", "type": "number", "format": "double" }, "unit": { "description": "Required. The weight unit. Acceptable values are: - \"`g`\" - \"`kg`\" - \"`oz`\" - \"`lb`\" ", "type": "string" } } }, "ProductShipping": { "id": "ProductShipping", "type": "object", "properties": { "price": { "description": "Fixed shipping price, represented as a number.", "$ref": "Price" }, "country": { "description": "The CLDR territory code of the country to which an item will ship.", "type": "string" }, "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" }, "locationId": { "description": "The numeric ID of a location that the shipping rate applies to as defined in the Google Ads API.", "type": "string", "format": "int64" }, "locationGroupName": { "description": "The location where the shipping is applicable, represented by a location group name.", "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" }, "minHandlingTime": { "description": "Minimum handling time (inclusive) between when the order is received and shipped in business days. 0 means that the order is shipped on the same day as it's received if it happens before the cut-off time. minHandlingTime can only be present together with maxHandlingTime; but it's not required if maxHandlingTime is present.", "type": "string", "format": "int64" }, "maxHandlingTime": { "description": "Maximum handling time (inclusive) between when the order is received and shipped in business days. 0 means that the order is shipped on the same day as it's received if it happens before the cut-off time. Both maxHandlingTime and maxTransitTime are required if providing shipping speeds.", "type": "string", "format": "int64" }, "minTransitTime": { "description": "Minimum transit time (inclusive) between when the order has shipped and when it's delivered in business days. 0 means that the order is delivered on the same day as it ships. minTransitTime can only be present together with maxTransitTime; but it's not required if maxTransitTime is present.", "type": "string", "format": "int64" }, "maxTransitTime": { "description": "Maximum transit time (inclusive) between when the order has shipped and when it's delivered in business days. 0 means that the order is delivered on the same day as it ships. Both maxHandlingTime and maxTransitTime are required if providing shipping speeds.", "type": "string", "format": "int64" } } }, "FreeShippingThreshold": { "id": "FreeShippingThreshold", "description": "Conditions to be met for a product to have free shipping.", "type": "object", "properties": { "country": { "description": "Required. The [CLDR territory code](http://www.unicode.org/repos/cldr/tags/latest/common/main/en.xml) of the country to which an item will ship.", "type": "string" }, "priceThreshold": { "description": "Required. The minimum product price for the shipping cost to become free. Represented as a number.", "$ref": "Price" } } }, "ProductShippingWeight": { "id": "ProductShippingWeight", "type": "object", "properties": { "value": { "description": "The weight of the product used to calculate the shipping cost of the item.", "type": "number", "format": "double" }, "unit": { "description": "The unit of value.", "type": "string" } } }, "ProductTax": { "id": "ProductTax", "type": "object", "properties": { "rate": { "description": "The percentage of tax rate that applies to the item price.", "type": "number", "format": "double" }, "country": { "description": "The country within which the item is taxed, specified as a CLDR territory code.", "type": "string" }, "region": { "description": "The geographic region to which the tax rate applies.", "type": "string" }, "taxShip": { "description": "Should be set to true if tax is charged on shipping.", "type": "boolean" }, "locationId": { "description": "The numeric ID of a location that the tax rate applies to as defined in the Google Ads API.", "type": "string", "format": "int64" }, "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" } } }, "Installment": { "id": "Installment", "description": "Details of a monthly installment payment offering. [Learn more](https://support.google.com/merchants/answer/6324474) about installments.", "type": "object", "properties": { "months": { "description": "The number of installments the buyer has to pay.", "type": "string", "format": "int64" }, "amount": { "description": "The amount the buyer has to pay per month.", "$ref": "Price" }, "downpayment": { "description": "Optional. The initial down payment amount the buyer has to pay.", "$ref": "Price" }, "creditType": { "description": "Optional. Type of installment payments. Supported values are: - \"`finance`\" - \"`lease`\" ", "type": "string" } } }, "LoyaltyProgram": { "id": "LoyaltyProgram", "description": "Allows the setting up of loyalty program benefits (for example price or points). https://support.google.com/merchants/answer/12922446", "type": "object", "properties": { "programLabel": { "description": "Required. The label of the loyalty program. This is an internal label that uniquely identifies the relationship between a merchant entity and a loyalty program entity. It must be provided so that system can associate the assets below (for example, price and points) with a merchant. The corresponding program must be linked to the merchant account.", "type": "string" }, "tierLabel": { "description": "Required. The label of the tier within the loyalty program. Must match one of the labels within the program.", "type": "string" }, "price": { "description": "Optional. The price for members of the given tier (instant discount price). Must be smaller or equal to the regular price.", "$ref": "Price" }, "cashbackForFutureUse": { "description": "Optional. The cashback that can be used for future purchases.", "$ref": "Price" }, "loyaltyPoints": { "description": "Optional. The amount of loyalty points earned on a purchase.", "type": "string", "format": "int64" } } }, "ProductUnitPricingMeasure": { "id": "ProductUnitPricingMeasure", "type": "object", "properties": { "value": { "description": "The measure of an item.", "type": "number", "format": "double" }, "unit": { "description": "The unit of the measure.", "type": "string" } } }, "ProductUnitPricingBaseMeasure": { "id": "ProductUnitPricingBaseMeasure", "type": "object", "properties": { "value": { "description": "The denominator of the unit price.", "type": "string", "format": "int64" }, "unit": { "description": "The unit of the denominator.", "type": "string" } } }, "ProductShippingDimension": { "id": "ProductShippingDimension", "type": "object", "properties": { "value": { "description": "The dimension of the product used to calculate the shipping cost of the item.", "type": "number", "format": "double" }, "unit": { "description": "The unit of value.", "type": "string" } } }, "ProductProductDetail": { "id": "ProductProductDetail", "type": "object", "properties": { "sectionName": { "description": "The section header used to group a set of product details.", "type": "string" }, "attributeName": { "description": "The name of the product detail.", "type": "string" }, "attributeValue": { "description": "The value of the product detail.", "type": "string" } } }, "ProductSubscriptionCost": { "id": "ProductSubscriptionCost", "type": "object", "properties": { "period": { "description": "The type of subscription period. - \"`month`\" - \"`year`\" ", "type": "string" }, "periodLength": { "description": "The number of subscription periods the buyer has to pay.", "type": "string", "format": "int64" }, "amount": { "description": "The amount the buyer has to pay per subscription period.", "$ref": "Price" } } }, "CloudExportAdditionalProperties": { "id": "CloudExportAdditionalProperties", "description": "Product property for the Cloud Retail API. For example, properties for a TV product could be \"Screen-Resolution\" or \"Screen-Size\".", "type": "object", "properties": { "propertyName": { "description": "Name of the given property. For example, \"Screen-Resolution\" for a TV product. Maximum string size is 256 characters.", "type": "string" }, "textValue": { "description": "Text value of the given property. For example, \"8K(UHD)\" could be a text value for a TV product. Maximum number of specified values for this field is 400. Values are stored in an arbitrary but consistent order. Maximum string size is 256 characters.", "type": "array", "items": { "type": "string" } }, "boolValue": { "description": "Boolean value of the given property. For example for a TV product, \"True\" or \"False\" if the screen is UHD.", "type": "boolean" }, "intValue": { "description": "Integer values of the given property. For example, 1080 for a screen resolution of a TV product. Maximum number of specified values for this field is 400. Values are stored in an arbitrary but consistent order.", "type": "array", "items": { "type": "string", "format": "int64" } }, "floatValue": { "description": "Float values of the given property. For example for a TV product 1.2345. Maximum number of specified values for this field is 400. Values are stored in an arbitrary but consistent order.", "type": "array", "items": { "type": "number", "format": "float" } }, "minValue": { "description": "Minimum float value of the given property. For example for a TV product 1.00.", "type": "number", "format": "float" }, "maxValue": { "description": "Maximum float value of the given property. For example for a TV product 100.00.", "type": "number", "format": "float" }, "unitCode": { "description": "Unit of the given property. For example, \"Pixels\" for a TV product. Maximum string size is 256 bytes.", "type": "string" } } }, "ProductCertification": { "id": "ProductCertification", "description": "Product [certification](https://support.google.com/merchants/answer/13528839), introduced for EU energy efficiency labeling compliance using the [EU EPREL](https://eprel.ec.europa.eu/screen/home) database.", "type": "object", "properties": { "certificationAuthority": { "description": "The certification authority, for example \"European_Commission\". Maximum length is 2000 characters.", "type": "string" }, "certificationName": { "description": "The name of the certification, for example \"EPREL\". Maximum length is 2000 characters.", "type": "string" }, "certificationCode": { "description": "The certification code, for eaxample \"123456\". Maximum length is 2000 characters.", "type": "string" } } }, "ProductStructuredTitle": { "id": "ProductStructuredTitle", "description": "Structured title, for algorithmically (AI)-generated titles. See [title](https://support.google.com/merchants/answer/6324415#Whentouse) for more information.", "type": "object", "properties": { "digitalSourceType": { "description": "Optional. The digital source type. Acceptable values are: - \"`trained_algorithmic_media`\" - \"`default`\" ", "type": "string" }, "content": { "description": "Required. The title text. Maximum length is 150 characters.", "type": "string" } } }, "ProductStructuredDescription": { "id": "ProductStructuredDescription", "description": "Structured description, for algorithmically (AI)-generated descriptions. See [description](https://support.google.com/merchants/answer/6324468#When_to_use) for more information.", "type": "object", "properties": { "digitalSourceType": { "description": "Optional. The digital source type. Acceptable values are: - \"`trained_algorithmic_media`\" - \"`default`\" ", "type": "string" }, "content": { "description": "Required. The description text. Maximum length is 5000 characters.", "type": "string" } } }, "ProductsCustomBatchResponse": { "id": "ProductsCustomBatchResponse", "type": "object", "properties": { "entries": { "description": "The result of the execution of the batch requests.", "type": "array", "items": { "$ref": "ProductsCustomBatchResponseEntry" } }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#productsCustomBatchResponse`\".", "type": "string" } } }, "ProductsCustomBatchResponseEntry": { "id": "ProductsCustomBatchResponseEntry", "description": "A batch entry encoding a single non-batch products response.", "type": "object", "properties": { "batchId": { "description": "The ID of the request entry this entry responds to.", "type": "integer", "format": "uint32" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#productsCustomBatchResponseEntry`\"", "type": "string" }, "product": { "description": "The inserted product. Only defined if the method is `insert` and if the request was successful.", "$ref": "Product" }, "errors": { "description": "A list of errors for failed custombatch entries. *Note:* Schema errors fail the whole request.", "$ref": "Errors" } } }, "ProductsListResponse": { "id": "ProductsListResponse", "type": "object", "properties": { "nextPageToken": { "description": "The token for the retrieval of the next page of products.", "type": "string" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#productsListResponse`\".", "type": "string" }, "resources": { "type": "array", "items": { "$ref": "Product" } } } }, "ProductstatusesCustomBatchRequest": { "id": "ProductstatusesCustomBatchRequest", "type": "object", "properties": { "entries": { "description": "The request entries to be processed in the batch.", "type": "array", "items": { "$ref": "ProductstatusesCustomBatchRequestEntry" } } } }, "ProductstatusesCustomBatchRequestEntry": { "id": "ProductstatusesCustomBatchRequestEntry", "description": "A batch entry encoding a single non-batch productstatuses request.", "type": "object", "properties": { "batchId": { "description": "An entry ID, unique within the batch request.", "type": "integer", "format": "uint32" }, "merchantId": { "description": "The ID of the managing account.", "type": "string", "format": "uint64" }, "method": { "description": "The method of the batch entry. Acceptable values are: - \"`get`\" ", "type": "string" }, "productId": { "description": "The ID of the product whose status to get.", "type": "string" }, "includeAttributes": { "description": "Deprecated: Setting this field has no effect and attributes are never included.", "deprecated": true, "type": "boolean" }, "destinations": { "description": "If set, only issues for the specified destinations are returned, otherwise only issues for the Shopping destination.", "type": "array", "items": { "type": "string" } } } }, "ProductstatusesCustomBatchResponse": { "id": "ProductstatusesCustomBatchResponse", "type": "object", "properties": { "entries": { "description": "The result of the execution of the batch requests.", "type": "array", "items": { "$ref": "ProductstatusesCustomBatchResponseEntry" } }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#productstatusesCustomBatchResponse`\".", "type": "string" } } }, "ProductstatusesCustomBatchResponseEntry": { "id": "ProductstatusesCustomBatchResponseEntry", "description": "A batch entry encoding a single non-batch productstatuses response.", "type": "object", "properties": { "batchId": { "description": "The ID of the request entry this entry responds to.", "type": "integer", "format": "uint32" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#productstatusesCustomBatchResponseEntry`\"", "type": "string" }, "productStatus": { "description": "The requested product status. Only defined if the request was successful.", "$ref": "ProductStatus" }, "errors": { "description": "A list of errors for failed custombatch entries. *Note:* Schema errors fail the whole request.", "$ref": "Errors" } } }, "ProductStatus": { "id": "ProductStatus", "description": "The status of a product, that is, information about a product computed asynchronously.", "type": "object", "properties": { "productId": { "description": "The ID of the product for which status is reported.", "type": "string" }, "title": { "description": "The title of the product.", "type": "string" }, "link": { "description": "The link to the product.", "type": "string" }, "destinationStatuses": { "description": "The intended destinations for the product.", "type": "array", "items": { "$ref": "ProductStatusDestinationStatus" } }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#productStatus`\"", "type": "string" }, "creationDate": { "description": "Date on which the item has been created, in ISO 8601 format.", "type": "string" }, "lastUpdateDate": { "description": "Date on which the item has been last updated, in ISO 8601 format.", "type": "string" }, "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.", "type": "array", "items": { "$ref": "ProductStatusItemLevelIssue" } } } }, "ProductStatusDestinationStatus": { "id": "ProductStatusDestinationStatus", "type": "object", "properties": { "destination": { "description": "The name of the destination", "type": "string" }, "status": { "description": "Deprecated. Destination approval status in `targetCountry` of the offer.", "deprecated": true, "type": "string" }, "approvedCountries": { "description": "List of country codes (ISO 3166-1 alpha-2) where the offer is approved.", "type": "array", "items": { "type": "string" } }, "pendingCountries": { "description": "List of country codes (ISO 3166-1 alpha-2) where the offer is pending approval.", "type": "array", "items": { "type": "string" } }, "disapprovedCountries": { "description": "List of country codes (ISO 3166-1 alpha-2) where the offer is disapproved.", "type": "array", "items": { "type": "string" } } } }, "ProductStatusItemLevelIssue": { "id": "ProductStatusItemLevelIssue", "type": "object", "properties": { "code": { "description": "The error code of the issue.", "type": "string" }, "servability": { "description": "How this issue affects serving of the offer.", "type": "string" }, "resolution": { "description": "Whether the issue can be resolved by the merchant.", "type": "string" }, "attributeName": { "description": "The attribute's name, if the issue is caused by a single attribute.", "type": "string" }, "destination": { "description": "The destination the issue applies to.", "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" }, "applicableCountries": { "description": "List of country codes (ISO 3166-1 alpha-2) where issue applies to the offer.", "type": "array", "items": { "type": "string" } } } }, "ProductstatusesListResponse": { "id": "ProductstatusesListResponse", "type": "object", "properties": { "nextPageToken": { "description": "The token for the retrieval of the next page of products statuses.", "type": "string" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#productstatusesListResponse`\".", "type": "string" }, "resources": { "type": "array", "items": { "$ref": "ProductStatus" } } } }, "PubsubNotificationSettings": { "id": "PubsubNotificationSettings", "description": "Settings for Pub/Sub notifications, all methods require that the caller is a direct user of the merchant center account.", "type": "object", "properties": { "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#pubsubNotificationSettings`\"", "type": "string" }, "cloudTopicName": { "description": "Cloud pub/sub topic to which notifications are sent (read-only).", "type": "string" }, "registeredEvents": { "description": "List of event types. Acceptable values are: - \"`orderPendingShipment`\" ", "type": "array", "items": { "type": "string" } } } }, "RegionalinventoryCustomBatchRequest": { "id": "RegionalinventoryCustomBatchRequest", "type": "object", "properties": { "entries": { "description": "The request entries to be processed in the batch.", "type": "array", "items": { "$ref": "RegionalinventoryCustomBatchRequestEntry" } } } }, "RegionalinventoryCustomBatchRequestEntry": { "id": "RegionalinventoryCustomBatchRequestEntry", "description": "A batch entry encoding a single non-batch regional inventory request.", "type": "object", "properties": { "batchId": { "description": "An entry ID, unique within the batch request.", "type": "integer", "format": "uint32" }, "merchantId": { "description": "The ID of the managing account.", "type": "string", "format": "uint64" }, "method": { "description": "Method of the batch request entry. Acceptable values are: - \"`insert`\" ", "type": "string" }, "productId": { "description": "The ID of the product for which to update price and availability.", "type": "string" }, "regionalInventory": { "description": "Price and availability of the product.", "$ref": "RegionalInventory" } } }, "RegionalInventory": { "id": "RegionalInventory", "description": "Regional inventory resource. contains the regional name and all attributes which are overridden for the specified region.", "type": "object", "properties": { "regionId": { "description": "The ID uniquely identifying each region.", "type": "string" }, "price": { "description": "The price of the product.", "$ref": "Price" }, "salePrice": { "description": "The sale price of the product. Mandatory if `sale_price_effective_date` is defined.", "$ref": "Price" }, "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" }, "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.", "type": "array", "items": { "$ref": "CustomAttribute" } }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#regionalInventory`\".", "type": "string" } } }, "RegionalinventoryCustomBatchResponse": { "id": "RegionalinventoryCustomBatchResponse", "type": "object", "properties": { "entries": { "description": "The result of the execution of the batch requests.", "type": "array", "items": { "$ref": "RegionalinventoryCustomBatchResponseEntry" } }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#regionalinventoryCustomBatchResponse`\".", "type": "string" } } }, "RegionalinventoryCustomBatchResponseEntry": { "id": "RegionalinventoryCustomBatchResponseEntry", "description": "A batch entry encoding a single non-batch regional inventory response.", "type": "object", "properties": { "batchId": { "description": "The ID of the request entry this entry responds to.", "type": "integer", "format": "uint32" }, "errors": { "description": "A list of errors for failed custombatch entries. *Note:* Schema errors fail the whole request.", "$ref": "Errors" }, "regionalInventory": { "description": "Price and availability of the product.", "$ref": "RegionalInventory" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#regionalinventoryCustomBatchResponseEntry`\".", "type": "string" } } }, "ReturnaddressCustomBatchRequest": { "id": "ReturnaddressCustomBatchRequest", "type": "object", "properties": { "entries": { "description": "The request entries to be processed in the batch.", "type": "array", "items": { "$ref": "ReturnaddressCustomBatchRequestEntry" } } } }, "ReturnaddressCustomBatchRequestEntry": { "id": "ReturnaddressCustomBatchRequestEntry", "type": "object", "properties": { "batchId": { "description": "An entry ID, unique within the batch request.", "type": "integer", "format": "uint32" }, "merchantId": { "description": "The Merchant Center account ID.", "type": "string", "format": "uint64" }, "method": { "description": "Method of the batch request entry. Acceptable values are: - \"`delete`\" - \"`get`\" - \"`insert`\" ", "type": "string" }, "returnAddressId": { "description": "The return address ID. This should be set only if the method is `delete` or `get`.", "type": "string" }, "returnAddress": { "description": "The return address to submit. This should be set only if the method is `insert`.", "$ref": "ReturnAddress" } } }, "ReturnAddress": { "id": "ReturnAddress", "description": "Return address resource.", "type": "object", "properties": { "returnAddressId": { "description": "Return address ID generated by Google.", "type": "string" }, "label": { "description": "Required. The user-defined label of the return address. For the default address, use the label \"default\".", "type": "string" }, "country": { "description": "Required. The country of sale where the return address is applicable.", "type": "string" }, "address": { "description": "Required. The address.", "$ref": "ReturnAddressAddress" }, "phoneNumber": { "description": "Required. The merchant's contact phone number regarding the return.", "type": "string" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#returnAddress`\"", "type": "string" } } }, "ReturnAddressAddress": { "id": "ReturnAddressAddress", "type": "object", "properties": { "recipientName": { "description": "Name of the recipient to address returns to.", "type": "string" }, "streetAddress": { "description": "Street-level part of the address. May be up to two lines, each line specified as an array element.", "type": "array", "items": { "type": "string" } }, "locality": { "description": "City, town or commune. May also include dependent localities or sublocalities (for example, neighborhoods or suburbs).", "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" }, "postalCode": { "description": "Postal code or ZIP (for example, \"94043\").", "type": "string" }, "country": { "description": "CLDR country code (for example, \"US\").", "type": "string" } } }, "ReturnaddressCustomBatchResponse": { "id": "ReturnaddressCustomBatchResponse", "type": "object", "properties": { "entries": { "description": "The result of the execution of the batch requests.", "type": "array", "items": { "$ref": "ReturnaddressCustomBatchResponseEntry" } }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#returnaddressCustomBatchResponse`\".", "type": "string" } } }, "ReturnaddressCustomBatchResponseEntry": { "id": "ReturnaddressCustomBatchResponseEntry", "type": "object", "properties": { "batchId": { "description": "The ID of the request entry to which this entry responds.", "type": "integer", "format": "uint32" }, "returnAddress": { "description": "The retrieved return address.", "$ref": "ReturnAddress" }, "errors": { "description": "A list of errors defined if, and only if, the request failed.", "$ref": "Errors" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#returnaddressCustomBatchResponseEntry`\"", "type": "string" } } }, "ReturnaddressListResponse": { "id": "ReturnaddressListResponse", "type": "object", "properties": { "nextPageToken": { "description": "The token for the retrieval of the next page of addresses.", "type": "string" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#returnaddressListResponse`\".", "type": "string" }, "resources": { "type": "array", "items": { "$ref": "ReturnAddress" } } } }, "ReturnpolicyCustomBatchRequest": { "id": "ReturnpolicyCustomBatchRequest", "type": "object", "properties": { "entries": { "description": "The request entries to be processed in the batch.", "type": "array", "items": { "$ref": "ReturnpolicyCustomBatchRequestEntry" } } } }, "ReturnpolicyCustomBatchRequestEntry": { "id": "ReturnpolicyCustomBatchRequestEntry", "type": "object", "properties": { "batchId": { "description": "An entry ID, unique within the batch request.", "type": "integer", "format": "uint32" }, "merchantId": { "description": "The Merchant Center account ID.", "type": "string", "format": "uint64" }, "method": { "description": "Method of the batch request entry. Acceptable values are: - \"`delete`\" - \"`get`\" - \"`insert`\" ", "type": "string" }, "returnPolicyId": { "description": "The return policy ID. This should be set only if the method is `delete` or `get`.", "type": "string" }, "returnPolicy": { "description": "The return policy to submit. This should be set only if the method is `insert`.", "$ref": "ReturnPolicy" } } }, "ReturnPolicy": { "id": "ReturnPolicy", "description": "Return policy resource.", "type": "object", "properties": { "returnPolicyId": { "description": "Return policy ID generated by Google.", "type": "string" }, "label": { "description": "Required. The user-defined label of the return policy. For the default policy, use the label \"default\".", "type": "string" }, "country": { "description": "Required. The country of sale where the return policy is applicable.", "type": "string" }, "name": { "description": "Required. The name of the policy as shown in Merchant Center.", "type": "string" }, "policy": { "description": "Required. The policy.", "$ref": "ReturnPolicyPolicy" }, "seasonalOverrides": { "description": "An optional list of seasonal overrides.", "type": "array", "items": { "$ref": "ReturnPolicySeasonalOverride" } }, "nonFreeReturnReasons": { "description": "Return reasons that will incur return fees.", "type": "array", "items": { "type": "string" } }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#returnPolicy`\"", "type": "string" }, "returnShippingFee": { "description": "The return shipping fee that will apply to non free return reasons.", "$ref": "Price" } } }, "ReturnPolicyPolicy": { "id": "ReturnPolicyPolicy", "type": "object", "properties": { "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. Acceptable values are: - \"`lastReturnDate`\" - \"`lifetimeReturns`\" - \"`noReturns`\" - \"`numberOfDaysAfterDelivery`\" ", "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.", "type": "string", "format": "int64" }, "lastReturnDate": { "description": "Required. 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" } } }, "ReturnPolicySeasonalOverride": { "id": "ReturnPolicySeasonalOverride", "type": "object", "properties": { "name": { "description": "Required. The name of the seasonal override as shown in Merchant Center.", "type": "string" }, "startDate": { "description": "Required. First day on which the override applies. In ISO 8601 format.", "type": "string" }, "endDate": { "description": "Required. Last day on which the override applies. In ISO 8601 format.", "type": "string" }, "policy": { "description": "Required. The policy which is in effect during that time.", "$ref": "ReturnPolicyPolicy" } } }, "ReturnpolicyCustomBatchResponse": { "id": "ReturnpolicyCustomBatchResponse", "type": "object", "properties": { "entries": { "description": "The result of the execution of the batch requests.", "type": "array", "items": { "$ref": "ReturnpolicyCustomBatchResponseEntry" } }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#returnpolicyCustomBatchResponse`\".", "type": "string" } } }, "ReturnpolicyCustomBatchResponseEntry": { "id": "ReturnpolicyCustomBatchResponseEntry", "type": "object", "properties": { "batchId": { "description": "The ID of the request entry to which this entry responds.", "type": "integer", "format": "uint32" }, "returnPolicy": { "description": "The retrieved return policy.", "$ref": "ReturnPolicy" }, "errors": { "description": "A list of errors defined if, and only if, the request failed.", "$ref": "Errors" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#returnpolicyCustomBatchResponseEntry`\"", "type": "string" } } }, "ReturnpolicyListResponse": { "id": "ReturnpolicyListResponse", "type": "object", "properties": { "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#returnpolicyListResponse`\".", "type": "string" }, "resources": { "type": "array", "items": { "$ref": "ReturnPolicy" } } } }, "SettlementReport": { "id": "SettlementReport", "description": " Settlement reports detail order-level and item-level credits and debits between you and Google.", "type": "object", "properties": { "settlementId": { "description": "The ID of the settlement report.", "type": "string" }, "transferDate": { "description": "Date on which transfer for this payment was initiated by Google, in ISO 8601 format.", "type": "string" }, "transferIds": { "description": "The list of bank identifiers used for the transfer. For example, Trace ID for Federal Automated Clearing House (ACH). This may also be known as the Wire ID.", "type": "array", "items": { "type": "string" } }, "startDate": { "description": "The start date on which all transactions are included in the report, in ISO 8601 format.", "type": "string" }, "endDate": { "description": "The end date on which all transactions are included in the report, in ISO 8601 format.", "type": "string" }, "previousBalance": { "description": "The residual amount from the previous invoice. This is set only if the previous invoices are not paid because of negative balance.", "$ref": "Price" }, "transferAmount": { "description": "The money due to the merchant.", "$ref": "Price" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#settlementReport`\"", "type": "string" } } }, "SettlementreportsListResponse": { "id": "SettlementreportsListResponse", "type": "object", "properties": { "nextPageToken": { "description": "The token for the retrieval of the next page of returns.", "type": "string" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#settlementreportsListResponse`\".", "type": "string" }, "resources": { "type": "array", "items": { "$ref": "SettlementReport" } } } }, "SettlementtransactionsListResponse": { "id": "SettlementtransactionsListResponse", "type": "object", "properties": { "nextPageToken": { "description": "The token for the retrieval of the next page of returns.", "type": "string" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#settlementtransactionsListResponse`\".", "type": "string" }, "resources": { "type": "array", "items": { "$ref": "SettlementTransaction" } } } }, "SettlementTransaction": { "id": "SettlementTransaction", "description": "Settlement transactions give a detailed breakdown of the settlement report.", "type": "object", "properties": { "identifiers": { "description": "Identifiers of the transaction.", "$ref": "SettlementTransactionIdentifiers" }, "transaction": { "description": "Details of the transaction.", "$ref": "SettlementTransactionTransaction" }, "amount": { "description": "The amount for the transaction.", "$ref": "SettlementTransactionAmount" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#settlementTransaction`\"", "type": "string" } } }, "SettlementTransactionIdentifiers": { "id": "SettlementTransactionIdentifiers", "type": "object", "properties": { "settlementEntryId": { "description": "The unique ID of the settlement transaction entry.", "type": "string" }, "transactionId": { "description": "The Google transaction ID.", "type": "string" }, "merchantOrderId": { "description": "The merchant provided order ID.", "type": "string" }, "shipmentIds": { "description": "The shipment ids for the item.", "type": "array", "items": { "type": "string" } }, "adjustmentId": { "description": "The identifier of the adjustments, if it's available.", "type": "string" }, "orderItemId": { "description": "The identifier of the item.", "type": "string" } } }, "SettlementTransactionTransaction": { "id": "SettlementTransactionTransaction", "type": "object", "properties": { "type": { "description": "The type of the transaction that occurred. Acceptable values are: - \"`order`\" - \"`reversal`\" - \"`orderRefund`\" - \"`reversalRefund`\" - \"`issueRelatedRefundAndReplacement`\" - \"`returnLabelShippingFeeTransaction`\" - \"`reversalIssueRelatedRefundAndReplacement`\" - \"`reversalReturnLabelShippingFeeTransaction`\" - \"`lumpSumCorrectionTransaction`\" ", "type": "string" }, "postDate": { "description": "The time on which the event occurred in ISO 8601 format.", "type": "string" } } }, "SettlementTransactionAmount": { "id": "SettlementTransactionAmount", "type": "object", "properties": { "type": { "description": "The type of the amount. Acceptable values are: - \"`itemPrice`\" - \"`orderPrice`\" - \"`refund`\" - \"`earlyRefund`\" - \"`courtesyRefund`\" - \"`returnRefund`\" - \"`returnLabelShippingFeeAmount`\" - \"`lumpSumCorrectionAmount`\" ", "type": "string" }, "description": { "description": "The description of the event. Acceptable values are: - \"`taxWithhold`\" - \"`principal`\" - \"`principalAdjustment`\" - \"`shippingFee`\" - \"`merchantRemittedSalesTax`\" - \"`googleRemittedSalesTax`\" - \"`merchantCoupon`\" - \"`merchantCouponTax`\" - \"`merchantRemittedDisposalTax`\" - \"`googleRemittedDisposalTax`\" - \"`merchantRemittedRedemptionFee`\" - \"`googleRemittedRedemptionFee`\" - \"`eeeEcoFee`\" - \"`furnitureEcoFee`\" - \"`copyPrivateFee`\" - \"`eeeEcoFeeCommission`\" - \"`furnitureEcoFeeCommission`\" - \"`copyPrivateFeeCommission`\" - \"`principalRefund`\" - \"`principalRefundTax`\" - \"`itemCommission`\" - \"`adjustmentCommission`\" - \"`shippingFeeCommission`\" - \"`commissionRefund`\" - \"`damaged`\" - \"`damagedOrDefectiveItem`\" - \"`expiredItem`\" - \"`faultyItem`\" - \"`incorrectItemReceived`\" - \"`itemMissing`\" - \"`qualityNotExpected`\" - \"`receivedTooLate`\" - \"`storePackageMissing`\" - \"`transitPackageMissing`\" - \"`unsuccessfulDeliveryUndeliverable`\" - \"`wrongChargeInStore`\" - \"`wrongItem`\" - \"`returns`\" - \"`undeliverable`\" - \"`issueRelatedRefundAndReplacementAmountDescription`\" - \"`refundFromMerchant`\" - \"`returnLabelShippingFee`\" - \"`lumpSumCorrection`\" - \"`pspFee`\" - \"`principalRefundDoesNotFit`\" - \"`principalRefundOrderedWrongItem`\" - \"`principalRefundQualityNotExpected`\" - \"`principalRefundBetterPriceFound`\" - \"`principalRefundNoLongerNeeded`\" - \"`principalRefundChangedMind`\" - \"`principalRefundReceivedTooLate`\" - \"`principalRefundIncorrectItemReceived`\" - \"`principalRefundDamagedOrDefectiveItem`\" - \"`principalRefundDidNotMatchDescription`\" - \"`principalRefundExpiredItem`\" ", "type": "string" }, "commission": { "$ref": "SettlementTransactionAmountCommission" }, "transactionAmount": { "description": "The amount that contributes to the line item price.", "$ref": "Price" } } }, "SettlementTransactionAmountCommission": { "id": "SettlementTransactionAmountCommission", "type": "object", "properties": { "category": { "description": "The category of the commission. Acceptable values are: - \"`animalsAndPetSupplies`\" - \"`dogCatFoodAndCatLitter`\" - \"`apparelAndAccessories`\" - \"`shoesHandbagsAndSunglasses`\" - \"`costumesAndAccessories`\" - \"`jewelry`\" - \"`watches`\" - \"`hobbiesArtsAndCrafts`\" - \"`homeAndGarden`\" - \"`entertainmentCollectibles`\" - \"`collectibleCoins`\" - \"`sportsCollectibles`\" - \"`sportingGoods`\" - \"`toysAndGames`\" - \"`musicalInstruments`\" - \"`giftCards`\" - \"`babyAndToddler`\" - \"`babyFoodWipesAndDiapers`\" - \"`businessAndIndustrial`\" - \"`camerasOpticsAndPhotography`\" - \"`consumerElectronics`\" - \"`electronicsAccessories`\" - \"`personalComputers`\" - \"`videoGameConsoles`\" - \"`foodAndGrocery`\" - \"`beverages`\" - \"`tobaccoProducts`\" - \"`furniture`\" - \"`hardware`\" - \"`buildingMaterials`\" - \"`tools`\" - \"`healthAndPersonalCare`\" - \"`beauty`\" - \"`householdSupplies`\" - \"`kitchenAndDining`\" - \"`majorAppliances`\" - \"`luggageAndBags`\" - \"`media`\" - \"`officeSupplies`\" - \"`softwareAndVideoGames`\" - \"`vehiclePartsAndAccessories`\" - \"`vehicleTiresAndWheels`\" - \"`vehicles`\" - \"`everythingElse`\" ", "type": "string" }, "rate": { "description": "Rate of the commission in percentage.", "type": "string" } } }, "ShippingsettingsCustomBatchRequest": { "id": "ShippingsettingsCustomBatchRequest", "type": "object", "properties": { "entries": { "description": "The request entries to be processed in the batch.", "type": "array", "items": { "$ref": "ShippingsettingsCustomBatchRequestEntry" } } } }, "ShippingsettingsCustomBatchRequestEntry": { "id": "ShippingsettingsCustomBatchRequestEntry", "description": "A batch entry encoding a single non-batch shippingsettings request.", "type": "object", "properties": { "batchId": { "description": "An entry ID, unique within the batch request.", "type": "integer", "format": "uint32" }, "merchantId": { "description": "The ID of the managing account.", "type": "string", "format": "uint64" }, "method": { "description": "The method of the batch entry. Acceptable values are: - \"`get`\" - \"`update`\" ", "type": "string" }, "accountId": { "description": "The ID of the account for which to get/update account shipping settings.", "type": "string", "format": "uint64" }, "shippingSettings": { "description": "The account shipping settings to update. Only defined if the method is `update`.", "$ref": "ShippingSettings" } } }, "ShippingSettings": { "id": "ShippingSettings", "description": "The merchant account's shipping settings. All methods except getsupportedcarriers and getsupportedholidays require the admin role.", "type": "object", "properties": { "accountId": { "description": "The ID of the account to which these account shipping settings belong. Ignored upon update, always present in get request responses.", "type": "string", "format": "uint64" }, "services": { "description": "The target account's list of services. Optional.", "type": "array", "items": { "$ref": "Service" } }, "postalCodeGroups": { "description": "A list of postal code groups that can be referred to in `services`. Optional.", "type": "array", "items": { "$ref": "PostalCodeGroup" } }, "warehouses": { "description": "Optional. A list of warehouses which can be referred to in `services`.", "type": "array", "items": { "$ref": "Warehouse" } } } }, "Service": { "id": "Service", "type": "object", "properties": { "name": { "description": "Free-form name of the service. Must be unique within target account. Required.", "type": "string" }, "deliveryCountry": { "description": "The CLDR territory code of the country to which the service applies. Required.", "type": "string" }, "currency": { "description": "The CLDR code of the currency to which this service applies. Must match that of the prices in rate groups.", "type": "string" }, "deliveryTime": { "description": "Time spent in various aspects from order to the delivery of the product. Required.", "$ref": "DeliveryTime" }, "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.", "type": "array", "items": { "$ref": "RateGroup" } }, "active": { "description": "A boolean exposing the active status of the shipping service. Required.", "type": "boolean" }, "minimumOrderValue": { "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. Cannot be set together with minimum_order_value_table.", "$ref": "Price" }, "eligibility": { "description": "Eligibility for this service. Acceptable values are: - \"`All scenarios`\" - \"`All scenarios except Shopping Actions`\" - \"`Shopping Actions`\" ", "type": "string" }, "shipmentType": { "description": "Type of locations this service ships orders to. Acceptable values are: - \"`delivery`\" - \"`pickup` (deprecated)\" - \"`local_delivery`\" - \"`collection_point`\" ", "type": "string" }, "pickupService": { "description": "The carrier-service pair delivering items to collection points. The list of supported pickup services can be retrieved through the `getSupportedPickupServices` method. Required if and only if the service delivery type is `pickup`.", "$ref": "PickupCarrierService" }, "minimumOrderValueTable": { "description": "Table of per store minimum order values for the pickup fulfillment type. Cannot be set together with minimum_order_value.", "$ref": "MinimumOrderValueTable" }, "storeConfig": { "description": "A list of stores your products are delivered from. This is only available for the local delivery shipment type.", "$ref": "ServiceStoreConfig" } } }, "DeliveryTime": { "id": "DeliveryTime", "type": "object", "properties": { "minTransitTimeInDays": { "description": "Minimum number of business days that are 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.", "type": "integer", "format": "uint32" }, "maxTransitTimeInDays": { "description": "Maximum number of business days that are spent in transit. 0 means same day delivery, 1 means next day delivery. Must be greater than or equal to `minTransitTimeInDays`.", "type": "integer", "format": "uint32" }, "holidayCutoffs": { "description": "Holiday cutoff definitions. If configured, they specify order cutoff times for holiday-specific shipping.", "type": "array", "items": { "$ref": "HolidayCutoff" } }, "cutoffTime": { "description": "Business days cutoff time definition. If not configured, the cutoff time will be defaulted to 8AM PST. If local delivery, use Service.StoreConfig.CutoffConfig.", "$ref": "CutoffTime" }, "minHandlingTimeInDays": { "description": "Minimum number of business days spent before an order is shipped. 0 means same day shipped, 1 means next day shipped.", "type": "integer", "format": "uint32" }, "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`.", "type": "integer", "format": "uint32" }, "transitTimeTable": { "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.", "$ref": "TransitTable" }, "handlingBusinessDayConfig": { "description": "The business days during which orders can be handled. If not provided, Monday to Friday business days will be assumed.", "$ref": "BusinessDayConfig" }, "transitBusinessDayConfig": { "description": "The business days during which orders can be in-transit. If not provided, Monday to Friday business days will be assumed.", "$ref": "BusinessDayConfig" }, "warehouseBasedDeliveryTimes": { "description": "Indicates that the delivery time should be calculated per warehouse (shipping origin location) based on the settings of the selected carrier. When set, no other transit time related field in DeliveryTime should be set.", "type": "array", "items": { "$ref": "WarehouseBasedDeliveryTime" } } } }, "HolidayCutoff": { "id": "HolidayCutoff", "type": "object", "properties": { "holidayId": { "description": "Unique identifier for the holiday. Required.", "type": "string" }, "deadlineDate": { "description": "Date of the order deadline, in ISO 8601 format. For example, \"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.", "type": "integer", "format": "uint32" }, "deadlineTimezone": { "description": "Timezone identifier for the deadline hour (for example, \"Europe/Zurich\"). List of identifiers. Required.", "type": "string" }, "visibleFromDate": { "description": "Date on which the deadline will become visible to consumers in ISO 8601 format. For example, \"2016-10-31\" for 31st October 2016. Required.", "type": "string" } } }, "CutoffTime": { "id": "CutoffTime", "type": "object", "properties": { "hour": { "description": "Hour of the cutoff time until which an order has to be placed to be processed in the same day. Required.", "type": "integer", "format": "uint32" }, "minute": { "description": "Minute of the cutoff time until which an order has to be placed to be processed in the same day. Required.", "type": "integer", "format": "uint32" }, "timezone": { "description": "Timezone identifier for the cutoff time (for example, \"Europe/Zurich\"). List of identifiers. Required.", "type": "string" } } }, "TransitTable": { "id": "TransitTable", "type": "object", "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.", "type": "array", "items": { "type": "string" } }, "transitTimeLabels": { "description": "A list of transit time labels. The last value can be `\"all other labels\"`. Example: `[\"food\", \"electronics\", \"all other labels\"]`.", "type": "array", "items": { "type": "string" } }, "rows": { "type": "array", "items": { "$ref": "TransitTableTransitTimeRow" } } } }, "TransitTableTransitTimeRow": { "id": "TransitTableTransitTimeRow", "type": "object", "properties": { "values": { "type": "array", "items": { "$ref": "TransitTableTransitTimeRowTransitTimeValue" } } } }, "TransitTableTransitTimeRowTransitTimeValue": { "id": "TransitTableTransitTimeRowTransitTimeValue", "type": "object", "properties": { "minTransitTimeInDays": { "description": "Transit time range (min-max) in business days. 0 means same day delivery, 1 means next day delivery.", "type": "integer", "format": "uint32" }, "maxTransitTimeInDays": { "description": "Must be greater than or equal to `minTransitTimeInDays`.", "type": "integer", "format": "uint32" } } }, "BusinessDayConfig": { "id": "BusinessDayConfig", "type": "object", "properties": { "businessDays": { "description": "Regular business days, such as '\"monday\"'. May not be empty.", "type": "array", "items": { "type": "string" } } } }, "WarehouseBasedDeliveryTime": { "id": "WarehouseBasedDeliveryTime", "type": "object", "properties": { "carrier": { "description": "Required. Carrier, such as `\"UPS\"` or `\"Fedex\"`. The list of supported carriers can be retrieved through the `listSupportedCarriers` method.", "type": "string" }, "carrierService": { "description": "Required. Carrier service, such as `\"ground\"` or `\"2 days\"`. The list of supported services for a carrier can be retrieved through the `listSupportedCarriers` method. The name of the service must be in the eddSupportedServices list.", "type": "string" }, "warehouseName": { "description": "The name of the warehouse. Warehouse name need to be matched with name. If warehouseName is set, the below fields will be ignored. The warehouse info will be read from warehouse.", "type": "string" }, "originPostalCode": { "description": "Shipping origin.", "type": "string" }, "originStreetAddress": { "description": "Shipping origin's street address.", "type": "string" }, "originCity": { "description": "Shipping origin's city.", "type": "string" }, "originAdministrativeArea": { "description": "Shipping origin's state.", "type": "string" }, "originCountry": { "description": "Shipping origin's country represented as a [CLDR territory code](https://github.com/unicode-org/cldr/blob/latest/common/main/en.xml).", "type": "string" } } }, "RateGroup": { "id": "RateGroup", "type": "object", "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.", "type": "array", "items": { "type": "string" } }, "singleValue": { "description": "The value of the rate group (for example, flat rate $10). Can only be set if `mainTable` and `subtables` are not set.", "$ref": "Value" }, "mainTable": { "description": "A table defining the rate group, when `singleValue` is not expressive enough. Can only be set if `singleValue` is not set.", "$ref": "Table" }, "subtables": { "description": "A list of subtables referred to by `mainTable`. Can only be set if `mainTable` is set.", "type": "array", "items": { "$ref": "Table" } }, "carrierRates": { "description": "A list of carrier rates that can be referred to by `mainTable` or `singleValue`.", "type": "array", "items": { "$ref": "CarrierRate" } }, "name": { "description": "Name of the rate group. Optional. If set has to be unique within shipping service.", "type": "string" } } }, "Value": { "id": "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.", "type": "object", "properties": { "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" }, "flatRate": { "description": "A flat rate. Can only be set if all other fields are not set.", "$ref": "Price" }, "pricePercentage": { "description": "A percentage of the price represented as a number in decimal notation (for example, `\"5.4\"`). Can only be set if all other fields are not set.", "type": "string" }, "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" }, "subtableName": { "description": "The name of a subtable. Can only be set in table cells (not for single values), and only if all other fields are not set.", "type": "string" } } }, "Table": { "id": "Table", "type": "object", "properties": { "name": { "description": "Name of the table. Required for subtables, ignored for the main table.", "type": "string" }, "rowHeaders": { "description": "Headers of the table's rows. Required.", "$ref": "Headers" }, "columnHeaders": { "description": "Headers of the table's columns. Optional: if not set then the table has only one dimension.", "$ref": "Headers" }, "rows": { "description": "The list of rows that constitute the table. Must have the same length as `rowHeaders`. Required.", "type": "array", "items": { "$ref": "Row" } } } }, "Headers": { "id": "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.", "type": "object", "properties": { "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\", \"\u003c= $500\", and \"\u003e $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.", "type": "array", "items": { "$ref": "Price" } }, "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\", \"\u003c= 50kg\", and \"\u003e 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.", "type": "array", "items": { "$ref": "Weight" } }, "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\", \"\u003c= 50 items\", and \"\u003e 50 items\". Must be non-empty. Can only be set if all other fields are not set.", "type": "array", "items": { "type": "string" } }, "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.", "type": "array", "items": { "type": "string" } }, "locations": { "description": "A list of location ID sets. Must be non-empty. Can only be set if all other fields are not set.", "type": "array", "items": { "$ref": "LocationIdSet" } } } }, "Weight": { "id": "Weight", "type": "object", "properties": { "value": { "description": "Required. The weight represented as a number. The weight can have a maximum precision of four decimal places.", "type": "string" }, "unit": { "description": "Required. The weight unit. Acceptable values are: - \"`kg`\" - \"`lb`\" ", "type": "string" } } }, "LocationIdSet": { "id": "LocationIdSet", "type": "object", "properties": { "locationIds": { "description": "A non-empty list of location IDs. They must all be of the same location type (for example, state).", "type": "array", "items": { "type": "string" } } } }, "Row": { "id": "Row", "type": "object", "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.", "type": "array", "items": { "$ref": "Value" } } } }, "CarrierRate": { "id": "CarrierRate", "type": "object", "properties": { "name": { "description": "Name of the carrier rate. Must be unique per rate group. Required.", "type": "string" }, "carrierName": { "description": "Carrier service, such as `\"UPS\"` or `\"Fedex\"`. The list of supported carriers can be retrieved through 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 through the `getSupportedCarriers` method. 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" }, "flatAdjustment": { "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.", "$ref": "Price" } } }, "PickupCarrierService": { "id": "PickupCarrierService", "type": "object", "properties": { "carrierName": { "description": "The name of the pickup carrier (for example, `\"UPS\"`). Required.", "type": "string" }, "serviceName": { "description": "The name of the pickup service (for example, `\"Access point\"`). Required.", "type": "string" } } }, "MinimumOrderValueTable": { "id": "MinimumOrderValueTable", "type": "object", "properties": { "storeCodeSetWithMovs": { "type": "array", "items": { "$ref": "MinimumOrderValueTableStoreCodeSetWithMov" } } } }, "MinimumOrderValueTableStoreCodeSetWithMov": { "id": "MinimumOrderValueTableStoreCodeSetWithMov", "description": "A list of store code sets sharing the same minimum order value. At least two sets are required and the last one must be empty, which signifies 'MOV for all other stores'. Each store code can only appear once across all the sets. All prices within a service must have the same currency.", "type": "object", "properties": { "storeCodes": { "description": "A list of unique store codes or empty for the catch all.", "type": "array", "items": { "type": "string" } }, "value": { "description": "The minimum order value for the given stores.", "$ref": "Price" } } }, "ServiceStoreConfig": { "id": "ServiceStoreConfig", "description": "Stores that provide local delivery. Only valid with local delivery fulfillment.", "type": "object", "properties": { "storeServiceType": { "description": "Indicates whether all stores listed by this merchant provide local delivery or not. Acceptable values are `all stores` and `selected stores`", "type": "string" }, "storeCodes": { "description": "A list of store codes that provide local delivery. If empty, then `store_service_type` must be `all_stores`, or an error is thrown. If not empty, then `store_service_type` must be `selected_stores`, or an error is thrown.", "type": "array", "items": { "type": "string" } }, "cutoffConfig": { "description": "Time local delivery ends for the day. This can be either `local_cutoff_time` or `store_close_offset_hours`, if both are provided an error is thrown.", "$ref": "ServiceStoreConfigCutoffConfig" }, "serviceRadius": { "description": "Maximum delivery radius. Only needed for local delivery fulfillment type.", "$ref": "Distance" } } }, "ServiceStoreConfigCutoffConfig": { "id": "ServiceStoreConfigCutoffConfig", "description": "Time local delivery ends for the day based on the local timezone of the store. `local_cutoff_time` and `store_close_offset_hours` are mutually exclusive.", "type": "object", "properties": { "localCutoffTime": { "description": "Time in hours and minutes in the local timezone when local delivery ends.", "$ref": "ServiceStoreConfigCutoffConfigLocalCutoffTime" }, "storeCloseOffsetHours": { "description": "Represents cutoff time as the number of hours before store closing. Mutually exclusive with other fields (hour and minute).", "type": "string", "format": "int64" }, "noDeliveryPostCutoff": { "description": "Merchants can opt-out of showing n+1 day local delivery when they have a shipping service configured to n day local delivery. For example, if the shipping service defines same-day delivery, and it's past the cut-off, setting this field to `true` results in the calculated shipping service rate returning `NO_DELIVERY_POST_CUTOFF`. In the same example, setting this field to `false` results in the calculated shipping time being one day. This is only for local delivery.", "type": "boolean" } } }, "ServiceStoreConfigCutoffConfigLocalCutoffTime": { "id": "ServiceStoreConfigCutoffConfigLocalCutoffTime", "description": "Time in hours and minutes in the local timezone when local delivery ends.", "type": "object", "properties": { "hour": { "description": "Hour local delivery orders must be placed by to process the same day.", "type": "string", "format": "int64" }, "minute": { "description": "Minute local delivery orders must be placed by to process the same day.", "type": "string", "format": "int64" } } }, "Distance": { "id": "Distance", "description": "Distance represented by an integer and unit.", "type": "object", "properties": { "value": { "description": "The distance represented as a number.", "type": "string", "format": "int64" }, "unit": { "description": "The distance unit. Acceptable values are `None`, `Miles`, and `Kilometers`.", "type": "string" } } }, "PostalCodeGroup": { "id": "PostalCodeGroup", "type": "object", "properties": { "name": { "description": "The name of the postal code group, referred to in headers. Required.", "type": "string" }, "country": { "description": "The CLDR territory code of the country the postal code group applies to. Required.", "type": "string" }, "postalCodeRanges": { "description": "A range of postal codes. Required.", "type": "array", "items": { "$ref": "PostalCodeRange" } } } }, "PostalCodeRange": { "id": "PostalCodeRange", "type": "object", "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" } } }, "Warehouse": { "id": "Warehouse", "description": "A fulfillment warehouse, which stores and handles inventory.", "type": "object", "properties": { "name": { "description": "Required. The name of the warehouse. Must be unique within account.", "type": "string" }, "shippingAddress": { "description": "Required. Shipping address of the warehouse.", "$ref": "Address" }, "cutoffTime": { "description": "Required. The latest time of day that an order can be accepted and begin processing. Later orders will be processed in the next day. The time is based on the warehouse postal code.", "$ref": "WarehouseCutoffTime" }, "handlingDays": { "description": "Required. The number of days it takes for this warehouse to pack up and ship an item. This is on the warehouse level, but can be overridden on the offer level based on the attributes of an item.", "type": "string", "format": "int64" }, "businessDayConfig": { "description": "Business days of the warehouse. If not set, will be Monday to Friday by default.", "$ref": "BusinessDayConfig" } } }, "Address": { "id": "Address", "type": "object", "properties": { "streetAddress": { "description": "Street-level part of the address. Use `\\n` to add a second line.", "type": "string" }, "city": { "description": "Required. City, town or commune. May also include dependent localities or sublocalities (for example, neighborhoods or suburbs).", "type": "string" }, "administrativeArea": { "description": "Required. Top-level administrative subdivision of the country. For example, a state like California (\"CA\") or a province like Quebec (\"QC\").", "type": "string" }, "postalCode": { "description": "Required. Postal code or ZIP (for example, \"94043\").", "type": "string" }, "country": { "description": "Required. [CLDR country code](https://github.com/unicode-org/cldr/blob/latest/common/main/en.xml) (for example, \"US\").", "type": "string" } } }, "WarehouseCutoffTime": { "id": "WarehouseCutoffTime", "type": "object", "properties": { "hour": { "description": "Required. Hour (24-hour clock) of the cutoff time until which an order has to be placed to be processed in the same day by the warehouse. Hour is based on the timezone of warehouse.", "type": "integer", "format": "int32" }, "minute": { "description": "Required. Minute of the cutoff time until which an order has to be placed to be processed in the same day by the warehouse. Minute is based on the timezone of warehouse.", "type": "integer", "format": "int32" } } }, "ShippingsettingsCustomBatchResponse": { "id": "ShippingsettingsCustomBatchResponse", "type": "object", "properties": { "entries": { "description": "The result of the execution of the batch requests.", "type": "array", "items": { "$ref": "ShippingsettingsCustomBatchResponseEntry" } }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#shippingsettingsCustomBatchResponse`\".", "type": "string" } } }, "ShippingsettingsCustomBatchResponseEntry": { "id": "ShippingsettingsCustomBatchResponseEntry", "description": "A batch entry encoding a single non-batch shipping settings response.", "type": "object", "properties": { "batchId": { "description": "The ID of the request entry to which this entry responds.", "type": "integer", "format": "uint32" }, "shippingSettings": { "description": "The retrieved or updated account shipping settings.", "$ref": "ShippingSettings" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#shippingsettingsCustomBatchResponseEntry`\"", "type": "string" }, "errors": { "description": "A list of errors for failed custombatch entries. *Note:* Schema errors fail the whole request.", "$ref": "Errors" } } }, "ShippingsettingsGetSupportedCarriersResponse": { "id": "ShippingsettingsGetSupportedCarriersResponse", "type": "object", "properties": { "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#shippingsettingsGetSupportedCarriersResponse`\".", "type": "string" }, "carriers": { "description": "A list of supported carriers. May be empty.", "type": "array", "items": { "$ref": "CarriersCarrier" } } } }, "CarriersCarrier": { "id": "CarriersCarrier", "type": "object", "properties": { "name": { "description": "The name of the carrier (for example, `\"UPS\"`). Always present.", "type": "string" }, "country": { "description": "The CLDR country code of the carrier (for example, \"US\"). Always present.", "type": "string" }, "services": { "description": "A list of supported services (for example, `\"ground\"`) for that carrier. Contains at least one service. This is the list of valid values for CarrierRate.carrierService.", "type": "array", "items": { "type": "string" } }, "eddServices": { "description": "A list of services supported for EDD (Estimated Delivery Date) calculation. This is the list of valid values for WarehouseBasedDeliveryTime.carrierService.", "type": "array", "items": { "type": "string" } } } }, "ShippingsettingsGetSupportedHolidaysResponse": { "id": "ShippingsettingsGetSupportedHolidaysResponse", "type": "object", "properties": { "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#shippingsettingsGetSupportedHolidaysResponse`\".", "type": "string" }, "holidays": { "description": "A list of holidays applicable for delivery guarantees. May be empty.", "type": "array", "items": { "$ref": "HolidaysHoliday" } } } }, "HolidaysHoliday": { "id": "HolidaysHoliday", "type": "object", "properties": { "id": { "description": "Unique identifier for the holiday to be used when configuring holiday cutoffs. Always present.", "type": "string" }, "countryCode": { "description": "The CLDR territory code of the country in which the holiday is available. For example, \"US\", \"DE\", \"GB\". A holiday cutoff can only be configured in a shipping settings service with matching delivery country. Always present.", "type": "string" }, "type": { "description": "The holiday type. Always present. Acceptable values are: - \"`Christmas`\" - \"`Easter`\" - \"`Father's Day`\" - \"`Halloween`\" - \"`Independence Day (USA)`\" - \"`Mother's Day`\" - \"`Thanksgiving`\" - \"`Valentine's Day`\" ", "type": "string" }, "date": { "description": "Date of the holiday, in ISO 8601 format. For example, \"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. For example, \"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.", "type": "string", "format": "uint64" } } }, "ShippingsettingsGetSupportedPickupServicesResponse": { "id": "ShippingsettingsGetSupportedPickupServicesResponse", "type": "object", "properties": { "kind": { "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.", "type": "array", "items": { "$ref": "PickupServicesPickupService" } } } }, "PickupServicesPickupService": { "id": "PickupServicesPickupService", "type": "object", "properties": { "country": { "description": "The CLDR country code of the carrier (for example, \"US\"). Always present.", "type": "string" }, "carrierName": { "description": "The name of the carrier (for example, `\"UPS\"`). Always present.", "type": "string" }, "serviceName": { "description": "The name of the pickup service (for example, `\"Access point\"`). Always present.", "type": "string" } } }, "ShippingsettingsListResponse": { "id": "ShippingsettingsListResponse", "type": "object", "properties": { "nextPageToken": { "description": "The token for the retrieval of the next page of shipping settings.", "type": "string" }, "kind": { "description": "Identifies what kind of resource this is. Value: the fixed string \"`content#shippingsettingsListResponse`\".", "type": "string" }, "resources": { "type": "array", "items": { "$ref": "ShippingSettings" } } } }, "AccountCredentials": { "id": "AccountCredentials", "description": "Credentials allowing Google to call a partner's API on behalf of a merchant.", "type": "object", "properties": { "purpose": { "description": "Indicates to Google how Google should use these OAuth tokens.", "type": "string", "enumDescriptions": [ "Unknown purpose.", "The credentials allow Google to manage Shopify orders on behalf of the merchant (deprecated).", "The credentials allow Google to manage Shopify integration on behalf of the merchant." ], "enumDeprecated": [ false, true, false ], "enum": [ "ACCOUNT_CREDENTIALS_PURPOSE_UNSPECIFIED", "SHOPIFY_ORDER_MANAGEMENT", "SHOPIFY_INTEGRATION" ] }, "accessToken": { "description": "An OAuth access token.", "type": "string" }, "expiresIn": { "description": "The amount of time, in seconds, after which the access token is no longer valid.", "type": "string", "format": "int64" } } }, "RequestPhoneVerificationRequest": { "id": "RequestPhoneVerificationRequest", "description": "Request message for the RequestPhoneVerification method.", "type": "object", "properties": { "phoneRegionCode": { "description": "Required. Two letter country code for the phone number, for example `CA` for Canadian numbers. See the [ISO 3166-1 alpha-2](https://wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements) officially assigned codes.", "type": "string" }, "phoneNumber": { "description": "Phone number to be verified.", "type": "string" }, "phoneVerificationMethod": { "description": "Verification method to receive verification code.", "type": "string", "enumDescriptions": [ "Unknown method.", "Receive verification code by SMS.", "Receive verification code by phone call." ], "enum": [ "PHONE_VERIFICATION_METHOD_UNSPECIFIED", "SMS", "PHONE_CALL" ] }, "languageCode": { "description": "Language code [IETF BCP 47 syntax](https://tools.ietf.org/html/bcp47) (for example, en-US). Language code is used to provide localized `SMS` and `PHONE_CALL`. Default language used is en-US if not provided.", "type": "string" } } }, "RequestPhoneVerificationResponse": { "id": "RequestPhoneVerificationResponse", "description": "Response message for the RequestPhoneVerification method.", "type": "object", "properties": { "verificationId": { "description": "The verification ID to use in subsequent calls to `verifyphonenumber`.", "type": "string" } } }, "VerifyPhoneNumberRequest": { "id": "VerifyPhoneNumberRequest", "description": "Request message for the VerifyPhoneNumber method.", "type": "object", "properties": { "verificationId": { "description": "The verification ID returned by `requestphoneverification`.", "type": "string" }, "verificationCode": { "description": "The verification code that was sent to the phone number for validation.", "type": "string" }, "phoneVerificationMethod": { "description": "Verification method used to receive verification code.", "type": "string", "enumDescriptions": [ "Unknown method.", "Receive verification code by SMS.", "Receive verification code by phone call." ], "enum": [ "PHONE_VERIFICATION_METHOD_UNSPECIFIED", "SMS", "PHONE_CALL" ] } } }, "VerifyPhoneNumberResponse": { "id": "VerifyPhoneNumberResponse", "description": "Response message for the VerifyPhoneNumber method.", "type": "object", "properties": { "verifiedPhoneNumber": { "description": "Verified phone number if verification is successful. This phone number can only be replaced by another verified phone number.", "type": "string" } } }, "ListAccountLabelsResponse": { "id": "ListAccountLabelsResponse", "description": "Response message for the `ListAccountLabels` method.", "type": "object", "properties": { "accountLabels": { "description": "The labels from the specified account.", "type": "array", "items": { "$ref": "AccountLabel" } }, "nextPageToken": { "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" } } }, "AccountLabel": { "id": "AccountLabel", "description": "Label assigned by CSS domain or CSS group to one of its sub-accounts.", "type": "object", "properties": { "labelId": { "description": "Output only. The ID of the label.", "readOnly": true, "type": "string", "format": "int64" }, "accountId": { "description": "Immutable. The ID of account this label belongs to.", "type": "string", "format": "int64" }, "name": { "description": "The display name of this label.", "type": "string" }, "description": { "description": "The description of this label.", "type": "string" }, "labelType": { "description": "Output only. The type of this label.", "readOnly": true, "type": "string", "enumDescriptions": [ "Unknown label type.", "Indicates that the label was created manually.", "Indicates that the label was created automatically by CSS Center." ], "enum": [ "LABEL_TYPE_UNSPECIFIED", "MANUAL", "AUTOMATIC" ] } } }, "Collection": { "id": "Collection", "description": "The collection message.", "type": "object", "properties": { "id": { "description": "Required. The REST ID of the collection. Content API methods that operate on collections take this as their collectionId parameter. The REST ID for a collection is of the form collectionId. [id attribute](https://support.google.com/merchants/answer/9649290)", "type": "string" }, "language": { "description": "The language of a collection and the language of any featured products linked to the collection. [language attribute](https://support.google.com/merchants/answer/9673781)", "type": "string" }, "productCountry": { "description": "[product_country attribute](https://support.google.com/merchants/answer/9674155)", "type": "string" }, "imageLink": { "description": "The URL of a collection’s image. [image_link attribute](https://support.google.com/merchants/answer/9703236)", "type": "array", "items": { "type": "string" } }, "featuredProduct": { "description": "This identifies one or more products associated with the collection. Used as a lookup to the corresponding product ID in your product feeds. Provide a maximum of 100 featuredProduct (for collections). Provide up to 10 featuredProduct (for Shoppable Images only) with ID and X and Y coordinates. [featured_product attribute](https://support.google.com/merchants/answer/9703736)", "type": "array", "items": { "$ref": "CollectionFeaturedProduct" } }, "link": { "description": "A collection’s landing page. URL directly linking to your collection's page on your website. [link attribute](https://support.google.com/merchants/answer/9673983)", "type": "string" }, "mobileLink": { "description": "A collection’s mobile-optimized landing page when you have a different URL for mobile and desktop traffic. [mobile_link attribute](https://support.google.com/merchants/answer/9646123)", "type": "string" }, "headline": { "description": "Your collection's name. [headline attribute](https://support.google.com/merchants/answer/9673580)", "type": "array", "items": { "type": "string" } }, "customLabel0": { "description": "Label that you assign to a collection to help organize bidding and reporting in Shopping campaigns. [Custom label](https://support.google.com/merchants/answer/9674217)", "type": "string" }, "customLabel1": { "description": "Label that you assign to a collection to help organize bidding and reporting in Shopping campaigns.", "type": "string" }, "customLabel2": { "description": "Label that you assign to a collection to help organize bidding and reporting in Shopping campaigns.", "type": "string" }, "customLabel3": { "description": "Label that you assign to a collection to help organize bidding and reporting in Shopping campaigns.", "type": "string" }, "customLabel4": { "description": "Label that you assign to a collection to help organize bidding and reporting in Shopping campaigns.", "type": "string" } } }, "CollectionFeaturedProduct": { "id": "CollectionFeaturedProduct", "description": "The message for FeaturedProduct. [FeaturedProduct](https://support.google.com/merchants/answer/9703736)", "type": "object", "properties": { "offerId": { "description": "The unique identifier for the product item.", "type": "string" }, "x": { "description": "Required. X-coordinate of the product callout on the Shoppable Image.", "type": "number", "format": "float" }, "y": { "description": "Required. Y-coordinate of the product callout on the Shoppable Image.", "type": "number", "format": "float" } } }, "ListCollectionsResponse": { "id": "ListCollectionsResponse", "description": "Response message for the ListCollections method.", "type": "object", "properties": { "resources": { "description": "The collections listed.", "type": "array", "items": { "$ref": "Collection" } }, "nextPageToken": { "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" } } }, "ListMethodQuotasResponse": { "id": "ListMethodQuotasResponse", "description": "Response message for the ListMethodQuotas method.", "type": "object", "properties": { "methodQuotas": { "description": "The current quota usage and limits per each method.", "type": "array", "items": { "$ref": "MethodQuota" } }, "nextPageToken": { "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" } } }, "MethodQuota": { "id": "MethodQuota", "description": "The quota information per method in the Content API.", "type": "object", "properties": { "method": { "description": "Output only. The method name, for example `products.list`. Method name does not contain version because quota can be shared between different API versions of the same method.", "readOnly": true, "type": "string" }, "quotaUsage": { "description": "Output only. The current quota usage, meaning the number of calls already made to the method per day. Usage is reset every day at 12 PM midday UTC.", "readOnly": true, "type": "string", "format": "int64" }, "quotaLimit": { "description": "Output only. The maximum number of calls allowed per day for the method.", "readOnly": true, "type": "string", "format": "int64" }, "quotaMinuteLimit": { "description": "Output only. The maximum number of calls allowed per minute for the method.", "readOnly": true, "type": "string", "format": "int64" } } }, "CollectionStatus": { "id": "CollectionStatus", "description": "The collectionstatus message.", "type": "object", "properties": { "id": { "description": "Required. The ID of the collection for which status is reported.", "type": "string" }, "destinationStatuses": { "description": "The intended destinations for the collection.", "type": "array", "items": { "$ref": "CollectionStatusDestinationStatus" } }, "creationDate": { "description": "Date on which the collection has been created in [ISO 8601](http://en.wikipedia.org/wiki/ISO_8601) format: Date, time, and offset, for example \"2020-01-02T09:00:00+01:00\" or \"2020-01-02T09:00:00Z\"", "type": "string" }, "lastUpdateDate": { "description": "Date on which the collection has been last updated in [ISO 8601](http://en.wikipedia.org/wiki/ISO_8601) format: Date, time, and offset, for example \"2020-01-02T09:00:00+01:00\" or \"2020-01-02T09:00:00Z\"", "type": "string" }, "collectionLevelIssuses": { "description": "A list of all issues associated with the collection.", "type": "array", "items": { "$ref": "CollectionStatusItemLevelIssue" } } } }, "CollectionStatusDestinationStatus": { "id": "CollectionStatusDestinationStatus", "description": "Destination status message.", "type": "object", "properties": { "destination": { "description": "The name of the destination", "type": "string" }, "status": { "description": "The status for the specified destination in the collections target country.", "type": "string" }, "approvedCountries": { "description": "Country codes (ISO 3166-1 alpha-2) where the collection is approved.", "type": "array", "items": { "type": "string" } }, "pendingCountries": { "description": "Country codes (ISO 3166-1 alpha-2) where the collection is pending approval.", "type": "array", "items": { "type": "string" } }, "disapprovedCountries": { "description": "Country codes (ISO 3166-1 alpha-2) where the collection is disapproved.", "type": "array", "items": { "type": "string" } } } }, "CollectionStatusItemLevelIssue": { "id": "CollectionStatusItemLevelIssue", "description": "Issue associated with the collection.", "type": "object", "properties": { "code": { "description": "The error code of the issue.", "type": "string" }, "servability": { "description": "How this issue affects the serving of the collection.", "type": "string" }, "resolution": { "description": "Whether the issue can be resolved by the merchant.", "type": "string" }, "attributeName": { "description": "The attribute's name, if the issue is caused by a single attribute.", "type": "string" }, "destination": { "description": "The destination the issue applies to.", "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" }, "applicableCountries": { "description": "Country codes (ISO 3166-1 alpha-2) where issue applies to the offer.", "type": "array", "items": { "type": "string" } } } }, "ListCollectionStatusesResponse": { "id": "ListCollectionStatusesResponse", "description": "Response message for the ListCollectionStatuses method.", "type": "object", "properties": { "resources": { "description": "The collectionstatuses listed.", "type": "array", "items": { "$ref": "CollectionStatus" } }, "nextPageToken": { "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" } } }, "ConversionSource": { "id": "ConversionSource", "description": "Represents a conversion source owned by a Merchant account. A merchant account can have up to 200 conversion sources.", "type": "object", "properties": { "conversionSourceId": { "description": "Output only. Generated by the Content API upon creation of a new `ConversionSource`. Format: [a-z]{4}:.+ The four characters before the colon represent the type of conversio source. Content after the colon represents the ID of the conversion source within that type. The ID of two different conversion sources might be the same across different types. The following type prefixes are supported: - galk: For GoogleAnalyticsLink sources. - mcdn: For MerchantCenterDestination sources.", "readOnly": true, "type": "string" }, "googleAnalyticsLink": { "description": "Immutable. Conversion Source of type \"Link to Google Analytics Property\".", "$ref": "GoogleAnalyticsLink" }, "merchantCenterDestination": { "description": "Conversion Source of type \"Merchant Center Tag Destination\".", "$ref": "MerchantCenterDestination" }, "state": { "description": "Output only. Current state of this conversion source. Can't be edited through the API.", "readOnly": true, "type": "string", "enumDescriptions": [ "", "Conversion source is fully functional.", "Conversion source has been archived in the last 30 days and not currently functional. Can be restored using the undelete method.", "Conversion source creation has started but not fully finished yet." ], "enum": [ "STATE_UNSPECIFIED", "ACTIVE", "ARCHIVED", "PENDING" ] }, "expireTime": { "description": "Output only. The time when an archived conversion source becomes permanently deleted and is no longer available to undelete.", "readOnly": true, "type": "string", "format": "google-datetime" } } }, "GoogleAnalyticsLink": { "id": "GoogleAnalyticsLink", "description": "\"Google Analytics Link\" sources can be used to get conversion data from an existing Google Analytics property into the linked Merchant Center account.", "type": "object", "properties": { "propertyId": { "description": "Required. Immutable. ID of the Google Analytics property the merchant is linked to.", "type": "string", "format": "int64" }, "attributionSettings": { "description": "Output only. Attribution settings for the linked Google Analytics property.", "readOnly": true, "$ref": "AttributionSettings" }, "propertyName": { "description": "Output only. Name of the Google Analytics property the merchant is linked to.", "readOnly": true, "type": "string" } } }, "AttributionSettings": { "id": "AttributionSettings", "description": "Represents attribution settings for conversion sources receiving pre-attribution data.", "type": "object", "properties": { "attributionLookbackWindowInDays": { "description": "Required. Lookback windows (in days) used for attribution in this source. Supported values are 7, 30, 40.", "type": "integer", "format": "int32" }, "attributionModel": { "description": "Required. Attribution model.", "type": "string", "enumDescriptions": [ "", "Cross-channel Last Click model.", "Ads-preferred Last Click model.", "Cross-channel Data Driven model.", "Cross-channel First Click model.", "Cross-channel Linear model.", "Cross-channel Position Based model.", "Cross-channel Time Decay model." ], "enum": [ "ATTRIBUTION_MODEL_UNSPECIFIED", "CROSS_CHANNEL_LAST_CLICK", "ADS_PREFERRED_LAST_CLICK", "CROSS_CHANNEL_DATA_DRIVEN", "CROSS_CHANNEL_FIRST_CLICK", "CROSS_CHANNEL_LINEAR", "CROSS_CHANNEL_POSITION_BASED", "CROSS_CHANNEL_TIME_DECAY" ] }, "conversionType": { "description": "Immutable. Unordered list. List of different conversion types a conversion event can be classified as. A standard \"purchase\" type will be automatically created if this list is empty at creation time.", "type": "array", "items": { "$ref": "AttributionSettingsConversionType" } } } }, "AttributionSettingsConversionType": { "id": "AttributionSettingsConversionType", "description": "Message representing a types of conversion events", "type": "object", "properties": { "name": { "description": "Output only. Conversion event name, as it'll be reported by the client.", "readOnly": true, "type": "string" }, "includeInReporting": { "description": "Output only. Option indicating if the type should be included in Merchant Center reporting.", "readOnly": true, "type": "boolean" } } }, "MerchantCenterDestination": { "id": "MerchantCenterDestination", "description": "\"Merchant Center Destination\" sources can be used to send conversion events from a website using a Google tag directly to a Merchant Center account where the source is created.", "type": "object", "properties": { "destinationId": { "description": "Output only. Merchant Center Destination ID.", "readOnly": true, "type": "string" }, "attributionSettings": { "description": "Required. Attribution settings being used for the Merchant Center Destination.", "$ref": "AttributionSettings" }, "displayName": { "description": "Required. Merchant-specified display name for the destination. This is the name that identifies the conversion source within the Merchant Center UI. Limited to 64 characters.", "type": "string" }, "currencyCode": { "description": "Required. Three-letter currency code (ISO 4217). The currency code defines in which currency the conversions sent to this destination will be reported in Merchant Center.", "type": "string" } } }, "UndeleteConversionSourceRequest": { "id": "UndeleteConversionSourceRequest", "description": "Request message for the UndeleteConversionSource method.", "type": "object", "properties": {} }, "ListConversionSourcesResponse": { "id": "ListConversionSourcesResponse", "description": "Response message for the ListConversionSources method.", "type": "object", "properties": { "conversionSources": { "description": "List of conversion sources.", "type": "array", "items": { "$ref": "ConversionSource" } }, "nextPageToken": { "description": "Token to be used to fetch the next results page.", "type": "string" } } }, "CaptureOrderRequest": { "id": "CaptureOrderRequest", "description": "Request message for the CaptureOrder method.", "type": "object", "properties": {} }, "CaptureOrderResponse": { "id": "CaptureOrderResponse", "description": "Response message for the CaptureOrder method.", "type": "object", "properties": { "executionStatus": { "description": "The status of the execution. Only defined if the request was successful. Acceptable values are: * \"duplicate\" * \"executed\"", "type": "string", "enumDescriptions": [ "Default value. This value is unused.", "The request was completed successfully.", "The request was not performed because it already executed once successfully." ], "enum": [ "EXECUTION_STATUS_UNSPECIFIED", "EXECUTED", "DUPLICATE" ] } } }, "BuyOnGoogleProgramStatus": { "id": "BuyOnGoogleProgramStatus", "description": "Response message for the GetProgramStatus method.", "type": "object", "properties": { "customerServiceVerifiedEmail": { "description": "Output only. The customer service verified email.", "readOnly": true, "type": "string" }, "customerServicePendingEmail": { "description": "The customer service pending email. After verification this field becomes empty.", "type": "string" }, "customerServicePendingPhoneRegionCode": { "description": "Two letter country code for the pending phone number, for example `CA` for Canadian numbers. See the [ISO 3166-1 alpha-2](https://wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements) officially assigned codes. In order to update this field the customer_service_pending_phone_number must also be set. After verification this field becomes empty.", "type": "string" }, "customerServicePendingPhoneNumber": { "description": "The pending phone number specified for BuyOnGoogle program. It might be different than account level phone number. In order to update this field the customer_service_pending_phone_region_code must also be set. After verification this field becomes empty.", "type": "string" }, "customerServiceVerifiedPhoneRegionCode": { "description": "Output only. Two letter country code for the verified phone number, for example `CA` for Canadian numbers. See the [ISO 3166-1 alpha-2](https://wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements) officially assigned codes.", "readOnly": true, "type": "string" }, "customerServiceVerifiedPhoneNumber": { "description": "Output only. The verified phone number specified for BuyOnGoogle program. It might be different than account level phone number.", "readOnly": true, "type": "string" }, "participationStage": { "description": "Output only. The current participation stage for the program.", "readOnly": true, "type": "string", "enumDescriptions": [ "Default value when participation stage is not set.", "Merchant is not eligible for onboarding to a given program in a specific region code.", "Merchant is eligible for onboarding to a given program in a specific region code.", "Merchant is onboarding to a given program in a specific region code.", "Merchant fulfilled all the requirements and is ready to request review in a specific region code.", "Merchant is waiting for the review to be completed in a specific region code.", "The review for a merchant has been rejected in a specific region code.", "Merchant's program participation is active for a specific region code.", "Participation has been paused.", "The program cannot be further reactivated or paused. See more about [Buy on Google](https://support.google.com/merchants/answer/7679273)." ], "enum": [ "PROGRAM_PARTICIPATION_STAGE_UNSPECIFIED", "NOT_ELIGIBLE", "ELIGIBLE", "ONBOARDING", "ELIGIBLE_FOR_REVIEW", "PENDING_REVIEW", "REVIEW_DISAPPROVED", "ACTIVE", "PAUSED", "DEPRECATED" ] }, "onlineSalesChannel": { "description": "The channels through which the merchant is selling.", "type": "string", "enumDescriptions": [ "Default value when online sales channel is not set.", "Merchant is selling exclusively on Google.", "Merchant is selling on Google and other websites." ], "enum": [ "ONLINE_SALES_CHANNEL_UNSPECIFIED", "GOOGLE_EXCLUSIVE", "GOOGLE_AND_OTHER_WEBSITES" ] }, "businessModel": { "description": "The business models in which merchant participates.", "type": "array", "items": { "type": "string", "enumDescriptions": [ "Default value when business model is not set.", "Merchant is a manufacturer.", "Merchant is an importer.", "Merchant is a reseller.", "Merchant has a different business model." ], "enum": [ "BUSINESS_MODEL_UNSPECIFIED", "MANUFACTURER", "IMPORTER", "RESELLER", "OTHER" ] } } } }, "OnboardBuyOnGoogleProgramRequest": { "id": "OnboardBuyOnGoogleProgramRequest", "description": "Request message for the OnboardProgram method.", "type": "object", "properties": { "customerServiceEmail": { "description": "The customer service email.", "type": "string" } } }, "RequestReviewBuyOnGoogleProgramRequest": { "id": "RequestReviewBuyOnGoogleProgramRequest", "description": "Request message for the RequestReviewProgram method.", "type": "object", "properties": {} }, "ActivateBuyOnGoogleProgramRequest": { "id": "ActivateBuyOnGoogleProgramRequest", "description": "Request message for the ActivateProgram method.", "type": "object", "properties": {} }, "PauseBuyOnGoogleProgramRequest": { "id": "PauseBuyOnGoogleProgramRequest", "description": "Request message for the PauseProgram method.", "type": "object", "properties": {} }, "FreeListingsProgramStatus": { "id": "FreeListingsProgramStatus", "description": "Response message for GetFreeListingsProgramStatus.", "type": "object", "properties": { "globalState": { "description": "State of the program. `ENABLED` if there are offers for at least one region.", "type": "string", "enumDescriptions": [ "State is unknown.", "Program is not enabled for any country.", "No products have been uploaded for any region. Upload products to Merchant Center.", "Program is enabled and offers are uploaded for at least one country." ], "enum": [ "PROGRAM_STATE_UNSPECIFIED", "NOT_ENABLED", "NO_OFFERS_UPLOADED", "ENABLED" ] }, "regionStatuses": { "description": "Status of the program in each region. Regions with the same status and review eligibility are grouped together in `regionCodes`.", "type": "array", "items": { "$ref": "FreeListingsProgramStatusRegionStatus" } } } }, "FreeListingsProgramStatusRegionStatus": { "id": "FreeListingsProgramStatusRegionStatus", "description": "Status of program and region.", "type": "object", "properties": { "regionCodes": { "description": "The two-letter [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) codes for all the regions with the same `eligibilityStatus` and `reviewEligibility`.", "type": "array", "items": { "type": "string" } }, "eligibilityStatus": { "description": "Eligibility status of the standard free listing program.", "type": "string", "enumDescriptions": [ "State is not known.", "If the account has no issues and review is completed successfully.", "There are one or more issues that needs to be resolved for account to be active for the program. Detailed list of account issues are available in [accountstatuses](https://developers.google.com/shopping-content/reference/rest/v2.1/accountstatuses) API.", "If account has issues but offers are servable. Some of the issue can make account DISAPPROVED after a certain deadline.", "Account is under review.", "Account is waiting for review to start.", "Program is currently onboarding. Upload valid offers to complete onboarding." ], "enum": [ "STATE_UNSPECIFIED", "APPROVED", "DISAPPROVED", "WARNING", "UNDER_REVIEW", "PENDING_REVIEW", "ONBOARDING" ] }, "disapprovalDate": { "description": "Date by which eligibilityStatus will go from `WARNING` to `DISAPPROVED`. Only visible when your eligibilityStatus is WARNING. In [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format: `YYYY-MM-DD`.", "type": "string" }, "reviewEligibilityStatus": { "description": "If a program is eligible for review in a specific region. Only visible if `eligibilityStatus` is `DISAPPROVED`.", "type": "string", "enumDescriptions": [ "Review eligibility state is unknown.", "Account is eligible for review for a specified region code.", "Account is not eligible for review for a specified region code." ], "enum": [ "REVIEW_ELIGIBILITY_UNSPECIFIED", "ELIGIBLE", "INELIGIBLE" ] }, "reviewIneligibilityReason": { "description": "Review ineligibility reason if account is not eligible for review.", "type": "string", "enumDescriptions": [ "Requesting a review from Google is not possible.", "All onboarding issues needs to be fixed.", "Not enough offers uploaded for this country.", "Cooldown period applies. Wait until cooldown period ends.", "Account is already under review.", "No issues available to review.", "Account will be automatically reviewed at the end of the grace period.", "Account is retired. Should not appear in MC.", "Account was already reviewd." ], "enum": [ "REVIEW_INELIGIBILITY_REASON_UNSPECIFIED", "ONBOARDING_ISSUES", "NOT_ENOUGH_OFFERS", "IN_COOLDOWN_PERIOD", "ALREADY_UNDER_REVIEW", "NO_REVIEW_REQUIRED", "WILL_BE_REVIEWED_AUTOMATICALLY", "IS_RETIRED", "ALREADY_REVIEWED" ] }, "reviewIneligibilityReasonDescription": { "description": "Reason a program in a specific region isn’t eligible for review. Only visible if `reviewEligibilityStatus` is `INELIGIBLE`.", "type": "string" }, "reviewIssues": { "description": "Issues evaluated in the review process. Fix all issues before requesting a review.", "type": "array", "items": { "type": "string" } }, "onboardingIssues": { "description": "Issues that must be fixed to be eligible for review.", "type": "array", "items": { "type": "string" } }, "reviewIneligibilityReasonDetails": { "description": "Additional information for ineligibility. If `reviewIneligibilityReason` is `IN_COOLDOWN_PERIOD`, a timestamp for the end of the cooldown period is provided.", "$ref": "FreeListingsProgramStatusReviewIneligibilityReasonDetails" } } }, "FreeListingsProgramStatusReviewIneligibilityReasonDetails": { "id": "FreeListingsProgramStatusReviewIneligibilityReasonDetails", "description": "Additional details for review ineligibility reasons.", "type": "object", "properties": { "cooldownTime": { "description": "This timestamp represents end of cooldown period for review ineligbility reason `IN_COOLDOWN_PERIOD`.", "type": "string", "format": "google-datetime" } } }, "CheckoutSettings": { "id": "CheckoutSettings", "description": "`CheckoutSettings` for a specific merchant ID.", "type": "object", "properties": { "merchantId": { "description": "Required. The ID of the account.", "type": "string", "format": "int64" }, "uriSettings": { "description": "URL settings for cart or checkout URL.", "$ref": "UrlSettings" }, "enrollmentState": { "description": "Output only. Reflects the merchant enrollment state in `Checkout` feature.", "readOnly": true, "type": "string", "enumDescriptions": [ "Default enrollment state when enrollment state is not specified.", "Merchant has not enrolled into the feature.", "Merchant has enrolled into the feature by providing either an account level URL or checkout URLs as part of their feed.", "Merchant has previously enrolled but opted out of the feature." ], "enum": [ "CHECKOUT_ON_MERCHANT_ENROLLMENT_STATE_UNSPECIFIED", "INACTIVE", "ENROLLED", "OPT_OUT" ] }, "reviewState": { "description": "Output only. Reflects the merchant review state in `Checkout` feature. This is set based on the data quality reviews of the URL provided by the merchant. A merchant with enrollment state as `ENROLLED` can be in the following review states: `IN_REVIEW`, `APPROVED` or `DISAPPROVED`. A merchant must be in an enrollment_state of `ENROLLED` before a review can begin for the merchant.", "readOnly": true, "type": "string", "enumDescriptions": [ "Default review state when review state is not specified.", "Merchant provided URLs are being reviewed for data quality issues.", "Merchant account has been approved. Indicates the data quality checks have passed.", "Merchant account has been disapproved due to data quality issues." ], "enum": [ "CHECKOUT_ON_MERCHANT_REVIEW_STATE_UNSPECIFIED", "IN_REVIEW", "APPROVED", "DISAPPROVED" ] }, "effectiveUriSettings": { "description": "The effective value of `url_settings` for a given merchant ID. If account level settings are present then this value will be a copy of the account level settings. Otherwise, it will have the value of the parent account.", "$ref": "UrlSettings" }, "effectiveEnrollmentState": { "description": "Output only. The effective value of enrollment state for a given merchant ID. If account level settings are present then this value will be a copy of the account level settings. Otherwise, it will have the value of the parent account.", "readOnly": true, "type": "string", "enumDescriptions": [ "Default enrollment state when enrollment state is not specified.", "Merchant has not enrolled into the feature.", "Merchant has enrolled into the feature by providing either an account level URL or checkout URLs as part of their feed.", "Merchant has previously enrolled but opted out of the feature." ], "enum": [ "CHECKOUT_ON_MERCHANT_ENROLLMENT_STATE_UNSPECIFIED", "INACTIVE", "ENROLLED", "OPT_OUT" ] }, "effectiveReviewState": { "description": "Output only. The effective value of review state for a given merchant ID. If account level settings are present then this value will be a copy of the account level settings. Otherwise, it will have the value of the parent account.", "readOnly": true, "type": "string", "enumDescriptions": [ "Default review state when review state is not specified.", "Merchant provided URLs are being reviewed for data quality issues.", "Merchant account has been approved. Indicates the data quality checks have passed.", "Merchant account has been disapproved due to data quality issues." ], "enum": [ "CHECKOUT_ON_MERCHANT_REVIEW_STATE_UNSPECIFIED", "IN_REVIEW", "APPROVED", "DISAPPROVED" ] } } }, "UrlSettings": { "id": "UrlSettings", "description": "Specifications related to the `Checkout` URL. The `UriTemplate` is of the form `https://www.mystore.com/checkout?item_id={id}` where `{id}` will be automatically replaced with data from the merchant account with this attribute [offer_id](https://developers.google.com/shopping-content/reference/rest/v2.1/products#Product.FIELDS.offer_id)", "type": "object", "properties": { "checkoutUriTemplate": { "description": "URL template when the placeholders are expanded will redirect the buyer to the merchant checkout page with the item in the cart.", "type": "string" }, "cartUriTemplate": { "description": "URL template when the placeholders are expanded will redirect the buyer to the cart page on the merchant website with the selected item in cart.", "type": "string" } } }, "InsertCheckoutSettingsRequest": { "id": "InsertCheckoutSettingsRequest", "description": "Request message for the `InsertCheckoutSettings` method.", "type": "object", "properties": { "uriSettings": { "description": "Required. The `UrlSettings` for the request. The presence of URL settings indicates `Checkout` enrollment.", "$ref": "UrlSettings" } } }, "RequestReviewFreeListingsRequest": { "id": "RequestReviewFreeListingsRequest", "description": "Request message for the RequestReviewFreeListings Program method.", "type": "object", "properties": { "regionCode": { "description": "The code [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) of the country for which review is to be requested.", "type": "string" } } }, "ShoppingAdsProgramStatus": { "id": "ShoppingAdsProgramStatus", "description": "Response message for GetShoppingAdsProgramStatus.", "type": "object", "properties": { "globalState": { "description": "State of the program. `ENABLED` if there are offers for at least one region.", "type": "string", "enumDescriptions": [ "State is unknown.", "Program is not enabled for any country.", "No products have been uploaded for any region. Upload products to Merchant Center.", "Program is enabled and offers are uploaded for at least one country." ], "enum": [ "PROGRAM_STATE_UNSPECIFIED", "NOT_ENABLED", "NO_OFFERS_UPLOADED", "ENABLED" ] }, "regionStatuses": { "description": "Status of the program in each region. Regions with the same status and review eligibility are grouped together in `regionCodes`.", "type": "array", "items": { "$ref": "ShoppingAdsProgramStatusRegionStatus" } } } }, "ShoppingAdsProgramStatusRegionStatus": { "id": "ShoppingAdsProgramStatusRegionStatus", "description": "Status of program and region.", "type": "object", "properties": { "regionCodes": { "description": "The two-letter [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) codes for all the regions with the same `eligibilityStatus` and `reviewEligibility`.", "type": "array", "items": { "type": "string" } }, "eligibilityStatus": { "description": "Eligibility status of the Shopping Ads program.", "type": "string", "enumDescriptions": [ "State is not known.", "If the account has no issues and review is completed successfully.", "There are one or more issues that needs to be resolved for account to be active for the program. Detailed list of account issues are available in [accountstatuses](https://developers.google.com/shopping-content/reference/rest/v2.1/accountstatuses) API.", "If account has issues but offers are servable. Some of the issue can make account DISAPPROVED after a certain deadline.", "Account is under review.", "Account is waiting for review to start.", "Program is currently onboarding. Upload valid offers to complete onboarding." ], "enum": [ "STATE_UNSPECIFIED", "APPROVED", "DISAPPROVED", "WARNING", "UNDER_REVIEW", "PENDING_REVIEW", "ONBOARDING" ] }, "disapprovalDate": { "description": "Date by which eligibilityStatus will go from `WARNING` to `DISAPPROVED`. Only visible when your eligibilityStatus is WARNING. In [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format: `YYYY-MM-DD`.", "type": "string" }, "reviewEligibilityStatus": { "description": "If a program is eligible for review in a specific region. Only visible if `eligibilityStatus` is `DISAPPROVED`.", "type": "string", "enumDescriptions": [ "Review eligibility state is unknown.", "Account is eligible for review for a specified region code.", "Account is not eligible for review for a specified region code." ], "enum": [ "REVIEW_ELIGIBILITY_UNSPECIFIED", "ELIGIBLE", "INELIGIBLE" ] }, "reviewIneligibilityReason": { "description": "Review ineligibility reason if account is not eligible for review.", "type": "string", "enumDescriptions": [ "Requesting a review from Google is not possible.", "All onboarding issues needs to be fixed.", "Not enough offers uploaded for this country.", "Cooldown period applies. Wait until cooldown period ends.", "Account is already under review.", "No issues available to review.", "Account will be automatically reviewed at the end of the grace period.", "Account is retired. Should not appear in MC.", "Account was already reviewd." ], "enum": [ "REVIEW_INELIGIBILITY_REASON_UNSPECIFIED", "ONBOARDING_ISSUES", "NOT_ENOUGH_OFFERS", "IN_COOLDOWN_PERIOD", "ALREADY_UNDER_REVIEW", "NO_REVIEW_REQUIRED", "WILL_BE_REVIEWED_AUTOMATICALLY", "IS_RETIRED", "ALREADY_REVIEWED" ] }, "reviewIneligibilityReasonDescription": { "description": "Reason a program in a specific region isn’t eligible for review. Only visible if `reviewEligibilityStatus` is `INELIGIBLE`.", "type": "string" }, "reviewIssues": { "description": "Issues evaluated in the review process. Fix all issues before requesting a review.", "type": "array", "items": { "type": "string" } }, "onboardingIssues": { "description": "Issues that must be fixed to be eligible for review.", "type": "array", "items": { "type": "string" } }, "reviewIneligibilityReasonDetails": { "description": "Additional information for ineligibility. If `reviewIneligibilityReason` is `IN_COOLDOWN_PERIOD`, a timestamp for the end of the cooldown period is provided.", "$ref": "ShoppingAdsProgramStatusReviewIneligibilityReasonDetails" } } }, "ShoppingAdsProgramStatusReviewIneligibilityReasonDetails": { "id": "ShoppingAdsProgramStatusReviewIneligibilityReasonDetails", "description": "Additional details for review ineligibility reasons.", "type": "object", "properties": { "cooldownTime": { "description": "This timestamp represents end of cooldown period for review ineligbility reason `IN_COOLDOWN_PERIOD`.", "type": "string", "format": "google-datetime" } } }, "RequestReviewShoppingAdsRequest": { "id": "RequestReviewShoppingAdsRequest", "description": "Request message for the RequestReviewShoppingAds program method.", "type": "object", "properties": { "regionCode": { "description": "The code [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) of the country for which review is to be requested.", "type": "string" } } }, "ListCssesResponse": { "id": "ListCssesResponse", "description": "The response message for the `ListCsses` method", "type": "object", "properties": { "csses": { "description": "The CSS domains affiliated with the specified CSS group.", "type": "array", "items": { "$ref": "Css" } }, "nextPageToken": { "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" } } }, "Css": { "id": "Css", "description": "Information about CSS domain.", "type": "object", "properties": { "cssDomainId": { "description": "Output only. Immutable. The CSS domain ID.", "readOnly": true, "type": "string", "format": "int64" }, "fullName": { "description": "Output only. Immutable. The CSS domain's full name.", "readOnly": true, "type": "string" }, "displayName": { "description": "Output only. Immutable. The CSS domain's display name, used when space is constrained.", "readOnly": true, "type": "string" }, "homepageUri": { "description": "Output only. Immutable. The CSS domain's homepage.", "readOnly": true, "type": "string" }, "cssGroupId": { "description": "Output only. Immutable. The ID of the CSS group this CSS domain is affiliated with. Only populated for CSS group users.", "readOnly": true, "type": "string", "format": "int64" }, "labelIds": { "description": "A list of label IDs that are assigned to this CSS domain by its CSS group. Only populated for CSS group users.", "type": "array", "items": { "type": "string", "format": "int64" } } } }, "LabelIds": { "id": "LabelIds", "description": "The IDs of labels that should be assigned to the CSS domain.", "type": "object", "properties": { "labelIds": { "description": "The list of label IDs.", "type": "array", "items": { "type": "string", "format": "int64" } } } }, "AccountReturnCarrier": { "id": "AccountReturnCarrier", "description": " The return carrier information. This service is designed for merchants enrolled in the Buy on Google program. ", "type": "object", "properties": { "carrierAccountId": { "description": "Output only. Immutable. The Google-provided unique carrier ID, used to update the resource.", "readOnly": true, "type": "string", "format": "int64" }, "carrierAccountNumber": { "description": "Number of the carrier account.", "type": "string" }, "carrierAccountName": { "description": "Name of the carrier account.", "type": "string" }, "carrierCode": { "description": "The carrier code enum. Accepts the values FEDEX or UPS.", "type": "string", "enumDescriptions": [ "Carrier not specified", "FedEx carrier", "UPS carrier" ], "enum": [ "CARRIER_CODE_UNSPECIFIED", "FEDEX", "UPS" ] } } }, "ListAccountReturnCarrierResponse": { "id": "ListAccountReturnCarrierResponse", "description": "Response for listing account return carriers.", "type": "object", "properties": { "accountReturnCarriers": { "description": "List of all available account return carriers for the merchant.", "type": "array", "items": { "$ref": "AccountReturnCarrier" } } } }, "SearchRequest": { "id": "SearchRequest", "description": "Request message for the ReportService.Search method.", "type": "object", "properties": { "query": { "description": "Required. Query that defines performance metrics to retrieve and dimensions according to which the metrics are to be segmented. For details on how to construct your query, see the [Query Language guide](https://developers.google.com/shopping-content/guides/reports/query-language/overview).", "type": "string" }, "pageSize": { "description": "Number of ReportRows to retrieve in a single page. Defaults to 1000. Values above 5000 are coerced to 5000.", "type": "integer", "format": "int32" }, "pageToken": { "description": "Token of the page to retrieve. If not specified, the first page of results is returned. In order to request the next page of results, the value obtained from `next_page_token` in the previous response should be used.", "type": "string" } } }, "SearchResponse": { "id": "SearchResponse", "description": "Response message for the ReportService.Search method.", "type": "object", "properties": { "results": { "description": "Rows that matched the search query.", "type": "array", "items": { "$ref": "ReportRow" } }, "nextPageToken": { "description": "Token which can be sent as `page_token` to retrieve the next page. If omitted, there are no subsequent pages.", "type": "string" } } }, "ReportRow": { "id": "ReportRow", "description": "Result row returned from the search query.", "type": "object", "properties": { "segments": { "description": "Segmentation dimensions requested by the merchant in the query. Dimension values are only set for dimensions requested explicitly in the query.", "$ref": "Segments" }, "metrics": { "description": "Metrics requested by the merchant in the query. Metric values are only set for metrics requested explicitly in the query.", "$ref": "Metrics" }, "productView": { "description": "Product fields requested by the merchant in the query. Field values are only set if the merchant queries `ProductView`.", "$ref": "ProductView" }, "productCluster": { "description": "Product cluster fields requested by the merchant in the query. Field values are only set if the merchant queries `BestSellersProductClusterView`.", "$ref": "ProductCluster" }, "brand": { "description": "Brand fields requested by the merchant in the query. Field values are only set if the merchant queries `BestSellersBrandView`.", "$ref": "Brand" }, "bestSellers": { "description": "Best sellers fields requested by the merchant in the query. Field values are only set if the merchant queries `BestSellersProductClusterView` or `BestSellersBrandView`.", "$ref": "BestSellers" }, "priceCompetitiveness": { "description": "Price competitiveness fields requested by the merchant in the query. Field values are only set if the merchant queries `PriceCompetitivenessProductView`.", "$ref": "PriceCompetitiveness" }, "priceInsights": { "description": "Price insights fields requested by the merchant in the query. Field values are only set if the merchant queries `PriceInsightsProductView`.", "$ref": "PriceInsights" }, "competitiveVisibility": { "description": "Competitive visibility fields requested by the merchant in the query. Field values are only set if the merchant queries `CompetitiveVisibilityTopMerchantView`, `CompetitiveVisibilityBenchmarkView` or `CompetitiveVisibilityCompetitorView`.", "$ref": "CompetitiveVisibility" }, "topicTrends": { "description": "[Topic trends](https://support.google.com/merchants/answer/13542370) fields requested by the merchant in the query. Field values are only set if the merchant queries `TopicTrendsView`.", "$ref": "TopicTrends" } } }, "Segments": { "id": "Segments", "description": "Dimensions according to which metrics are segmented in the response. Values of product dimensions, such as `offer_id`, reflect the state of a product at the time of the corresponding event, for example, impression or order. Segment fields cannot be selected in queries without also selecting at least one metric field. Values are only set for dimensions requested explicitly in the request's search query.", "type": "object", "properties": { "program": { "description": "Program to which metrics apply, for example, Free Product Listing.", "type": "string", "enumDescriptions": [ "Not specified.", "Shopping Ads.", "Free Product Listing.", "Free Local Product Listing.", "Buy on Google Listing." ], "enum": [ "PROGRAM_UNSPECIFIED", "SHOPPING_ADS", "FREE_PRODUCT_LISTING", "FREE_LOCAL_PRODUCT_LISTING", "BUY_ON_GOOGLE_LISTING" ] }, "date": { "description": "Date in the merchant timezone to which metrics apply.", "$ref": "Date" }, "week": { "description": "First day of the week (Monday) of the metrics date in the merchant timezone.", "$ref": "Date" }, "customerCountryCode": { "description": "Code of the country where the customer is located at the time of the event. Represented in the ISO 3166 format. If the customer country cannot be determined, a special 'ZZ' code is returned.", "type": "string" }, "currencyCode": { "description": "Currency in which price metrics are represented, for example, if you select `ordered_item_sales_micros`, the returned value will be represented by this currency.", "type": "string" }, "offerId": { "description": "Merchant-provided id of the product.", "type": "string" }, "title": { "description": "Title of the product.", "type": "string" }, "brand": { "description": "Brand of the product.", "type": "string" }, "categoryL1": { "description": "[Product category (1st level)](https://developers.google.com/shopping-content/guides/reports/segmentation#category_and_product_type) in Google's product taxonomy.", "type": "string" }, "categoryL2": { "description": "[Product category (2nd level)](https://developers.google.com/shopping-content/guides/reports/segmentation#category_and_product_type) in Google's product taxonomy.", "type": "string" }, "categoryL3": { "description": "[Product category (3rd level)](https://developers.google.com/shopping-content/guides/reports/segmentation#category_and_product_type) in Google's product taxonomy.", "type": "string" }, "categoryL4": { "description": "[Product category (4th level)](https://developers.google.com/shopping-content/guides/reports/segmentation#category_and_product_type) in Google's product taxonomy.", "type": "string" }, "categoryL5": { "description": "[Product category (5th level)](https://developers.google.com/shopping-content/guides/reports/segmentation#category_and_product_type) in Google's product taxonomy.", "type": "string" }, "productTypeL1": { "description": "[Product type (1st level)](https://developers.google.com/shopping-content/guides/reports/segmentation#category_and_product_type) in merchant's own product taxonomy.", "type": "string" }, "productTypeL2": { "description": "[Product type (2nd level)](https://developers.google.com/shopping-content/guides/reports/segmentation#category_and_product_type) in merchant's own product taxonomy.", "type": "string" }, "productTypeL3": { "description": "[Product type (3rd level)](https://developers.google.com/shopping-content/guides/reports/segmentation#category_and_product_type) in merchant's own product taxonomy.", "type": "string" }, "productTypeL4": { "description": "[Product type (4th level)](https://developers.google.com/shopping-content/guides/reports/segmentation#category_and_product_type) in merchant's own product taxonomy.", "type": "string" }, "productTypeL5": { "description": "[Product type (5th level)](https://developers.google.com/shopping-content/guides/reports/segmentation#category_and_product_type) in merchant's own product taxonomy.", "type": "string" }, "customLabel0": { "description": "Custom label 0 for custom grouping of products.", "type": "string" }, "customLabel1": { "description": "Custom label 1 for custom grouping of products.", "type": "string" }, "customLabel2": { "description": "Custom label 2 for custom grouping of products.", "type": "string" }, "customLabel3": { "description": "Custom label 3 for custom grouping of products.", "type": "string" }, "customLabel4": { "description": "Custom label 4 for custom grouping of products.", "type": "string" } } }, "Date": { "id": "Date", "description": "Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp", "type": "object", "properties": { "year": { "description": "Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.", "type": "integer", "format": "int32" }, "month": { "description": "Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.", "type": "integer", "format": "int32" }, "day": { "description": "Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.", "type": "integer", "format": "int32" } } }, "Metrics": { "id": "Metrics", "description": "Performance metrics. Values are only set for metrics requested explicitly in the request's search query.", "type": "object", "properties": { "clicks": { "description": "Number of clicks.", "type": "string", "format": "int64" }, "impressions": { "description": "Number of times merchant's products are shown.", "type": "string", "format": "int64" }, "ctr": { "description": "Click-through rate - the number of clicks merchant's products receive (clicks) divided by the number of times the products are shown (impressions).", "type": "number", "format": "double" }, "conversions": { "description": "Number of conversions attributed to the product, reported on the conversion date. Depending on the attribution model, a conversion might be distributed across multiple clicks, where each click gets its own credit assigned. This metric is a sum of all such credits. The metric is currently available only for the FREE_PRODUCT_LISTING program.", "type": "number", "format": "double" }, "conversionValueMicros": { "description": "Value of conversions in micros (1 millionth of a standard unit, 1 USD = 1000000 micros) attributed to the product, reported on the conversion date. The metric is currently available only for the FREE_PRODUCT_LISTING program. The currency of the returned value is stored in the currency_code segment. If this metric is selected, 'segments.currency_code' is automatically added to the SELECT clause in the search query (unless it is explicitly selected by the user) and the currency_code segment is populated in the response.", "type": "string", "format": "int64" }, "conversionRate": { "description": "Number of conversions divided by the number of clicks, reported on the impression date. The metric is currently available only for the FREE_PRODUCT_LISTING program.", "type": "number", "format": "double" }, "orders": { "description": "Number of placed orders. Excludes customer cancellations that happened within 30 minutes of placing the order. **This metric cannot be segmented by product dimensions and customer_country_code.**", "type": "string", "format": "int64" }, "shippedOrders": { "description": "Number of fully shipped orders, reported on the last shipment date. **This metric cannot be segmented by product dimensions and customer_country_code.**", "type": "string", "format": "int64" }, "unshippedOrders": { "description": "Number of orders not shipped or partially shipped up until the end of the queried day. If a multi-day period is specified in the search query, the returned value is the average number of unshipped orders over the days in the queried period. **This metric cannot be segmented by product dimensions and customer_country_code.**", "type": "number", "format": "double" }, "daysToShip": { "description": "Average number of days between an order being placed and the order being fully shipped, reported on the last shipment date. **This metric cannot be segmented by product dimensions and customer_country_code.**", "type": "number", "format": "double" }, "aos": { "description": "Average order size - the average number of items in an order. **This metric cannot be segmented by product dimensions and customer_country_code.**", "type": "number", "format": "double" }, "aovMicros": { "description": "Average order value in micros (1 millionth of a standard unit, 1 USD = 1000000 micros) - the average value (total price of items) of all placed orders. The currency of the returned value is stored in the currency_code segment. If this metric is selected, 'segments.currency_code' is automatically added to the SELECT clause in the search query (unless it is explicitly selected by the user) and the currency_code segment is populated in the response. **This metric cannot be segmented by product dimensions and customer_country_code.**", "type": "number", "format": "double" }, "orderedItems": { "description": "Number of ordered items. Excludes customer cancellations that happened within 30 minutes of placing the order. **This metric cannot be segmented by customer_country_code.**", "type": "string", "format": "int64" }, "orderedItemSalesMicros": { "description": "Total price of ordered items in micros (1 millionth of a standard unit, 1 USD = 1000000 micros). Excludes shipping, taxes (US only), and customer cancellations that happened within 30 minutes of placing the order. The currency of the returned value is stored in the currency_code segment. If this metric is selected, 'segments.currency_code' is automatically added to the SELECT clause in the search query (unless it is explicitly selected by the user) and the currency_code segment is populated in the response. **This metric cannot be segmented by customer_country_code.**", "type": "string", "format": "int64" }, "shippedItems": { "description": "Number of shipped items, reported on the shipment date. **This metric cannot be segmented by customer_country_code.**", "type": "string", "format": "int64" }, "unshippedItems": { "description": "Number of ordered items not shipped up until the end of the queried day. If a multi-day period is specified in the search query, the returned value is the average number of unshipped items over the days in the queried period. **This metric cannot be segmented by customer_country_code.**", "type": "number", "format": "double" }, "shippedItemSalesMicros": { "description": "Total price of shipped items in micros (1 millionth of a standard unit, 1 USD = 1000000 micros), reported on the order date. Excludes shipping and taxes (US only). The currency of the returned value is stored in the currency_code segment. If this metric is selected, 'segments.currency_code' is automatically added to the SELECT clause in the search query (unless it is explicitly selected by the user) and the currency_code segment is populated in the response. **This metric cannot be segmented by customer_country_code.**", "type": "string", "format": "int64" }, "rejectedItems": { "description": "Number of ordered items canceled by the merchant, reported on the order date. **This metric cannot be segmented by customer_country_code.**", "type": "string", "format": "int64" }, "itemDaysToShip": { "description": "Average number of days between an item being ordered and the item being **This metric cannot be segmented by customer_country_code.**", "type": "number", "format": "double" }, "itemFillRate": { "description": "Percentage of shipped items in relation to all finalized items (shipped or rejected by the merchant; unshipped items are not taken into account), reported on the order date. Item fill rate is lowered by merchant rejections. **This metric cannot be segmented by customer_country_code.**", "type": "number", "format": "double" }, "returnedItems": { "description": "Number of ordered items sent back for return, reported on the date when the merchant accepted the return. **This metric cannot be segmented by customer_country_code.**", "type": "string", "format": "int64" }, "returnsMicros": { "description": "Total price of ordered items sent back for return in micros (1 millionth of a standard unit, 1 USD = 1000000 micros), reported on the date when the merchant accepted the return. The currency of the returned value is stored in the currency_code segment. If this metric is selected, 'segments.currency_code' is automatically added to the SELECT clause in the search query (unless it is explicitly selected by the user) and the currency_code segment is populated in the response. **This metric cannot be segmented by customer_country_code.**", "type": "string", "format": "int64" }, "returnRate": { "description": "Total price of returned items divided by the total price of shipped items, reported on the order date. If this metric is selected, 'segments.currency_code' is automatically added to the SELECT clause in the search query (unless it is explicitly selected by the user) and the currency_code segment is populated in the response. **This metric cannot be segmented by customer_country_code.**", "type": "number", "format": "double" } } }, "ProductView": { "id": "ProductView", "description": "Product fields. Values are only set for fields requested explicitly in the request's search query.", "type": "object", "properties": { "id": { "description": "The REST ID of the product, in the form of channel:contentLanguage:targetCountry:offerId. Content API methods that operate on products take this as their productId parameter. Should always be included in the SELECT clause.", "type": "string" }, "offerId": { "description": "Merchant-provided id of the product.", "type": "string" }, "title": { "description": "Title of the product.", "type": "string" }, "brand": { "description": "Brand of the product.", "type": "string" }, "categoryL1": { "description": "First level of the product category in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436).", "type": "string" }, "categoryL2": { "description": "Second level of the product category in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436).", "type": "string" }, "categoryL3": { "description": "Third level of the product category in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436).", "type": "string" }, "categoryL4": { "description": "Fourth level of the product category in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436).", "type": "string" }, "categoryL5": { "description": "Fifth level of the product category in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436).", "type": "string" }, "productTypeL1": { "description": "First level of the product type in merchant's own [product taxonomy](https://support.google.com/merchants/answer/6324436).", "type": "string" }, "productTypeL2": { "description": "Second level of the product type in merchant's own [product taxonomy](https://support.google.com/merchants/answer/6324436).", "type": "string" }, "productTypeL3": { "description": "Third level of the product type in merchant's own [product taxonomy](https://support.google.com/merchants/answer/6324436).", "type": "string" }, "productTypeL4": { "description": "Fourth level of the product type in merchant's own [product taxonomy](https://support.google.com/merchants/answer/6324436).", "type": "string" }, "productTypeL5": { "description": "Fifth level of the product type in merchant's own [product taxonomy](https://support.google.com/merchants/answer/6324436).", "type": "string" }, "currencyCode": { "description": "Product price currency code (for example, ISO 4217). Absent if product price is not available.", "type": "string" }, "priceMicros": { "description": "Product price specified as micros (1 millionth of a standard unit, 1 USD = 1000000 micros) in the product currency. Absent in case the information about the price of the product is not available.", "type": "string", "format": "int64" }, "languageCode": { "description": "Language code of the product in BCP 47 format.", "type": "string" }, "condition": { "description": "Condition of the product.", "type": "string" }, "channel": { "description": "Channel of the product (online versus local).", "type": "string", "enumDescriptions": [ "Indicates that the channel is unspecified.", "Indicates that the channel is local.", "Indicates that the channel is online." ], "enum": [ "CHANNEL_UNSPECIFIED", "LOCAL", "ONLINE" ] }, "availability": { "description": "Availability of the product.", "type": "string" }, "shippingLabel": { "description": "The normalized shipping label specified in the feed", "type": "string" }, "gtin": { "description": "GTIN of the product.", "type": "array", "items": { "type": "string" } }, "itemGroupId": { "description": "Item group ID provided by the merchant for grouping variants together.", "type": "string" }, "creationTime": { "description": "The time the merchant created the product in timestamp seconds.", "type": "string", "format": "google-datetime" }, "expirationDate": { "description": "Expiration date for the product. Specified on insertion.", "$ref": "Date" }, "aggregatedDestinationStatus": { "description": "Aggregated destination status.", "type": "string", "enumDescriptions": [ "Undefined aggregated status.", "Offer isn't eligible, or is disapproved for all destinations.", "Offer's status is pending in all destinations.", "Offer is eligible for some (but not all) destinations.", "Offer is eligible for all destinations." ], "enum": [ "AGGREGATED_STATUS_UNSPECIFIED", "NOT_ELIGIBLE_OR_DISAPPROVED", "PENDING", "ELIGIBLE_LIMITED", "ELIGIBLE" ] }, "itemIssues": { "description": "List of item issues for the product.", "type": "array", "items": { "$ref": "ProductViewItemIssue" } }, "clickPotential": { "description": "Estimated performance potential compared to highest performing products of the merchant.", "type": "string", "enumDescriptions": [ "Unknown predicted clicks impact.", "Potential to receive a low number of clicks compared to the highest performing products of the merchant.", "Potential to receive a moderate number of clicks compared to the highest performing products of the merchant.", "Potential to receive a similar number of clicks as the highest performing products of the merchant." ], "enum": [ "CLICK_POTENTIAL_UNSPECIFIED", "LOW", "MEDIUM", "HIGH" ] }, "clickPotentialRank": { "description": "Rank of the product based on its click potential. A product with `click_potential_rank` 1 has the highest click potential among the merchant's products that fulfill the search query conditions.", "type": "string", "format": "int64" } } }, "ProductViewItemIssue": { "id": "ProductViewItemIssue", "description": "Item issue associated with the product.", "type": "object", "properties": { "issueType": { "description": "Item issue type.", "$ref": "ProductViewItemIssueItemIssueType" }, "severity": { "description": "Item issue severity.", "$ref": "ProductViewItemIssueItemIssueSeverity" }, "resolution": { "description": "Item issue resolution.", "type": "string", "enumDescriptions": [ "Unknown resolution type.", "The merchant has to fix the issue.", "The issue will be resolved automatically (for example, image crawl), or Google review. No merchant action is required now. Resolution might lead to another issue (for example, if crawl fails)." ], "enum": [ "UNKNOWN", "MERCHANT_ACTION", "PENDING_PROCESSING" ] } } }, "ProductViewItemIssueItemIssueType": { "id": "ProductViewItemIssueItemIssueType", "description": "Type of the item issue.", "type": "object", "properties": { "canonicalAttribute": { "description": "Canonical attribute name for attribute-specific issues.", "type": "string" }, "code": { "description": "Error code of the issue.", "type": "string" } } }, "ProductViewItemIssueItemIssueSeverity": { "id": "ProductViewItemIssueItemIssueSeverity", "description": "Severity of an issue per destination in a region, and aggregated severity.", "type": "object", "properties": { "severityPerDestination": { "description": "Item issue severity for every destination.", "type": "array", "items": { "$ref": "ProductViewItemIssueIssueSeverityPerDestination" } }, "aggregatedSeverity": { "description": "Severity of an issue aggregated for destination.", "type": "string", "enumDescriptions": [ "Undefined Issue severity.", "Issue disapproves the product in at least one of the selected destinations.", "Issue demotes the product in all selected destinations it affects.", "Issue resolution is `PENDING_PROCESSING`." ], "enum": [ "AGGREGATED_ISSUE_SEVERITY_UNSPECIFIED", "DISAPPROVED", "DEMOTED", "PENDING" ] } } }, "ProductViewItemIssueIssueSeverityPerDestination": { "id": "ProductViewItemIssueIssueSeverityPerDestination", "description": "Issue severity for all affected regions in a destination.", "type": "object", "properties": { "destination": { "description": "Issue destination.", "type": "string" }, "disapprovedCountries": { "description": "List of disapproved countries in the destination.", "type": "array", "items": { "type": "string" } }, "demotedCountries": { "description": "List of demoted countries in the destination.", "type": "array", "items": { "type": "string" } } } }, "ProductCluster": { "id": "ProductCluster", "description": "Product cluster fields. A product cluster is a grouping for different offers that represent the same product. Values are only set for fields requested explicitly in the request's search query.", "type": "object", "properties": { "title": { "description": "Title of the product cluster.", "type": "string" }, "brand": { "description": "Brand of the product cluster.", "type": "string" }, "categoryL1": { "description": "Product category (1st level) of the product cluster, represented in Google's product taxonomy.", "type": "string" }, "categoryL2": { "description": "Product category (2nd level) of the product cluster, represented in Google's product taxonomy.", "type": "string" }, "categoryL3": { "description": "Product category (3rd level) of the product cluster, represented in Google's product taxonomy.", "type": "string" }, "categoryL4": { "description": "Product category (4th level) of the product cluster, represented in Google's product taxonomy.", "type": "string" }, "categoryL5": { "description": "Product category (5th level) of the product cluster, represented in Google's product taxonomy.", "type": "string" }, "variantGtins": { "description": "GTINs of example variants of the product cluster.", "type": "array", "items": { "type": "string" } }, "inventoryStatus": { "description": "Tells whether the product cluster is `IN_STOCK` in your product feed across multiple countries, `OUT_OF_STOCK` in your product feed, or `NOT_IN_INVENTORY` at all. The field doesn't take the Best Sellers report country filter into account.", "type": "string", "enumDescriptions": [ "Inventory status is unknown.", "Merchant has a product for this product cluster or brand in stock.", "Merchant has a product for this product cluster or brand in inventory but it is currently out of stock.", "Merchant does not have a product for this product cluster or brand in inventory." ], "enum": [ "INVENTORY_STATUS_UNSPECIFIED", "IN_STOCK", "OUT_OF_STOCK", "NOT_IN_INVENTORY" ] }, "brandInventoryStatus": { "description": "Tells if there is at least one product of the brand currently `IN_STOCK` in your product feed across multiple countries, all products are `OUT_OF_STOCK` in your product feed, or `NOT_IN_INVENTORY`. The field doesn't take the Best Sellers report country filter into account.", "type": "string", "enumDescriptions": [ "Inventory status is unknown.", "Merchant has a product for this product cluster or brand in stock.", "Merchant has a product for this product cluster or brand in inventory but it is currently out of stock.", "Merchant does not have a product for this product cluster or brand in inventory." ], "enum": [ "INVENTORY_STATUS_UNSPECIFIED", "IN_STOCK", "OUT_OF_STOCK", "NOT_IN_INVENTORY" ] } } }, "Brand": { "id": "Brand", "description": "Brand fields. Values are only set for fields requested explicitly in the request's search query.", "type": "object", "properties": { "name": { "description": "Name of the brand.", "type": "string" } } }, "BestSellers": { "id": "BestSellers", "description": "Fields related to the [Best sellers reports](https://support.google.com/merchants/answer/9488679).", "type": "object", "properties": { "reportDate": { "description": "Report date. The value of this field can only be one of the following: * The first day of the week (Monday) for weekly reports. * The first day of the month for monthly reports. If a `WHERE` condition on `best_sellers.report_date` is not specified in the query, the latest available weekly or monthly report is returned.", "$ref": "Date" }, "reportGranularity": { "description": "Granularity of the report. The ranking can be done over a week or a month timeframe. A `WHERE` condition on `best_sellers.report_granularity` is required in the query.", "type": "string", "enumDescriptions": [ "Report granularity is unknown.", "Ranking is done over a week timeframe.", "Ranking is done over a month timeframe." ], "enum": [ "REPORT_GRANULARITY_UNSPECIFIED", "WEEKLY", "MONTHLY" ] }, "countryCode": { "description": "Country where the ranking is calculated. A `WHERE` condition on `best_sellers.country_code` is required in the query.", "type": "string" }, "categoryId": { "description": "Google product category ID to calculate the ranking for, represented in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436). If a `WHERE` condition on `best_sellers.category_id` is not specified in the query, rankings for all top-level categories are returned.", "type": "string", "format": "int64" }, "rank": { "description": "Popularity on Shopping ads and free listings, in the selected category and country, based on the estimated number of units sold.", "type": "string", "format": "int64" }, "previousRank": { "description": "Popularity rank in the previous week or month.", "type": "string", "format": "int64" }, "relativeDemand": { "description": "Estimated demand in relation to the item with the highest popularity rank in the same category and country.", "type": "string", "enumDescriptions": [ "Relative demand is unknown.", "Demand is 0-5% of the demand of the highest ranked product clusters or brands.", "Demand is 6-10% of the demand of the highest ranked product clusters or brands.", "Demand is 11-20% of the demand of the highest ranked product clusters or brands.", "Demand is 21-50% of the demand of the highest ranked product clusters or brands.", "Demand is 51-100% of the demand of the highest ranked product clusters or brands." ], "enum": [ "RELATIVE_DEMAND_UNSPECIFIED", "VERY_LOW", "LOW", "MEDIUM", "HIGH", "VERY_HIGH" ] }, "previousRelativeDemand": { "description": "Estimated demand in relation to the item with the highest popularity rank in the same category and country in the previous week or month.", "type": "string", "enumDescriptions": [ "Relative demand is unknown.", "Demand is 0-5% of the demand of the highest ranked product clusters or brands.", "Demand is 6-10% of the demand of the highest ranked product clusters or brands.", "Demand is 11-20% of the demand of the highest ranked product clusters or brands.", "Demand is 21-50% of the demand of the highest ranked product clusters or brands.", "Demand is 51-100% of the demand of the highest ranked product clusters or brands." ], "enum": [ "RELATIVE_DEMAND_UNSPECIFIED", "VERY_LOW", "LOW", "MEDIUM", "HIGH", "VERY_HIGH" ] }, "relativeDemandChange": { "description": "Change in the estimated demand. Whether it rose, sank or remained flat.", "type": "string", "enumDescriptions": [ "Relative demand change is unknown.", "Relative demand is lower than previous time period.", "Relative demand is equal to previous time period.", "Relative demand is higher than the previous time period." ], "enum": [ "RELATIVE_DEMAND_CHANGE_TYPE_UNSPECIFIED", "SINKER", "FLAT", "RISER" ] } } }, "PriceCompetitiveness": { "id": "PriceCompetitiveness", "description": "Price competitiveness fields requested by the merchant in the query. Field values are only set if the merchant queries `PriceCompetitivenessProductView`. https://support.google.com/merchants/answer/9626903", "type": "object", "properties": { "countryCode": { "description": "The country of the price benchmark (ISO 3166 code).", "type": "string" }, "benchmarkPriceMicros": { "description": "The latest available price benchmark in micros (1 millionth of a standard unit, 1 USD = 1000000 micros) for the product's catalog in the benchmark country.", "type": "string", "format": "int64" }, "benchmarkPriceCurrencyCode": { "description": "The price benchmark currency (ISO 4217 code).", "type": "string" } } }, "PriceInsights": { "id": "PriceInsights", "description": "Price insights fields requested by the merchant in the query. Field values are only set if the merchant queries `PriceInsightsProductView`. https://support.google.com/merchants/answer/11916926", "type": "object", "properties": { "suggestedPriceMicros": { "description": "The latest suggested price in micros (1 millionth of a standard unit, 1 USD = 1000000 micros) for the product.", "type": "string", "format": "int64" }, "suggestedPriceCurrencyCode": { "description": "The suggested price currency (ISO 4217 code).", "type": "string" }, "predictedImpressionsChangeFraction": { "description": "The predicted change in impressions as a fraction after introducing the suggested price compared to current active price. For example, 0.05 is a 5% predicted increase in impressions.", "type": "number", "format": "double" }, "predictedClicksChangeFraction": { "description": "The predicted change in clicks as a fraction after introducing the suggested price compared to current active price. For example, 0.05 is a 5% predicted increase in clicks.", "type": "number", "format": "double" }, "predictedConversionsChangeFraction": { "description": "The predicted change in conversions as a fraction after introducing the suggested price compared to current active price. For example, 0.05 is a 5% predicted increase in conversions).", "type": "number", "format": "double" }, "predictedGrossProfitChangeFraction": { "description": "*Deprecated*: This field is no longer supported and will start returning 0. The predicted change in gross profit as a fraction after introducing the suggested price compared to current active price. For example, 0.05 is a 5% predicted increase in gross profit.", "type": "number", "format": "double" }, "predictedMonthlyGrossProfitChangeMicros": { "description": "*Deprecated*: This field is no longer supported and will start returning 0. The predicted change in gross profit in micros (1 millionth of a standard unit, 1 USD = 1000000 micros) after introducing the suggested price for a month compared to current active price.", "type": "string", "format": "int64" }, "predictedMonthlyGrossProfitChangeCurrencyCode": { "description": "*Deprecated*: This field is no longer supported and will start returning USD for all requests. The predicted monthly gross profit change currency (ISO 4217 code).", "type": "string" } } }, "CompetitiveVisibility": { "id": "CompetitiveVisibility", "description": "Fields related to [competitive visibility reports] (https://support.google.com/merchants/answer/11366442).", "type": "object", "properties": { "date": { "description": "Date of this row. Available only in `CompetitiveVisibilityBenchmarkView` and `CompetitiveVisibilityCompetitorView`. Required in the `SELECT` clause for `CompetitiveVisibilityMarketBenchmarkView`.", "$ref": "Date" }, "domain": { "description": "Domain of your competitor or your domain, if 'is_your_domain' is true. Available only in `CompetitiveVisibilityTopMerchantView` and `CompetitiveVisibilityCompetitorView`. Required in the `SELECT` clause for `CompetitiveVisibilityTopMerchantView` and `CompetitiveVisibilityCompetitorView`. Cannot be filtered on in the 'WHERE' clause.", "type": "string" }, "isYourDomain": { "description": "True if this row contains data for your domain. Available only in `CompetitiveVisibilityTopMerchantView` and `CompetitiveVisibilityCompetitorView`. Cannot be filtered on in the 'WHERE' clause.", "type": "boolean" }, "countryCode": { "description": "The country where impression appeared. Required in the `SELECT` clause. A `WHERE` condition on `competitive_visibility.country_code` is required in the query.", "type": "string" }, "categoryId": { "description": "Google product category ID to calculate the report for, represented in [Google's product taxonomy](https://support.google.com/merchants/answer/6324436). Required in the `SELECT` clause. A `WHERE` condition on `competitive_visibility.category_id` is required in the query.", "type": "string", "format": "int64" }, "trafficSource": { "description": "Type of impression listing. Required in the `SELECT` clause. Cannot be filtered on in the 'WHERE' clause.", "type": "string", "enumDescriptions": [ "Traffic source is unknown.", "Organic traffic.", "Traffic from Ads.", "Organic and Ads traffic." ], "enum": [ "UNKNOWN", "ORGANIC", "ADS", "ALL" ] }, "rank": { "description": "Position of the domain in the top merchants ranking for the selected keys (`date`, `category_id`, `country_code`, `listing_type`) based on impressions. 1 is the highest. Available only in `CompetitiveVisibilityTopMerchantView` and `CompetitiveVisibilityCompetitorView`. Cannot be filtered on in the 'WHERE' clause.", "type": "string", "format": "uint64" }, "adsOrganicRatio": { "description": "[Ads / organic ratio] (https://support.google.com/merchants/answer/11366442#zippy=%2Cadsfree-ratio) shows how often a merchant receives impressions from Shopping ads compared to organic traffic. The number is rounded and bucketed. Available only in `CompetitiveVisibilityTopMerchantView` and `CompetitiveVisibilityCompetitorView`. Cannot be filtered on in the 'WHERE' clause.", "type": "number", "format": "double" }, "pageOverlapRate": { "description": "Page overlap rate describes how frequently competing retailers’ offers are shown together with your offers on the same page. Available only in `CompetitiveVisibilityTopMerchantView` and `CompetitiveVisibilityCompetitorView`. Cannot be filtered on in the 'WHERE' clause.", "type": "number", "format": "double" }, "higherPositionRate": { "description": "Higher position rate shows how often a competitor’s offer got placed in a higher position on the page than your offer. Available only in `CompetitiveVisibilityTopMerchantView` and `CompetitiveVisibilityCompetitorView`. Cannot be filtered on in the 'WHERE' clause.", "type": "number", "format": "double" }, "relativeVisibility": { "description": "Relative visibility shows how often your competitors’ offers are shown compared to your offers. In other words, this is the number of displayed impressions of a competitor retailer divided by the number of your displayed impressions during a selected time range for a selected product category and country. Available only in `CompetitiveVisibilityCompetitorView`. Cannot be filtered on in the 'WHERE' clause.", "type": "number", "format": "double" }, "yourDomainVisibilityTrend": { "description": "Change in visibility based on impressions for your domain with respect to the start of the selected time range (or first day with non-zero impressions). Available only in `CompetitiveVisibilityBenchmarkView`. Cannot be filtered on in the 'WHERE' clause.", "type": "number", "format": "double" }, "categoryBenchmarkVisibilityTrend": { "description": "Change in visibility based on impressions with respect to the start of the selected time range (or first day with non-zero impressions) for a combined set of merchants with highest visibility approximating the market. Available only in `CompetitiveVisibilityBenchmarkView`. Cannot be filtered on in the 'WHERE' clause.", "type": "number", "format": "double" } } }, "TopicTrends": { "id": "TopicTrends", "description": "Topic trends fields requested by the merchant in the query. Field values are only set if the merchant queries `TopicTrendsView`. Forecast data can be queried up to 13 weeks by passing a future date in the `date` field. Historical data is measured daily, and forecasted data is projected weekly. All data points are normalized based on the highest data points returned in the response. If you make separate queries with different date ranges, you might see different values for the same date in each response. The recommended way to get a trend score of a topic is `last7_days_search_interest / last{$day}_days_search_interest - 1`. You can view trends for up to eight topics at a time.", "type": "object", "properties": { "customerCountryCode": { "description": "Country trends are calculated for. Must be a two-letter country code (ISO 3166-1-alpha-2 code), for example, `“US”`.", "type": "string" }, "topic": { "description": "Google-provided topic trends are calculated for. Only top eight topics are returned. Topic is what shoppers are searching for on Google, grouped by the same concept.", "type": "string" }, "date": { "description": "Date the trend score was retrieved.", "$ref": "Date" }, "searchInterest": { "description": "Daily search interest, normalized to the time and country to make comparisons easier, with 100 representing peak popularity (from 0 to 100) for the requested time period and location.", "type": "number", "format": "double" }, "last7DaysSearchInterest": { "description": "Search interest in the last 7 days, with the same normalization as search_interest. This field is only present for a past date.", "type": "number", "format": "double" }, "last30DaysSearchInterest": { "description": "Search interest in the last 30 days, with the same normalization as search_interest. This field is only present for a past date.", "type": "number", "format": "double" }, "last90DaysSearchInterest": { "description": "Search interest in the last 90 days, with the same normalization as search_interest. This field is only present for a past date.", "type": "number", "format": "double" }, "last120DaysSearchInterest": { "description": "Search interest in the last 120 days, with the same normalization as search_interest. This field is only present for a past date.", "type": "number", "format": "double" }, "next7DaysSearchInterest": { "description": "Estimated search interest in the next 7 days, with the same normalization as search_interest. This field is only present for a future date.", "type": "number", "format": "double" } } }, "RenderAccountIssuesRequestPayload": { "id": "RenderAccountIssuesRequestPayload", "description": "The payload for configuring how the content should be rendered.", "type": "object", "properties": { "contentOption": { "description": "Optional. How the detailed content should be returned. Default option is to return the content as a pre-rendered HTML text.", "type": "string", "enumDescriptions": [ "Default value. Will never be provided by the API.", "Returns the detail of the issue as a pre-rendered HTML text." ], "enum": [ "CONTENT_OPTION_UNSPECIFIED", "PRE_RENDERED_HTML" ] }, "userInputActionOption": { "description": "Optional. How actions with user input form should be handled. If not provided, actions will be returned as links that points merchant to Merchant Center where they can request the action.", "type": "string", "enumDescriptions": [ "Default value. Will never be provided by the API.", "Actions that require user input are represented only as links that points merchant to Merchant Center where they can request the action. Provides easier to implement alternative to `BUILT_IN_USER_INPUT_ACTIONS`.", "Returns content and input form definition for each complex action. Your application needs to display this content and input form to the merchant before they can request processing of the action. To start the action, your application needs to call the `triggeraction` method." ], "enum": [ "USER_INPUT_ACTION_RENDERING_OPTION_UNSPECIFIED", "REDIRECT_TO_MERCHANT_CENTER", "BUILT_IN_USER_INPUT_ACTIONS" ] } } }, "RenderAccountIssuesResponse": { "id": "RenderAccountIssuesResponse", "description": "Response containing support content and actions for listed account issues.", "type": "object", "properties": { "issues": { "description": "List of account issues for a given account. This list can be shown with compressed, expandable items. In the compressed form, the title and impact should be shown for each issue. Once the issue is expanded, the detailed content and available actions should be rendered.", "type": "array", "items": { "$ref": "AccountIssue" } }, "alternateDisputeResolution": { "description": "The Alternate Dispute Resolution (ADR) contains a link to a page where merchant can bring their appeal to an [external body](https://support.google.com/european-union-digital-services-act-redress-options/answer/13535501). If the ADR is present, it MUST be available to the merchant on the page that shows the list with their account issues.", "$ref": "AlternateDisputeResolution" } } }, "AccountIssue": { "id": "AccountIssue", "description": "An issue affecting specific merchant.", "type": "object", "properties": { "title": { "description": "Title of the issue.", "type": "string" }, "impact": { "description": "Clarifies the severity of the issue. The summarizing message, if present, should be shown right under the title for each issue. It helps merchants to quickly understand the impact of the issue. The detailed breakdown helps the merchant to fully understand the impact of the issue. It can be rendered as dialog that opens when the merchant mouse over the summarized impact statement. Issues with different severity can be styled differently. They may use a different color or icon to signal the difference between `ERROR`, `WARNING` and `INFO`.", "$ref": "AccountIssueImpact" }, "prerenderedContent": { "description": "Details of the issue as a pre-rendered HTML. HTML elements contain CSS classes that can be used to customize the style of the content. Always sanitize the HTML before embedding it directly to your application. The sanitizer needs to allow basic HTML tags, such as: `div`, `span`, `p`, `a`, `ul`, `li`, `table`, `tr`, `td`. For example, you can use [DOMPurify](https://www.npmjs.com/package/dompurify). CSS classes: * `issue-detail` - top level container for the detail of the issue * `callout-banners` - section of the `issue-detail` with callout banners * `callout-banner` - single callout banner, inside `callout-banners` * `callout-banner-info` - callout with important information (default) * `callout-banner-warning` - callout with a warning * `callout-banner-error` - callout informing about an error (most severe) * `issue-content` - section of the `issue-detail`, contains multiple `content-element` * `content-element` - content element such as a list, link or paragraph, inside `issue-content` * `root-causes` - unordered list with items describing root causes of the issue, inside `issue-content` * `root-causes-intro` - intro text before the `root-causes` list, inside `issue-content` * `segment` - section of the text, `span` inside paragraph * `segment-attribute` - section of the text that represents a product attribute, for example 'image\\_link' * `segment-literal` - section of the text that contains a special value, for example '0-1000 kg' * `segment-bold` - section of the text that should be rendered as bold * `segment-italic` - section of the text that should be rendered as italic * `tooltip` - used on paragraphs that should be rendered with a tooltip. A section of the text in such a paragraph will have a class `tooltip-text` and is intended to be shown in a mouse over dialog. If the style is not used, the `tooltip-text` section would be shown on a new line, after the main part of the text. * `tooltip-text` - marks a section of the text within a `tooltip`, that is intended to be shown in a mouse over dialog. * `tooltip-icon` - marks a section of the text within a `tooltip`, that can be replaced with a tooltip icon, for example '?' or 'i'. By default, this section contains a `br` tag, that is separating the main text and the tooltip text when the style is not used. * `tooltip-style-question` - the tooltip shows helpful information, can use the '?' as an icon. * `tooltip-style-info` - the tooltip adds additional information fitting to the context, can use the 'i' as an icon. * `content-moderation` - marks the paragraph that explains how the issue was identified. * `new-element` - Present for new elements added to the pre-rendered content in the future. To make sure that a new content element does not break your style, you can hide everything with this class.", "type": "string" }, "actions": { "description": "A list of actionable steps that can be executed to solve the issue. An example is requesting a re-review or providing arguments when merchant disagrees with the issue. Actions that are supported in (your) third-party application can be rendered as buttons and should be available to merchant when they expand the issue.", "type": "array", "items": { "$ref": "Action" } } } }, "AccountIssueImpact": { "id": "AccountIssueImpact", "description": "Overall impact of the issue.", "type": "object", "properties": { "message": { "description": "Optional. Message summarizing the overall impact of the issue. If present, it should be rendered to the merchant. For example: \"Disapproves 90k offers in 25 countries\"", "type": "string" }, "severity": { "description": "The severity of the issue.", "type": "string", "enumDescriptions": [ "Default value. Will never be provided by the API.", "Causes either an account suspension or an item disapproval. Errors should be resolved as soon as possible to ensure items are eligible to appear in results again.", "Warnings can negatively impact the performance of ads and can lead to item or account suspensions in the future unless the issue is resolved.", "Infos are suggested optimizations to increase data quality. Resolving these issues is recommended, but not required." ], "enum": [ "SEVERITY_UNSPECIFIED", "ERROR", "WARNING", "INFO" ] }, "breakdowns": { "description": "Detailed impact breakdown. Explains the types of restriction the issue has in different shopping destinations and territory. If present, it should be rendered to the merchant. Can be shown as a mouse over dropdown or a dialog. Each breakdown item represents a group of regions with the same impact details.", "type": "array", "items": { "$ref": "Breakdown" } } } }, "Breakdown": { "id": "Breakdown", "description": "A detailed impact breakdown for a group of regions where the impact of the issue on different shopping destinations is the same.", "type": "object", "properties": { "regions": { "description": "Lists of regions. Should be rendered as a title for this group of details. The full list should be shown to merchant. If the list is too long, it is recommended to make it expandable.", "type": "array", "items": { "$ref": "BreakdownRegion" } }, "details": { "description": "Human readable, localized description of issue's effect on different targets. Should be rendered as a list. For example: * \"Products not showing in ads\" * \"Products not showing organically\"", "type": "array", "items": { "type": "string" } } } }, "BreakdownRegion": { "id": "BreakdownRegion", "description": "Region with code and localized name.", "type": "object", "properties": { "code": { "description": "The [CLDR territory code] (http://www.unicode.org/repos/cldr/tags/latest/common/main/en.xml)", "type": "string" }, "name": { "description": "The localized name of the region. For region with code='001' the value is 'All countries' or the equivalent in other languages.", "type": "string" } } }, "Action": { "id": "Action", "description": "An actionable step that can be executed to solve the issue.", "type": "object", "properties": { "builtinSimpleAction": { "description": "Action implemented and performed in (your) third-party application. The application should point the merchant to the place, where they can access the corresponding functionality or provide instructions, if the specific functionality is not available.", "$ref": "BuiltInSimpleAction" }, "externalAction": { "description": "Action that is implemented and performed outside of (your) third-party application. The application needs to redirect the merchant to the external location where they can perform the action.", "$ref": "ExternalAction" }, "builtinUserInputAction": { "description": "Action implemented and performed in (your) third-party application. The application needs to show an additional content and input form to the merchant as specified for given action. They can trigger the action only when they provided all required inputs.", "$ref": "BuiltInUserInputAction" }, "buttonLabel": { "description": "Label of the action button.", "type": "string" }, "isAvailable": { "description": "Controlling whether the button is active or disabled. The value is 'false' when the action was already requested or is not available. If the action is not available then a reason will be present. If (your) third-party application shows a disabled button for action that is not available, then it should also show reasons.", "type": "boolean" }, "reasons": { "description": "List of reasons why the action is not available. The list of reasons is empty if the action is available. If there is only one reason, it can be displayed next to the disabled button. If there are more reasons, all of them should be displayed, for example in a pop-up dialog.", "type": "array", "items": { "$ref": "ActionReason" } } } }, "BuiltInSimpleAction": { "id": "BuiltInSimpleAction", "description": "Action that is implemented and performed in (your) third-party application. Represents various functionality that is expected to be available to merchant and will help them with resolving the issue. The application should point the merchant to the place, where they can access the corresponding functionality. If the functionality is not supported, it is recommended to explain the situation to merchant and provide them with instructions how to solve the issue.", "type": "object", "properties": { "type": { "description": "The type of action that represents a functionality that is expected to be available in third-party application.", "type": "string", "enumDescriptions": [ "Default value. Will never be provided by the API.", "Redirect merchant to the part of your application where they can verify their phone.", "Redirect merchant to the part of your application where they can claim their website.", "Redirect merchant to the part of your application where they can add products.", "Open a form where the merchant can edit their contact information.", "Redirect merchant to the part of your application where they can link ads account.", "Open a form where the merchant can add their business registration number.", "Open a form where the merchant can edit an attribute. The attribute that needs to be updated is specified in attribute_code field of the action.", "Redirect merchant from the product issues to the diagnostic page with their account issues in your application. This action will be returned only for product issues that are caused by an account issue and thus merchant should resolve the problem on the account level.", "Show additional content to the merchant. This action will be used for example to deliver a justification from national authority." ], "enum": [ "BUILT_IN_SIMPLE_ACTION_TYPE_UNSPECIFIED", "VERIFY_PHONE", "CLAIM_WEBSITE", "ADD_PRODUCTS", "ADD_CONTACT_INFO", "LINK_ADS_ACCOUNT", "ADD_BUSINESS_REGISTRATION_NUMBER", "EDIT_ITEM_ATTRIBUTE", "FIX_ACCOUNT_ISSUE", "SHOW_ADDITIONAL_CONTENT" ] }, "attributeCode": { "description": "The attribute that needs to be updated. Present when the type is `EDIT_ITEM_ATTRIBUTE`. This field contains a code for attribute, represented in snake_case. You can find a list of product's attributes, with their codes [here](https://support.google.com/merchants/answer/7052112).", "type": "string" }, "additionalContent": { "description": "Long text from an external source that should be available to the merchant. Present when the type is `SHOW_ADDITIONAL_CONTENT`.", "$ref": "BuiltInSimpleActionAdditionalContent" } } }, "BuiltInSimpleActionAdditionalContent": { "id": "BuiltInSimpleActionAdditionalContent", "description": "Long text from external source.", "type": "object", "properties": { "title": { "description": "Title of the additional content;", "type": "string" }, "paragraphs": { "description": "Long text organized into paragraphs.", "type": "array", "items": { "type": "string" } } } }, "ExternalAction": { "id": "ExternalAction", "description": "Action that is implemented and performed outside of the third-party application. It should redirect the merchant to the provided URL of an external system where they can perform the action. For example to request a review in the Merchant Center.", "type": "object", "properties": { "type": { "description": "The type of external action.", "type": "string", "enumDescriptions": [ "Default value. Will never be provided by the API.", "Redirect to Merchant Center where the merchant can request a review for issue related to their product.", "Redirect to Merchant Center where the merchant can request a review for issue related to their account.", "Redirect to the form in Help Center where the merchant can request a legal appeal for the issue.", "Redirect to Merchant Center where the merchant can perform identity verification." ], "enum": [ "EXTERNAL_ACTION_TYPE_UNSPECIFIED", "REVIEW_PRODUCT_ISSUE_IN_MERCHANT_CENTER", "REVIEW_ACCOUNT_ISSUE_IN_MERCHANT_CENTER", "LEGAL_APPEAL_IN_HELP_CENTER", "VERIFY_IDENTITY_IN_MERCHANT_CENTER" ] }, "uri": { "description": "URL to external system, for example Merchant Center, where the merchant can perform the action.", "type": "string" } } }, "BuiltInUserInputAction": { "id": "BuiltInUserInputAction", "description": "Action that is implemented and performed in (your) third-party application. The application needs to show an additional content and input form to the merchant. They can start the action only when they provided all required inputs. The application will request processing of the action by calling the [triggeraction method](https://developers.google.com/shopping-content/reference/rest/v2.1/merchantsupport/triggeraction).", "type": "object", "properties": { "actionContext": { "description": "Internal details. Not for display but need to be sent back when triggering the action.", "type": "string" }, "flows": { "description": "Actions may provide multiple different flows. Merchant selects one that fits best to their intent. Selecting the flow is the first step in user's interaction with the action. It affects what input fields will be available and required and also how the request will be processed.", "type": "array", "items": { "$ref": "ActionFlow" } } } }, "ActionFlow": { "id": "ActionFlow", "description": "Flow that can be selected for an action. When merchant selects a flow, application should open a dialog with more information and input form.", "type": "object", "properties": { "id": { "description": "Not for display but need to be sent back for the selected action flow.", "type": "string" }, "label": { "description": "Text value describing the intent for the action flow. It can be used as an input label if merchant needs to pick one of multiple flows. For example: \"I disagree with the issue\"", "type": "string" }, "inputs": { "description": "A list of input fields.", "type": "array", "items": { "$ref": "InputField" } }, "dialogTitle": { "description": "Title of the request dialog. For example: \"Before you request a review\"", "type": "string" }, "dialogMessage": { "description": "Message displayed in the request dialog. For example: \"Make sure you've fixed all your country-specific issues. If not, you may have to wait 7 days to request another review\". There may be an more information to be shown in a tooltip.", "$ref": "TextWithTooltip" }, "dialogCallout": { "description": "Important message to be highlighted in the request dialog. For example: \"You can only request a review for disagreeing with this issue once. If it's not approved, you'll need to fix the issue and wait a few days before you can request another review.\"", "$ref": "Callout" }, "dialogButtonLabel": { "description": "Label for the button to trigger the action from the action dialog. For example: \"Request review\"", "type": "string" } } }, "InputField": { "id": "InputField", "description": "Input field that needs to be available to the merchant. If the field is marked as required, then a value needs to be provided for a successful processing of the request.", "type": "object", "properties": { "id": { "description": "Not for display but need to be sent back for the given input field.", "type": "string" }, "label": { "description": "Input field label. There may be more information to be shown in a tooltip.", "$ref": "TextWithTooltip" }, "required": { "description": "Whether the field is required. The action button needs to stay disabled till values for all required fields are provided.", "type": "boolean" }, "textInput": { "description": "Input field to provide text information. Corresponds to the [html input type=text](https://www.w3.org/TR/2012/WD-html-markup-20121025/input.text.html#input.text) or [html textarea](https://www.w3.org/TR/2012/WD-html-markup-20121025/textarea.html#textarea).", "$ref": "InputFieldTextInput" }, "choiceInput": { "description": "Input field to select one of the offered choices. Corresponds to the [html input type=radio](https://www.w3.org/TR/2012/WD-html-markup-20121025/input.radio.html#input.radio).", "$ref": "InputFieldChoiceInput" }, "checkboxInput": { "description": "Input field to provide a boolean value. Corresponds to the [html input type=checkbox](https://www.w3.org/TR/2012/WD-html-markup-20121025/input.checkbox.html#input.checkbox).", "$ref": "InputFieldCheckboxInput" } } }, "TextWithTooltip": { "id": "TextWithTooltip", "description": "Block of text that may contain a tooltip with more information.", "type": "object", "properties": { "simpleValue": { "description": "Value of the message as a simple text.", "type": "string" }, "simpleTooltipValue": { "description": "Value of the tooltip as a simple text.", "type": "string" }, "tooltipIconStyle": { "description": "The suggested type of an icon for tooltip, if a tooltip is present.", "type": "string", "enumDescriptions": [ "Default value. Will never be provided by the API.", "Used when the tooltip adds additional information to the context, the 'i' can be used as an icon.", "Used when the tooltip shows helpful information, the '?' can be used as an icon." ], "enum": [ "TOOLTIP_ICON_STYLE_UNSPECIFIED", "INFO", "QUESTION" ] } } }, "InputFieldTextInput": { "id": "InputFieldTextInput", "description": "Text input allows merchants to provide a text value.", "type": "object", "properties": { "type": { "description": "Type of the text input", "type": "string", "enumDescriptions": [ "Default value. Will never be provided by the API.", "Used when a short text is expected. The field can be rendered as a [text field](https://www.w3.org/TR/2012/WD-html-markup-20121025/input.text.html#input.text).", "Used when a longer text is expected. The field should be rendered as a [textarea](https://www.w3.org/TR/2012/WD-html-markup-20121025/textarea.html#textarea)." ], "enum": [ "TEXT_INPUT_TYPE_UNSPECIFIED", "GENERIC_SHORT_TEXT", "GENERIC_LONG_TEXT" ] }, "additionalInfo": { "description": "Additional info regarding the field to be displayed to merchant. For example, warning to not include personal identifiable information. There may be more information to be shown in a tooltip.", "$ref": "TextWithTooltip" }, "formatInfo": { "description": "Information about the required format. If present, it should be shown close to the input field to help merchants to provide a correct value. For example: \"VAT numbers should be in a format similar to SK9999999999\"", "type": "string" }, "ariaLabel": { "description": "Text to be used as the [aria-label](https://www.w3.org/TR/WCAG20-TECHS/ARIA14.html) for the input.", "type": "string" } } }, "InputFieldChoiceInput": { "id": "InputFieldChoiceInput", "description": "Choice input allows merchants to select one of the offered choices. Some choices may be linked to additional input fields that should be displayed under or next to the choice option. The value for the additional input field needs to be provided only when the specific choice is selected by the merchant. For example, additional input field can be hidden or disabled until the merchant selects the specific choice.", "type": "object", "properties": { "options": { "description": "A list of choices. Only one option can be selected.", "type": "array", "items": { "$ref": "InputFieldChoiceInputChoiceInputOption" } } } }, "InputFieldChoiceInputChoiceInputOption": { "id": "InputFieldChoiceInputChoiceInputOption", "description": "A choice that merchant can select.", "type": "object", "properties": { "id": { "description": "Not for display but need to be sent back for the selected choice option.", "type": "string" }, "label": { "description": "Short description of the choice option. There may be more information to be shown as a tooltip.", "$ref": "TextWithTooltip" }, "additionalInput": { "description": "Input that should be displayed when this option is selected. The additional input will not contain a `ChoiceInput`.", "$ref": "InputField" } } }, "InputFieldCheckboxInput": { "id": "InputFieldCheckboxInput", "description": "Checkbox input allows merchants to provide a boolean value. Corresponds to the [html input type=checkbox](https://www.w3.org/TR/2012/WD-html-markup-20121025/input.checkbox.html#input.checkbox). If merchant checks the box, the input value for the field is `true`, otherwise it is `false`. This type of input is often used as a confirmation that the merchant completed required steps before they are allowed to start the action. In such a case, the input field is marked as required and the button to trigger the action should stay disabled until the merchant checks the box.", "type": "object", "properties": {} }, "Callout": { "id": "Callout", "description": "An important message that should be highlighted. Usually displayed as a banner.", "type": "object", "properties": { "styleHint": { "description": "Can be used to render messages with different severity in different styles. Snippets off all types contain important information that should be displayed to merchants.", "type": "string", "enumDescriptions": [ "Default value. Will never be provided by the API.", "The most important type of information highlighting problems, like an unsuccessful outcome of previously requested actions.", "Information warning about pending problems, risks or deadlines.", "Default severity for important information like pending status of previously requested action or cooldown for re-review." ], "enum": [ "CALLOUT_STYLE_HINT_UNSPECIFIED", "ERROR", "WARNING", "INFO" ] }, "fullMessage": { "description": "A full message that needs to be shown to the merchant.", "$ref": "TextWithTooltip" } } }, "ActionReason": { "id": "ActionReason", "description": "A single reason why the action is not available.", "type": "object", "properties": { "message": { "description": "Messages summarizing the reason, why the action is not available. For example: \"Review requested on Jan 03. Review requests can take a few days to complete.\"", "type": "string" }, "detail": { "description": "Detailed explanation of the reason. Should be displayed as a hint if present.", "type": "string" }, "action": { "description": "Optional. An action that needs to be performed to solve the problem represented by this reason. This action will always be available. Should be rendered as a link or button next to the summarizing message. For example, the review may be available only once merchant configure all required attributes. In such a situation this action can be a link to the form, where they can fill the missing attribute to unblock the main action.", "$ref": "Action" } } }, "AlternateDisputeResolution": { "id": "AlternateDisputeResolution", "description": "The Alternate Dispute Resolution (ADR) that may be available to merchants in some regions. If present, the link should be shown on the same page as the list of issues.", "type": "object", "properties": { "uri": { "description": "The URL pointing to a page, where merchant can request alternative dispute resolution with an [external body](https://support.google.com/european-union-digital-services-act-redress-options/answer/13535501).", "type": "string" }, "label": { "description": "The label for the alternate dispute resolution link.", "type": "string" } } }, "RenderProductIssuesRequestPayload": { "id": "RenderProductIssuesRequestPayload", "description": "The payload for configuring how the content should be rendered.", "type": "object", "properties": { "contentOption": { "description": "Optional. How the detailed content should be returned. Default option is to return the content as a pre-rendered HTML text.", "type": "string", "enumDescriptions": [ "Default value. Will never be provided by the API.", "Returns the detail of the issue as a pre-rendered HTML text." ], "enum": [ "CONTENT_OPTION_UNSPECIFIED", "PRE_RENDERED_HTML" ] }, "userInputActionOption": { "description": "Optional. How actions with user input form should be handled. If not provided, actions will be returned as links that points merchant to Merchant Center where they can request the action.", "type": "string", "enumDescriptions": [ "Default value. Will never be provided by the API.", "Actions that require user input are represented only as links that points merchant to Merchant Center where they can request the action. Provides easier to implement alternative to `BUILT_IN_USER_INPUT_ACTIONS`.", "Returns content and input form definition for each complex action. Your application needs to display this content and input form to the merchant before they can request processing of the action. To start the action, your application needs to call the `triggeraction` method." ], "enum": [ "USER_INPUT_ACTION_RENDERING_OPTION_UNSPECIFIED", "REDIRECT_TO_MERCHANT_CENTER", "BUILT_IN_USER_INPUT_ACTIONS" ] } } }, "RenderProductIssuesResponse": { "id": "RenderProductIssuesResponse", "description": "Response containing support content and actions for listed product issues.", "type": "object", "properties": { "issues": { "description": "List of issues for a given product. This list can be shown with compressed, expandable items. In the compressed form, the title and impact should be shown for each issue. Once the issue is expanded, the detailed content and available actions should be rendered.", "type": "array", "items": { "$ref": "ProductIssue" } }, "alternateDisputeResolution": { "description": "The Alternate Dispute Resolution (ADR) contains a link to a page where merchant can bring their appeal to an [external body](https://support.google.com/european-union-digital-services-act-redress-options/answer/13535501). If present, the link should be shown on the same page as the list of issues.", "$ref": "AlternateDisputeResolution" } } }, "ProductIssue": { "id": "ProductIssue", "description": "An issue affecting specific product.", "type": "object", "properties": { "title": { "description": "Title of the issue.", "type": "string" }, "impact": { "description": "Clarifies the severity of the issue. The summarizing message, if present, should be shown right under the title for each issue. It helps merchants to quickly understand the impact of the issue. The detailed breakdown helps the merchant to fully understand the impact of the issue. It can be rendered as dialog that opens when the merchant mouse over the summarized impact statement. Issues with different severity can be styled differently. They may use a different color or icon to signal the difference between `ERROR`, `WARNING` and `INFO`.", "$ref": "ProductIssueImpact" }, "prerenderedContent": { "description": "Details of the issue as a pre-rendered HTML. HTML elements contain CSS classes that can be used to customize the style of the content. Always sanitize the HTML before embedding it directly to your application. The sanitizer needs to allow basic HTML tags, such as: `div`, `span`, `p`, `a`, `ul`, `li`, `table`, `tr`, `td`. For example, you can use [DOMPurify](https://www.npmjs.com/package/dompurify). CSS classes: * `issue-detail` - top level container for the detail of the issue * `callout-banners` - section of the `issue-detail` with callout banners * `callout-banner` - single callout banner, inside `callout-banners` * `callout-banner-info` - callout with important information (default) * `callout-banner-warning` - callout with a warning * `callout-banner-error` - callout informing about an error (most severe) * `issue-content` - section of the `issue-detail`, contains multiple `content-element` * `content-element` - content element such as a list, link or paragraph, inside `issue-content` * `root-causes` - unordered list with items describing root causes of the issue, inside `issue-content` * `root-causes-intro` - intro text before the `root-causes` list, inside `issue-content` * `segment` - section of the text, `span` inside paragraph * `segment-attribute` - section of the text that represents a product attribute, for example 'image\\_link' * `segment-literal` - section of the text that contains a special value, for example '0-1000 kg' * `segment-bold` - section of the text that should be rendered as bold * `segment-italic` - section of the text that should be rendered as italic * `tooltip` - used on paragraphs that should be rendered with a tooltip. A section of the text in such a paragraph will have a class `tooltip-text` and is intended to be shown in a mouse over dialog. If the style is not used, the `tooltip-text` section would be shown on a new line, after the main part of the text. * `tooltip-text` - marks a section of the text within a `tooltip`, that is intended to be shown in a mouse over dialog. * `tooltip-icon` - marks a section of the text within a `tooltip`, that can be replaced with a tooltip icon, for example '?' or 'i'. By default, this section contains a `br` tag, that is separating the main text and the tooltip text when the style is not used. * `tooltip-style-question` - the tooltip shows helpful information, can use the '?' as an icon. * `tooltip-style-info` - the tooltip adds additional information fitting to the context, can use the 'i' as an icon. * `content-moderation` - marks the paragraph that explains how the issue was identified. * `new-element` - Present for new elements added to the pre-rendered content in the future. To make sure that a new content element does not break your style, you can hide everything with this class.", "type": "string" }, "actions": { "description": "A list of actionable steps that can be executed to solve the issue. An example is requesting a re-review or providing arguments when merchant disagrees with the issue. Actions that are supported in (your) third-party application can be rendered as buttons and should be available to merchant when they expand the issue.", "type": "array", "items": { "$ref": "Action" } } } }, "ProductIssueImpact": { "id": "ProductIssueImpact", "description": "Overall impact of product issue.", "type": "object", "properties": { "message": { "description": "Optional. Message summarizing the overall impact of the issue. If present, it should be rendered to the merchant. For example: \"Limits visibility in France\"", "type": "string" }, "severity": { "description": "The severity of the issue.", "type": "string", "enumDescriptions": [ "Default value. Will never be provided by the API.", "Causes either an account suspension or an item disapproval. Errors should be resolved as soon as possible to ensure items are eligible to appear in results again.", "Warnings can negatively impact the performance of ads and can lead to item or account suspensions in the future unless the issue is resolved.", "Infos are suggested optimizations to increase data quality. Resolving these issues is recommended, but not required." ], "enum": [ "SEVERITY_UNSPECIFIED", "ERROR", "WARNING", "INFO" ] }, "breakdowns": { "description": "Detailed impact breakdown. Explains the types of restriction the issue has in different shopping destinations and territory. If present, it should be rendered to the merchant. Can be shown as a mouse over dropdown or a dialog. Each breakdown item represents a group of regions with the same impact details.", "type": "array", "items": { "$ref": "Breakdown" } } } }, "TriggerActionPayload": { "id": "TriggerActionPayload", "description": "The payload for the triggered action.", "type": "object", "properties": { "actionContext": { "description": "Required. The context from the selected action. The value is obtained from rendered issues and needs to be sent back to identify the action that is being triggered.", "type": "string" }, "actionInput": { "description": "Required. Input provided by the merchant.", "$ref": "ActionInput" } } }, "ActionInput": { "id": "ActionInput", "description": "Input provided by the merchant.", "type": "object", "properties": { "actionFlowId": { "description": "Required. Id of the selected action flow.", "type": "string" }, "inputValues": { "description": "Required. Values for input fields.", "type": "array", "items": { "$ref": "InputValue" } } } }, "InputValue": { "id": "InputValue", "description": "Input provided by the merchant for input field.", "type": "object", "properties": { "inputFieldId": { "description": "Required. Id of the corresponding input field.", "type": "string" }, "textInputValue": { "description": "Value for text input field.", "$ref": "InputValueTextInputValue" }, "choiceInputValue": { "description": "Value for choice input field.", "$ref": "InputValueChoiceInputValue" }, "checkboxInputValue": { "description": "Value for checkbox input field.", "$ref": "InputValueCheckboxInputValue" } } }, "InputValueTextInputValue": { "id": "InputValueTextInputValue", "description": "Value for text input field.", "type": "object", "properties": { "value": { "description": "Required. Text provided by the merchant.", "type": "string" } } }, "InputValueChoiceInputValue": { "id": "InputValueChoiceInputValue", "description": "Value for choice input field.", "type": "object", "properties": { "choiceInputOptionId": { "description": "Required. Id of the option that was selected by the merchant.", "type": "string" } } }, "InputValueCheckboxInputValue": { "id": "InputValueCheckboxInputValue", "description": "Value for checkbox input field.", "type": "object", "properties": { "value": { "description": "Required. True if the merchant checked the box field. False otherwise.", "type": "boolean" } } }, "TriggerActionResponse": { "id": "TriggerActionResponse", "description": "Response informing about the started action.", "type": "object", "properties": { "message": { "description": "The message for merchant.", "type": "string" } } }, "ReturnShippingLabel": { "id": "ReturnShippingLabel", "description": "Return shipping label for a Buy on Google merchant-managed return.", "type": "object", "properties": { "labelUri": { "description": "The URL for the return shipping label in PDF format", "type": "string" }, "carrier": { "description": "Name of the carrier.", "type": "string" }, "trackingId": { "description": "The tracking id of this return label.", "type": "string" } } }, "Region": { "id": "Region", "description": "Represents a geographic region that you can use as a target with both the `RegionalInventory` and `ShippingSettings` services. You can define regions as collections of either postal codes or, in some countries, using predefined geotargets.", "type": "object", "properties": { "regionId": { "description": "Output only. Immutable. The ID uniquely identifying each region.", "readOnly": true, "type": "string" }, "merchantId": { "description": "Output only. Immutable. Merchant that owns the region.", "readOnly": true, "type": "string", "format": "int64" }, "displayName": { "description": "The display name of the region.", "type": "string" }, "postalCodeArea": { "description": "A list of postal codes that defines the region area.", "$ref": "RegionPostalCodeArea" }, "geotargetArea": { "description": "A list of geotargets that defines the region area.", "$ref": "RegionGeoTargetArea" }, "regionalInventoryEligible": { "description": "Output only. Indicates if the region is eligible to use in the Regional Inventory configuration.", "readOnly": true, "type": "boolean" }, "shippingEligible": { "description": "Output only. Indicates if the region is eligible to use in the Shipping Services configuration.", "readOnly": true, "type": "boolean" } } }, "RegionPostalCodeArea": { "id": "RegionPostalCodeArea", "description": "A list of postal codes that defines the region area. Note: All regions defined using postal codes are accessible via the account's `ShippingSettings.postalCodeGroups` resource.", "type": "object", "properties": { "regionCode": { "description": "Required. CLDR territory code or the country the postal code group applies to.", "type": "string" }, "postalCodes": { "description": "Required. A range of postal codes.", "type": "array", "items": { "$ref": "RegionPostalCodeAreaPostalCodeRange" } } } }, "RegionPostalCodeAreaPostalCodeRange": { "id": "RegionPostalCodeAreaPostalCodeRange", "description": "A range of postal codes that defines the region area.", "type": "object", "properties": { "begin": { "description": "Required. 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*\".", "type": "string" }, "end": { "description": "Optional. 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" } } }, "RegionGeoTargetArea": { "id": "RegionGeoTargetArea", "description": "A list of geotargets that defines the region area.", "type": "object", "properties": { "geotargetCriteriaIds": { "description": "Required. A non-empty list of [location IDs](https://developers.google.com/adwords/api/docs/appendix/geotargeting). They must all be of the same location type (e.g., state).", "type": "array", "items": { "type": "string", "format": "int64" } } } }, "ListRegionsResponse": { "id": "ListRegionsResponse", "description": "Response message for the `ListRegions` method.", "type": "object", "properties": { "regions": { "description": "The regions from the specified merchant.", "type": "array", "items": { "$ref": "Region" } }, "nextPageToken": { "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" } } }, "Promotion": { "id": "Promotion", "description": "Represents a promotion. See the following articles for more details. * [Promotions feed specification](https://support.google.com/merchants/answer/2906014) * [Local promotions feed specification](https://support.google.com/merchants/answer/10146130) * [Promotions on Buy on Google product data specification](https://support.google.com/merchants/answer/9173673)", "type": "object", "properties": { "id": { "description": "Output only. The REST promotion ID to uniquely identify the promotion. Content API methods that operate on promotions take this as their `promotionId` parameter. The REST ID for a promotion is of the form channel:contentLanguage:targetCountry:promotionId The `channel` field has a value of `\"online\"`, `\"in_store\"`, or `\"online_in_store\"`.", "readOnly": true, "type": "string" }, "targetCountry": { "description": "Required. The target country used as part of the unique identifier. Can be `AU`, `CA`, `DE`, `FR`, `GB`, `IN`, `US`, `BR`, `ES`, `NL`, `JP`, `IT` or `KR`.", "type": "string" }, "contentLanguage": { "description": "Required. The content language used as part of the unique identifier. `en` content language is available for all target countries. `fr` content language is available for `CA` and `FR` target countries. `de` content language is available for `DE` target country. `nl` content language is available for `NL` target country. `it` content language is available for `IT` target country. `pt` content language is available for `BR` target country. `ja` content language is available for `JP` target country. `ko` content language is available for `KR` target country.", "type": "string" }, "promotionId": { "description": "Required. The user provided promotion ID to uniquely identify the promotion.", "type": "string" }, "productApplicability": { "description": "Required. Applicability of the promotion to either all products or only specific products.", "type": "string", "enumDescriptions": [ "Which products the promotion applies to is unknown.", "Applicable to all products.", "Applicable to only a single product or list of products." ], "enum": [ "PRODUCT_APPLICABILITY_UNSPECIFIED", "ALL_PRODUCTS", "SPECIFIC_PRODUCTS" ] }, "offerType": { "description": "Required. Type of the promotion.", "type": "string", "enumDescriptions": [ "Unknown offer type.", "Offer type without a code.", "Offer type with a code." ], "enum": [ "OFFER_TYPE_UNSPECIFIED", "NO_CODE", "GENERIC_CODE" ] }, "genericRedemptionCode": { "description": "Generic redemption code for the promotion. To be used with the `offerType` field.", "type": "string" }, "longTitle": { "description": "Required. Long title for the promotion.", "type": "string" }, "promotionEffectiveDates": { "description": "String representation of the promotion effective dates. Deprecated. Use `promotion_effective_time_period` instead.", "deprecated": true, "type": "string" }, "promotionDisplayDates": { "description": "String representation of the promotion display dates. Deprecated. Use `promotion_display_time_period` instead.", "deprecated": true, "type": "string" }, "redemptionChannel": { "description": "Required. Redemption channel for the promotion. At least one channel is required.", "type": "array", "items": { "type": "string", "enumDescriptions": [ "Indicates that the channel is unspecified.", "Indicates that the channel is in store.", "Indicates that the channel is online." ], "enum": [ "REDEMPTION_CHANNEL_UNSPECIFIED", "IN_STORE", "ONLINE" ] } }, "couponValueType": { "description": "Required. Coupon value type for the promotion.", "type": "string", "enumDescriptions": [ "Indicates that the coupon value type is unspecified.", "Money off coupon value type.", "Percent off coupon value type.", "Buy M quantity, get N money off coupon value type. `buy_this_quantity` and `get_this_quantity` must be present. `money_off_amount` must also be present.", "Buy M quantity, get N percent off coupon value type. `buy_this_quantity` and `get_this_quantity` must be present. `percent_off_percentage` must also be present.", "Buy M quantity, get money off. `buy_this_quantity` and `money_off_amount` must be present.", "Buy M quantity, get money off. `buy_this_quantity` and `percent_off_percentage` must be present.", "Free gift with description only.", "Free gift with value (description is optional).", "Free gift with item ID (description is optional).", "Standard free shipping coupon value type.", "Overnight free shipping coupon value type.", "Two day free shipping coupon value type." ], "enum": [ "COUPON_VALUE_TYPE_UNSPECIFIED", "MONEY_OFF", "PERCENT_OFF", "BUY_M_GET_N_MONEY_OFF", "BUY_M_GET_N_PERCENT_OFF", "BUY_M_GET_MONEY_OFF", "BUY_M_GET_PERCENT_OFF", "FREE_GIFT", "FREE_GIFT_WITH_VALUE", "FREE_GIFT_WITH_ITEM_ID", "FREE_SHIPPING_STANDARD", "FREE_SHIPPING_OVERNIGHT", "FREE_SHIPPING_TWO_DAY" ] }, "promotionDestinationIds": { "description": "Destination ID for the promotion.", "type": "array", "items": { "type": "string" } }, "itemId": { "description": "Product filter by item ID for the promotion.", "type": "array", "items": { "type": "string" } }, "brand": { "description": "Product filter by brand for the promotion.", "type": "array", "items": { "type": "string" } }, "itemGroupId": { "description": "Product filter by item group ID for the promotion.", "type": "array", "items": { "type": "string" } }, "productType": { "description": "Product filter by product type for the promotion.", "type": "array", "items": { "type": "string" } }, "itemIdExclusion": { "description": "Product filter by item ID exclusion for the promotion.", "type": "array", "items": { "type": "string" } }, "brandExclusion": { "description": "Product filter by brand exclusion for the promotion.", "type": "array", "items": { "type": "string" } }, "itemGroupIdExclusion": { "description": "Product filter by item group ID exclusion for the promotion.", "type": "array", "items": { "type": "string" } }, "productTypeExclusion": { "description": "Product filter by product type exclusion for the promotion.", "type": "array", "items": { "type": "string" } }, "minimumPurchaseAmount": { "description": "Minimum purchase amount for the promotion.", "$ref": "PriceAmount" }, "minimumPurchaseQuantity": { "description": "Minimum purchase quantity for the promotion.", "type": "integer", "format": "int32" }, "limitQuantity": { "description": "Maximum purchase quantity for the promotion.", "type": "integer", "format": "int32" }, "limitValue": { "description": "Maximum purchase value for the promotion.", "$ref": "PriceAmount" }, "percentOff": { "description": "The percentage discount offered in the promotion.", "type": "integer", "format": "int32" }, "moneyOffAmount": { "description": "The money off amount offered in the promotion.", "$ref": "PriceAmount" }, "getThisQuantityDiscounted": { "description": "The number of items discounted in the promotion.", "type": "integer", "format": "int32" }, "freeGiftValue": { "description": "Free gift value for the promotion.", "$ref": "PriceAmount" }, "freeGiftDescription": { "description": "Free gift description for the promotion.", "type": "string" }, "freeGiftItemId": { "description": "Free gift item ID for the promotion.", "type": "string" }, "shippingServiceNames": { "description": "Shipping service names for the promotion.", "type": "array", "items": { "type": "string" } }, "moneyBudget": { "description": "Cost cap for the promotion.", "$ref": "PriceAmount" }, "orderLimit": { "description": "Order limit for the promotion.", "type": "integer", "format": "int32" }, "promotionEffectiveTimePeriod": { "description": "Required. `TimePeriod` representation of the promotion's effective dates.", "$ref": "TimePeriod" }, "promotionDisplayTimePeriod": { "description": "`TimePeriod` representation of the promotion's display dates.", "$ref": "TimePeriod" }, "storeApplicability": { "description": "Whether the promotion applies to all stores, or only specified stores. Local Inventory ads promotions throw an error if no store applicability is included. An INVALID_ARGUMENT error is thrown if store_applicability is set to ALL_STORES and store_code or score_code_exclusion is set to a value.", "type": "string", "enumDescriptions": [ "Which store codes the promotion applies to is unknown.", "Promotion applies to all stores.", "Promotion applies to only the specified stores." ], "enum": [ "STORE_APPLICABILITY_UNSPECIFIED", "ALL_STORES", "SPECIFIC_STORES" ] }, "storeCode": { "description": "Store codes to include for the promotion.", "type": "array", "items": { "type": "string" } }, "storeCodeExclusion": { "description": "Store codes to exclude for the promotion.", "type": "array", "items": { "type": "string" } }, "promotionUrl": { "description": "URL to the page on the merchant's site where the promotion shows. Local Inventory ads promotions throw an error if no promo url is included. URL is used to confirm that the promotion is valid and can be redeemed.", "type": "string" }, "promotionStatus": { "description": "Output only. The current status of the promotion.", "readOnly": true, "$ref": "PromotionPromotionStatus" } } }, "PriceAmount": { "id": "PriceAmount", "description": "The price represented as a number and currency.", "type": "object", "properties": { "value": { "description": "The price represented as a number.", "type": "string" }, "currency": { "description": "The currency of the price.", "type": "string" } } }, "TimePeriod": { "id": "TimePeriod", "description": "A message that represents a time period.", "type": "object", "properties": { "startTime": { "description": "The starting timestamp.", "type": "string", "format": "google-datetime" }, "endTime": { "description": "The ending timestamp.", "type": "string", "format": "google-datetime" } } }, "PromotionPromotionStatus": { "id": "PromotionPromotionStatus", "description": "The status of the promotion.", "type": "object", "properties": { "destinationStatuses": { "description": "The intended destinations for the promotion.", "type": "array", "items": { "$ref": "PromotionPromotionStatusDestinationStatus" } }, "promotionIssue": { "description": "A list of issues associated with the promotion.", "type": "array", "items": { "$ref": "PromotionPromotionStatusPromotionIssue" } }, "creationDate": { "description": "Date on which the promotion has been created in [ISO 8601](http://en.wikipedia.org/wiki/ISO_8601) format: Date, time, and offset, for example \"2020-01-02T09:00:00+01:00\" or \"2020-01-02T09:00:00Z\"", "type": "string" }, "lastUpdateDate": { "description": "Date on which the promotion status has been last updated in [ISO 8601](http://en.wikipedia.org/wiki/ISO_8601) format: Date, time, and offset, for example \"2020-01-02T09:00:00+01:00\" or \"2020-01-02T09:00:00Z\"", "type": "string" } } }, "PromotionPromotionStatusDestinationStatus": { "id": "PromotionPromotionStatusDestinationStatus", "description": "The destination status of the promotion.", "type": "object", "properties": { "destination": { "description": "The name of the destination.", "type": "string" }, "status": { "description": "The status for the specified destination.", "type": "string", "enumDescriptions": [ "Unknown promotion state.", "The promotion is under review.", "The promotion is disapproved", "The promotion is approved and active.", "The promotion is stopped by merchant.", "The promotion is no longer active.", "The promotion is not stopped, and all reviews are approved, but the active date is in the future." ], "enum": [ "STATE_UNSPECIFIED", "IN_REVIEW", "REJECTED", "LIVE", "STOPPED", "EXPIRED", "PENDING" ] } } }, "PromotionPromotionStatusPromotionIssue": { "id": "PromotionPromotionStatusPromotionIssue", "description": "The issue associated with the promotion.", "type": "object", "properties": { "code": { "description": "Code of the issue.", "type": "string" }, "detail": { "description": "Explanation of the issue.", "type": "string" } } }, "ListPromotionResponse": { "id": "ListPromotionResponse", "description": "Response message for Promotions.List method.", "type": "object", "properties": { "promotions": { "description": "List of all available promotions for the merchant.", "type": "array", "items": { "$ref": "Promotion" } }, "nextPageToken": { "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.", "type": "string" } } }, "GenerateRecommendationsResponse": { "id": "GenerateRecommendationsResponse", "description": "Response containing generated recommendations.", "type": "object", "properties": { "recommendations": { "description": "Recommendations generated for a request.", "type": "array", "items": { "$ref": "Recommendation" } }, "responseToken": { "description": "Output only. Response token is a string created for each `GenerateRecommendationsResponse`. This token doesn't expire, and is globally unique. This token must be used when reporting interactions for recommendations.", "readOnly": true, "type": "string" } } }, "Recommendation": { "id": "Recommendation", "description": "Recommendations are suggested ways to improve your merchant account's performance. For example, to engage with a feature, or start using a new Google product.", "type": "object", "properties": { "type": { "description": "Output only. Type of the recommendation. List of currently available recommendation types: - OPPORTUNITY_CREATE_NEW_COLLECTION - OPPORTUNITY_CREATE_EMAIL_CAMPAIGN", "readOnly": true, "type": "string" }, "subType": { "description": "Optional. Subtype of the recommendations. Only applicable when multiple recommendations can be generated per type, and is used as an identifier of recommendation under the same recommendation type.", "type": "string" }, "recommendationName": { "description": "Optional. Localized recommendation name. The localization uses the {@link `GenerateRecommendationsRequest.language_code`} field in {@link `GenerateRecommendationsRequest`} requests.", "type": "string" }, "title": { "description": "Optional. Localized Recommendation Title. Localization uses the {@link `GenerateRecommendationsRequest.language_code`} field in {@link `GenerateRecommendationsRequest`} requests.", "type": "string" }, "defaultDescription": { "description": "Optional. Localized recommendation description. The localization the {@link `GenerateRecommendationsRequest.language_code`} field in {@link `GenerateRecommendationsRequest`} requests.", "type": "string" }, "additionalDescriptions": { "description": "Output only. List of additional localized descriptions for a recommendation. Localication uses the `languageCode` field in `GenerateRecommendations` requests. Not all description types are guaranteed to be present and we recommend to rely on default description.", "readOnly": true, "type": "array", "items": { "$ref": "RecommendationDescription" } }, "defaultCallToAction": { "description": "Optional. Default CTA of the recommendation.", "$ref": "RecommendationCallToAction" }, "additionalCallToAction": { "description": "Output only. CTAs of this recommendation. Repeated.", "readOnly": true, "type": "array", "items": { "$ref": "RecommendationCallToAction" } }, "paid": { "description": "Optional. Indicates whether a user needs to pay when they complete the user journey suggested by the recommendation.", "type": "boolean" }, "creative": { "description": "Output only. Any creatives attached to the recommendation. Repeated.", "readOnly": true, "type": "array", "items": { "$ref": "RecommendationCreative" } }, "numericalImpact": { "description": "Optional. A numerical score of the impact from the recommendation's description. For example, a recommendation might suggest an upward trend in sales for a certain product. Higher number means larger impact.", "type": "integer", "format": "int32" } } }, "RecommendationDescription": { "id": "RecommendationDescription", "description": "Google-provided description for the recommendation.", "type": "object", "properties": { "text": { "description": "Output only. Text of the description.", "readOnly": true, "type": "string" }, "type": { "description": "Output only. Type of the description.", "readOnly": true, "type": "string", "enumDescriptions": [ "Default value. Will never be provided by the API.", "Short description.", "Long description." ], "enum": [ "DESCRIPTION_TYPE_UNSPECIFIED", "SHORT", "LONG" ] } } }, "RecommendationCallToAction": { "id": "RecommendationCallToAction", "description": "Call to action (CTA) that explains how a merchant can implement this recommendation", "type": "object", "properties": { "localizedText": { "description": "Output only. Localized text of the CTA. Optional.", "readOnly": true, "type": "string" }, "intent": { "description": "Output only. Intent of the action. This value describes the intent (for example, `OPEN_CREATE_EMAIL_CAMPAIGN_FLOW`) and can vary from recommendation to recommendation. This value can change over time for the same recommendation. Currently available intent values: - OPEN_CREATE_EMAIL_CAMPAIGN_FLOW: Opens a user journey where they can create a marketing email campaign. (No default URL) - OPEN_CREATE_COLLECTION_TAB: Opens a user journey where they can [create a collection](https://support.google.com/merchants/answer/9703228) for their Merchant account. (No default URL)", "readOnly": true, "type": "string" }, "uri": { "description": "Optional. URL of the CTA. This field will only be set for some recommendations where there is a suggested landing URL. Otherwise it will be set to an empty string. We recommend developers to use their own custom landing page according to the description of the intent field above when this uri field is empty.", "type": "string" } } }, "RecommendationCreative": { "id": "RecommendationCreative", "description": "Creative is a multimedia attachment to recommendation that can be used on the frontend.", "type": "object", "properties": { "uri": { "description": "URL of the creative.", "type": "string" }, "type": { "description": "Type of the creative.", "type": "string", "enumDescriptions": [ "Default value. If provided, shall be considered invalid.", "Video creatives.", "Photo creatives." ], "enum": [ "CREATIVE_TYPE_UNSPECIFIED", "VIDEO", "PHOTO" ] } } }, "ReportInteractionRequest": { "id": "ReportInteractionRequest", "description": "Request to report interactions on a recommendation.", "type": "object", "properties": { "interactionType": { "description": "Required. Type of the interaction that is reported, for example INTERACTION_CLICK.", "type": "string", "enumDescriptions": [ "Default value. If provided, the service will throw ApiError with description \"Required parameter: interactionType\".", "When a recommendation is dismissed.", "When a recommendation is clicked." ], "enum": [ "INTERACTION_TYPE_UNSPECIFIED", "INTERACTION_DISMISS", "INTERACTION_CLICK" ] }, "responseToken": { "description": "Required. Token of the response when recommendation was returned.", "type": "string" }, "type": { "description": "Required. Type of the recommendations on which this interaction happened. This field must be set only to the value that is returned by {@link `GenerateRecommendationsResponse`} call.", "type": "string" }, "subtype": { "description": "Optional. Subtype of the recommendations this interaction happened on. This field must be set only to the value that is returned by {@link `RecommendationsService.GenerateRecommendations`} call.", "type": "string" } } }, "ReturnPolicyOnline": { "id": "ReturnPolicyOnline", "description": "Return policy online object. This is currently used to represent return policies for ads and free listings programs.", "type": "object", "properties": { "returnPolicyId": { "description": "Output only. Return policy ID generated by Google.", "readOnly": true, "type": "string" }, "label": { "description": "The unique user-defined label of the return policy. The same label cannot be used in different return policies for the same country. Policies with the label 'default' will apply to all products, unless a product specifies a return_policy_label attribute.", "type": "string" }, "countries": { "description": "The countries of sale where the return policy is applicable. The values must be a valid 2 letter ISO 3166 code, e.g. \"US\".", "type": "array", "items": { "type": "string" } }, "name": { "description": "The name of the policy as shown in Merchant Center.", "type": "string" }, "policy": { "description": "The return policy.", "$ref": "ReturnPolicyOnlinePolicy" }, "restockingFee": { "description": "The restocking fee that applies to all return reason categories. This would be treated as a free restocking fee if the value is not set.", "$ref": "ReturnPolicyOnlineRestockingFee" }, "returnMethods": { "description": "The return methods of how customers can return an item. This value is required to not be empty unless the type of return policy is noReturns.", "type": "array", "items": { "type": "string", "enumDescriptions": [ "Default value. This value is unused.", "By mail.", "In store.", "At a kiosk." ], "enum": [ "RETURN_METHOD_UNSPECIFIED", "BY_MAIL", "IN_STORE", "AT_A_KIOSK" ] } }, "itemConditions": { "description": "The item conditions that are accepted for returns. This is required to not be empty unless the type of return policy is noReturns.", "type": "array", "items": { "type": "string", "enumDescriptions": [ "Default value. This value is unused.", "New.", "Used." ], "enum": [ "ITEM_CONDITION_UNSPECIFIED", "NEW", "USED" ] } }, "returnReasonCategoryInfo": { "description": "The return reason category information. This required to not be empty unless the type of return policy is noReturns.", "type": "array", "items": { "$ref": "ReturnPolicyOnlineReturnReasonCategoryInfo" } }, "returnPolicyUri": { "description": "The return policy uri. This can used by Google to do a sanity check for the policy.", "type": "string" } } }, "ReturnPolicyOnlinePolicy": { "id": "ReturnPolicyOnlinePolicy", "description": "The available policies.", "type": "object", "properties": { "type": { "description": "Policy type.", "type": "string", "enumDescriptions": [ "Default value. This value is unused.", "Number of days after a return is delivered.", "No returns.", "Life time returns." ], "enum": [ "TYPE_UNSPECIFIED", "NUMBER_OF_DAYS_AFTER_DELIVERY", "NO_RETURNS", "LIFETIME_RETURNS" ] }, "days": { "description": "The number of days items can be returned after delivery, where one day is defined to be 24 hours after the delivery timestamp. Required for `numberOfDaysAfterDelivery` returns.", "type": "string", "format": "int64" } } }, "ReturnPolicyOnlineRestockingFee": { "id": "ReturnPolicyOnlineRestockingFee", "description": "The restocking fee. This can either be a fixed fee or a micro percent.", "type": "object", "properties": { "fixedFee": { "description": "Fixed restocking fee.", "$ref": "PriceAmount" }, "microPercent": { "description": "Percent of total price in micros. 15,000,000 means 15% of the total price would be charged.", "type": "integer", "format": "int32" } } }, "ReturnPolicyOnlineReturnReasonCategoryInfo": { "id": "ReturnPolicyOnlineReturnReasonCategoryInfo", "description": "The return reason category info wrapper.", "type": "object", "properties": { "returnReasonCategory": { "description": "The return reason category.", "type": "string", "enumDescriptions": [ "Default value. This value is unused.", "Buyer remorse.", "Item defect." ], "enum": [ "RETURN_REASON_CATEGORY_UNSPECIFIED", "BUYER_REMORSE", "ITEM_DEFECT" ] }, "returnLabelSource": { "description": "The corresponding return label source.", "type": "string", "enumDescriptions": [ "Default value. This value is unused.", "Download and print the label.", "Label in the box.", "Customers' responsibility to get the label." ], "enum": [ "RETURN_LABEL_SOURCE_UNSPECIFIED", "DOWNLOAD_AND_PRINT", "IN_THE_BOX", "CUSTOMER_RESPONSIBILITY" ] }, "returnShippingFee": { "description": "The corresponding return shipping fee. This is only applicable when returnLabelSource is not the customer's responsibility.", "$ref": "ReturnPolicyOnlineReturnShippingFee" } } }, "ReturnPolicyOnlineReturnShippingFee": { "id": "ReturnPolicyOnlineReturnShippingFee", "description": "The return shipping fee. This can either be a fixed fee or a boolean to indicate that the customer pays the actual shipping cost.", "type": "object", "properties": { "type": { "description": "Type of return shipping fee.", "type": "string", "enumDescriptions": [ "Default value. This value is unused.", "The return shipping fee is a fixed value.", "Customer will pay the actual return shipping fee." ], "enum": [ "TYPE_UNSPECIFIED", "FIXED", "CUSTOMER_PAYING_ACTUAL_FEE" ] }, "fixedFee": { "description": "Fixed return shipping fee amount. This value is only applicable when type is FIXED. We will treat the return shipping fee as free if type is FIXED and this value is not set.", "$ref": "PriceAmount" } } }, "ListReturnPolicyOnlineResponse": { "id": "ListReturnPolicyOnlineResponse", "description": "Response message for the `ListReturnPolicyOnline` method.", "type": "object", "properties": { "returnPolicies": { "description": "The retrieved return policies.", "type": "array", "items": { "$ref": "ReturnPolicyOnline" } } } }, "OrderTrackingSignal": { "id": "OrderTrackingSignal", "description": "Represents a merchant trade from which signals are extracted, e.g. shipping.", "type": "object", "properties": { "orderTrackingSignalId": { "description": "Output only. The ID that uniquely identifies this order tracking signal.", "readOnly": true, "type": "string", "format": "int64" }, "merchantId": { "description": "The Google merchant ID of this order tracking signal. This value is optional. If left unset, the caller's merchant ID is used. You must request access in order to provide data on behalf of another merchant. For more information, see [Submitting Order Tracking Signals](/shopping-content/guides/order-tracking-signals).", "type": "string", "format": "int64" }, "orderCreatedTime": { "description": "Required. The time when the order was created on the merchant side. Include the year and timezone string, if available.", "$ref": "DateTime" }, "orderId": { "description": "Required. The ID of the order on the merchant side. This field will be hashed in returned OrderTrackingSignal creation response.", "type": "string" }, "shippingInfo": { "description": "The shipping information for the order.", "type": "array", "items": { "$ref": "OrderTrackingSignalShippingInfo" } }, "lineItems": { "description": "Information about line items in the order.", "type": "array", "items": { "$ref": "OrderTrackingSignalLineItemDetails" } }, "shipmentLineItemMapping": { "description": "The mapping of the line items to the shipment information.", "type": "array", "items": { "$ref": "OrderTrackingSignalShipmentLineItemMapping" } }, "customerShippingFee": { "description": "The shipping fee of the order; this value should be set to zero in the case of free shipping.", "$ref": "PriceAmount" }, "deliveryPostalCode": { "description": "Required. The delivery postal code, as a continuous string without spaces or dashes, e.g. \"95016\". This field will be anonymized in returned OrderTrackingSignal creation response.", "type": "string" }, "deliveryRegionCode": { "description": "Required. The [CLDR territory code] (http://www.unicode.org/repos/cldr/tags/latest/common/main/en.xml) for the shipping destination.", "type": "string" } } }, "DateTime": { "id": "DateTime", "description": "Represents civil time (or occasionally physical time). This type can represent a civil time in one of a few possible ways: * When utc_offset is set and time_zone is unset: a civil time on a calendar day with a particular offset from UTC. * When time_zone is set and utc_offset is unset: a civil time on a calendar day in a particular time zone. * When neither time_zone nor utc_offset is set: a civil time on a calendar day in local time. The date is relative to the Proleptic Gregorian Calendar. If year, month, or day are 0, the DateTime is considered not to have a specific year, month, or day respectively. This type may also be used to represent a physical time if all the date and time fields are set and either case of the `time_offset` oneof is set. Consider using `Timestamp` message for physical time instead. If your use case also would like to store the user's timezone, that can be done in another field. This type is more flexible than some applications may want. Make sure to document and validate your application's limitations.", "type": "object", "properties": { "year": { "description": "Optional. Year of date. Must be from 1 to 9999, or 0 if specifying a datetime without a year.", "type": "integer", "format": "int32" }, "month": { "description": "Optional. Month of year. Must be from 1 to 12, or 0 if specifying a datetime without a month.", "type": "integer", "format": "int32" }, "day": { "description": "Optional. Day of month. Must be from 1 to 31 and valid for the year and month, or 0 if specifying a datetime without a day.", "type": "integer", "format": "int32" }, "hours": { "description": "Optional. Hours of day in 24 hour format. Should be from 0 to 23, defaults to 0 (midnight). An API may choose to allow the value \"24:00:00\" for scenarios like business closing time.", "type": "integer", "format": "int32" }, "minutes": { "description": "Optional. Minutes of hour of day. Must be from 0 to 59, defaults to 0.", "type": "integer", "format": "int32" }, "seconds": { "description": "Optional. Seconds of minutes of the time. Must normally be from 0 to 59, defaults to 0. An API may allow the value 60 if it allows leap-seconds.", "type": "integer", "format": "int32" }, "nanos": { "description": "Optional. Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999, defaults to 0.", "type": "integer", "format": "int32" }, "utcOffset": { "description": "UTC offset. Must be whole seconds, between -18 hours and +18 hours. For example, a UTC offset of -4:00 would be represented as { seconds: -14400 }.", "type": "string", "format": "google-duration" }, "timeZone": { "description": "Time zone.", "$ref": "TimeZone" } } }, "TimeZone": { "id": "TimeZone", "description": "Represents a time zone from the [IANA Time Zone Database](https://www.iana.org/time-zones).", "type": "object", "properties": { "id": { "description": "IANA Time Zone Database time zone, e.g. \"America/New_York\".", "type": "string" }, "version": { "description": "Optional. IANA Time Zone Database version number, e.g. \"2019a\".", "type": "string" } } }, "OrderTrackingSignalShippingInfo": { "id": "OrderTrackingSignalShippingInfo", "description": "The shipping information for the order.", "type": "object", "properties": { "shipmentId": { "description": "Required. The shipment ID. This field will be hashed in returned OrderTrackingSignal creation response.", "type": "string" }, "trackingId": { "description": "The tracking ID of the shipment. This field is required if one of the following fields is absent: earliest_delivery_promise_time, latest_delivery_promise_time, and actual_delivery_time.", "type": "string" }, "carrierName": { "description": "The name of the shipping carrier for the delivery. This field is required if one of the following fields is absent: earliest_delivery_promise_time, latest_delivery_promise_time, and actual_delivery_time.", "type": "string" }, "carrierServiceName": { "description": "The service type for fulfillment, e.g., GROUND, FIRST_CLASS, etc.", "type": "string" }, "shippedTime": { "description": "The time when the shipment was shipped. Include the year and timezone string, if available.", "$ref": "DateTime" }, "earliestDeliveryPromiseTime": { "description": "The earliest delivery promised time. Include the year and timezone string, if available. This field is required, if one of the following fields is absent: tracking_id or carrier_name.", "$ref": "DateTime" }, "latestDeliveryPromiseTime": { "description": "The latest delivery promised time. Include the year and timezone string, if available. This field is required, if one of the following fields is absent: tracking_id or carrier_name.", "$ref": "DateTime" }, "actualDeliveryTime": { "description": "The time when the shipment was actually delivered. Include the year and timezone string, if available. This field is required, if one of the following fields is absent: tracking_id or carrier_name.", "$ref": "DateTime" }, "shippingStatus": { "description": "The status of the shipment.", "type": "string", "enumDescriptions": [ "The shipping status is not known to merchant.", "All items are shipped.", "The shipment is already delivered." ], "enum": [ "SHIPPING_STATE_UNSPECIFIED", "SHIPPED", "DELIVERED" ] }, "originPostalCode": { "description": "The origin postal code, as a continuous string without spaces or dashes, e.g. \"95016\". This field will be anonymized in returned OrderTrackingSignal creation response.", "type": "string" }, "originRegionCode": { "description": "The [CLDR territory code] (http://www.unicode.org/repos/cldr/tags/latest/common/main/en.xml) for the shipping origin.", "type": "string" } } }, "OrderTrackingSignalLineItemDetails": { "id": "OrderTrackingSignalLineItemDetails", "description": "The line items of the order.", "type": "object", "properties": { "lineItemId": { "description": "Required. The ID for this line item.", "type": "string" }, "productId": { "description": "Required. The Content API REST ID of the product, in the form channel:contentLanguage:targetCountry:offerId.", "type": "string" }, "gtin": { "description": "The Global Trade Item Number.", "type": "string" }, "mpn": { "description": "The manufacturer part number.", "type": "string" }, "upc": { "description": "Universal product code for this item (deprecated: Please use GTIN instead).", "deprecated": true, "type": "string" }, "sku": { "description": "Merchant SKU for this item (deprecated).", "deprecated": true, "type": "string" }, "productDescription": { "description": "Plain text description of this product (deprecated: Please use product_title instead).", "deprecated": true, "type": "string" }, "productTitle": { "description": "Plain text title of this product.", "type": "string" }, "brand": { "description": "Brand of the product.", "type": "string" }, "quantity": { "description": "The quantity of the line item in the order.", "type": "string", "format": "int64" } } }, "OrderTrackingSignalShipmentLineItemMapping": { "id": "OrderTrackingSignalShipmentLineItemMapping", "description": "Represents how many items are in the shipment for the given shipment_id and line_item_id.", "type": "object", "properties": { "shipmentId": { "description": "Required. The shipment ID. This field will be hashed in returned OrderTrackingSignal creation response.", "type": "string" }, "lineItemId": { "description": "Required. The line item ID.", "type": "string" }, "quantity": { "description": "The line item quantity in the shipment.", "type": "string", "format": "int64" } } }, "ProductDeliveryTime": { "id": "ProductDeliveryTime", "description": "The estimated days to deliver a product after an order is placed. Only authorized shipping signals partners working with a merchant can use this resource. Merchants should use the [`products`](https://developers.google.com/shopping-content/reference/rest/v2.1/products#productshipping) resource instead.", "type": "object", "properties": { "productId": { "description": "Required. The `id` of the product.", "$ref": "ProductId" }, "areaDeliveryTimes": { "description": "Required. A set of associations between `DeliveryArea` and `DeliveryTime` entries. The total number of `areaDeliveryTimes` can be at most 100.", "type": "array", "items": { "$ref": "ProductDeliveryTimeAreaDeliveryTime" } } } }, "ProductId": { "id": "ProductId", "description": "The Content API ID of the product.", "type": "object", "properties": { "productId": { "description": "The Content API ID of the product, in the form `channel:contentLanguage:targetCountry:offerId`.", "type": "string" } } }, "ProductDeliveryTimeAreaDeliveryTime": { "id": "ProductDeliveryTimeAreaDeliveryTime", "description": "A pairing of `DeliveryArea` associated with a `DeliveryTime` for this product.", "type": "object", "properties": { "deliveryArea": { "description": "Required. The delivery area associated with `deliveryTime` for this product.", "$ref": "DeliveryArea" }, "deliveryTime": { "description": "Required. The delivery time associated with `deliveryArea` for this product.", "$ref": "ProductDeliveryTimeAreaDeliveryTimeDeliveryTime" } } }, "DeliveryArea": { "id": "DeliveryArea", "description": "A delivery area for the product. Only one of `countryCode` or `postalCodeRange` must be set.", "type": "object", "properties": { "countryCode": { "description": "Required. The country that the product can be delivered to. Submit a [unicode CLDR region](http://www.unicode.org/repos/cldr/tags/latest/common/main/en.xml) such as `US` or `CH`.", "type": "string" }, "postalCodeRange": { "description": "A postal code, postal code range or postal code prefix that defines this area. Limited to US and AUS.", "$ref": "DeliveryAreaPostalCodeRange" }, "regionCode": { "description": "A state, territory, or prefecture. This is supported for the United States, Australia, and Japan. Provide a subdivision code from the ISO 3166-2 code tables ([US](https://en.wikipedia.org/wiki/ISO_3166-2:US), [AU](https://en.wikipedia.org/wiki/ISO_3166-2:AU), or [JP](https://en.wikipedia.org/wiki/ISO_3166-2:JP)) without country prefix (for example, `\"NY\"`, `\"NSW\"`, `\"03\"`).", "type": "string" } } }, "DeliveryAreaPostalCodeRange": { "id": "DeliveryAreaPostalCodeRange", "description": "A range of postal codes that defines the delivery area. Only set `firstPostalCode` when specifying a single postal code.", "type": "object", "properties": { "firstPostalCode": { "description": "Required. 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*\"`.", "type": "string" }, "lastPostalCode": { "description": "A postal code or a pattern of the form prefix* denoting the inclusive upper bound of the range defining the area (for example [070* - 078*] results in the range [07000 - 07899]). It must have the same length as `firstPostalCode`: if `firstPostalCode` is a postal code then `lastPostalCode` must be a postal code too; if firstPostalCode is a pattern then `lastPostalCode` must be a pattern with the same prefix length. Ignored if not set, then the area is defined as being all the postal codes matching `firstPostalCode`.", "type": "string" } } }, "ProductDeliveryTimeAreaDeliveryTimeDeliveryTime": { "id": "ProductDeliveryTimeAreaDeliveryTimeDeliveryTime", "description": "A delivery time for this product.", "type": "object", "properties": { "minHandlingTimeDays": { "description": "Required. The minimum number of business days (inclusive) between when an order is placed and when the product ships. If a product ships in the same day, set this value to 0.", "type": "integer", "format": "int32" }, "maxHandlingTimeDays": { "description": "Required. The maximum number of business days (inclusive) between when an order is placed and when the product ships. If a product ships in the same day, set this value to 0.", "type": "integer", "format": "int32" }, "minTransitTimeDays": { "description": "Required. The minimum number of business days (inclusive) between when the product ships and when the product is delivered.", "type": "integer", "format": "int32" }, "maxTransitTimeDays": { "description": "Required. The maximum number of business days (inclusive) between when the product ships and when the product is delivered.", "type": "integer", "format": "int32" } } } } }