is.google-api-services-content.v2-rev20210113-1.31.0.source-code.content.v2.json Maven / Gradle / Ivy
{
"ownerName": "Google",
"servicePath": "",
"auth": {
"oauth2": {
"scopes": {
"https://www.googleapis.com/auth/content": {
"description": "Manage your product listings and accounts for Google Shopping"
}
}
}
},
"documentationLink": "https://developers.google.com/shopping-content/v2/",
"icons": {
"x16": "http://www.google.com/images/icons/product/search-16.gif",
"x32": "http://www.google.com/images/icons/product/search-32.gif"
},
"mtlsRootUrl": "https://shoppingcontent.mtls.googleapis.com/",
"baseUrl": "https://shoppingcontent.googleapis.com/",
"ownerDomain": "google.com",
"kind": "discovery#restDescription",
"parameters": {
"quotaUser": {
"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",
"type": "string"
},
"$.xgafv": {
"description": "V1 error format.",
"enum": [
"1",
"2"
],
"type": "string",
"enumDescriptions": [
"v1 error format",
"v2 error format"
],
"location": "query"
},
"oauth_token": {
"location": "query",
"type": "string",
"description": "OAuth 2.0 token for the current user."
},
"callback": {
"location": "query",
"description": "JSONP",
"type": "string"
},
"access_token": {
"description": "OAuth access token.",
"location": "query",
"type": "string"
},
"upload_protocol": {
"location": "query",
"description": "Upload protocol for media (e.g. \"raw\", \"multipart\").",
"type": "string"
},
"alt": {
"enumDescriptions": [
"Responses with Content-Type of application/json",
"Media download with context-dependent Content-Type",
"Responses with Content-Type of application/x-protobuf"
],
"type": "string",
"default": "json",
"location": "query",
"description": "Data format for response.",
"enum": [
"json",
"media",
"proto"
]
},
"uploadType": {
"description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").",
"location": "query",
"type": "string"
},
"prettyPrint": {
"default": "true",
"location": "query",
"description": "Returns response with indentations and line breaks.",
"type": "boolean"
},
"key": {
"type": "string",
"location": "query",
"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."
},
"fields": {
"location": "query",
"description": "Selector specifying which fields to include in a partial response.",
"type": "string"
}
},
"batchPath": "batch",
"canonicalName": "Shopping Content",
"fullyEncodeReservedExpansion": true,
"protocol": "rest",
"title": "Content API for Shopping",
"name": "content",
"id": "content:v2",
"revision": "20210113",
"schemas": {
"OrderLineItemProduct": {
"properties": {
"mpn": {
"type": "string",
"description": "Manufacturer Part Number (MPN) of the item."
},
"price": {
"$ref": "Price",
"description": "Price of the item."
},
"fees": {
"items": {
"$ref": "OrderLineItemProductFee"
},
"description": "Associated fees at order creation time.",
"type": "array"
},
"condition": {
"description": "Condition or state of the item. Acceptable values are: - \"`new`\" - \"`refurbished`\" - \"`used`\" ",
"type": "string"
},
"imageLink": {
"type": "string",
"description": "URL of an image of the item."
},
"contentLanguage": {
"description": "The two-letter ISO 639-1 language code for the item.",
"type": "string"
},
"brand": {
"description": "Brand of the item.",
"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"
},
"targetCountry": {
"type": "string",
"description": "The CLDR territory // code of the target country of the product."
},
"title": {
"type": "string",
"description": "The title of the product."
},
"id": {
"description": "The REST ID of the product.",
"type": "string"
},
"shownImage": {
"description": "URL to the cached image shown to the user when order was placed.",
"type": "string"
},
"offerId": {
"description": "An identifier of the item.",
"type": "string"
},
"variantAttributes": {
"items": {
"$ref": "OrderLineItemProductVariantAttribute"
},
"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"
},
"channel": {
"type": "string",
"description": "The item's channel (online or local). Acceptable values are: - \"`local`\" - \"`online`\" "
}
},
"type": "object",
"id": "OrderLineItemProduct"
},
"LiasettingsListPosDataProvidersResponse": {
"type": "object",
"id": "LiasettingsListPosDataProvidersResponse",
"properties": {
"posDataProviders": {
"type": "array",
"items": {
"$ref": "PosDataProviders"
},
"description": "The list of POS data providers for each eligible country"
},
"kind": {
"type": "string",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#liasettingsListPosDataProvidersResponse\"."
}
}
},
"OrderinvoicesCustomBatchRequestEntryCreateRefundInvoiceReturnOption": {
"properties": {
"description": {
"type": "string",
"description": "Optional description of the return reason."
},
"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"
}
},
"id": "OrderinvoicesCustomBatchRequestEntryCreateRefundInvoiceReturnOption",
"type": "object"
},
"OrdersAdvanceTestOrderResponse": {
"type": "object",
"properties": {
"kind": {
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#ordersAdvanceTestOrderResponse\".",
"type": "string"
}
},
"id": "OrdersAdvanceTestOrderResponse"
},
"OrdersShipLineItemsResponse": {
"properties": {
"executionStatus": {
"type": "string",
"description": "The status of the execution. Acceptable values are: - \"`duplicate`\" - \"`executed`\" "
},
"kind": {
"type": "string",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#ordersShipLineItemsResponse\"."
}
},
"type": "object",
"id": "OrdersShipLineItemsResponse"
},
"AccounttaxCustomBatchRequest": {
"type": "object",
"id": "AccounttaxCustomBatchRequest",
"properties": {
"entries": {
"type": "array",
"description": "The request entries to be processed in the batch.",
"items": {
"$ref": "AccounttaxCustomBatchRequestEntry"
}
}
}
},
"DatafeedstatusesCustomBatchRequest": {
"id": "DatafeedstatusesCustomBatchRequest",
"properties": {
"entries": {
"items": {
"$ref": "DatafeedstatusesCustomBatchRequestEntry"
},
"description": "The request entries to be processed in the batch.",
"type": "array"
}
},
"type": "object"
},
"OrdersInStoreRefundLineItemResponse": {
"id": "OrdersInStoreRefundLineItemResponse",
"properties": {
"executionStatus": {
"type": "string",
"description": "The status of the execution. Acceptable values are: - \"`duplicate`\" - \"`executed`\" "
},
"kind": {
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#ordersInStoreRefundLineItemResponse\".",
"type": "string"
}
},
"type": "object"
},
"AccountstatusesCustomBatchResponse": {
"properties": {
"entries": {
"items": {
"$ref": "AccountstatusesCustomBatchResponseEntry"
},
"type": "array",
"description": "The result of the execution of the batch requests."
},
"kind": {
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#accountstatusesCustomBatchResponse\".",
"type": "string"
}
},
"type": "object",
"id": "AccountstatusesCustomBatchResponse"
},
"OrdersCustomBatchRequestEntryCancelLineItem": {
"id": "OrdersCustomBatchRequestEntryCancelLineItem",
"type": "object",
"properties": {
"amountPretax": {
"$ref": "Price",
"description": "Amount to refund for the cancelation. Optional. If not set, Google will calculate the default based on the price and tax of the items involved. The amount must not be larger than the net amount left on the order."
},
"reason": {
"type": "string",
"description": "The reason for the cancellation. Acceptable values are: - \"`customerInitiatedCancel`\" - \"`invalidCoupon`\" - \"`malformedShippingAddress`\" - \"`noInventory`\" - \"`other`\" - \"`priceError`\" - \"`shippingPriceError`\" - \"`taxError`\" - \"`undeliverableShippingAddress`\" - \"`unsupportedPoBoxAddress`\" "
},
"quantity": {
"format": "uint32",
"type": "integer",
"description": "The quantity to cancel."
},
"reasonText": {
"type": "string",
"description": "The explanation of the reason."
},
"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"
},
"amountTax": {
"description": "Tax amount that corresponds to cancellation amount in amountPretax. Optional, but if filled, then amountPretax must be set. Calculated automatically if not provided.",
"$ref": "Price"
},
"amount": {
"$ref": "Price",
"description": "Deprecated. Please use amountPretax and amountTax instead."
},
"lineItemId": {
"description": "The ID of the line item to cancel. Either lineItemId or productId is required.",
"type": "string"
}
}
},
"DatafeedStatus": {
"id": "DatafeedStatus",
"type": "object",
"description": "The status of a datafeed, i.e., the result of the last retrieval of the datafeed computed asynchronously when the feed processing is finished.",
"properties": {
"lastUploadDate": {
"type": "string",
"description": "The last date at which the feed was uploaded."
},
"processingStatus": {
"type": "string",
"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. "
},
"errors": {
"description": "The list of errors occurring in the feed.",
"items": {
"$ref": "DatafeedStatusError"
},
"type": "array"
},
"language": {
"type": "string",
"description": "The two-letter ISO 639-1 language for which the status is reported."
},
"datafeedId": {
"description": "The ID of the feed for which the status is reported.",
"format": "uint64",
"type": "string"
},
"itemsTotal": {
"description": "The number of items in the feed that were processed.",
"type": "string",
"format": "uint64"
},
"country": {
"type": "string",
"description": "The country for which the status is reported, represented as a CLDR territory code."
},
"kind": {
"type": "string",
"description": "Identifies what kind of resource this is. Value: the fixed string \"`content#datafeedStatus`\""
},
"warnings": {
"description": "The list of errors occurring in the feed.",
"items": {
"$ref": "DatafeedStatusError"
},
"type": "array"
},
"itemsValid": {
"description": "The number of items in the feed that were valid.",
"type": "string",
"format": "uint64"
}
}
},
"PosInventory": {
"properties": {
"timestamp": {
"type": "string",
"description": "Required. The inventory timestamp, in ISO 8601 format."
},
"quantity": {
"format": "int64",
"type": "string",
"description": "Required. The available quantity of the item."
},
"storeCode": {
"description": "Required. The identifier of the merchant's store. Either a `storeCode` inserted via the API or the code of the store in Google My Business.",
"type": "string"
},
"targetCountry": {
"description": "Required. The CLDR territory code for the item.",
"type": "string"
},
"itemId": {
"type": "string",
"description": "Required. A unique identifier for the item."
},
"kind": {
"description": "Identifies what kind of resource this is. Value: the fixed string \"`content#posInventory`\"",
"type": "string"
},
"price": {
"description": "Required. The current price of the item.",
"$ref": "Price"
},
"gtin": {
"type": "string",
"description": "Global Trade Item Number."
},
"contentLanguage": {
"type": "string",
"description": "Required. The two-letter ISO 639-1 language code for the item."
}
},
"id": "PosInventory",
"type": "object",
"description": "The absolute quantity of an item available at the given store."
},
"OrdersAcknowledgeResponse": {
"id": "OrdersAcknowledgeResponse",
"properties": {
"kind": {
"type": "string",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#ordersAcknowledgeResponse\"."
},
"executionStatus": {
"description": "The status of the execution. Acceptable values are: - \"`duplicate`\" - \"`executed`\" ",
"type": "string"
}
},
"type": "object"
},
"OrderreportsListTransactionsResponse": {
"properties": {
"kind": {
"type": "string",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#orderreportsListTransactionsResponse\"."
},
"transactions": {
"type": "array",
"items": {
"$ref": "OrderReportTransaction"
},
"description": "The list of transactions."
},
"nextPageToken": {
"type": "string",
"description": "The token for the retrieval of the next page of transactions."
}
},
"id": "OrderreportsListTransactionsResponse",
"type": "object"
},
"OrderLineItemShippingDetailsMethod": {
"type": "object",
"properties": {
"methodName": {
"type": "string",
"description": "Required. The name of the shipping method."
},
"maxDaysInTransit": {
"description": "Required. Maximum transit time.",
"format": "uint32",
"type": "integer"
},
"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"
}
},
"id": "OrderLineItemShippingDetailsMethod"
},
"OrdersCustomBatchRequestEntrySetLineItemMetadata": {
"properties": {
"annotations": {
"type": "array",
"items": {
"$ref": "OrderMerchantProvidedAnnotation"
}
},
"lineItemId": {
"type": "string",
"description": "The ID of the line item to set metadata. Either lineItemId or productId is required."
},
"productId": {
"description": "The ID of the product to set metadata. This is the REST ID used in the products service. Either lineItemId or productId is required.",
"type": "string"
}
},
"type": "object",
"id": "OrdersCustomBatchRequestEntrySetLineItemMetadata"
},
"InventoryCustomBatchRequest": {
"id": "InventoryCustomBatchRequest",
"type": "object",
"properties": {
"entries": {
"description": "The request entries to be processed in the batch.",
"type": "array",
"items": {
"$ref": "InventoryCustomBatchRequestEntry"
}
}
}
},
"ProductsCustomBatchResponseEntry": {
"type": "object",
"properties": {
"errors": {
"description": "A list of errors defined if and only if the request failed.",
"$ref": "Errors"
},
"product": {
"$ref": "Product",
"description": "The inserted product. Only defined if the method is `insert` and if the request was successful."
},
"kind": {
"description": "Identifies what kind of resource this is. Value: the fixed string \"`content#productsCustomBatchResponseEntry`\"",
"type": "string"
},
"batchId": {
"description": "The ID of the request entry this entry responds to.",
"type": "integer",
"format": "uint32"
}
},
"description": "A batch entry encoding a single non-batch products response.",
"id": "ProductsCustomBatchResponseEntry"
},
"LocationIdSet": {
"type": "object",
"id": "LocationIdSet",
"properties": {
"locationIds": {
"description": "A non-empty list of location IDs. They must all be of the same location type (e.g., state).",
"type": "array",
"items": {
"type": "string"
}
}
}
},
"OrdersAcknowledgeRequest": {
"type": "object",
"properties": {
"operationId": {
"type": "string",
"description": "The ID of the operation. Unique across all operations for a given order."
}
},
"id": "OrdersAcknowledgeRequest"
},
"MinimumOrderValueTableStoreCodeSetWithMov": {
"properties": {
"storeCodes": {
"items": {
"type": "string"
},
"type": "array",
"description": "A list of unique store codes or empty for the catch all."
},
"value": {
"description": "The minimum order value for the given stores.",
"$ref": "Price"
}
},
"id": "MinimumOrderValueTableStoreCodeSetWithMov",
"type": "object",
"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."
},
"ProductstatusesCustomBatchRequest": {
"properties": {
"entries": {
"type": "array",
"description": "The request entries to be processed in the batch.",
"items": {
"$ref": "ProductstatusesCustomBatchRequestEntry"
}
}
},
"type": "object",
"id": "ProductstatusesCustomBatchRequest"
},
"OrdersUpdateShipmentRequest": {
"type": "object",
"properties": {
"operationId": {
"description": "The ID of the operation. Unique across all operations for a given order.",
"type": "string"
},
"status": {
"description": "New status for the shipment. Not updated if missing. Acceptable values are: - \"`delivered`\" - \"`undeliverable`\" - \"`readyForPickup`\" ",
"type": "string"
},
"deliveryDate": {
"type": "string",
"description": "Date on which the shipment has been delivered, in ISO 8601 format. Optional and can be provided only if `status` is `delivered`."
},
"shipmentId": {
"type": "string",
"description": "The ID of the shipment."
},
"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": {
"type": "string",
"description": "The tracking ID for the shipment. Not updated if missing."
}
},
"id": "OrdersUpdateShipmentRequest"
},
"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.",
"properties": {
"subtableName": {
"type": "string",
"description": "The name of a subtable. Can only be set in table cells (i.e., not for single values), and only if all other fields are not set."
},
"noShipping": {
"type": "boolean",
"description": "If true, then the product can't ship. Must be true when set, can only be set if all other fields are not set."
},
"carrierRateName": {
"type": "string",
"description": "The name of a carrier rate referring to a carrier rate defined in the same rate group. Can only be set if all other fields are not set."
},
"pricePercentage": {
"type": "string",
"description": "A percentage of the price represented as a number in decimal notation (e.g., `\"5.4\"`). Can only be set if all other fields are not set."
},
"flatRate": {
"$ref": "Price",
"description": "A flat rate. Can only be set if all other fields are not set."
}
},
"type": "object",
"id": "Value"
},
"ProductShipping": {
"properties": {
"locationId": {
"format": "int64",
"description": "The numeric ID of a location that the shipping rate applies to as defined in the AdWords API.",
"type": "string"
},
"price": {
"description": "Fixed shipping price, represented as a number.",
"$ref": "Price"
},
"service": {
"description": "A free-form description of the service class or delivery speed.",
"type": "string"
},
"country": {
"type": "string",
"description": "The CLDR territory code of the country to which an item will ship."
},
"postalCode": {
"type": "string",
"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."
},
"locationGroupName": {
"description": "The location where the shipping is applicable, represented by a location group name.",
"type": "string"
},
"region": {
"type": "string",
"description": "The geographic region to which a shipping rate applies."
}
},
"id": "ProductShipping",
"type": "object"
},
"ShippingSettings": {
"description": "The merchant account's shipping settings. All methods except getsupportedcarriers and getsupportedholidays require the admin role.",
"id": "ShippingSettings",
"type": "object",
"properties": {
"services": {
"items": {
"$ref": "Service"
},
"type": "array",
"description": "The target account's list of services. Optional."
},
"postalCodeGroups": {
"items": {
"$ref": "PostalCodeGroup"
},
"description": "A list of postal code groups that can be referred to in `services`. Optional.",
"type": "array"
},
"accountId": {
"type": "string",
"format": "uint64",
"description": "The ID of the account to which these account shipping settings belong. Ignored upon update, always present in get request responses."
}
}
},
"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": {
"type": "string",
"description": "Shipping cost and policy URL."
}
}
},
"OrderLegacyPromotionBenefit": {
"properties": {
"subType": {
"type": "string",
"description": "Further describes the benefit of the promotion. Note that we will expand on this enumeration as we support new promotion sub-types. Acceptable values are: - \"`buyMGetMoneyOff`\" - \"`buyMGetNMoneyOff`\" - \"`buyMGetNPercentOff`\" - \"`buyMGetPercentOff`\" - \"`freeGift`\" - \"`freeGiftWithItemId`\" - \"`freeGiftWithValue`\" - \"`freeOvernightShipping`\" - \"`freeShipping`\" - \"`freeTwoDayShipping`\" - \"`moneyOff`\" - \"`percentageOff`\" - \"`rewardPoints`\" - \"`salePrice`\" "
},
"offerIds": {
"type": "array",
"description": "The OfferId(s) that were purchased in this order and map to this specific benefit of the promotion.",
"items": {
"type": "string"
}
},
"type": {
"description": "Describes whether the promotion applies to products (e.g. 20% off) or to shipping (e.g. Free Shipping). Acceptable values are: - \"`product`\" - \"`shipping`\" ",
"type": "string"
},
"discount": {
"description": "The discount in the order price when the promotion is applied.",
"$ref": "Price"
},
"taxImpact": {
"description": "The impact on tax when the promotion is applied.",
"$ref": "Price"
}
},
"id": "OrderLegacyPromotionBenefit",
"type": "object"
},
"Inventory": {
"type": "object",
"id": "Inventory",
"properties": {
"salePrice": {
"description": "The sale price of the product. Mandatory if `sale_price_effective_date` is defined.",
"$ref": "Price"
},
"customLabel3": {
"description": "Custom label 3 for custom grouping of items in a Shopping campaign. Only supported for online products.",
"type": "string"
},
"customLabel1": {
"type": "string",
"description": "Custom label 1 for custom grouping of items in a Shopping campaign. Only supported for online products."
},
"sellOnGoogleQuantity": {
"type": "integer",
"description": "The quantity of the product that is available for selling on Google. Supported only for online products.",
"format": "uint32"
},
"loyaltyPoints": {
"description": "Loyalty points that users receive after purchasing the item. Japan only.",
"$ref": "LoyaltyPoints"
},
"pickup": {
"description": "Store pickup information. Only supported for local inventory. Not setting `pickup` means \"don't update\" while setting it to the empty value (`{}` in JSON) means \"delete\". Otherwise, `pickupMethod` and `pickupSla` must be set together, unless `pickupMethod` is \"not supported\".",
"$ref": "InventoryPickup"
},
"customLabel2": {
"type": "string",
"description": "Custom label 2 for custom grouping of items in a Shopping campaign. Only supported for online products."
},
"instoreProductLocation": {
"description": "The instore product location. Supported only for local products.",
"type": "string"
},
"kind": {
"description": "Identifies what kind of resource this is. Value: the fixed string \"`content#inventory`\"",
"type": "string"
},
"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"
},
"installment": {
"description": "Number and amount of installments to pay for an item. Brazil only.",
"$ref": "Installment"
},
"customLabel0": {
"description": "Custom label 0 for custom grouping of items in a Shopping campaign. Only supported for online products.",
"type": "string"
},
"customLabel4": {
"type": "string",
"description": "Custom label 3 for custom grouping of items in a Shopping campaign. Only supported for online products."
},
"availability": {
"type": "string",
"description": "The availability of the product. Acceptable values are: - \"`in stock`\" - \"`out of stock`\" - \"`preorder`\" "
},
"price": {
"description": "The price of the product.",
"$ref": "Price"
},
"quantity": {
"type": "integer",
"description": "The quantity of the product. Must be equal to or greater than zero. Supported only for local products.",
"format": "uint32"
}
}
},
"OrdersCustomBatchResponse": {
"properties": {
"kind": {
"type": "string",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#ordersCustomBatchResponse\"."
},
"entries": {
"type": "array",
"description": "The result of the execution of the batch requests.",
"items": {
"$ref": "OrdersCustomBatchResponseEntry"
}
}
},
"id": "OrdersCustomBatchResponse",
"type": "object"
},
"MerchantOrderReturn": {
"description": "Order return. Production access (all methods) requires the order manager role. Sandbox access does not.",
"properties": {
"merchantOrderId": {
"description": "Merchant defined order ID.",
"type": "string"
},
"creationDate": {
"type": "string",
"description": "The date of creation of the return, in ISO 8601 format."
},
"orderReturnId": {
"type": "string",
"description": "Order return ID generated by Google."
},
"returnItems": {
"items": {
"$ref": "MerchantOrderReturnItem"
},
"type": "array",
"description": "Items of the return."
},
"orderId": {
"type": "string",
"description": "Google order ID."
},
"returnShipments": {
"description": "Shipments of the return.",
"items": {
"$ref": "ReturnShipment"
},
"type": "array"
}
},
"id": "MerchantOrderReturn",
"type": "object"
},
"GmbAccounts": {
"properties": {
"accountId": {
"type": "string",
"description": "The ID of the Merchant Center account.",
"format": "uint64"
},
"gmbAccounts": {
"type": "array",
"description": "A list of GMB accounts which are available to the merchant.",
"items": {
"$ref": "GmbAccountsGmbAccount"
}
}
},
"id": "GmbAccounts",
"type": "object"
},
"ProductShippingDimension": {
"properties": {
"value": {
"type": "number",
"format": "double",
"description": "The dimension of the product used to calculate the shipping cost of the item."
},
"unit": {
"type": "string",
"description": "The unit of value."
}
},
"id": "ProductShippingDimension",
"type": "object"
},
"AccountTax": {
"description": "The tax settings of a merchant account. All methods require the admin role.",
"id": "AccountTax",
"type": "object",
"properties": {
"kind": {
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#accountTax\".",
"type": "string"
},
"rules": {
"description": "Tax rules. Updating the tax rules will enable US taxes (not reversible). Defining no rules is equivalent to not charging tax at all.",
"type": "array",
"items": {
"$ref": "AccountTaxTaxRule"
}
},
"accountId": {
"description": "Required. The ID of the account to which these account tax settings belong.",
"format": "uint64",
"type": "string"
}
}
},
"Account": {
"properties": {
"id": {
"description": "Required for update. Merchant Center account ID.",
"format": "uint64",
"type": "string"
},
"youtubeChannelLinks": {
"description": "List of linked YouTube channels that are active or pending approval. To create a new link request, add a new link with status `active` to the list. It will remain in a `pending` state until approved or rejected in the YT Creator Studio interface. To delete an active link, or to cancel a link request, remove it from the list.",
"items": {
"$ref": "AccountYouTubeChannelLink"
},
"type": "array"
},
"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"
}
},
"googleMyBusinessLink": {
"$ref": "AccountGoogleMyBusinessLink",
"description": "The GMB account which is linked or in the process of being linked with the Merchant Center account."
},
"kind": {
"description": "Identifies what kind of resource this is. Value: the fixed string \"`content#account`\"",
"type": "string"
},
"businessInformation": {
"$ref": "AccountBusinessInformation",
"description": "The business information of the account."
},
"sellerId": {
"type": "string",
"description": "Client-specific, locally-unique, internal ID for the child account."
},
"adultContent": {
"description": "Indicates whether the merchant sells adult content.",
"type": "boolean"
},
"name": {
"description": "Required. Display name for the account.",
"type": "string"
},
"reviewsUrl": {
"type": "string",
"description": "[DEPRECATED] This field is never returned and will be ignored if provided."
},
"websiteUrl": {
"description": "The merchant's website.",
"type": "string"
},
"adwordsLinks": {
"description": "List of linked AdWords 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 AdWords interface or through the AdWords API. To delete an active link, or to cancel a link request, remove it from the list.",
"items": {
"$ref": "AccountAdwordsLink"
},
"type": "array"
}
},
"id": "Account",
"description": "Account data. After the creation of a new account it may take a few minutes before it is fully operational. The methods delete, insert, and update require the admin role.",
"type": "object"
},
"AccountAdwordsLink": {
"properties": {
"status": {
"type": "string",
"description": "Status of the link between this Merchant Center account and the AdWords account. Upon retrieval, it represents the actual status of the link and can be either `active` if it was approved in Google AdWords 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`\" "
},
"adwordsId": {
"type": "string",
"description": "Customer ID of the AdWords account.",
"format": "uint64"
}
},
"type": "object",
"id": "AccountAdwordsLink"
},
"OrdersInStoreRefundLineItemRequest": {
"id": "OrdersInStoreRefundLineItemRequest",
"type": "object",
"properties": {
"lineItemId": {
"type": "string",
"description": "The ID of the line item to return. Either lineItemId or productId is required."
},
"quantity": {
"format": "uint32",
"description": "The quantity to return and refund.",
"type": "integer"
},
"reason": {
"type": "string",
"description": "The reason for the return. Acceptable values are: - \"`customerDiscretionaryReturn`\" - \"`customerInitiatedMerchantCancel`\" - \"`deliveredTooLate`\" - \"`expiredItem`\" - \"`invalidCoupon`\" - \"`malformedShippingAddress`\" - \"`other`\" - \"`productArrivedDamaged`\" - \"`productNotAsDescribed`\" - \"`qualityNotAsExpected`\" - \"`undeliverableShippingAddress`\" - \"`unsupportedPoBoxAddress`\" - \"`wrongProductShipped`\" "
},
"amountPretax": {
"description": "The amount that is refunded. Required.",
"$ref": "Price"
},
"reasonText": {
"description": "The explanation of the reason.",
"type": "string"
},
"amountTax": {
"description": "Tax amount that correspond to refund amount in amountPretax. Required.",
"$ref": "Price"
},
"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"
},
"operationId": {
"description": "The ID of the operation. Unique across all operations for a given order.",
"type": "string"
}
}
},
"PosListResponse": {
"properties": {
"resources": {
"type": "array",
"items": {
"$ref": "PosStore"
}
},
"kind": {
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#posListResponse\".",
"type": "string"
}
},
"id": "PosListResponse",
"type": "object"
},
"RefundReason": {
"id": "RefundReason",
"type": "object",
"properties": {
"description": {
"description": "Description of the reason.",
"type": "string"
},
"reasonCode": {
"type": "string",
"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`\" "
}
}
},
"Datafeed": {
"properties": {
"id": {
"description": "Required for update. The ID of the data feed.",
"type": "string",
"format": "int64"
},
"format": {
"description": "Format of the feed file.",
"$ref": "DatafeedFormat"
},
"targets": {
"type": "array",
"items": {
"$ref": "DatafeedTarget"
},
"description": "The targets this feed should apply to (country, language, destinations)."
},
"name": {
"description": "Required for insert. A descriptive name of the data feed.",
"type": "string"
},
"intendedDestinations": {
"items": {
"type": "string"
},
"type": "array",
"description": "[DEPRECATED] Please use targets[].includedDestinations instead. The list of intended destinations (corresponds to checked check boxes in Merchant Center)."
},
"fileName": {
"description": "Required. The filename of the feed. All feeds must have a unique file name.",
"type": "string"
},
"targetCountry": {
"description": "[DEPRECATED] Please use targets[].country instead. The country where the items in the feed will be included in the search index, represented as a CLDR territory code.",
"type": "string"
},
"attributeLanguage": {
"type": "string",
"description": "The two-letter ISO 639-1 language in which the attributes are defined in the data feed."
},
"fetchSchedule": {
"description": "Fetch schedule for the feed file.",
"$ref": "DatafeedFetchSchedule"
},
"contentLanguage": {
"description": "[DEPRECATED] Please use targets[].language instead. The two-letter ISO 639-1 language of the items in the feed. Must be a valid language for `targetCountry`.",
"type": "string"
},
"kind": {
"type": "string",
"description": "Identifies what kind of resource this is. Value: the fixed string \"`content#datafeed`\""
},
"contentType": {
"type": "string",
"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`\" "
}
},
"id": "Datafeed",
"description": "Datafeed configuration data.",
"type": "object"
},
"OrdersCustomBatchRequestEntryCreateTestReturnReturnItem": {
"properties": {
"quantity": {
"description": "Quantity that is returned.",
"format": "uint32",
"type": "integer"
},
"lineItemId": {
"description": "The ID of the line item to return.",
"type": "string"
}
},
"type": "object",
"id": "OrdersCustomBatchRequestEntryCreateTestReturnReturnItem"
},
"AccountStatusItemLevelIssue": {
"properties": {
"detail": {
"type": "string",
"description": "A detailed issue description in English."
},
"resolution": {
"description": "Whether the issue can be resolved by the merchant.",
"type": "string"
},
"description": {
"description": "A short issue description in English.",
"type": "string"
},
"code": {
"type": "string",
"description": "The error code of the issue."
},
"servability": {
"description": "How this issue affects serving of the offer.",
"type": "string"
},
"attributeName": {
"description": "The attribute's name, if the issue is caused by a single attribute.",
"type": "string"
},
"documentation": {
"type": "string",
"description": "The URL of a web page to help with resolving this issue."
},
"numItems": {
"format": "int64",
"type": "string",
"description": "Number of items with this issue."
}
},
"id": "AccountStatusItemLevelIssue",
"type": "object"
},
"AccountsClaimWebsiteResponse": {
"properties": {
"kind": {
"type": "string",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#accountsClaimWebsiteResponse\"."
}
},
"type": "object",
"id": "AccountsClaimWebsiteResponse"
},
"PosCustomBatchResponseEntry": {
"type": "object",
"id": "PosCustomBatchResponseEntry",
"properties": {
"kind": {
"description": "Identifies what kind of resource this is. Value: the fixed string \"`content#posCustomBatchResponseEntry`\"",
"type": "string"
},
"errors": {
"description": "A list of errors defined if, and only if, the request failed.",
"$ref": "Errors"
},
"store": {
"$ref": "PosStore",
"description": "The retrieved or updated store information."
},
"inventory": {
"description": "The updated inventory information.",
"$ref": "PosInventory"
},
"batchId": {
"format": "uint32",
"type": "integer",
"description": "The ID of the request entry to which this entry responds."
},
"sale": {
"$ref": "PosSale",
"description": "The updated sale information."
}
}
},
"CustomGroup": {
"properties": {
"attributes": {
"type": "array",
"description": "The sub-attributes.",
"items": {
"$ref": "CustomAttribute"
}
},
"name": {
"type": "string",
"description": "The name of the group. Underscores will be replaced by spaces upon insertion."
}
},
"id": "CustomGroup",
"type": "object"
},
"AccountStatus": {
"id": "AccountStatus",
"description": "The status of an account, i.e., information about its products, which is computed offline and not returned immediately at insertion time.",
"properties": {
"dataQualityIssues": {
"description": "DEPRECATED - never populated.",
"items": {
"$ref": "AccountStatusDataQualityIssue"
},
"type": "array"
},
"accountLevelIssues": {
"items": {
"$ref": "AccountStatusAccountLevelIssue"
},
"type": "array",
"description": "A list of account level issues."
},
"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"
},
"products": {
"items": {
"$ref": "AccountStatusProducts"
},
"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"
},
"websiteClaimed": {
"type": "boolean",
"description": "Whether the account's website is claimed or not."
}
},
"type": "object"
},
"Headers": {
"description": "A non-empty list of row or column headers for a table. Exactly one of `prices`, `weights`, `numItems`, `postalCodeGroupNames`, or `location` must be set.",
"id": "Headers",
"type": "object",
"properties": {
"prices": {
"items": {
"$ref": "Price"
},
"type": "array",
"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."
},
"weights": {
"type": "array",
"items": {
"$ref": "Weight"
},
"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."
},
"numberOfItems": {
"type": "array",
"description": "A list of inclusive number of items upper bounds. The last value can be `\"infinity\"`. For example `[\"10\", \"50\", \"infinity\"]` represents the headers \"\u003c= 10 items\", \"\u003c= 50 items\", and \"\u003e 50 items\". Must be non-empty. Can only be set if all other fields are not set.",
"items": {
"type": "string"
}
},
"postalCodeGroupNames": {
"items": {
"type": "string"
},
"type": "array",
"description": "A list of postal group names. The last value can be `\"all other locations\"`. Example: `[\"zone 1\", \"zone 2\", \"all other locations\"]`. The referred postal code groups must match the delivery country of the service. Must be non-empty. Can only be set if all other fields are not set."
},
"locations": {
"type": "array",
"items": {
"$ref": "LocationIdSet"
},
"description": "A list of location ID sets. Must be non-empty. Can only be set if all other fields are not set."
}
}
},
"DatafeedstatusesCustomBatchResponse": {
"type": "object",
"properties": {
"kind": {
"type": "string",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#datafeedstatusesCustomBatchResponse\"."
},
"entries": {
"description": "The result of the execution of the batch requests.",
"items": {
"$ref": "DatafeedstatusesCustomBatchResponseEntry"
},
"type": "array"
}
},
"id": "DatafeedstatusesCustomBatchResponse"
},
"Installment": {
"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"
}
},
"type": "object",
"id": "Installment"
},
"ShippingsettingsCustomBatchRequest": {
"properties": {
"entries": {
"description": "The request entries to be processed in the batch.",
"items": {
"$ref": "ShippingsettingsCustomBatchRequestEntry"
},
"type": "array"
}
},
"type": "object",
"id": "ShippingsettingsCustomBatchRequest"
},
"AccountGoogleMyBusinessLink": {
"properties": {
"status": {
"type": "string",
"description": "Status of the link between this Merchant Center account and the GMB account. Acceptable values are: - \"`active`\" - \"`pending`\" "
},
"gmbEmail": {
"type": "string",
"description": "The GMB email address of which a specific account within a GMB account. A sample account within a GMB account could be a business account with set of locations, managed under the GMB account."
}
},
"id": "AccountGoogleMyBusinessLink",
"type": "object"
},
"Amount": {
"type": "object",
"properties": {
"tax": {
"description": "[required] Tax value.",
"$ref": "Price"
},
"pretax": {
"description": "[required] Value before taxes.",
"$ref": "Price"
}
},
"id": "Amount"
},
"OrdersShipLineItemsRequest": {
"type": "object",
"properties": {
"operationId": {
"description": "The ID of the operation. Unique across all operations for a given order.",
"type": "string"
},
"trackingId": {
"type": "string",
"description": "Deprecated. Please use shipmentInfo instead. The tracking ID for the shipment."
},
"shipmentGroupId": {
"description": "ID of the shipment group. Required for orders that use the orderinvoices service.",
"type": "string"
},
"shipmentInfos": {
"type": "array",
"description": "Shipment information. This field is repeated because a single line item can be shipped in several packages (and have several tracking IDs).",
"items": {
"$ref": "OrdersCustomBatchRequestEntryShipLineItemsShipmentInfo"
}
},
"shipmentId": {
"description": "Deprecated. Please use shipmentInfo instead. The ID of the shipment.",
"type": "string"
},
"lineItems": {
"items": {
"$ref": "OrderShipmentLineItemShipment"
},
"type": "array",
"description": "Line items to ship."
},
"carrier": {
"description": "Deprecated. Please use shipmentInfo instead. The carrier handling the shipment. See `shipments[].carrier` in the Orders resource representation for a list of acceptable values.",
"type": "string"
}
},
"id": "OrdersShipLineItemsRequest"
},
"LiasettingsListResponse": {
"id": "LiasettingsListResponse",
"properties": {
"kind": {
"type": "string",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#liasettingsListResponse\"."
},
"nextPageToken": {
"description": "The token for the retrieval of the next page of LIA settings.",
"type": "string"
},
"resources": {
"type": "array",
"items": {
"$ref": "LiaSettings"
}
}
},
"type": "object"
},
"HolidaysHoliday": {
"id": "HolidaysHoliday",
"properties": {
"deliveryGuaranteeDate": {
"description": "Date on which the order has to arrive at the customer's, in ISO 8601 format. E.g. \"2016-12-24\" for 24th December 2016. Always present.",
"type": "string"
},
"type": {
"type": "string",
"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`\" "
},
"date": {
"type": "string",
"description": "Date of the holiday, in ISO 8601 format. E.g. \"2016-12-25\" for Christmas 2016. Always present."
},
"countryCode": {
"description": "The CLDR territory code of the country in which the holiday is available. E.g. \"US\", \"DE\", \"GB\". A holiday cutoff can only be configured in a shipping settings service with matching delivery country. Always present.",
"type": "string"
},
"deliveryGuaranteeHour": {
"description": "Hour of the day in the delivery location's timezone on the guaranteed delivery date by which the order has to arrive at the customer's. Possible values are: 0 (midnight), 1, ..., 12 (noon), 13, ..., 23. Always present.",
"format": "uint64",
"type": "string"
},
"id": {
"type": "string",
"description": "Unique identifier for the holiday to be used when configuring holiday cutoffs. Always present."
}
},
"type": "object"
},
"OrderreturnsListResponse": {
"id": "OrderreturnsListResponse",
"properties": {
"nextPageToken": {
"description": "The token for the retrieval of the next page of returns.",
"type": "string"
},
"resources": {
"items": {
"$ref": "MerchantOrderReturn"
},
"type": "array"
},
"kind": {
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#orderreturnsListResponse\".",
"type": "string"
}
},
"type": "object"
},
"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"
}
},
"id": "OrdersGetTestOrderTemplateResponse"
},
"AccountTaxTaxRule": {
"type": "object",
"id": "AccountTaxTaxRule",
"description": "Tax calculation rule to apply in a state or province (USA only).",
"properties": {
"locationId": {
"format": "uint64",
"type": "string",
"description": "Required. State (or province) is which the tax is applicable, described by its location ID (also called criteria ID)."
},
"useGlobalRate": {
"type": "boolean",
"description": "Whether the tax rate is taken from a global tax table or specified explicitly."
},
"shippingTaxed": {
"type": "boolean",
"description": "If true, shipping charges are also taxed."
},
"country": {
"type": "string",
"description": "Country code in which tax is applicable."
},
"ratePercent": {
"description": "Explicit tax rate in percent, represented as a floating point number without the percentage character. Must not be negative.",
"type": "string"
}
}
},
"Price": {
"type": "object",
"properties": {
"currency": {
"description": "The currency of the price.",
"type": "string"
},
"value": {
"type": "string",
"description": "The price represented as a number."
}
},
"id": "Price"
},
"AccountsListResponse": {
"type": "object",
"id": "AccountsListResponse",
"properties": {
"kind": {
"type": "string",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#accountsListResponse\"."
},
"nextPageToken": {
"type": "string",
"description": "The token for the retrieval of the next page of accounts."
},
"resources": {
"items": {
"$ref": "Account"
},
"type": "array"
}
}
},
"OrdersUpdateLineItemShippingDetailsRequest": {
"id": "OrdersUpdateLineItemShippingDetailsRequest",
"type": "object",
"properties": {
"shipByDate": {
"type": "string",
"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 not be a date in the past."
},
"lineItemId": {
"type": "string",
"description": "The ID of the line item to set metadata. Either lineItemId or productId is required."
},
"productId": {
"type": "string",
"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."
},
"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 not be a date in the past.",
"type": "string"
},
"operationId": {
"type": "string",
"description": "The ID of the operation. Unique across all operations for a given order."
}
}
},
"Error": {
"type": "object",
"id": "Error",
"description": "An error returned by the API.",
"properties": {
"message": {
"type": "string",
"description": "A description of the error."
},
"domain": {
"description": "The domain of the error.",
"type": "string"
},
"reason": {
"description": "The error code.",
"type": "string"
}
}
},
"OrderShipment": {
"properties": {
"scheduledDeliveryDetails": {
"$ref": "OrderShipmentScheduledDeliveryDetails",
"description": "Delivery details of the shipment if scheduling is needed."
},
"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 will not 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) 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"
},
"creationDate": {
"description": "Date on which the shipment has been created, in ISO 8601 format.",
"type": "string"
},
"id": {
"description": "The ID of the shipment.",
"type": "string"
},
"status": {
"description": "The status of the shipment. Acceptable values are: - \"`delivered`\" - \"`readyForPickup`\" - \"`shipped`\" - \"`undeliverable`\" ",
"type": "string"
},
"lineItems": {
"description": "The line items that are shipped.",
"type": "array",
"items": {
"$ref": "OrderShipmentLineItemShipment"
}
},
"trackingId": {
"type": "string",
"description": "The tracking ID for the shipment."
},
"deliveryDate": {
"type": "string",
"description": "Date on which the shipment has been delivered, in ISO 8601 format. Present only if `status` is `delivered`"
}
},
"id": "OrderShipment",
"type": "object"
},
"LiaSettings": {
"description": "Local Inventory ads (LIA) settings. All methods except listposdataproviders require the admin role.",
"type": "object",
"id": "LiaSettings",
"properties": {
"accountId": {
"type": "string",
"format": "uint64",
"description": "The ID of the account to which these LIA settings belong. Ignored upon update, always present in get request responses."
},
"kind": {
"type": "string",
"description": "Identifies what kind of resource this is. Value: the fixed string \"`content#liaSettings`\""
},
"countrySettings": {
"items": {
"$ref": "LiaCountrySettings"
},
"type": "array",
"description": "The LIA settings for each country."
}
}
},
"DatafeedsListResponse": {
"properties": {
"resources": {
"type": "array",
"items": {
"$ref": "Datafeed"
}
},
"nextPageToken": {
"description": "The token for the retrieval of the next page of datafeeds.",
"type": "string"
},
"kind": {
"type": "string",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#datafeedsListResponse\"."
}
},
"id": "DatafeedsListResponse",
"type": "object"
},
"LiasettingsSetPosDataProviderResponse": {
"type": "object",
"properties": {
"kind": {
"type": "string",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#liasettingsSetPosDataProviderResponse\"."
}
},
"id": "LiasettingsSetPosDataProviderResponse"
},
"AccountStatusAccountLevelIssue": {
"id": "AccountStatusAccountLevelIssue",
"type": "object",
"properties": {
"documentation": {
"type": "string",
"description": "The URL of a web page to help resolving this issue."
},
"detail": {
"description": "Additional details about the issue.",
"type": "string"
},
"id": {
"type": "string",
"description": "Issue identifier."
},
"destination": {
"type": "string",
"description": "The destination the issue applies to. If this field is empty then the issue applies to all available destinations."
},
"title": {
"type": "string",
"description": "Short description of the issue."
},
"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"
}
}
},
"OrderPickupDetails": {
"properties": {
"address": {
"$ref": "OrderAddress",
"description": "Address of the pickup location where the shipment should be sent. Note that `recipientName` in the address is the name of the business at the pickup location."
},
"collectors": {
"type": "array",
"items": {
"$ref": "OrderPickupDetailsCollector"
},
"description": "Collectors authorized to pick up shipment from the pickup location."
},
"locationId": {
"description": "ID of the pickup location.",
"type": "string"
}
},
"type": "object",
"id": "OrderPickupDetails"
},
"OrderPaymentMethod": {
"type": "object",
"id": "OrderPaymentMethod",
"properties": {
"expirationYear": {
"description": "The card expiration year (4-digit, e.g. 2015).",
"type": "integer",
"format": "int32"
},
"expirationMonth": {
"description": "The card expiration month (January = 1, February = 2 etc.).",
"type": "integer",
"format": "int32"
},
"lastFourDigits": {
"type": "string",
"description": "The last four digits of the card number."
},
"type": {
"type": "string",
"description": "The type of instrument. Acceptable values are: - \"`AMEX`\" - \"`DISCOVER`\" - \"`JCB`\" - \"`MASTERCARD`\" - \"`UNIONPAY`\" - \"`VISA`\" - \"``\" "
},
"billingAddress": {
"$ref": "OrderAddress",
"description": "The billing address."
},
"phoneNumber": {
"type": "string",
"description": "The billing phone number."
}
}
},
"ProductsListResponse": {
"properties": {
"resources": {
"items": {
"$ref": "Product"
},
"type": "array"
},
"nextPageToken": {
"type": "string",
"description": "The token for the retrieval of the next page of products."
},
"kind": {
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#productsListResponse\".",
"type": "string"
}
},
"type": "object",
"id": "ProductsListResponse"
},
"OrderReportTransaction": {
"properties": {
"productAmountWithRemittedTax": {
"$ref": "ProductAmount",
"description": "Total amount with remitted tax for the items."
},
"transactionDate": {
"type": "string",
"description": "The date of the transaction, in ISO 8601 format."
},
"disbursementDate": {
"type": "string",
"description": "The date the disbursement was initiated, in ISO 8601 format."
},
"merchantOrderId": {
"type": "string",
"description": "Merchant-provided ID of the order."
},
"merchantId": {
"description": "The ID of the managing account.",
"type": "string",
"format": "uint64"
},
"productAmount": {
"$ref": "Amount",
"description": "Total amount for the items."
},
"disbursementAmount": {
"description": "The disbursement amount.",
"$ref": "Price"
},
"disbursementCreationDate": {
"description": "The date the disbursement was created, in ISO 8601 format.",
"type": "string"
},
"orderId": {
"type": "string",
"description": "The ID of the order."
},
"disbursementId": {
"description": "The ID of the disbursement.",
"type": "string"
}
},
"type": "object",
"id": "OrderReportTransaction"
},
"MerchantOrderReturnItem": {
"id": "MerchantOrderReturnItem",
"properties": {
"customerReturnReason": {
"$ref": "CustomerReturnReason",
"description": "The reason that the customer chooses to return an item."
},
"returnShipmentIds": {
"type": "array",
"items": {
"type": "string"
},
"description": "IDs of the return shipments that this return item belongs to."
},
"itemId": {
"description": "Product level item ID. If the returned items are of the same product, they will have the same ID.",
"type": "string"
},
"product": {
"description": "Product data from the time of the order placement.",
"$ref": "OrderLineItemProduct"
},
"merchantReturnReason": {
"description": "The reason that merchant chooses to accept a return item.",
"$ref": "RefundReason"
},
"state": {
"description": "State of the item. Acceptable values are: - \"`canceled`\" - \"`new`\" - \"`received`\" - \"`refunded`\" - \"`rejected`\" ",
"type": "string"
}
},
"type": "object"
},
"InvoiceSummaryAdditionalChargeSummary": {
"id": "InvoiceSummaryAdditionalChargeSummary",
"properties": {
"totalAmount": {
"$ref": "Amount",
"description": "[required] Total additional charge for this type."
},
"type": {
"description": "[required] Type of the additional charge. Acceptable values are: - \"`shipping`\" ",
"type": "string"
}
},
"type": "object"
},
"Weight": {
"properties": {
"value": {
"type": "string",
"description": "Required. The weight represented as a number."
},
"unit": {
"description": "Required. The weight unit. Acceptable values are: - \"`kg`\" - \"`lb`\" ",
"type": "string"
}
},
"type": "object",
"id": "Weight"
},
"ShippingsettingsCustomBatchRequestEntry": {
"description": "A batch entry encoding a single non-batch shippingsettings request.",
"id": "ShippingsettingsCustomBatchRequestEntry",
"properties": {
"shippingSettings": {
"$ref": "ShippingSettings",
"description": "The account shipping settings to update. Only defined if the method is `update`."
},
"merchantId": {
"type": "string",
"format": "uint64",
"description": "The ID of the managing account."
},
"method": {
"type": "string",
"description": "The method of the batch entry. Acceptable values are: - \"`get`\" - \"`update`\" "
},
"batchId": {
"format": "uint32",
"description": "An entry ID, unique within the batch request.",
"type": "integer"
},
"accountId": {
"description": "The ID of the account for which to get/update account shipping settings.",
"format": "uint64",
"type": "string"
}
},
"type": "object"
},
"ShipmentInvoice": {
"id": "ShipmentInvoice",
"properties": {
"lineItemInvoices": {
"items": {
"$ref": "ShipmentInvoiceLineItemInvoice"
},
"type": "array",
"description": "[required] Invoice details per line item."
},
"shipmentGroupId": {
"type": "string",
"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."
},
"invoiceSummary": {
"$ref": "InvoiceSummary",
"description": "[required] Invoice summary."
}
},
"type": "object"
},
"ShippingsettingsListResponse": {
"properties": {
"resources": {
"items": {
"$ref": "ShippingSettings"
},
"type": "array"
},
"nextPageToken": {
"type": "string",
"description": "The token for the retrieval of the next page of shipping settings."
},
"kind": {
"type": "string",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#shippingsettingsListResponse\"."
}
},
"type": "object",
"id": "ShippingsettingsListResponse"
},
"OrdersCustomBatchRequestEntry": {
"id": "OrdersCustomBatchRequestEntry",
"properties": {
"refund": {
"$ref": "OrdersCustomBatchRequestEntryRefund",
"description": "Required for `refund` method."
},
"batchId": {
"type": "integer",
"description": "An entry ID, unique within the batch request.",
"format": "uint32"
},
"method": {
"type": "string",
"description": "The method of the batch entry. Acceptable values are: - \"`acknowledge`\" - \"`cancel`\" - \"`cancelLineItem`\" - \"`get`\" - \"`getByMerchantOrderId`\" - \"`inStoreRefundLineItem`\" - \"`refund`\" - \"`rejectReturnLineItem`\" - \"`returnLineItem`\" - \"`returnRefundLineItem`\" - \"`setLineItemMetadata`\" - \"`shipLineItems`\" - \"`updateLineItemShippingDetails`\" - \"`updateMerchantOrderId`\" - \"`updateShipment`\" "
},
"inStoreRefundLineItem": {
"$ref": "OrdersCustomBatchRequestEntryInStoreRefundLineItem",
"description": "Required for `inStoreReturnLineItem` method."
},
"setLineItemMetadata": {
"description": "Required for `setLineItemMetadata` method.",
"$ref": "OrdersCustomBatchRequestEntrySetLineItemMetadata"
},
"merchantId": {
"format": "uint64",
"type": "string",
"description": "The ID of the managing account."
},
"orderId": {
"type": "string",
"description": "The ID of the order. Required for all methods beside `getByMerchantOrderId`."
},
"updateLineItemShippingDetails": {
"$ref": "OrdersCustomBatchRequestEntryUpdateLineItemShippingDetails",
"description": "Required for `updateLineItemShippingDate` method."
},
"returnRefundLineItem": {
"description": "Required for `returnRefundLineItem` method.",
"$ref": "OrdersCustomBatchRequestEntryReturnRefundLineItem"
},
"operationId": {
"description": "The ID of the operation. Unique across all operations for a given order. Required for all methods beside `get` and `getByMerchantOrderId`.",
"type": "string"
},
"updateShipment": {
"$ref": "OrdersCustomBatchRequestEntryUpdateShipment",
"description": "Required for `updateShipment` method."
},
"cancelLineItem": {
"description": "Required for `cancelLineItem` method.",
"$ref": "OrdersCustomBatchRequestEntryCancelLineItem"
},
"shipLineItems": {
"description": "Required for `shipLineItems` method.",
"$ref": "OrdersCustomBatchRequestEntryShipLineItems"
},
"merchantOrderId": {
"description": "The merchant order ID. Required for `updateMerchantOrderId` and `getByMerchantOrderId` methods.",
"type": "string"
},
"rejectReturnLineItem": {
"$ref": "OrdersCustomBatchRequestEntryRejectReturnLineItem",
"description": "Required for `rejectReturnLineItem` method."
},
"cancel": {
"$ref": "OrdersCustomBatchRequestEntryCancel",
"description": "Required for `cancel` method."
},
"returnLineItem": {
"description": "Required for `returnLineItem` method.",
"$ref": "OrdersCustomBatchRequestEntryReturnLineItem"
}
},
"type": "object"
},
"OrdersListResponse": {
"properties": {
"nextPageToken": {
"type": "string",
"description": "The token for the retrieval of the next page of orders."
},
"kind": {
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#ordersListResponse\".",
"type": "string"
},
"resources": {
"type": "array",
"items": {
"$ref": "Order"
}
}
},
"id": "OrdersListResponse",
"type": "object"
},
"OrdersCustomBatchRequestEntryCancel": {
"id": "OrdersCustomBatchRequestEntryCancel",
"type": "object",
"properties": {
"reason": {
"type": "string",
"description": "The reason for the cancellation. Acceptable values are: - \"`customerInitiatedCancel`\" - \"`invalidCoupon`\" - \"`malformedShippingAddress`\" - \"`noInventory`\" - \"`other`\" - \"`priceError`\" - \"`shippingPriceError`\" - \"`taxError`\" - \"`undeliverableShippingAddress`\" - \"`unsupportedPoBoxAddress`\" "
},
"reasonText": {
"type": "string",
"description": "The explanation of the reason."
}
}
},
"PostalCodeRange": {
"id": "PostalCodeRange",
"properties": {
"postalCodeRangeBegin": {
"type": "string",
"description": "A postal code or a pattern of the form `prefix*` denoting the inclusive lower bound of the range defining the area. Examples values: `\"94108\"`, `\"9410*\"`, `\"9*\"`. Required."
},
"postalCodeRangeEnd": {
"description": "A postal code or a pattern of the form `prefix*` denoting the inclusive upper bound of the range defining the area. It must have the same length as `postalCodeRangeBegin`: if `postalCodeRangeBegin` is a postal code then `postalCodeRangeEnd` must be a postal code too; if `postalCodeRangeBegin` is a pattern then `postalCodeRangeEnd` must be a pattern with the same prefix length. Optional: if not set, then the area is defined as being all the postal codes matching `postalCodeRangeBegin`.",
"type": "string"
}
},
"type": "object"
},
"UnitInvoiceAdditionalCharge": {
"properties": {
"additionalChargeAmount": {
"$ref": "Amount",
"description": "[required] Amount of the additional charge."
},
"type": {
"type": "string",
"description": "[required] Type of the additional charge. Acceptable values are: - \"`shipping`\" "
},
"additionalChargePromotions": {
"items": {
"$ref": "Promotion"
},
"description": "Deprecated.",
"type": "array"
}
},
"type": "object",
"id": "UnitInvoiceAdditionalCharge"
},
"DatafeedsCustomBatchRequest": {
"type": "object",
"properties": {
"entries": {
"items": {
"$ref": "DatafeedsCustomBatchRequestEntry"
},
"description": "The request entries to be processed in the batch.",
"type": "array"
}
},
"id": "DatafeedsCustomBatchRequest"
},
"OrdersUpdateLineItemShippingDetailsResponse": {
"id": "OrdersUpdateLineItemShippingDetailsResponse",
"properties": {
"executionStatus": {
"description": "The status of the execution. Acceptable values are: - \"`duplicate`\" - \"`executed`\" ",
"type": "string"
},
"kind": {
"type": "string",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#ordersUpdateLineItemShippingDetailsResponse\"."
}
},
"type": "object"
},
"OrdersCreateTestReturnResponse": {
"id": "OrdersCreateTestReturnResponse",
"properties": {
"kind": {
"type": "string",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#ordersCreateTestReturnResponse\"."
},
"returnId": {
"description": "The ID of the newly created test order return.",
"type": "string"
}
},
"type": "object"
},
"GmbAccountsGmbAccount": {
"id": "GmbAccountsGmbAccount",
"properties": {
"email": {
"type": "string",
"description": "The email which identifies the GMB account."
},
"listingCount": {
"format": "uint64",
"description": "Number of listings under this account.",
"type": "string"
},
"type": {
"type": "string",
"description": "The type of the GMB account (User or Business)."
},
"name": {
"description": "The name of the GMB account.",
"type": "string"
}
},
"type": "object"
},
"ProductAmount": {
"id": "ProductAmount",
"properties": {
"priceAmount": {
"description": "The pre-tax or post-tax price depending on the location of the order.",
"$ref": "Price"
},
"taxAmount": {
"$ref": "Price",
"description": "Tax value."
},
"remittedTaxAmount": {
"$ref": "Price",
"description": "Remitted tax value."
}
},
"type": "object"
},
"PosDataProvidersPosDataProvider": {
"type": "object",
"id": "PosDataProvidersPosDataProvider",
"properties": {
"providerId": {
"format": "uint64",
"type": "string",
"description": "The ID of the account."
},
"displayName": {
"type": "string",
"description": "The display name of Pos data Provider."
},
"fullName": {
"description": "The full name of this POS data Provider.",
"type": "string"
}
}
},
"PosDataProviders": {
"properties": {
"country": {
"type": "string",
"description": "Country code."
},
"posDataProviders": {
"items": {
"$ref": "PosDataProvidersPosDataProvider"
},
"description": "A list of POS data providers.",
"type": "array"
}
},
"id": "PosDataProviders",
"type": "object"
},
"AccountsLinkResponse": {
"type": "object",
"properties": {
"kind": {
"type": "string",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#accountsLinkResponse\"."
}
},
"id": "AccountsLinkResponse"
},
"AccountsCustomBatchRequestEntry": {
"properties": {
"labelIds": {
"description": "Label IDs for the 'updatelabels' request.",
"items": {
"type": "string",
"format": "uint64"
},
"type": "array"
},
"accountId": {
"format": "uint64",
"description": "The ID of the targeted account. Only defined if the method is not `insert`.",
"type": "string"
},
"overwrite": {
"type": "boolean",
"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."
},
"force": {
"type": "boolean",
"description": "Whether the account should be deleted if the account has offers. Only applicable if the method is `delete`."
},
"account": {
"$ref": "Account",
"description": "The account to create or update. Only defined if the method is `insert` or `update`."
},
"batchId": {
"format": "uint32",
"description": "An entry ID, unique within the batch request.",
"type": "integer"
},
"linkRequest": {
"$ref": "AccountsCustomBatchRequestEntryLinkRequest",
"description": "Details about the `link` request."
},
"merchantId": {
"type": "string",
"format": "uint64",
"description": "The ID of the managing account."
},
"method": {
"description": "The method of the batch entry. Acceptable values are: - \"`claimWebsite`\" - \"`delete`\" - \"`get`\" - \"`insert`\" - \"`link`\" - \"`update`\" ",
"type": "string"
}
},
"description": "A batch entry encoding a single non-batch accounts request.",
"id": "AccountsCustomBatchRequestEntry",
"type": "object"
},
"PosCustomBatchRequestEntry": {
"id": "PosCustomBatchRequestEntry",
"properties": {
"storeCode": {
"type": "string",
"description": "The store code. This should be set only if the method is `delete` or `get`."
},
"inventory": {
"$ref": "PosInventory",
"description": "The inventory to submit. This should be set only if the method is `inventory`."
},
"targetMerchantId": {
"format": "uint64",
"description": "The ID of the account for which to get/submit data.",
"type": "string"
},
"batchId": {
"type": "integer",
"description": "An entry ID, unique within the batch request.",
"format": "uint32"
},
"method": {
"description": "The method of the batch entry. Acceptable values are: - \"`delete`\" - \"`get`\" - \"`insert`\" - \"`inventory`\" - \"`sale`\" ",
"type": "string"
},
"sale": {
"description": "The sale information to submit. This should be set only if the method is `sale`.",
"$ref": "PosSale"
},
"store": {
"description": "The store information to submit. This should be set only if the method is `insert`.",
"$ref": "PosStore"
},
"merchantId": {
"format": "uint64",
"type": "string",
"description": "The ID of the POS data provider."
}
},
"type": "object"
},
"OrderReturn": {
"type": "object",
"id": "OrderReturn",
"properties": {
"actor": {
"type": "string",
"description": "The actor that created the refund. Acceptable values are: - \"`customer`\" - \"`googleBot`\" - \"`googleCustomerService`\" - \"`googlePayments`\" - \"`googleSabre`\" - \"`merchant`\" "
},
"reasonText": {
"type": "string",
"description": "The explanation of the reason."
},
"creationDate": {
"type": "string",
"description": "Date on which the item has been created, in ISO 8601 format."
},
"quantity": {
"format": "uint32",
"type": "integer",
"description": "Quantity that is returned."
},
"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"
}
}
},
"ShippingsettingsCustomBatchResponse": {
"id": "ShippingsettingsCustomBatchResponse",
"properties": {
"kind": {
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#shippingsettingsCustomBatchResponse\".",
"type": "string"
},
"entries": {
"type": "array",
"description": "The result of the execution of the batch requests.",
"items": {
"$ref": "ShippingsettingsCustomBatchResponseEntry"
}
}
},
"type": "object"
},
"InventorySetRequest": {
"properties": {
"price": {
"description": "The price of the product.",
"$ref": "Price"
},
"pickup": {
"$ref": "InventoryPickup",
"description": "Store pickup information. Only supported for local inventory. Not setting `pickup` means \"don't update\" while setting it to the empty value (`{}` in JSON) means \"delete\". Otherwise, `pickupMethod` and `pickupSla` must be set together, unless `pickupMethod` is \"not supported\"."
},
"availability": {
"type": "string",
"description": "The availability of the product. Acceptable values are: - \"`in stock`\" - \"`out of stock`\" - \"`preorder`\" "
},
"instoreProductLocation": {
"description": "The instore product location. Supported only for local products.",
"type": "string"
},
"customLabel0": {
"description": "Custom label 0 for custom grouping of items in a Shopping campaign. Only supported for online products.",
"type": "string"
},
"salePrice": {
"$ref": "Price",
"description": "The sale price of the product. Mandatory if `sale_price_effective_date` is defined."
},
"loyaltyPoints": {
"$ref": "LoyaltyPoints",
"description": "Loyalty points that users receive after purchasing the item. Japan only."
},
"installment": {
"$ref": "Installment",
"description": "Number and amount of installments to pay for an item. Brazil only."
},
"salePriceEffectiveDate": {
"type": "string",
"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."
},
"sellOnGoogleQuantity": {
"format": "uint32",
"description": "The quantity of the product that is available for selling on Google. Supported only for online products.",
"type": "integer"
},
"quantity": {
"description": "The quantity of the product. Must be equal to or greater than zero. Supported only for local products.",
"type": "integer",
"format": "uint32"
},
"customLabel2": {
"type": "string",
"description": "Custom label 2 for custom grouping of items in a Shopping campaign. Only supported for online products."
},
"customLabel1": {
"type": "string",
"description": "Custom label 1 for custom grouping of items in a Shopping campaign. Only supported for online products."
},
"customLabel3": {
"description": "Custom label 3 for custom grouping of items in a Shopping campaign. Only supported for online products.",
"type": "string"
},
"customLabel4": {
"type": "string",
"description": "Custom label 3 for custom grouping of items in a Shopping campaign. Only supported for online products."
}
},
"id": "InventorySetRequest",
"type": "object"
},
"RateGroup": {
"id": "RateGroup",
"properties": {
"singleValue": {
"$ref": "Value",
"description": "The value of the rate group (e.g. flat rate $10). Can only be set if `mainTable` and `subtables` are not set."
},
"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"
},
"applicableShippingLabels": {
"description": "A list of shipping labels defining the products to which this rate group applies to. This is a disjunction: only one of the labels has to match for the rate group to apply. May only be empty for the last rate group of a service. Required.",
"items": {
"type": "string"
},
"type": "array"
},
"carrierRates": {
"type": "array",
"items": {
"$ref": "CarrierRate"
},
"description": "A list of carrier rates that can be referred to by `mainTable` or `singleValue`."
},
"name": {
"type": "string",
"description": "Name of the rate group. Optional. If set has to be unique within shipping service."
},
"subtables": {
"description": "A list of subtables referred to by `mainTable`. Can only be set if `mainTable` is set.",
"items": {
"$ref": "Table"
},
"type": "array"
}
},
"type": "object"
},
"AccountsAuthInfoResponse": {
"id": "AccountsAuthInfoResponse",
"type": "object",
"properties": {
"kind": {
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#accountsAuthInfoResponse\".",
"type": "string"
},
"accountIdentifiers": {
"type": "array",
"items": {
"$ref": "AccountIdentifier"
},
"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. "
}
}
},
"DatafeedTarget": {
"id": "DatafeedTarget",
"properties": {
"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 for this target (corresponds to checked check boxes in Merchant Center). Default destinations are always included unless provided in `excludedDestinations`. List of supported destinations (if available to the account): - DisplayAds - Shopping - ShoppingActions - SurfacesAcrossGoogle ",
"items": {
"type": "string"
},
"type": "array"
},
"excludedDestinations": {
"type": "array",
"items": {
"type": "string"
},
"description": "The list of destinations to exclude for this target (corresponds to unchecked check boxes in Merchant Center)."
},
"country": {
"description": "The country where the items in the feed will be included in the search index, represented as a CLDR territory code.",
"type": "string"
}
},
"type": "object"
},
"OrdersReturnLineItemRequest": {
"properties": {
"lineItemId": {
"description": "The ID of the line item to return. Either lineItemId or productId is required.",
"type": "string"
},
"reason": {
"type": "string",
"description": "The reason for the return. Acceptable values are: - \"`customerDiscretionaryReturn`\" - \"`customerInitiatedMerchantCancel`\" - \"`deliveredTooLate`\" - \"`expiredItem`\" - \"`invalidCoupon`\" - \"`malformedShippingAddress`\" - \"`other`\" - \"`productArrivedDamaged`\" - \"`productNotAsDescribed`\" - \"`qualityNotAsExpected`\" - \"`undeliverableShippingAddress`\" - \"`unsupportedPoBoxAddress`\" - \"`wrongProductShipped`\" "
},
"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"
},
"reasonText": {
"description": "The explanation of the reason.",
"type": "string"
},
"operationId": {
"description": "The ID of the operation. Unique across all operations for a given order.",
"type": "string"
},
"quantity": {
"format": "uint32",
"type": "integer",
"description": "The quantity to return."
}
},
"type": "object",
"id": "OrdersReturnLineItemRequest"
},
"LoyaltyPoints": {
"id": "LoyaltyPoints",
"properties": {
"pointsValue": {
"format": "int64",
"type": "string",
"description": "The retailer's loyalty points in absolute value."
},
"ratio": {
"type": "number",
"description": "The ratio of a point when converted to currency. Google assumes currency based on Merchant Center settings. If ratio is left out, it defaults to 1.0.",
"format": "double"
},
"name": {
"description": "Name of loyalty points program. It is recommended to limit the name to 12 full-width characters or 24 Roman characters.",
"type": "string"
}
},
"type": "object"
},
"ProductstatusesCustomBatchResponse": {
"properties": {
"kind": {
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#productstatusesCustomBatchResponse\".",
"type": "string"
},
"entries": {
"description": "The result of the execution of the batch requests.",
"items": {
"$ref": "ProductstatusesCustomBatchResponseEntry"
},
"type": "array"
}
},
"type": "object",
"id": "ProductstatusesCustomBatchResponse"
},
"OrdersCustomBatchRequestEntryRejectReturnLineItem": {
"properties": {
"productId": {
"type": "string",
"description": "The ID of the product to return. This is the REST ID used in the products service. Either lineItemId or productId is required."
},
"lineItemId": {
"description": "The ID of the line item to return. Either lineItemId or productId is required.",
"type": "string"
},
"quantity": {
"type": "integer",
"format": "uint32",
"description": "The quantity to return and refund."
},
"reasonText": {
"type": "string",
"description": "The explanation of the reason."
},
"reason": {
"description": "The reason for the return. Acceptable values are: - \"`damagedOrUsed`\" - \"`missingComponent`\" - \"`notEligible`\" - \"`other`\" - \"`outOfReturnWindow`\" ",
"type": "string"
}
},
"type": "object",
"id": "OrdersCustomBatchRequestEntryRejectReturnLineItem"
},
"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.",
"format": "uint32",
"type": "integer"
},
"datafeed": {
"description": "The requested data feed. Defined if and only if the request was successful.",
"$ref": "Datafeed"
},
"errors": {
"$ref": "Errors",
"description": "A list of errors defined if and only if the request failed."
}
}
},
"DatafeedstatusesCustomBatchRequestEntry": {
"properties": {
"country": {
"type": "string",
"description": "The country for which to get the datafeed status. If this parameter is provided then language must also be provided. Note that for multi-target datafeeds this parameter is required."
},
"datafeedId": {
"format": "uint64",
"description": "The ID of the data feed to get.",
"type": "string"
},
"batchId": {
"description": "An entry ID, unique within the batch request.",
"type": "integer",
"format": "uint32"
},
"method": {
"description": "The method of the batch entry. Acceptable values are: - \"`get`\" ",
"type": "string"
},
"merchantId": {
"format": "uint64",
"description": "The ID of the managing account.",
"type": "string"
},
"language": {
"description": "The language for which to get the datafeed status. If this parameter is provided then country must also be provided. Note that for multi-target datafeeds this parameter is required.",
"type": "string"
}
},
"id": "DatafeedstatusesCustomBatchRequestEntry",
"description": "A batch entry encoding a single non-batch datafeedstatuses request.",
"type": "object"
},
"OrdersRefundResponse": {
"id": "OrdersRefundResponse",
"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#ordersRefundResponse\".",
"type": "string"
}
},
"type": "object"
},
"OrdersCustomBatchRequestEntryRefund": {
"type": "object",
"properties": {
"amount": {
"$ref": "Price",
"description": "Deprecated. Please use amountPretax and amountTax instead."
},
"reason": {
"type": "string",
"description": "The reason for the refund. Acceptable values are: - \"`adjustment`\" - \"`courtesyAdjustment`\" - \"`customerCanceled`\" - \"`customerDiscretionaryReturn`\" - \"`deliveredLateByCarrier`\" - \"`feeAdjustment`\" - \"`lateShipmentCredit`\" - \"`noInventory`\" - \"`other`\" - \"`priceError`\" - \"`productArrivedDamaged`\" - \"`productNotAsDescribed`\" - \"`shippingCostAdjustment`\" - \"`taxAdjustment`\" - \"`undeliverableShippingAddress`\" - \"`wrongProductShipped`\" "
},
"amountPretax": {
"$ref": "Price",
"description": "The amount that is refunded. Either amount or amountPretax should be filled."
},
"reasonText": {
"description": "The explanation of the reason.",
"type": "string"
},
"amountTax": {
"$ref": "Price",
"description": "Tax amount that corresponds to refund amount in amountPretax. Optional, but if filled, amountPretax must be set. Calculated automatically if not provided."
}
},
"id": "OrdersCustomBatchRequestEntryRefund"
},
"Product": {
"description": " Required product attributes are primarily defined by the products data specification. See the Products Data Specification Help Center article for information. Some attributes are country-specific, so make sure you select the appropriate country in the drop-down selector at the top of the page. Product data. After inserting, updating, or deleting a product, it may take several minutes before changes take effect.",
"id": "Product",
"properties": {
"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"
},
"minEnergyEfficiencyClass": {
"description": "The energy efficiency class as defined in EU directive 2010/30/EU. Acceptable values are: - \"`A`\" - \"`A+`\" - \"`A++`\" - \"`A+++`\" - \"`B`\" - \"`C`\" - \"`D`\" - \"`E`\" - \"`F`\" - \"`G`\" ",
"type": "string"
},
"contentLanguage": {
"type": "string",
"description": "Required. The two-letter ISO 639-1 language code for the item."
},
"taxes": {
"items": {
"$ref": "ProductTax"
},
"type": "array",
"description": "Tax information."
},
"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"
},
"adult": {
"type": "boolean",
"description": "Should be set to true if the item is targeted towards adults."
},
"displayAdsLink": {
"type": "string",
"description": "URL directly to your item's landing page for dynamic remarketing campaigns."
},
"customLabel4": {
"description": "Custom label 4 for custom grouping of items in a Shopping campaign.",
"type": "string"
},
"customLabel1": {
"type": "string",
"description": "Custom label 1 for custom grouping of items in a Shopping campaign."
},
"id": {
"type": "string",
"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 is of the form channel:contentLanguage: targetCountry: offerId."
},
"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"
},
"adwordsLabels": {
"items": {
"type": "string"
},
"type": "array",
"description": "Similar to adwords_grouping, but only works on CPC."
},
"sizeSystem": {
"description": "System in which the size is specified. Recommended for apparel items. Acceptable values are: - \"`AU`\" - \"`BR`\" - \"`CN`\" - \"`DE`\" - \"`EU`\" - \"`FR`\" - \"`IT`\" - \"`JP`\" - \"`MEX`\" - \"`UK`\" - \"`US`\" ",
"type": "string"
},
"offerId": {
"type": "string",
"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."
},
"sellOnGoogleQuantity": {
"type": "string",
"description": "The quantity of the product that is available for selling on Google. Supported only for online products.",
"format": "int64"
},
"salePrice": {
"$ref": "Price",
"description": "Advertised sale price of the item."
},
"link": {
"description": "URL directly linking to your item's page on your website.",
"type": "string"
},
"loyaltyPoints": {
"$ref": "LoyaltyPoints",
"description": "Loyalty points that users receive after purchasing the item. Japan only."
},
"targetCountry": {
"description": "Required. The CLDR territory code for the item.",
"type": "string"
},
"displayAdsValue": {
"type": "number",
"format": "double",
"description": "Offer margin for dynamic remarketing campaigns."
},
"price": {
"description": "Price of the item.",
"$ref": "Price"
},
"additionalImageLinks": {
"description": "Additional URLs of images of the item.",
"items": {
"type": "string"
},
"type": "array"
},
"customAttributes": {
"items": {
"$ref": "CustomAttribute"
},
"type": "array",
"description": "A list of custom (merchant-provided) attributes. It can also be used for submitting any attribute of the feed specification in its generic form (e.g., `{ \"name\": \"size type\", \"value\": \"regular\" }`). This is useful for submitting attributes not explicitly exposed by the API, such as additional attributes used for Buy on Google (formerly known as Shopping Actions)."
},
"displayAdsId": {
"type": "string",
"description": "An identifier for an item for dynamic remarketing campaigns."
},
"installment": {
"description": "Number and amount of installments to pay for an item.",
"$ref": "Installment"
},
"multipack": {
"format": "int64",
"type": "string",
"description": "The number of identical products in a merchant-defined multipack."
},
"pattern": {
"description": "The item's pattern (e.g. polka dots).",
"type": "string"
},
"adwordsGrouping": {
"type": "string",
"description": "Used to group items in an arbitrary way. Only for CPA%, discouraged otherwise."
},
"unitPricingBaseMeasure": {
"description": "The preference of the denominator of the unit price.",
"$ref": "ProductUnitPricingBaseMeasure"
},
"shippingWidth": {
"$ref": "ProductShippingDimension",
"description": "Width of the item for shipping."
},
"itemGroupId": {
"description": "Shared identifier for all variants of the same product.",
"type": "string"
},
"onlineOnly": {
"type": "boolean",
"description": "Deprecated."
},
"gtin": {
"description": "Global Trade Item Number (GTIN) of the item.",
"type": "string"
},
"mpn": {
"type": "string",
"description": "Manufacturer Part Number (MPN) of the item."
},
"shippingWeight": {
"$ref": "ProductShippingWeight",
"description": "Weight of the item for shipping."
},
"description": {
"type": "string",
"description": "Description of the item."
},
"displayAdsSimilarIds": {
"items": {
"type": "string"
},
"type": "array",
"description": "Advertiser-specified recommendations."
},
"aspects": {
"type": "array",
"items": {
"$ref": "ProductAspect"
},
"description": "Deprecated. Do not use."
},
"shippingLength": {
"description": "Length of the item for shipping.",
"$ref": "ProductShippingDimension"
},
"customGroups": {
"description": "A list of custom (merchant-provided) custom attribute groups.",
"type": "array",
"items": {
"$ref": "CustomGroup"
}
},
"costOfGoodsSold": {
"$ref": "Price",
"description": "Cost of goods sold. Used for gross profit reporting."
},
"color": {
"description": "Color of the item.",
"type": "string"
},
"brand": {
"type": "string",
"description": "Brand of the item."
},
"ageGroup": {
"description": "Target age group of the item. Acceptable values are: - \"`adult`\" - \"`infant`\" - \"`kids`\" - \"`newborn`\" - \"`toddler`\" - \"`youngAdult`\" ",
"type": "string"
},
"customLabel2": {
"description": "Custom label 2 for custom grouping of items in a Shopping campaign.",
"type": "string"
},
"displayAdsTitle": {
"type": "string",
"description": "Title of an item for dynamic remarketing campaigns."
},
"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"
},
"channel": {
"type": "string",
"description": "Required. The item's channel (online or local). Acceptable values are: - \"`local`\" - \"`online`\" "
},
"availability": {
"description": "Availability status of the item. Acceptable values are: - \"`in stock`\" - \"`out of stock`\" - \"`preorder`\" ",
"type": "string"
},
"sizes": {
"type": "array",
"items": {
"type": "string"
},
"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)."
},
"customLabel3": {
"type": "string",
"description": "Custom label 3 for custom grouping of items in a Shopping campaign."
},
"kind": {
"description": "Identifies what kind of resource this is. Value: the fixed string \"`content#product`\"",
"type": "string"
},
"mobileLink": {
"type": "string",
"description": "URL for the mobile-optimized version of your item's landing page."
},
"validatedDestinations": {
"items": {
"type": "string"
},
"type": "array",
"description": "Deprecated. The read-only list of intended destinations which passed validation."
},
"adwordsRedirect": {
"description": "Allows advertisers to override the item URL when the product is shown within the context of Product Ads.",
"type": "string"
},
"maxEnergyEfficiencyClass": {
"type": "string",
"description": "The energy efficiency class as defined in EU directive 2010/30/EU. Acceptable values are: - \"`A`\" - \"`A+`\" - \"`A++`\" - \"`A+++`\" - \"`B`\" - \"`C`\" - \"`D`\" - \"`E`\" - \"`F`\" - \"`G`\" "
},
"canonicalLink": {
"type": "string",
"description": "URL for the canonical version of your item's landing page."
},
"destinations": {
"description": "Specifies the intended destinations for the product.",
"items": {
"$ref": "ProductDestination"
},
"type": "array"
},
"unitPricingMeasure": {
"description": "The measure and dimension of an item.",
"$ref": "ProductUnitPricingMeasure"
},
"customLabel0": {
"description": "Custom label 0 for custom grouping of items in a Shopping campaign.",
"type": "string"
},
"condition": {
"description": "Condition or state of the item. Acceptable values are: - \"`new`\" - \"`refurbished`\" - \"`used`\" ",
"type": "string"
},
"energyEfficiencyClass": {
"type": "string",
"description": "The energy efficiency class as defined in EU directive 2010/30/EU. Acceptable values are: - \"`A`\" - \"`A+`\" - \"`A++`\" - \"`A+++`\" - \"`B`\" - \"`C`\" - \"`D`\" - \"`E`\" - \"`F`\" - \"`G`\" "
},
"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"
},
"source": {
"description": "The source of the offer, i.e., how the offer was created. Acceptable values are: - \"`api`\" - \"`crawl`\" - \"`feed`\" ",
"type": "string"
},
"additionalProductTypes": {
"type": "array",
"description": "Additional categories of the item (formatted as in products data specification).",
"items": {
"type": "string"
}
},
"shipping": {
"items": {
"$ref": "ProductShipping"
},
"type": "array",
"description": "Shipping rules."
},
"promotionIds": {
"items": {
"type": "string"
},
"description": "The unique ID of a promotion.",
"type": "array"
},
"shippingHeight": {
"$ref": "ProductShippingDimension",
"description": "Height of the item for shipping."
},
"minHandlingTime": {
"type": "string",
"description": "Minimal product handling time (in business days).",
"format": "int64"
},
"sizeType": {
"description": "The cut of the item. Recommended for apparel items. Acceptable values are: - \"`big and tall`\" - \"`maternity`\" - \"`oversize`\" - \"`petite`\" - \"`plus`\" - \"`regular`\" ",
"type": "string"
},
"productType": {
"type": "string",
"description": "Your category of the item (formatted as in products data specification)."
},
"gender": {
"description": "Target gender of the item. Acceptable values are: - \"`female`\" - \"`male`\" - \"`unisex`\" ",
"type": "string"
},
"warnings": {
"type": "array",
"description": "Read-only warnings.",
"items": {
"$ref": "Error"
}
},
"salePriceEffectiveDate": {
"description": "Date range during which the item is on sale (see products data specification ).",
"type": "string"
},
"title": {
"description": "Title of the item.",
"type": "string"
},
"maxHandlingTime": {
"description": "Maximal product handling time (in business days).",
"format": "int64",
"type": "string"
},
"imageLink": {
"description": "URL of an image of the item.",
"type": "string"
},
"material": {
"type": "string",
"description": "The material of which the item is made."
}
},
"type": "object"
},
"PosSale": {
"id": "PosSale",
"description": "The change of the available quantity of an item at the given store.",
"type": "object",
"properties": {
"price": {
"$ref": "Price",
"description": "Required. The price of the item."
},
"kind": {
"type": "string",
"description": "Identifies what kind of resource this is. Value: the fixed string \"`content#posSale`\""
},
"itemId": {
"type": "string",
"description": "Required. A unique identifier for the item."
},
"gtin": {
"type": "string",
"description": "Global Trade Item Number."
},
"timestamp": {
"description": "Required. The inventory timestamp, in ISO 8601 format.",
"type": "string"
},
"quantity": {
"description": "Required. The relative change of the available quantity. Negative for items returned.",
"type": "string",
"format": "int64"
},
"saleId": {
"description": "A unique ID to group items from the same sale event.",
"type": "string"
},
"targetCountry": {
"type": "string",
"description": "Required. The CLDR territory code for the item."
},
"contentLanguage": {
"type": "string",
"description": "Required. The two-letter ISO 639-1 language code for the item."
},
"storeCode": {
"description": "Required. The identifier of the merchant's store. Either a `storeCode` inserted via the API or the code of the store in Google My Business.",
"type": "string"
}
}
},
"OrdersCustomBatchRequestEntryShipLineItemsShipmentInfo": {
"id": "OrdersCustomBatchRequestEntryShipLineItemsShipmentInfo",
"properties": {
"carrier": {
"type": "string",
"description": "The carrier handling the shipment. See `shipments[].carrier` in the Orders resource representation for a list of acceptable values."
},
"shipmentId": {
"type": "string",
"description": "Required. The ID of the shipment. This is assigned by the merchant and is unique to each shipment."
},
"trackingId": {
"type": "string",
"description": "The tracking ID for the shipment."
}
},
"type": "object"
},
"AccountstatusesCustomBatchRequestEntry": {
"type": "object",
"description": "A batch entry encoding a single non-batch accountstatuses request.",
"id": "AccountstatusesCustomBatchRequestEntry",
"properties": {
"accountId": {
"type": "string",
"format": "uint64",
"description": "The ID of the (sub-)account whose status to get."
},
"merchantId": {
"description": "The ID of the managing account.",
"type": "string",
"format": "uint64"
},
"batchId": {
"format": "uint32",
"type": "integer",
"description": "An entry ID, unique within the batch request."
},
"destinations": {
"description": "If set, only issues for the specified destinations are returned, otherwise only issues for the Shopping destination.",
"items": {
"type": "string"
},
"type": "array"
},
"method": {
"type": "string",
"description": "The method of the batch entry. Acceptable values are: - \"`get`\" "
}
}
},
"DeliveryTime": {
"id": "DeliveryTime",
"properties": {
"handlingBusinessDayConfig": {
"description": "The business days during which orders can be handled. If not provided, Monday to Friday business days will be assumed.",
"$ref": "BusinessDayConfig"
},
"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"
},
"holidayCutoffs": {
"type": "array",
"items": {
"$ref": "HolidayCutoff"
},
"description": "Holiday cutoff definitions. If configured, they specify order cutoff times for holiday-specific shipping."
},
"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"
},
"cutoffTime": {
"description": "Business days cutoff time definition. If not configured the cutoff time will be defaulted to 8AM PST.",
"$ref": "CutoffTime"
},
"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"
},
"minTransitTimeInDays": {
"format": "uint32",
"type": "integer",
"description": "Minimum number of business days that is spent in transit. 0 means same day delivery, 1 means next day delivery. Either `{min,max}TransitTimeInDays` or `transitTimeTable` must be set, but not both."
},
"transitBusinessDayConfig": {
"$ref": "BusinessDayConfig",
"description": "The business days during which orders can be in-transit. If not provided, Monday to Friday business days will be assumed."
},
"maxTransitTimeInDays": {
"description": "Maximum number of business days that is spent in transit. 0 means same day delivery, 1 means next day delivery. Must be greater than or equal to `minTransitTimeInDays`.",
"format": "uint32",
"type": "integer"
}
},
"type": "object"
},
"OrdersCreateTestOrderRequest": {
"properties": {
"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"
},
"testOrder": {
"$ref": "TestOrder",
"description": "The test order to create."
},
"country": {
"type": "string",
"description": "The CLDR territory code of the country of the test order to create. Affects the currency and addresses of orders created via `template_name`, or the addresses of orders created via `test_order`. Acceptable values are: - \"`US`\" - \"`FR`\" Defaults to `US`."
}
},
"id": "OrdersCreateTestOrderRequest",
"type": "object"
},
"Order": {
"type": "object",
"id": "Order",
"properties": {
"acknowledged": {
"description": "Whether the order was acknowledged.",
"type": "boolean"
},
"merchantOrderId": {
"type": "string",
"description": "Merchant-provided ID of the order."
},
"pickupDetails": {
"$ref": "OrderPickupDetails",
"description": "Pickup details for shipments of type `pickup`."
},
"lineItems": {
"items": {
"$ref": "OrderLineItem"
},
"description": "Line items that are ordered.",
"type": "array"
},
"id": {
"type": "string",
"description": "The REST ID of the order. Globally unique."
},
"shipments": {
"description": "Shipments of the order.",
"items": {
"$ref": "OrderShipment"
},
"type": "array"
},
"promotions": {
"type": "array",
"items": {
"$ref": "OrderLegacyPromotion"
},
"description": "The details of the merchant provided promotions applied to the order. To determine which promotions apply to which products, check the `Promotions[].Benefits[].OfferIds` field against the `LineItems[].Product.OfferId` 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 the line item level discount for a single specific item: For each promotion, subtract the `Promotions[].Benefits[].Discount.value` amount from the `LineItems[].Price.value`. 2. To calculate the line item level discount for multiple quantity of a specific item: For each promotion, divide the `Promotions[].Benefits[].Discount.value` by the quantity of products and substract it from `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."
},
"kind": {
"type": "string",
"description": "Identifies what kind of resource this is. Value: the fixed string \"`content#order`\""
},
"shippingCostTax": {
"description": "The tax for the total shipping cost.",
"$ref": "Price"
},
"shippingCost": {
"$ref": "Price",
"description": "The total cost of shipping for all items."
},
"channelType": {
"type": "string",
"description": "Deprecated. Acceptable values are: - \"`googleExpress`\" - \"`purchasesOnGoogle`\" "
},
"merchantId": {
"type": "string",
"format": "uint64"
},
"paymentStatus": {
"description": "The status of the payment. Acceptable values are: - \"`paymentCaptured`\" - \"`paymentRejected`\" - \"`paymentSecured`\" - \"`pendingAuthorization`\" ",
"type": "string"
},
"placedDate": {
"description": "The date when the order was placed, in ISO 8601 format.",
"type": "string"
},
"netAmount": {
"description": "The net amount for the order. For example, if an order was originally for a grand total of $100 and a refund was issued for $20, the net amount will be $80.",
"$ref": "Price"
},
"taxCollector": {
"type": "string",
"description": "The party responsible for collecting and remitting taxes. Acceptable values are: - \"`marketplaceFacilitator`\" - \"`merchant`\" "
},
"status": {
"description": "The status of the order. Acceptable values are: - \"`canceled`\" - \"`delivered`\" - \"`inProgress`\" - \"`partiallyDelivered`\" - \"`partiallyReturned`\" - \"`partiallyShipped`\" - \"`pendingShipment`\" - \"`returned`\" - \"`shipped`\" ",
"type": "string"
},
"refunds": {
"type": "array",
"description": "Refunds for the order.",
"items": {
"$ref": "OrderRefund"
}
},
"shippingOption": {
"type": "string",
"description": "Deprecated. Shipping details are provided with line items instead. Acceptable values are: - \"`economy`\" - \"`expedited`\" - \"`oneDay`\" - \"`sameDay`\" - \"`standard`\" - \"`twoDay`\" "
},
"deliveryDetails": {
"description": "Delivery details for shipments of type `delivery`.",
"$ref": "OrderDeliveryDetails"
},
"customer": {
"description": "The details of the customer who placed the order.",
"$ref": "OrderCustomer"
},
"paymentMethod": {
"description": "The details of the payment method.",
"$ref": "OrderPaymentMethod"
}
},
"description": "Order. Production access (all methods) requires the order manager role. Sandbox access does not."
},
"TestOrder": {
"type": "object",
"properties": {
"paymentMethod": {
"description": "The details of the payment method.",
"$ref": "TestOrderPaymentMethod"
},
"enableOrderinvoices": {
"type": "boolean",
"description": "Whether the orderinvoices service should support this order."
},
"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"
},
"kind": {
"description": "Identifies what kind of resource this is. Value: the fixed string \"`content#testOrder`\"",
"type": "string"
},
"promotions": {
"items": {
"$ref": "OrderLegacyPromotion"
},
"description": "Deprecated. Ignored if provided.",
"type": "array"
},
"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"
},
"predefinedDeliveryAddress": {
"type": "string",
"description": "Required. Identifier of one of the predefined delivery addresses for the delivery. Acceptable values are: - \"`dwight`\" - \"`jim`\" - \"`pam`\" "
},
"shippingCostTax": {
"description": "Deprecated. Ignored if provided.",
"$ref": "Price"
},
"lineItems": {
"type": "array",
"description": "Required. Line items that are ordered. At least one line item must be provided.",
"items": {
"$ref": "TestOrderLineItem"
}
},
"notificationMode": {
"description": "Restricted. Do not use.",
"type": "string"
},
"customer": {
"$ref": "TestOrderCustomer",
"description": "Required. The details of the customer who placed the order."
},
"shippingOption": {
"type": "string",
"description": "Required. The requested shipping option. Acceptable values are: - \"`economy`\" - \"`expedited`\" - \"`oneDay`\" - \"`sameDay`\" - \"`standard`\" - \"`twoDay`\" "
}
},
"id": "TestOrder"
},
"OrdersCreateTestOrderResponse": {
"type": "object",
"properties": {
"orderId": {
"type": "string",
"description": "The ID of the newly created test order."
},
"kind": {
"type": "string",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#ordersCreateTestOrderResponse\"."
}
},
"id": "OrdersCreateTestOrderResponse"
},
"InventoryCustomBatchResponseEntry": {
"properties": {
"kind": {
"type": "string",
"description": "Identifies what kind of resource this is. Value: the fixed string \"`content#inventoryCustomBatchResponseEntry`\""
},
"batchId": {
"format": "uint32",
"type": "integer",
"description": "The ID of the request entry this entry responds to."
},
"errors": {
"description": "A list of errors defined if and only if the request failed.",
"$ref": "Errors"
}
},
"description": "A batch entry encoding a single non-batch inventory response.",
"type": "object",
"id": "InventoryCustomBatchResponseEntry"
},
"TransitTableTransitTimeRow": {
"properties": {
"values": {
"type": "array",
"items": {
"$ref": "TransitTableTransitTimeRowTransitTimeValue"
}
}
},
"id": "TransitTableTransitTimeRow",
"type": "object"
},
"MinimumOrderValueTable": {
"type": "object",
"properties": {
"storeCodeSetWithMovs": {
"items": {
"$ref": "MinimumOrderValueTableStoreCodeSetWithMov"
},
"type": "array"
}
},
"id": "MinimumOrderValueTable"
},
"OrderinvoicesCreateChargeInvoiceResponse": {
"properties": {
"kind": {
"type": "string",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#orderinvoicesCreateChargeInvoiceResponse\"."
},
"executionStatus": {
"description": "The status of the execution. Acceptable values are: - \"`duplicate`\" - \"`executed`\" ",
"type": "string"
}
},
"type": "object",
"id": "OrderinvoicesCreateChargeInvoiceResponse"
},
"DatafeedstatusesCustomBatchResponseEntry": {
"id": "DatafeedstatusesCustomBatchResponseEntry",
"properties": {
"batchId": {
"description": "The ID of the request entry this entry responds to.",
"type": "integer",
"format": "uint32"
},
"errors": {
"description": "A list of errors defined if and only if the request failed.",
"$ref": "Errors"
},
"datafeedStatus": {
"description": "The requested data feed status. Defined if and only if the request was successful.",
"$ref": "DatafeedStatus"
}
},
"type": "object",
"description": "A batch entry encoding a single non-batch datafeedstatuses response."
},
"OrdersReturnLineItemResponse": {
"id": "OrdersReturnLineItemResponse",
"type": "object",
"properties": {
"kind": {
"type": "string",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#ordersReturnLineItemResponse\"."
},
"executionStatus": {
"description": "The status of the execution. Acceptable values are: - \"`duplicate`\" - \"`executed`\" ",
"type": "string"
}
}
},
"ProductStatus": {
"description": "The status of a product, i.e., information about a product computed asynchronously.",
"id": "ProductStatus",
"type": "object",
"properties": {
"productId": {
"type": "string",
"description": "The ID of the product for which status is reported."
},
"creationDate": {
"type": "string",
"description": "Date on which the item has been created, in ISO 8601 format."
},
"destinationStatuses": {
"type": "array",
"description": "The intended destinations for the product.",
"items": {
"$ref": "ProductStatusDestinationStatus"
}
},
"itemLevelIssues": {
"type": "array",
"items": {
"$ref": "ProductStatusItemLevelIssue"
},
"description": "A list of all issues associated with the product."
},
"kind": {
"type": "string",
"description": "Identifies what kind of resource this is. Value: the fixed string \"`content#productStatus`\""
},
"product": {
"description": "Product data after applying all the join inputs.",
"$ref": "Product"
},
"lastUpdateDate": {
"description": "Date on which the item has been last updated, in ISO 8601 format.",
"type": "string"
},
"dataQualityIssues": {
"items": {
"$ref": "ProductStatusDataQualityIssue"
},
"description": "DEPRECATED - never populated",
"type": "array"
},
"googleExpirationDate": {
"type": "string",
"description": "Date on which the item expires in Google Shopping, in ISO 8601 format."
},
"link": {
"description": "The link to the product.",
"type": "string"
},
"title": {
"type": "string",
"description": "The title of the product."
}
}
},
"LiasettingsSetInventoryVerificationContactResponse": {
"properties": {
"kind": {
"type": "string",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#liasettingsSetInventoryVerificationContactResponse\"."
}
},
"type": "object",
"id": "LiasettingsSetInventoryVerificationContactResponse"
},
"OrderDeliveryDetails": {
"id": "OrderDeliveryDetails",
"properties": {
"address": {
"$ref": "OrderAddress",
"description": "The delivery address"
},
"phoneNumber": {
"description": "The phone number of the person receiving the delivery.",
"type": "string"
}
},
"type": "object"
},
"LiasettingsCustomBatchResponse": {
"id": "LiasettingsCustomBatchResponse",
"properties": {
"kind": {
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#liasettingsCustomBatchResponse\".",
"type": "string"
},
"entries": {
"items": {
"$ref": "LiasettingsCustomBatchResponseEntry"
},
"type": "array",
"description": "The result of the execution of the batch requests."
}
},
"type": "object"
},
"PosSaleResponse": {
"id": "PosSaleResponse",
"type": "object",
"properties": {
"saleId": {
"description": "A unique ID to group items from the same sale event.",
"type": "string"
},
"targetCountry": {
"description": "Required. The CLDR territory code for the item.",
"type": "string"
},
"quantity": {
"description": "Required. The relative change of the available quantity. Negative for items returned.",
"type": "string",
"format": "int64"
},
"contentLanguage": {
"description": "Required. The two-letter ISO 639-1 language code for the item.",
"type": "string"
},
"itemId": {
"description": "Required. A unique identifier for the item.",
"type": "string"
},
"storeCode": {
"type": "string",
"description": "Required. The identifier of the merchant's store. Either a `storeCode` inserted via the API or the code of the store in Google My Business."
},
"kind": {
"type": "string",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#posSaleResponse\"."
},
"timestamp": {
"type": "string",
"description": "Required. The inventory timestamp, in ISO 8601 format."
},
"gtin": {
"type": "string",
"description": "Global Trade Item Number."
},
"price": {
"description": "Required. The price of the item.",
"$ref": "Price"
}
}
},
"InventoryPickup": {
"id": "InventoryPickup",
"properties": {
"pickupMethod": {
"description": "Whether store pickup is available for this offer and whether the pickup option should be shown as buy, reserve, or not supported. Only supported for local inventory. Unless the value is \"not supported\", must be submitted together with `pickupSla`. Acceptable values are: - \"`buy`\" - \"`not supported`\" - \"`reserve`\" - \"`ship to store`\" ",
"type": "string"
},
"pickupSla": {
"type": "string",
"description": "The expected date that an order will be ready for pickup, relative to when the order is placed. Only supported for local inventory. Must be submitted together with `pickupMethod`. Acceptable values are: - \"`five day`\" - \"`four day`\" - \"`multi day`\" - \"`multi week`\" - \"`next day`\" - \"`same day`\" - \"`seven day`\" - \"`six day`\" - \"`three day`\" - \"`two day`\" "
}
},
"type": "object"
},
"ShipmentTrackingInfo": {
"properties": {
"trackingNumber": {
"type": "string",
"description": "The tracking number for the package."
},
"carrier": {
"type": "string",
"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": "object",
"id": "ShipmentTrackingInfo"
},
"DatafeedstatusesListResponse": {
"id": "DatafeedstatusesListResponse",
"type": "object",
"properties": {
"kind": {
"type": "string",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#datafeedstatusesListResponse\"."
},
"resources": {
"items": {
"$ref": "DatafeedStatus"
},
"type": "array"
},
"nextPageToken": {
"type": "string",
"description": "The token for the retrieval of the next page of datafeed statuses."
}
}
},
"OrderreportsListDisbursementsResponse": {
"id": "OrderreportsListDisbursementsResponse",
"type": "object",
"properties": {
"nextPageToken": {
"description": "The token for the retrieval of the next page of disbursements.",
"type": "string"
},
"disbursements": {
"type": "array",
"description": "The list of disbursements.",
"items": {
"$ref": "OrderReportDisbursement"
}
},
"kind": {
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#orderreportsListDisbursementsResponse\".",
"type": "string"
}
}
},
"DatafeedsCustomBatchResponse": {
"id": "DatafeedsCustomBatchResponse",
"properties": {
"kind": {
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#datafeedsCustomBatchResponse\".",
"type": "string"
},
"entries": {
"items": {
"$ref": "DatafeedsCustomBatchResponseEntry"
},
"description": "The result of the execution of the batch requests.",
"type": "array"
}
},
"type": "object"
},
"LiaAboutPageSettings": {
"properties": {
"url": {
"type": "string",
"description": "The URL for the About page."
},
"status": {
"description": "The status of the verification process for the About page. Acceptable values are: - \"`active`\" - \"`inactive`\" - \"`pending`\" ",
"type": "string"
}
},
"id": "LiaAboutPageSettings",
"type": "object"
},
"AccountsCustomBatchRequest": {
"id": "AccountsCustomBatchRequest",
"type": "object",
"properties": {
"entries": {
"type": "array",
"description": "The request entries to be processed in the batch.",
"items": {
"$ref": "AccountsCustomBatchRequestEntry"
}
}
}
},
"LiaInventorySettings": {
"id": "LiaInventorySettings",
"type": "object",
"properties": {
"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"
},
"status": {
"type": "string",
"description": "The status of the inventory verification process. Acceptable values are: - \"`active`\" - \"`inactive`\" - \"`pending`\" "
},
"inventoryVerificationContactName": {
"description": "The name of the contact for the inventory verification process.",
"type": "string"
}
}
},
"OrdersSetLineItemMetadataResponse": {
"type": "object",
"properties": {
"kind": {
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#ordersSetLineItemMetadataResponse\".",
"type": "string"
},
"executionStatus": {
"description": "The status of the execution. Acceptable values are: - \"`duplicate`\" - \"`executed`\" ",
"type": "string"
}
},
"id": "OrdersSetLineItemMetadataResponse"
},
"ProductstatusesListResponse": {
"id": "ProductstatusesListResponse",
"type": "object",
"properties": {
"nextPageToken": {
"description": "The token for the retrieval of the next page of products statuses.",
"type": "string"
},
"resources": {
"items": {
"$ref": "ProductStatus"
},
"type": "array"
},
"kind": {
"type": "string",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#productstatusesListResponse\"."
}
}
},
"CarrierRate": {
"id": "CarrierRate",
"properties": {
"carrierName": {
"description": "Carrier service, such as `\"UPS\"` or `\"Fedex\"`. The list of supported carriers can be retrieved via the `getSupportedCarriers` method. Required.",
"type": "string"
},
"percentageAdjustment": {
"type": "string",
"description": "Multiplicative shipping rate modifier as a number in decimal notation. Can be negative. For example `\"5.4\"` increases the rate by 5.4%, `\"-3\"` decreases the rate by 3%. Optional."
},
"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"
},
"originPostalCode": {
"type": "string",
"description": "Shipping origin for this carrier rate. Required."
},
"carrierService": {
"description": "Carrier service, such as `\"ground\"` or `\"2 days\"`. The list of supported services for a carrier can be retrieved via the `getSupportedCarriers` method. Required.",
"type": "string"
},
"name": {
"description": "Name of the carrier rate. Must be unique per rate group. Required.",
"type": "string"
}
},
"type": "object"
},
"LiasettingsCustomBatchResponseEntry": {
"type": "object",
"id": "LiasettingsCustomBatchResponseEntry",
"properties": {
"batchId": {
"type": "integer",
"format": "uint32",
"description": "The ID of the request entry to which this entry responds."
},
"gmbAccounts": {
"$ref": "GmbAccounts",
"description": "The list of accessible GMB accounts."
},
"errors": {
"description": "A list of errors defined if, and only if, the request failed.",
"$ref": "Errors"
},
"liaSettings": {
"description": "The retrieved or updated Lia settings.",
"$ref": "LiaSettings"
},
"kind": {
"type": "string",
"description": "Identifies what kind of resource this is. Value: the fixed string \"`content#liasettingsCustomBatchResponseEntry`\""
},
"posDataProviders": {
"items": {
"$ref": "PosDataProviders"
},
"description": "The list of POS data providers.",
"type": "array"
}
}
},
"ProductShippingWeight": {
"properties": {
"unit": {
"description": "The unit of value.",
"type": "string"
},
"value": {
"type": "number",
"description": "The weight of the product used to calculate the shipping cost of the item.",
"format": "double"
}
},
"id": "ProductShippingWeight",
"type": "object"
},
"ShipmentInvoiceLineItemInvoice": {
"properties": {
"lineItemId": {
"type": "string",
"description": "ID of the line item. Either lineItemId or productId must be set."
},
"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"
},
"productId": {
"type": "string",
"description": "ID of the product. This is the REST ID used in the products service. Either lineItemId or productId must be set."
}
},
"id": "ShipmentInvoiceLineItemInvoice",
"type": "object"
},
"CustomAttribute": {
"properties": {
"type": {
"type": "string",
"description": "The type of the attribute. Acceptable values are: - \"`boolean`\" - \"`datetimerange`\" - \"`float`\" - \"`group`\" - \"`int`\" - \"`price`\" - \"`text`\" - \"`time`\" - \"`url`\" "
},
"name": {
"type": "string",
"description": "The name of the attribute. Underscores will be replaced by spaces upon insertion."
},
"value": {
"type": "string",
"description": "The value of the attribute."
},
"unit": {
"description": "Free-form unit of the attribute. Unit can only be used for values of type int, float, or price.",
"type": "string"
}
},
"type": "object",
"id": "CustomAttribute"
},
"CarriersCarrier": {
"id": "CarriersCarrier",
"properties": {
"services": {
"type": "array",
"description": "A list of supported services (e.g., `\"ground\"`) for that carrier. Contains at least one service.",
"items": {
"type": "string"
}
},
"country": {
"description": "The CLDR country code of the carrier (e.g., \"US\"). Always present.",
"type": "string"
},
"name": {
"description": "The name of the carrier (e.g., `\"UPS\"`). Always present.",
"type": "string"
}
},
"type": "object"
},
"AccountsCustomBatchResponseEntry": {
"id": "AccountsCustomBatchResponseEntry",
"description": "A batch entry encoding a single non-batch accounts response.",
"type": "object",
"properties": {
"kind": {
"type": "string",
"description": "Identifies what kind of resource this is. Value: the fixed string \"`content#accountsCustomBatchResponseEntry`\""
},
"batchId": {
"format": "uint32",
"type": "integer",
"description": "The ID of the request entry this entry responds to."
},
"errors": {
"$ref": "Errors",
"description": "A list of errors defined if and only if the request failed."
},
"account": {
"description": "The retrieved, created, or updated account. Not defined if the method was `delete`, `claimwebsite` or `link`.",
"$ref": "Account"
},
"linkStatus": {
"type": "string",
"description": "Deprecated. This field is never set. Acceptable values are: - \"`active`\" - \"`inactive`\" - \"`pending`\" "
}
}
},
"TestOrderCustomerMarketingRightsInfo": {
"properties": {
"lastUpdatedTimestamp": {
"type": "string",
"description": "Timestamp when last time marketing preference was updated. Could be empty, if user wasn't offered a selection yet."
},
"explicitMarketingPreference": {
"description": "Last know user use selection regards marketing preferences. In certain cases selection might not be known, so this field would be empty. Acceptable values are: - \"`denied`\" - \"`granted`\" ",
"type": "string"
}
},
"type": "object",
"id": "TestOrderCustomerMarketingRightsInfo"
},
"InventoryCustomBatchRequestEntry": {
"properties": {
"productId": {
"type": "string",
"description": "The ID of the product for which to update price and availability."
},
"inventory": {
"description": "Price and availability of the product.",
"$ref": "Inventory"
},
"batchId": {
"format": "uint32",
"description": "An entry ID, unique within the batch request.",
"type": "integer"
},
"storeCode": {
"type": "string",
"description": "The code of the store for which to update price and availability. Use `online` to update price and availability of an online product."
},
"merchantId": {
"description": "The ID of the managing account.",
"type": "string",
"format": "uint64"
}
},
"type": "object",
"id": "InventoryCustomBatchRequestEntry",
"description": "A batch entry encoding a single non-batch inventory request."
},
"OrderinvoicesCreateRefundInvoiceRequest": {
"properties": {
"refundOnlyOption": {
"description": "Option to create a refund-only invoice. Exactly one of `refundOnlyOption` or `returnOption` must be provided.",
"$ref": "OrderinvoicesCustomBatchRequestEntryCreateRefundInvoiceRefundOption"
},
"shipmentInvoices": {
"type": "array",
"items": {
"$ref": "ShipmentInvoice"
},
"description": "Invoice details for different shipment groups."
},
"returnOption": {
"$ref": "OrderinvoicesCustomBatchRequestEntryCreateRefundInvoiceReturnOption",
"description": "Option to create an invoice for a refund and mark all items within the invoice as returned. Exactly one of `refundOnlyOption` or `returnOption` must be provided."
},
"operationId": {
"description": "[required] The ID of the operation, unique across all operations for a given order.",
"type": "string"
},
"invoiceId": {
"type": "string",
"description": "[required] The ID of the invoice."
}
},
"id": "OrderinvoicesCreateRefundInvoiceRequest",
"type": "object"
},
"CutoffTime": {
"type": "object",
"id": "CutoffTime",
"properties": {
"minute": {
"description": "Minute of the cutoff time until which an order has to be placed to be processed in the same day. Required.",
"format": "uint32",
"type": "integer"
},
"hour": {
"format": "uint32",
"type": "integer",
"description": "Hour of the cutoff time until which an order has to be placed to be processed in the same day. Required."
},
"timezone": {
"type": "string",
"description": "Timezone identifier for the cutoff time. A list of identifiers can be found in the AdWords API documentation. E.g. \"Europe/Zurich\". Required."
}
}
},
"OrdersCustomBatchRequest": {
"properties": {
"entries": {
"description": "The request entries to be processed in the batch.",
"items": {
"$ref": "OrdersCustomBatchRequestEntry"
},
"type": "array"
}
},
"type": "object",
"id": "OrdersCustomBatchRequest"
},
"BusinessDayConfig": {
"id": "BusinessDayConfig",
"properties": {
"businessDays": {
"items": {
"type": "string"
},
"description": "Regular business days. May not be empty.",
"type": "array"
}
},
"type": "object"
},
"PosCustomBatchRequest": {
"id": "PosCustomBatchRequest",
"properties": {
"entries": {
"items": {
"$ref": "PosCustomBatchRequestEntry"
},
"description": "The request entries to be processed in the batch.",
"type": "array"
}
},
"type": "object"
},
"ProductStatusDestinationStatus": {
"type": "object",
"properties": {
"intention": {
"description": "Provided for backward compatibility only. Always set to \"required\". Acceptable values are: - \"`default`\" - \"`excluded`\" - \"`optional`\" - \"`required`\" ",
"type": "string"
},
"approvalPending": {
"description": "Whether the approval status might change due to further processing.",
"type": "boolean"
},
"destination": {
"description": "The name of the destination",
"type": "string"
},
"approvalStatus": {
"description": "The destination's approval status. Acceptable values are: - \"`approved`\" - \"`disapproved`\" ",
"type": "string"
}
},
"id": "ProductStatusDestinationStatus"
},
"OrdersCustomBatchRequestEntryUpdateShipment": {
"id": "OrdersCustomBatchRequestEntryUpdateShipment",
"type": "object",
"properties": {
"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"
},
"status": {
"type": "string",
"description": "New status for the shipment. Not updated if missing. Acceptable values are: - \"`delivered`\" - \"`undeliverable`\" - \"`readyForPickup`\" "
},
"shipmentId": {
"description": "The ID of the shipment.",
"type": "string"
},
"trackingId": {
"description": "The tracking ID for the shipment. Not updated if missing.",
"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"
}
}
},
"AccountstatusesCustomBatchResponseEntry": {
"description": "A batch entry encoding a single non-batch accountstatuses response.",
"id": "AccountstatusesCustomBatchResponseEntry",
"type": "object",
"properties": {
"batchId": {
"format": "uint32",
"description": "The ID of the request entry this entry responds to.",
"type": "integer"
},
"accountStatus": {
"description": "The requested account status. Defined if and only if the request was successful.",
"$ref": "AccountStatus"
},
"errors": {
"$ref": "Errors",
"description": "A list of errors defined if and only if the request failed."
}
}
},
"PosStore": {
"properties": {
"storeCode": {
"type": "string",
"description": "Required. A store identifier that is unique for the given merchant."
},
"kind": {
"description": "Identifies what kind of resource this is. Value: the fixed string \"`content#posStore`\"",
"type": "string"
},
"storeAddress": {
"type": "string",
"description": "Required. The street address of the store."
}
},
"id": "PosStore",
"description": "Store resource.",
"type": "object"
},
"OrdersGetByMerchantOrderIdResponse": {
"type": "object",
"id": "OrdersGetByMerchantOrderIdResponse",
"properties": {
"kind": {
"type": "string",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#ordersGetByMerchantOrderIdResponse\"."
},
"order": {
"description": "The requested order.",
"$ref": "Order"
}
}
},
"OrderLineItemProductVariantAttribute": {
"id": "OrderLineItemProductVariantAttribute",
"type": "object",
"properties": {
"dimension": {
"description": "The dimension of the variant.",
"type": "string"
},
"value": {
"description": "The value for the dimension.",
"type": "string"
}
}
},
"Errors": {
"type": "object",
"description": "A list of errors returned by a failed batch entry.",
"id": "Errors",
"properties": {
"message": {
"description": "The message of the first error in `errors`.",
"type": "string"
},
"code": {
"format": "uint32",
"type": "integer",
"description": "The HTTP status of the first error in `errors`."
},
"errors": {
"type": "array",
"items": {
"$ref": "Error"
},
"description": "A list of errors."
}
}
},
"OrderCustomer": {
"id": "OrderCustomer",
"properties": {
"explicitMarketingPreference": {
"type": "boolean",
"description": "Deprecated. Please use marketingRightsInfo instead."
},
"marketingRightsInfo": {
"$ref": "OrderCustomerMarketingRightsInfo",
"description": "Customer's marketing preferences. Contains the marketing opt-in information that is current at the time that the merchant call. User preference selections can change from one order to the next so preferences must be checked with every order."
},
"fullName": {
"description": "Full name of the customer.",
"type": "string"
},
"invoiceReceivingEmail": {
"description": "Email address for the merchant to send value-added tax or invoice documentation of the order. 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"
},
"email": {
"type": "string",
"description": "Deprecated."
}
},
"type": "object"
},
"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"
},
"productId": {
"type": "string",
"description": "The ID of the product to ship. This is the REST ID used in the products service. Either lineItemId or productId is required."
},
"quantity": {
"description": "The quantity that is shipped.",
"type": "integer",
"format": "uint32"
}
}
},
"Table": {
"properties": {
"columnHeaders": {
"$ref": "Headers",
"description": "Headers of the table's columns. Optional: if not set then the table has only one dimension."
},
"rows": {
"items": {
"$ref": "Row"
},
"description": "The list of rows that constitute the table. Must have the same length as `rowHeaders`. Required.",
"type": "array"
},
"name": {
"description": "Name of the table. Required for subtables, ignored for the main table.",
"type": "string"
},
"rowHeaders": {
"$ref": "Headers",
"description": "Headers of the table's rows. Required."
}
},
"type": "object",
"id": "Table"
},
"OrderLineItemReturnInfo": {
"properties": {
"isReturnable": {
"type": "boolean",
"description": "Required. Whether the item is returnable."
},
"daysToReturn": {
"format": "int32",
"description": "Required. How many days later the item can be returned.",
"type": "integer"
},
"policyUrl": {
"description": "Required. URL of the item return policy.",
"type": "string"
}
},
"id": "OrderLineItemReturnInfo",
"type": "object"
},
"OrdersReturnRefundLineItemResponse": {
"properties": {
"executionStatus": {
"type": "string",
"description": "The status of the execution. Acceptable values are: - \"`duplicate`\" - \"`executed`\" "
},
"kind": {
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#ordersReturnRefundLineItemResponse\".",
"type": "string"
}
},
"type": "object",
"id": "OrdersReturnRefundLineItemResponse"
},
"OrdersCancelTestOrderByCustomerRequest": {
"id": "OrdersCancelTestOrderByCustomerRequest",
"properties": {
"reason": {
"description": "The reason for the cancellation. Acceptable values are: - \"`changedMind`\" - \"`orderedWrongItem`\" - \"`other`\" ",
"type": "string"
}
},
"type": "object"
},
"AccounttaxCustomBatchRequestEntry": {
"id": "AccounttaxCustomBatchRequestEntry",
"properties": {
"method": {
"type": "string",
"description": "The method of the batch entry. Acceptable values are: - \"`get`\" - \"`update`\" "
},
"accountId": {
"description": "The ID of the account for which to get/update account tax settings.",
"format": "uint64",
"type": "string"
},
"merchantId": {
"description": "The ID of the managing account.",
"format": "uint64",
"type": "string"
},
"batchId": {
"description": "An entry ID, unique within the batch request.",
"format": "uint32",
"type": "integer"
},
"accountTax": {
"description": "The account tax settings to update. Only defined if the method is `update`.",
"$ref": "AccountTax"
}
},
"type": "object",
"description": "A batch entry encoding a single non-batch accounttax request."
},
"AccountUser": {
"id": "AccountUser",
"properties": {
"emailAddress": {
"type": "string",
"description": "User's email address."
},
"orderManager": {
"type": "boolean",
"description": "Whether user is an order manager."
},
"paymentsAnalyst": {
"description": "Whether user can access payment statements.",
"type": "boolean"
},
"paymentsManager": {
"type": "boolean",
"description": "Whether user can manage payment settings."
},
"admin": {
"type": "boolean",
"description": "Whether user is an admin."
}
},
"type": "object"
},
"OrdersReturnRefundLineItemRequest": {
"type": "object",
"properties": {
"amountPretax": {
"$ref": "Price",
"description": "The amount that is refunded. If omitted, refundless return is assumed (same as calling returnLineItem method)."
},
"reasonText": {
"description": "The explanation of the reason.",
"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"
},
"lineItemId": {
"type": "string",
"description": "The ID of the line item to return. Either lineItemId or productId is required."
},
"quantity": {
"description": "The quantity to return and refund.",
"format": "uint32",
"type": "integer"
},
"operationId": {
"type": "string",
"description": "The ID of the operation. Unique across all operations for a given order."
},
"amountTax": {
"description": "Tax amount that corresponds to refund amount in amountPretax. Optional, but if filled, then amountPretax must be set. Calculated automatically if not provided.",
"$ref": "Price"
},
"reason": {
"type": "string",
"description": "The reason for the return. Acceptable values are: - \"`customerDiscretionaryReturn`\" - \"`customerInitiatedMerchantCancel`\" - \"`deliveredTooLate`\" - \"`expiredItem`\" - \"`invalidCoupon`\" - \"`malformedShippingAddress`\" - \"`other`\" - \"`productArrivedDamaged`\" - \"`productNotAsDescribed`\" - \"`qualityNotAsExpected`\" - \"`undeliverableShippingAddress`\" - \"`unsupportedPoBoxAddress`\" - \"`wrongProductShipped`\" "
}
},
"id": "OrdersReturnRefundLineItemRequest"
},
"OrderLegacyPromotion": {
"id": "OrderLegacyPromotion",
"type": "object",
"properties": {
"effectiveDates": {
"description": "The date and time frame when the promotion is active and ready for validation review. Note that the promotion live time may be delayed for a few hours due to the validation review. Start date and end date are separated by a forward slash (/). The start date is specified by the format (YYYY-MM-DD), followed by the letter ?T?, the time of the day when the sale starts (in Greenwich Mean Time, GMT), followed by an expression of the time zone for the sale. The end date is in the same format.",
"type": "string"
},
"productApplicability": {
"description": "Whether the promotion is applicable to all products or only specific products. Acceptable values are: - \"`allProducts`\" - \"`specificProducts`\" ",
"type": "string"
},
"id": {
"description": "The unique ID of the promotion.",
"type": "string"
},
"genericRedemptionCode": {
"type": "string",
"description": "Optional. The text code that corresponds to the promotion when applied on the retailer?s website."
},
"longTitle": {
"description": "The full title of the promotion.",
"type": "string"
},
"redemptionChannel": {
"description": "Indicates that the promotion is valid online. Acceptable values are: - \"`online`\" ",
"type": "string"
},
"benefits": {
"type": "array",
"items": {
"$ref": "OrderLegacyPromotionBenefit"
}
}
}
},
"OrderinvoicesCreateRefundInvoiceResponse": {
"id": "OrderinvoicesCreateRefundInvoiceResponse",
"type": "object",
"properties": {
"executionStatus": {
"type": "string",
"description": "The status of the execution. Acceptable values are: - \"`duplicate`\" - \"`executed`\" "
},
"kind": {
"type": "string",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#orderinvoicesCreateRefundInvoiceResponse\"."
}
}
},
"Service": {
"type": "object",
"properties": {
"currency": {
"type": "string",
"description": "The CLDR code of the currency to which this service applies. Must match that of the prices in rate groups."
},
"deliveryCountry": {
"description": "The CLDR territory code of the country to which the service applies. Required.",
"type": "string"
},
"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"
},
"shipmentType": {
"type": "string",
"description": "Type of locations this service ships orders to. Acceptable values are: - \"`delivery`\" - \"`pickup`\" "
},
"pickupService": {
"description": "The carrier-service pair delivering items to collection points. The list of supported pickup services can be retrieved via the `getSupportedPickupServices` method. Required if and only if the service delivery type is `pickup`.",
"$ref": "PickupCarrierService"
},
"deliveryTime": {
"$ref": "DeliveryTime",
"description": "Time spent in various aspects from order to the delivery of the product. Required."
},
"active": {
"description": "A boolean exposing the active status of the shipping service. Required.",
"type": "boolean"
},
"rateGroups": {
"description": "Shipping rate group definitions. Only the last one is allowed to have an empty `applicableShippingLabels`, which means \"everything else\". The other `applicableShippingLabels` must not overlap.",
"items": {
"$ref": "RateGroup"
},
"type": "array"
},
"name": {
"description": "Free-form name of the service. Must be unique within target account. Required.",
"type": "string"
},
"minimumOrderValueTable": {
"$ref": "MinimumOrderValueTable",
"description": "Table of per store minimum order values for the pickup fulfillment type. Cannot be set together with minimum_order_value."
},
"eligibility": {
"description": "Eligibility for this service. Acceptable values are: - \"`All scenarios`\" - \"`All scenarios except Shopping Actions`\" - \"`Shopping Actions`\" ",
"type": "string"
}
},
"id": "Service"
},
"OrdersCustomBatchResponseEntry": {
"id": "OrdersCustomBatchResponseEntry",
"properties": {
"kind": {
"type": "string",
"description": "Identifies what kind of resource this is. Value: the fixed string \"`content#ordersCustomBatchResponseEntry`\""
},
"order": {
"description": "The retrieved order. Only defined if the method is `get` and if the request was successful.",
"$ref": "Order"
},
"errors": {
"$ref": "Errors",
"description": "A list of errors defined if and only if the request failed."
},
"batchId": {
"format": "uint32",
"description": "The ID of the request entry this entry responds to.",
"type": "integer"
},
"executionStatus": {
"description": "The status of the execution. Only defined if 1. the request was successful; and 2. the method is not `get`, `getByMerchantOrderId`, or one of the test methods. Acceptable values are: - \"`duplicate`\" - \"`executed`\" ",
"type": "string"
}
},
"type": "object"
},
"LiasettingsCustomBatchRequest": {
"type": "object",
"properties": {
"entries": {
"items": {
"$ref": "LiasettingsCustomBatchRequestEntry"
},
"description": "The request entries to be processed in the batch.",
"type": "array"
}
},
"id": "LiasettingsCustomBatchRequest"
},
"OrdersRejectReturnLineItemResponse": {
"properties": {
"executionStatus": {
"description": "The status of the execution. Acceptable values are: - \"`duplicate`\" - \"`executed`\" ",
"type": "string"
},
"kind": {
"type": "string",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#ordersRejectReturnLineItemResponse\"."
}
},
"type": "object",
"id": "OrdersRejectReturnLineItemResponse"
},
"OrdersCreateTestReturnRequest": {
"properties": {
"items": {
"description": "Returned items.",
"items": {
"$ref": "OrdersCustomBatchRequestEntryCreateTestReturnReturnItem"
},
"type": "array"
}
},
"type": "object",
"id": "OrdersCreateTestReturnRequest"
},
"OrderReportDisbursement": {
"type": "object",
"description": "Order disbursement. All methods require the payment analyst role.",
"id": "OrderReportDisbursement",
"properties": {
"disbursementCreationDate": {
"type": "string",
"description": "The disbursement date, in ISO 8601 format."
},
"merchantId": {
"format": "uint64",
"type": "string",
"description": "The ID of the managing account."
},
"disbursementDate": {
"type": "string",
"description": "The date the disbursement was initiated, in ISO 8601 format."
},
"disbursementId": {
"type": "string",
"description": "The ID of the disbursement."
},
"disbursementAmount": {
"description": "The disbursement amount.",
"$ref": "Price"
}
}
},
"LiaPosDataProvider": {
"type": "object",
"properties": {
"posExternalAccountId": {
"description": "The account ID by which this merchant is known to the POS data provider.",
"type": "string"
},
"posDataProviderId": {
"type": "string",
"format": "uint64",
"description": "The ID of the POS data provider."
}
},
"id": "LiaPosDataProvider"
},
"AccounttaxListResponse": {
"id": "AccounttaxListResponse",
"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": {
"items": {
"$ref": "AccountTax"
},
"type": "array"
}
},
"type": "object"
},
"OrdersUpdateMerchantOrderIdResponse": {
"type": "object",
"properties": {
"kind": {
"type": "string",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#ordersUpdateMerchantOrderIdResponse\"."
},
"executionStatus": {
"type": "string",
"description": "The status of the execution. Acceptable values are: - \"`duplicate`\" - \"`executed`\" "
}
},
"id": "OrdersUpdateMerchantOrderIdResponse"
},
"AccounttaxCustomBatchResponse": {
"properties": {
"entries": {
"items": {
"$ref": "AccounttaxCustomBatchResponseEntry"
},
"description": "The result of the execution of the batch requests.",
"type": "array"
},
"kind": {
"type": "string",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#accounttaxCustomBatchResponse\"."
}
},
"id": "AccounttaxCustomBatchResponse",
"type": "object"
},
"AccounttaxCustomBatchResponseEntry": {
"description": "A batch entry encoding a single non-batch accounttax response.",
"type": "object",
"id": "AccounttaxCustomBatchResponseEntry",
"properties": {
"batchId": {
"description": "The ID of the request entry this entry responds to.",
"type": "integer",
"format": "uint32"
},
"accountTax": {
"description": "The retrieved or updated account tax settings.",
"$ref": "AccountTax"
},
"errors": {
"description": "A list of errors defined if and only if the request failed.",
"$ref": "Errors"
},
"kind": {
"type": "string",
"description": "Identifies what kind of resource this is. Value: the fixed string \"`content#accounttaxCustomBatchResponseEntry`\""
}
}
},
"DatafeedFormat": {
"type": "object",
"id": "DatafeedFormat",
"properties": {
"quotingMode": {
"type": "string",
"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`\" "
},
"columnDelimiter": {
"type": "string",
"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`\" "
},
"fileEncoding": {
"type": "string",
"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`\" "
}
}
},
"OrdersUpdateShipmentResponse": {
"id": "OrdersUpdateShipmentResponse",
"properties": {
"kind": {
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#ordersUpdateShipmentResponse\".",
"type": "string"
},
"executionStatus": {
"type": "string",
"description": "The status of the execution. Acceptable values are: - \"`duplicate`\" - \"`executed`\" "
}
},
"type": "object"
},
"PostalCodeGroup": {
"id": "PostalCodeGroup",
"properties": {
"country": {
"description": "The CLDR territory code of the country the postal code group applies to. Required.",
"type": "string"
},
"name": {
"description": "The name of the postal code group, referred to in headers. Required.",
"type": "string"
},
"postalCodeRanges": {
"items": {
"$ref": "PostalCodeRange"
},
"type": "array",
"description": "A range of postal codes. Required."
}
},
"type": "object"
},
"UnitInvoiceTaxLine": {
"properties": {
"taxName": {
"description": "Optional name of the tax type. This should only be provided if `taxType` is `otherFeeTax`.",
"type": "string"
},
"taxAmount": {
"description": "[required] Tax amount for the tax type.",
"$ref": "Price"
},
"taxType": {
"description": "[required] Type of the tax. Acceptable values are: - \"`otherFee`\" - \"`otherFeeTax`\" - \"`sales`\" ",
"type": "string"
}
},
"id": "UnitInvoiceTaxLine",
"type": "object"
},
"AccountCustomerService": {
"id": "AccountCustomerService",
"type": "object",
"properties": {
"email": {
"description": "Customer service email.",
"type": "string"
},
"url": {
"description": "Customer service URL.",
"type": "string"
},
"phoneNumber": {
"description": "Customer service phone number.",
"type": "string"
}
}
},
"ProductTax": {
"id": "ProductTax",
"type": "object",
"properties": {
"region": {
"description": "The geographic region to which the tax rate applies.",
"type": "string"
},
"country": {
"type": "string",
"description": "The country within which the item is taxed, specified as a CLDR territory code."
},
"postalCode": {
"type": "string",
"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*."
},
"rate": {
"format": "double",
"description": "The percentage of tax rate that applies to the item price.",
"type": "number"
},
"locationId": {
"description": "The numeric ID of a location that the tax rate applies to as defined in the AdWords API.",
"type": "string",
"format": "int64"
},
"taxShip": {
"description": "Should be set to true if tax is charged on shipping.",
"type": "boolean"
}
}
},
"OrderLineItem": {
"properties": {
"returnInfo": {
"$ref": "OrderLineItemReturnInfo",
"description": "Details of the return policy for the line item."
},
"price": {
"$ref": "Price",
"description": "Total price for the line item. For example, if two items for $10 are purchased, the total price will be $20."
},
"tax": {
"$ref": "Price",
"description": "Total tax amount for the line item. For example, if two items are purchased, and each have a cost tax of $2, the total tax amount will be $4."
},
"product": {
"$ref": "OrderLineItemProduct",
"description": "Product data as seen by customer from the time of the order placement. Note that certain attributes values (e.g. title or gtin) might be reformatted and no longer match values submitted via product feed."
},
"quantityPending": {
"description": "Number of items pending.",
"type": "integer",
"format": "uint32"
},
"cancellations": {
"items": {
"$ref": "OrderCancellation"
},
"type": "array",
"description": "Cancellations of the line item."
},
"shippingDetails": {
"description": "Details of the requested shipping for the line item.",
"$ref": "OrderLineItemShippingDetails"
},
"quantityOrdered": {
"description": "Number of items ordered.",
"type": "integer",
"format": "uint32"
},
"quantityReturned": {
"format": "uint32",
"type": "integer",
"description": "Number of items returned."
},
"quantityShipped": {
"format": "uint32",
"description": "Number of items shipped.",
"type": "integer"
},
"quantityDelivered": {
"type": "integer",
"format": "uint32",
"description": "Number of items delivered."
},
"id": {
"type": "string",
"description": "The ID of the line item."
},
"quantityCanceled": {
"format": "uint32",
"type": "integer",
"description": "Number of items canceled."
},
"quantityReadyForPickup": {
"type": "integer",
"description": "Number of items ready for pickup.",
"format": "uint32"
},
"returns": {
"type": "array",
"items": {
"$ref": "OrderReturn"
},
"description": "Returns of the line item."
},
"annotations": {
"type": "array",
"description": "Annotations that are attached to the line item.",
"items": {
"$ref": "OrderMerchantProvidedAnnotation"
}
}
},
"type": "object",
"id": "OrderLineItem"
},
"LiasettingsGetAccessibleGmbAccountsResponse": {
"id": "LiasettingsGetAccessibleGmbAccountsResponse",
"properties": {
"gmbAccounts": {
"type": "array",
"description": "A list of GMB accounts which are available to the merchant.",
"items": {
"$ref": "GmbAccountsGmbAccount"
}
},
"accountId": {
"format": "uint64",
"description": "The ID of the Merchant Center account.",
"type": "string"
},
"kind": {
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#liasettingsGetAccessibleGmbAccountsResponse\".",
"type": "string"
}
},
"type": "object"
},
"OrdersCustomBatchRequestEntryUpdateLineItemShippingDetails": {
"properties": {
"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"
},
"deliverByDate": {
"type": "string",
"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 not be a date in the past."
},
"lineItemId": {
"type": "string",
"description": "The ID of the line item to set metadata. Either lineItemId or productId is required."
},
"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 not be a date in the past.",
"type": "string"
}
},
"type": "object",
"id": "OrdersCustomBatchRequestEntryUpdateLineItemShippingDetails"
},
"InventorySetResponse": {
"id": "InventorySetResponse",
"properties": {
"kind": {
"type": "string",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#inventorySetResponse\"."
}
},
"type": "object"
},
"OrderShipmentScheduledDeliveryDetails": {
"type": "object",
"id": "OrderShipmentScheduledDeliveryDetails",
"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 (e.g., \"+41 44 668 1800\").",
"type": "string"
}
}
},
"AccountBusinessInformation": {
"properties": {
"address": {
"description": "The address of the business.",
"$ref": "AccountAddress"
},
"customerService": {
"$ref": "AccountCustomerService",
"description": "The customer service information of the business."
},
"phoneNumber": {
"description": "The phone number of the business.",
"type": "string"
}
},
"id": "AccountBusinessInformation",
"type": "object"
},
"Row": {
"type": "object",
"properties": {
"cells": {
"items": {
"$ref": "Value"
},
"type": "array",
"description": "The list of cells that constitute the row. Must have the same length as `columnHeaders` for two-dimensional tables, a length of 1 for one-dimensional tables. Required."
}
},
"id": "Row"
},
"OrdersCustomBatchRequestEntryShipLineItems": {
"id": "OrdersCustomBatchRequestEntryShipLineItems",
"type": "object",
"properties": {
"shipmentId": {
"description": "Deprecated. Please use shipmentInfo instead. The ID of the shipment.",
"type": "string"
},
"carrier": {
"type": "string",
"description": "Deprecated. Please use shipmentInfo instead. The carrier handling the shipment. See `shipments[].carrier` in the Orders resource representation for a list of acceptable values."
},
"lineItems": {
"type": "array",
"items": {
"$ref": "OrderShipmentLineItemShipment"
},
"description": "Line items to ship."
},
"shipmentGroupId": {
"description": "ID of the shipment group. Required for orders that use the orderinvoices service.",
"type": "string"
},
"shipmentInfos": {
"description": "Shipment information. This field is repeated because a single line item can be shipped in several packages (and have several tracking IDs).",
"items": {
"$ref": "OrdersCustomBatchRequestEntryShipLineItemsShipmentInfo"
},
"type": "array"
},
"trackingId": {
"type": "string",
"description": "Deprecated. Please use shipmentInfo instead. The tracking ID for the shipment."
}
}
},
"AccountStatusProducts": {
"id": "AccountStatusProducts",
"type": "object",
"properties": {
"statistics": {
"description": "Aggregated product statistics.",
"$ref": "AccountStatusStatistics"
},
"destination": {
"type": "string",
"description": "The destination the data applies to."
},
"country": {
"type": "string",
"description": "The country the data applies to."
},
"channel": {
"type": "string",
"description": "The channel the data applies to. Acceptable values are: - \"`local`\" - \"`online`\" "
},
"itemLevelIssues": {
"items": {
"$ref": "AccountStatusItemLevelIssue"
},
"description": "List of item-level issues.",
"type": "array"
}
}
},
"ShippingsettingsGetSupportedCarriersResponse": {
"id": "ShippingsettingsGetSupportedCarriersResponse",
"type": "object",
"properties": {
"kind": {
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#shippingsettingsGetSupportedCarriersResponse\".",
"type": "string"
},
"carriers": {
"items": {
"$ref": "CarriersCarrier"
},
"description": "A list of supported carriers. May be empty.",
"type": "array"
}
}
},
"LiaCountrySettings": {
"id": "LiaCountrySettings",
"properties": {
"posDataProvider": {
"$ref": "LiaPosDataProvider",
"description": "The POS data provider linked with this country."
},
"about": {
"description": "The settings for the About page.",
"$ref": "LiaAboutPageSettings"
},
"onDisplayToOrder": {
"description": "LIA \"On Display To Order\" settings.",
"$ref": "LiaOnDisplayToOrderSettings"
},
"country": {
"description": "Required. CLDR country code (e.g. \"US\").",
"type": "string"
},
"hostedLocalStorefrontActive": {
"type": "boolean",
"description": "The status of the \"Merchant hosted local storefront\" feature."
},
"inventory": {
"$ref": "LiaInventorySettings",
"description": "LIA inventory verification settings."
},
"storePickupActive": {
"description": "The status of the \"Store pickup\" feature.",
"type": "boolean"
}
},
"type": "object"
},
"OrderinvoicesCustomBatchRequestEntryCreateRefundInvoiceRefundOption": {
"properties": {
"description": {
"description": "Optional description of the refund reason.",
"type": "string"
},
"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"
}
},
"id": "OrderinvoicesCustomBatchRequestEntryCreateRefundInvoiceRefundOption",
"type": "object"
},
"ProductUnitPricingBaseMeasure": {
"type": "object",
"properties": {
"value": {
"format": "int64",
"description": "The denominator of the unit price.",
"type": "string"
},
"unit": {
"type": "string",
"description": "The unit of the denominator."
}
},
"id": "ProductUnitPricingBaseMeasure"
},
"AccountstatusesListResponse": {
"id": "AccountstatusesListResponse",
"properties": {
"resources": {
"type": "array",
"items": {
"$ref": "AccountStatus"
}
},
"kind": {
"type": "string",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#accountstatusesListResponse\"."
},
"nextPageToken": {
"type": "string",
"description": "The token for the retrieval of the next page of account statuses."
}
},
"type": "object"
},
"LiasettingsCustomBatchRequestEntry": {
"type": "object",
"properties": {
"merchantId": {
"description": "The ID of the managing account.",
"type": "string",
"format": "uint64"
},
"posExternalAccountId": {
"description": "The account ID by which this merchant is known to the POS provider.",
"type": "string"
},
"method": {
"description": "The method of the batch entry. Acceptable values are: - \"`get`\" - \"`getAccessibleGmbAccounts`\" - \"`requestGmbAccess`\" - \"`requestInventoryVerification`\" - \"`setInventoryVerificationContact`\" - \"`update`\" ",
"type": "string"
},
"liaSettings": {
"$ref": "LiaSettings",
"description": "The account Lia settings to update. Only defined if the method is `update`."
},
"country": {
"type": "string",
"description": "The country code. Required only for RequestInventoryVerification."
},
"accountId": {
"format": "uint64",
"type": "string",
"description": "The ID of the account for which to get/update account LIA settings."
},
"contactEmail": {
"description": "Inventory validation contact email. Required only for SetInventoryValidationContact.",
"type": "string"
},
"posDataProviderId": {
"type": "string",
"format": "uint64",
"description": "The ID of POS data provider. Required only for SetPosProvider."
},
"gmbEmail": {
"description": "The GMB account. Required only for RequestGmbAccess.",
"type": "string"
},
"contactName": {
"description": "Inventory validation contact name. Required only for SetInventoryValidationContact.",
"type": "string"
},
"batchId": {
"format": "uint32",
"description": "An entry ID, unique within the batch request.",
"type": "integer"
}
},
"id": "LiasettingsCustomBatchRequestEntry"
},
"ProductstatusesCustomBatchResponseEntry": {
"properties": {
"kind": {
"type": "string",
"description": "Identifies what kind of resource this is. Value: the fixed string \"`content#productstatusesCustomBatchResponseEntry`\""
},
"errors": {
"$ref": "Errors",
"description": "A list of errors, if the request failed."
},
"batchId": {
"format": "uint32",
"description": "The ID of the request entry this entry responds to.",
"type": "integer"
},
"productStatus": {
"description": "The requested product status. Only defined if the request was successful.",
"$ref": "ProductStatus"
}
},
"description": "A batch entry encoding a single non-batch productstatuses response.",
"type": "object",
"id": "ProductstatusesCustomBatchResponseEntry"
},
"OrdersCustomBatchRequestEntryReturnLineItem": {
"id": "OrdersCustomBatchRequestEntryReturnLineItem",
"properties": {
"reasonText": {
"description": "The explanation of the reason.",
"type": "string"
},
"lineItemId": {
"type": "string",
"description": "The ID of the line item to return. Either lineItemId or productId is required."
},
"reason": {
"type": "string",
"description": "The reason for the return. Acceptable values are: - \"`customerDiscretionaryReturn`\" - \"`customerInitiatedMerchantCancel`\" - \"`deliveredTooLate`\" - \"`expiredItem`\" - \"`invalidCoupon`\" - \"`malformedShippingAddress`\" - \"`other`\" - \"`productArrivedDamaged`\" - \"`productNotAsDescribed`\" - \"`qualityNotAsExpected`\" - \"`undeliverableShippingAddress`\" - \"`unsupportedPoBoxAddress`\" - \"`wrongProductShipped`\" "
},
"quantity": {
"type": "integer",
"description": "The quantity to return.",
"format": "uint32"
},
"productId": {
"type": "string",
"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": "object"
},
"AccountStatusDataQualityIssue": {
"properties": {
"submittedValue": {
"type": "string"
},
"detail": {
"type": "string"
},
"exampleItems": {
"items": {
"$ref": "AccountStatusExampleItem"
},
"type": "array"
},
"location": {
"type": "string"
},
"lastChecked": {
"type": "string"
},
"numItems": {
"type": "integer",
"format": "uint32"
},
"id": {
"type": "string"
},
"destination": {
"type": "string"
},
"severity": {
"type": "string",
"description": " Acceptable values are: - \"`critical`\" - \"`error`\" - \"`suggestion`\" "
},
"displayedValue": {
"type": "string"
},
"country": {
"type": "string"
}
},
"id": "AccountStatusDataQualityIssue",
"type": "object"
},
"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": {
"type": "string",
"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`\" "
},
"lastUpdatedTimestamp": {
"type": "string",
"description": "Timestamp when last time marketing preference was updated. Could be empty, if user wasn't offered a selection yet."
}
}
},
"TransitTable": {
"type": "object",
"properties": {
"transitTimeLabels": {
"items": {
"type": "string"
},
"type": "array",
"description": "A list of transit time labels. The last value can be `\"all other labels\"`. Example: `[\"food\", \"electronics\", \"all other labels\"]`."
},
"postalCodeGroupNames": {
"description": "A list of postal group names. The last value can be `\"all other locations\"`. Example: `[\"zone 1\", \"zone 2\", \"all other locations\"]`. The referred postal code groups must match the delivery country of the service.",
"items": {
"type": "string"
},
"type": "array"
},
"rows": {
"items": {
"$ref": "TransitTableTransitTimeRow"
},
"type": "array"
}
},
"id": "TransitTable"
},
"PosSaleRequest": {
"id": "PosSaleRequest",
"properties": {
"gtin": {
"type": "string",
"description": "Global Trade Item Number."
},
"storeCode": {
"type": "string",
"description": "Required. The identifier of the merchant's store. Either a `storeCode` inserted via the API or the code of the store in Google My Business."
},
"quantity": {
"type": "string",
"format": "int64",
"description": "Required. The relative change of the available quantity. Negative for items returned."
},
"targetCountry": {
"type": "string",
"description": "Required. The CLDR territory code for the item."
},
"itemId": {
"description": "Required. A unique identifier for the item.",
"type": "string"
},
"price": {
"description": "Required. The price of the item.",
"$ref": "Price"
},
"contentLanguage": {
"description": "Required. The two-letter ISO 639-1 language code for the item.",
"type": "string"
},
"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"
}
},
"type": "object"
},
"OrdersRefundRequest": {
"type": "object",
"id": "OrdersRefundRequest",
"properties": {
"amount": {
"$ref": "Price",
"description": "Deprecated. Please use amountPretax and amountTax instead."
},
"reasonText": {
"description": "The explanation of the reason.",
"type": "string"
},
"reason": {
"description": "The reason for the refund. Acceptable values are: - \"`adjustment`\" - \"`courtesyAdjustment`\" - \"`customerCanceled`\" - \"`customerDiscretionaryReturn`\" - \"`deliveredLateByCarrier`\" - \"`feeAdjustment`\" - \"`lateShipmentCredit`\" - \"`noInventory`\" - \"`other`\" - \"`priceError`\" - \"`productArrivedDamaged`\" - \"`productNotAsDescribed`\" - \"`shippingCostAdjustment`\" - \"`taxAdjustment`\" - \"`undeliverableShippingAddress`\" - \"`wrongProductShipped`\" ",
"type": "string"
},
"operationId": {
"description": "The ID of the operation. Unique across all operations for a given order.",
"type": "string"
},
"amountPretax": {
"$ref": "Price",
"description": "The amount that is refunded. Either amount or amountPretax should be filled."
},
"amountTax": {
"description": "Tax amount that corresponds to refund amount in amountPretax. Optional, but if filled, amountPretax must be set. Calculated automatically if not provided.",
"$ref": "Price"
}
}
},
"OrdersRejectReturnLineItemRequest": {
"type": "object",
"id": "OrdersRejectReturnLineItemRequest",
"properties": {
"lineItemId": {
"type": "string",
"description": "The ID of the line item to return. Either lineItemId or productId is required."
},
"productId": {
"type": "string",
"description": "The ID of the product to return. This is the REST ID used in the products service. Either lineItemId or productId is required."
},
"reasonText": {
"type": "string",
"description": "The explanation of the reason."
},
"operationId": {
"description": "The ID of the operation. Unique across all operations for a given order.",
"type": "string"
},
"reason": {
"description": "The reason for the return. Acceptable values are: - \"`damagedOrUsed`\" - \"`missingComponent`\" - \"`notEligible`\" - \"`other`\" - \"`outOfReturnWindow`\" ",
"type": "string"
},
"quantity": {
"format": "uint32",
"description": "The quantity to return and refund.",
"type": "integer"
}
}
},
"AccountAddress": {
"type": "object",
"id": "AccountAddress",
"properties": {
"locality": {
"type": "string",
"description": "City, town or commune. May also include dependent localities or sublocalities (e.g. neighborhoods or suburbs)."
},
"region": {
"type": "string",
"description": "Top-level administrative subdivision of the country. For example, a state like California (\"CA\") or a province like Quebec (\"QC\")."
},
"postalCode": {
"description": "Postal code or ZIP (e.g. \"94043\").",
"type": "string"
},
"country": {
"type": "string",
"description": "CLDR country code (e.g. \"US\"). This value cannot be set for a sub-account of an MCA. All MCA sub-accounts inherit the country of their parent MCA."
},
"streetAddress": {
"type": "string",
"description": "Street-level part of the address."
}
}
},
"ProductDestination": {
"properties": {
"destinationName": {
"type": "string",
"description": "The name of the destination."
},
"intention": {
"description": "Whether the destination is required, excluded or should be validated. Acceptable values are: - \"`default`\" - \"`excluded`\" - \"`optional`\" - \"`required`\" ",
"type": "string"
}
},
"type": "object",
"id": "ProductDestination"
},
"OrdersCancelLineItemRequest": {
"type": "object",
"id": "OrdersCancelLineItemRequest",
"properties": {
"amountPretax": {
"description": "Amount to refund for the cancelation. Optional. If not set, Google will calculate the default based on the price and tax of the items involved. The amount must not be larger than the net amount left on the order.",
"$ref": "Price"
},
"reason": {
"type": "string",
"description": "The reason for the cancellation. Acceptable values are: - \"`customerInitiatedCancel`\" - \"`invalidCoupon`\" - \"`malformedShippingAddress`\" - \"`noInventory`\" - \"`other`\" - \"`priceError`\" - \"`shippingPriceError`\" - \"`taxError`\" - \"`undeliverableShippingAddress`\" - \"`unsupportedPoBoxAddress`\" "
},
"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"
},
"operationId": {
"description": "The ID of the operation. Unique across all operations for a given order.",
"type": "string"
},
"amountTax": {
"description": "Tax amount that corresponds to cancellation amount in amountPretax. Optional, but if filled, then amountPretax must be set. Calculated automatically if not provided.",
"$ref": "Price"
},
"amount": {
"description": "Deprecated. Please use amountPretax and amountTax instead.",
"$ref": "Price"
},
"quantity": {
"description": "The quantity to cancel.",
"format": "uint32",
"type": "integer"
},
"reasonText": {
"description": "The explanation of the reason.",
"type": "string"
},
"lineItemId": {
"type": "string",
"description": "The ID of the line item to cancel. Either lineItemId or productId is required."
}
}
},
"TestOrderLineItemProduct": {
"properties": {
"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"
},
"imageLink": {
"description": "Required. URL of an image of the item.",
"type": "string"
},
"itemGroupId": {
"type": "string",
"description": "Shared identifier for all variants of the same product. Optional."
},
"gtin": {
"type": "string",
"description": "Global Trade Item Number (GTIN) of the item. Optional."
},
"contentLanguage": {
"type": "string",
"description": "Required. The two-letter ISO 639-1 language code for the item. Acceptable values are: - \"`en`\" - \"`fr`\" "
},
"mpn": {
"type": "string",
"description": "Manufacturer Part Number (MPN) of the item. Optional."
},
"channel": {
"type": "string",
"description": "Deprecated. Acceptable values are: - \"`online`\" "
},
"variantAttributes": {
"type": "array",
"description": "Variant attributes for the item. Optional.",
"items": {
"$ref": "OrderLineItemProductVariantAttribute"
}
},
"title": {
"description": "Required. The title of the product.",
"type": "string"
},
"brand": {
"type": "string",
"description": "Required. Brand of the item."
},
"targetCountry": {
"description": "Required. The CLDR territory // code of the target country of the product.",
"type": "string"
},
"condition": {
"description": "Required. Condition or state of the item. Acceptable values are: - \"`new`\" ",
"type": "string"
},
"offerId": {
"type": "string",
"description": "Required. An identifier of the item."
},
"fees": {
"description": "Fees for the item. Optional.",
"type": "array",
"items": {
"$ref": "OrderLineItemProductFee"
}
}
},
"id": "TestOrderLineItemProduct",
"type": "object"
},
"OrderAddress": {
"properties": {
"recipientName": {
"description": "Name of the recipient.",
"type": "string"
},
"streetAddress": {
"description": "Street-level part of the address.",
"items": {
"type": "string"
},
"type": "array"
},
"country": {
"description": "CLDR country code (e.g. \"US\").",
"type": "string"
},
"locality": {
"description": "City, town or commune. May also include dependent localities or sublocalities (e.g. neighborhoods or suburbs).",
"type": "string"
},
"postalCode": {
"type": "string",
"description": "Postal Code or ZIP (e.g. \"94043\")."
},
"fullAddress": {
"items": {
"type": "string"
},
"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"
},
"isPostOfficeBox": {
"description": "Whether the address is a post office box.",
"type": "boolean"
},
"region": {
"type": "string",
"description": "Top-level administrative subdivision of the country. For example, a state like California (\"CA\") or a province like Quebec (\"QC\")."
}
},
"id": "OrderAddress",
"type": "object"
},
"OrdersCancelTestOrderByCustomerResponse": {
"id": "OrdersCancelTestOrderByCustomerResponse",
"properties": {
"kind": {
"type": "string",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#ordersCancelTestOrderByCustomerResponse\"."
}
},
"type": "object"
},
"Promotion": {
"properties": {
"promotionAmount": {
"$ref": "Amount",
"description": "[required] Amount of the promotion. The values here are the promotion applied to the unit price pretax and to the total of the tax amounts."
},
"promotionId": {
"type": "string",
"description": "[required] ID of the promotion."
}
},
"id": "Promotion",
"type": "object"
},
"TestOrderCustomer": {
"type": "object",
"id": "TestOrderCustomer",
"properties": {
"email": {
"type": "string",
"description": "Required. Email address of the customer. Acceptable values are: - \"`[email protected]`\" - \"`[email protected]`\" - \"`[email protected]`\" "
},
"fullName": {
"type": "string",
"description": "Full name of the customer."
},
"marketingRightsInfo": {
"$ref": "TestOrderCustomerMarketingRightsInfo",
"description": "Customer's marketing preferences."
},
"explicitMarketingPreference": {
"description": "Deprecated. Please use marketingRightsInfo instead.",
"type": "boolean"
}
}
},
"ShippingsettingsCustomBatchResponseEntry": {
"type": "object",
"description": "A batch entry encoding a single non-batch shipping settings response.",
"properties": {
"batchId": {
"description": "The ID of the request entry to which this entry responds.",
"type": "integer",
"format": "uint32"
},
"shippingSettings": {
"$ref": "ShippingSettings",
"description": "The retrieved or updated account shipping settings."
},
"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#shippingsettingsCustomBatchResponseEntry`\"",
"type": "string"
}
},
"id": "ShippingsettingsCustomBatchResponseEntry"
},
"ShippingsettingsGetSupportedPickupServicesResponse": {
"properties": {
"kind": {
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#shippingsettingsGetSupportedPickupServicesResponse\".",
"type": "string"
},
"pickupServices": {
"type": "array",
"items": {
"$ref": "PickupServicesPickupService"
},
"description": "A list of supported pickup services. May be empty."
}
},
"type": "object",
"id": "ShippingsettingsGetSupportedPickupServicesResponse"
},
"DatafeedsFetchNowResponse": {
"type": "object",
"id": "DatafeedsFetchNowResponse",
"properties": {
"kind": {
"type": "string",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#datafeedsFetchNowResponse\"."
}
}
},
"ReturnShipment": {
"properties": {
"deliveryDate": {
"type": "string",
"description": "The date of delivery of the shipment, in ISO 8601 format."
},
"returnMethodType": {
"type": "string",
"description": "Type of the return method. Acceptable values are: - \"`byMail`\" - \"`contactCustomerSupport`\" - \"`returnless`\" "
},
"shipmentId": {
"description": "Shipment ID generated by Google.",
"type": "string"
},
"creationDate": {
"type": "string",
"description": "The date of creation of the shipment, in ISO 8601 format."
},
"shippingDate": {
"description": "The date of shipping of the shipment, in ISO 8601 format.",
"type": "string"
},
"state": {
"type": "string",
"description": "State of the shipment. Acceptable values are: - \"`completed`\" - \"`new`\" - \"`shipped`\" - \"`undeliverable`\" - \"`pending`\" "
},
"shipmentTrackingInfos": {
"items": {
"$ref": "ShipmentTrackingInfo"
},
"description": "Tracking information of the shipment. One return shipment might be handled by several shipping carriers sequentially.",
"type": "array"
}
},
"type": "object",
"id": "ReturnShipment"
},
"AccountStatusStatistics": {
"id": "AccountStatusStatistics",
"type": "object",
"properties": {
"expiring": {
"description": "Number of expiring offers.",
"type": "string",
"format": "int64"
},
"disapproved": {
"format": "int64",
"description": "Number of disapproved offers.",
"type": "string"
},
"active": {
"format": "int64",
"type": "string",
"description": "Number of active offers."
},
"pending": {
"type": "string",
"description": "Number of pending offers.",
"format": "int64"
}
}
},
"InvoiceSummary": {
"type": "object",
"properties": {
"googleBalance": {
"description": "Deprecated.",
"$ref": "Amount"
},
"merchantBalance": {
"$ref": "Amount",
"description": "Deprecated."
},
"productTotal": {
"$ref": "Amount",
"description": "[required] Total price for the product."
},
"promotionSummaries": {
"description": "Deprecated.",
"items": {
"$ref": "Promotion"
},
"type": "array"
},
"customerBalance": {
"$ref": "Amount",
"description": "Deprecated."
},
"additionalChargeSummaries": {
"type": "array",
"description": "Summary of the total amounts of the additional charges.",
"items": {
"$ref": "InvoiceSummaryAdditionalChargeSummary"
}
}
},
"id": "InvoiceSummary"
},
"OrdersCustomBatchRequestEntryInStoreRefundLineItem": {
"type": "object",
"properties": {
"amountTax": {
"description": "Tax amount that correspond to refund amount in amountPretax. Required.",
"$ref": "Price"
},
"lineItemId": {
"description": "The ID of the line item to return. Either lineItemId or productId is required.",
"type": "string"
},
"reason": {
"type": "string",
"description": "The reason for the return. Acceptable values are: - \"`customerDiscretionaryReturn`\" - \"`customerInitiatedMerchantCancel`\" - \"`deliveredTooLate`\" - \"`expiredItem`\" - \"`invalidCoupon`\" - \"`malformedShippingAddress`\" - \"`other`\" - \"`productArrivedDamaged`\" - \"`productNotAsDescribed`\" - \"`qualityNotAsExpected`\" - \"`undeliverableShippingAddress`\" - \"`unsupportedPoBoxAddress`\" - \"`wrongProductShipped`\" "
},
"productId": {
"type": "string",
"description": "The ID of the product to return. This is the REST ID used in the products service. Either lineItemId or productId is required."
},
"reasonText": {
"type": "string",
"description": "The explanation of the reason."
},
"quantity": {
"type": "integer",
"description": "The quantity to return and refund.",
"format": "uint32"
},
"amountPretax": {
"description": "The amount that is refunded. Required.",
"$ref": "Price"
}
},
"id": "OrdersCustomBatchRequestEntryInStoreRefundLineItem"
},
"ProductStatusItemLevelIssue": {
"type": "object",
"properties": {
"code": {
"description": "The error code of the issue.",
"type": "string"
},
"destination": {
"type": "string",
"description": "The destination the issue applies to."
},
"detail": {
"type": "string",
"description": "A detailed issue description in English."
},
"description": {
"description": "A short issue description in English.",
"type": "string"
},
"resolution": {
"description": "Whether the issue can be resolved by the merchant.",
"type": "string"
},
"servability": {
"description": "How this issue affects serving of the offer.",
"type": "string"
},
"attributeName": {
"description": "The attribute's name, if the issue is caused by a single attribute.",
"type": "string"
},
"documentation": {
"description": "The URL of a web page to help with resolving this issue.",
"type": "string"
}
},
"id": "ProductStatusItemLevelIssue"
},
"AccountsCustomBatchRequestEntryLinkRequest": {
"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"
},
"linkType": {
"description": "Type of the link between the two accounts. Acceptable values are: - \"`channelPartner`\" - \"`eCommercePlatform`\" ",
"type": "string"
},
"linkedAccountId": {
"type": "string",
"description": "The ID of the linked account."
}
},
"id": "AccountsCustomBatchRequestEntryLinkRequest",
"type": "object"
},
"PickupCarrierService": {
"id": "PickupCarrierService",
"type": "object",
"properties": {
"carrierName": {
"description": "The name of the pickup carrier (e.g., `\"UPS\"`). Required.",
"type": "string"
},
"serviceName": {
"type": "string",
"description": "The name of the pickup service (e.g., `\"Access point\"`). Required."
}
}
},
"LiasettingsRequestInventoryVerificationResponse": {
"properties": {
"kind": {
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#liasettingsRequestInventoryVerificationResponse\".",
"type": "string"
}
},
"id": "LiasettingsRequestInventoryVerificationResponse",
"type": "object"
},
"ProductAspect": {
"properties": {
"aspectName": {
"type": "string",
"description": "Deprecated."
},
"destinationName": {
"type": "string",
"description": "Deprecated."
},
"intention": {
"type": "string",
"description": "Deprecated."
}
},
"type": "object",
"id": "ProductAspect"
},
"DatafeedStatusExample": {
"properties": {
"itemId": {
"type": "string",
"description": "The ID of the example item."
},
"lineNumber": {
"format": "uint64",
"type": "string",
"description": "Line number in the data feed where the example is found."
},
"value": {
"type": "string",
"description": "The problematic value."
}
},
"type": "object",
"id": "DatafeedStatusExample",
"description": "An example occurrence for a particular error."
},
"AccountstatusesCustomBatchRequest": {
"type": "object",
"properties": {
"entries": {
"description": "The request entries to be processed in the batch.",
"type": "array",
"items": {
"$ref": "AccountstatusesCustomBatchRequestEntry"
}
}
},
"id": "AccountstatusesCustomBatchRequest"
},
"ProductStatusDataQualityIssue": {
"type": "object",
"id": "ProductStatusDataQualityIssue",
"properties": {
"id": {
"type": "string"
},
"valueOnLandingPage": {
"type": "string"
},
"severity": {
"type": "string"
},
"valueProvided": {
"type": "string"
},
"destination": {
"type": "string"
},
"fetchStatus": {
"type": "string"
},
"detail": {
"type": "string"
},
"timestamp": {
"type": "string"
},
"location": {
"type": "string"
}
}
},
"OrdersSetLineItemMetadataRequest": {
"properties": {
"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"
},
"lineItemId": {
"type": "string",
"description": "The ID of the line item to set metadata. Either lineItemId or productId is required."
},
"annotations": {
"items": {
"$ref": "OrderMerchantProvidedAnnotation"
},
"type": "array"
},
"operationId": {
"type": "string",
"description": "The ID of the operation. Unique across all operations for a given order."
}
},
"type": "object",
"id": "OrdersSetLineItemMetadataRequest"
},
"CustomerReturnReason": {
"id": "CustomerReturnReason",
"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": {
"type": "string",
"description": "Description of the reason."
}
},
"type": "object"
},
"ProductsCustomBatchRequestEntry": {
"id": "ProductsCustomBatchRequestEntry",
"properties": {
"productId": {
"description": "The ID of the product to get or delete. Only defined if the method is `get` or `delete`.",
"type": "string"
},
"batchId": {
"description": "An entry ID, unique within the batch request.",
"format": "uint32",
"type": "integer"
},
"merchantId": {
"type": "string",
"format": "uint64",
"description": "The ID of the managing account."
},
"method": {
"description": "The method of the batch entry. Acceptable values are: - \"`delete`\" - \"`get`\" - \"`insert`\" ",
"type": "string"
},
"product": {
"description": "The product to insert. Only required if the method is `insert`.",
"$ref": "Product"
}
},
"description": "A batch entry encoding a single non-batch products request.",
"type": "object"
},
"OrderCancellation": {
"properties": {
"actor": {
"type": "string",
"description": "The actor that created the cancellation. Acceptable values are: - \"`customer`\" - \"`googleBot`\" - \"`googleCustomerService`\" - \"`googlePayments`\" - \"`googleSabre`\" - \"`merchant`\" "
},
"reasonText": {
"type": "string",
"description": "The explanation of the reason."
},
"creationDate": {
"description": "Date on which the cancellation has been created, in ISO 8601 format.",
"type": "string"
},
"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 will not 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`\" ",
"type": "string"
},
"quantity": {
"type": "integer",
"format": "uint32",
"description": "The quantity that was canceled."
}
},
"type": "object",
"id": "OrderCancellation"
},
"AccountsCustomBatchResponse": {
"id": "AccountsCustomBatchResponse",
"type": "object",
"properties": {
"kind": {
"type": "string",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#accountsCustomBatchResponse\"."
},
"entries": {
"items": {
"$ref": "AccountsCustomBatchResponseEntry"
},
"description": "The result of the execution of the batch requests.",
"type": "array"
}
}
},
"PosInventoryResponse": {
"properties": {
"itemId": {
"type": "string",
"description": "Required. A unique identifier for the item."
},
"gtin": {
"type": "string",
"description": "Global Trade Item Number."
},
"kind": {
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#posInventoryResponse\".",
"type": "string"
},
"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"
},
"contentLanguage": {
"type": "string",
"description": "Required. The two-letter ISO 639-1 language code for the item."
},
"targetCountry": {
"type": "string",
"description": "Required. The CLDR territory code for the item."
},
"storeCode": {
"type": "string",
"description": "Required. The identifier of the merchant's store. Either a `storeCode` inserted via the API or the code of the store in Google My Business."
},
"price": {
"description": "Required. The current price of the item.",
"$ref": "Price"
}
},
"type": "object",
"id": "PosInventoryResponse"
},
"OrdersCancelResponse": {
"type": "object",
"properties": {
"kind": {
"type": "string",
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#ordersCancelResponse\"."
},
"executionStatus": {
"description": "The status of the execution. Acceptable values are: - \"`duplicate`\" - \"`executed`\" ",
"type": "string"
}
},
"id": "OrdersCancelResponse"
},
"ShippingsettingsGetSupportedHolidaysResponse": {
"type": "object",
"properties": {
"holidays": {
"type": "array",
"items": {
"$ref": "HolidaysHoliday"
},
"description": "A list of holidays applicable for delivery guarantees. May be empty."
},
"kind": {
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#shippingsettingsGetSupportedHolidaysResponse\".",
"type": "string"
}
},
"id": "ShippingsettingsGetSupportedHolidaysResponse"
},
"ProductUnitPricingMeasure": {
"properties": {
"value": {
"format": "double",
"type": "number",
"description": "The measure of an item."
},
"unit": {
"type": "string",
"description": "The unit of the measure."
}
},
"id": "ProductUnitPricingMeasure",
"type": "object"
},
"OrderPickupDetailsCollector": {
"properties": {
"name": {
"description": "Name of the person picking up the shipment.",
"type": "string"
},
"phoneNumber": {
"type": "string",
"description": "Phone number of the person picking up the shipment."
}
},
"type": "object",
"id": "OrderPickupDetailsCollector"
},
"OrderinvoicesCreateChargeInvoiceRequest": {
"type": "object",
"properties": {
"invoiceId": {
"description": "[required] The ID of the invoice.",
"type": "string"
},
"shipmentGroupId": {
"type": "string",
"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."
},
"operationId": {
"type": "string",
"description": "[required] The ID of the operation, unique across all operations for a given order."
},
"lineItemInvoices": {
"type": "array",
"items": {
"$ref": "ShipmentInvoiceLineItemInvoice"
},
"description": "[required] Invoice details per line item."
},
"invoiceSummary": {
"$ref": "InvoiceSummary",
"description": "[required] Invoice summary."
}
},
"id": "OrderinvoicesCreateChargeInvoiceRequest"
},
"OrderLineItemShippingDetails": {
"properties": {
"type": {
"type": "string",
"description": "Type of shipment. Indicates whether `deliveryDetails` or `pickupDetails` is applicable for this shipment. Acceptable values are: - \"`delivery`\" - \"`pickup`\" "
},
"method": {
"description": "Required. Details of the shipping method.",
"$ref": "OrderLineItemShippingDetailsMethod"
},
"deliverByDate": {
"type": "string",
"description": "Required. The delivery by date, in ISO 8601 format."
},
"shipByDate": {
"type": "string",
"description": "Required. The ship by date, in ISO 8601 format."
}
},
"type": "object",
"id": "OrderLineItemShippingDetails"
},
"OrdersCancelLineItemResponse": {
"id": "OrdersCancelLineItemResponse",
"type": "object",
"properties": {
"executionStatus": {
"type": "string",
"description": "The status of the execution. Acceptable values are: - \"`duplicate`\" - \"`executed`\" "
},
"kind": {
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#ordersCancelLineItemResponse\".",
"type": "string"
}
}
},
"DatafeedStatusError": {
"type": "object",
"id": "DatafeedStatusError",
"properties": {
"code": {
"description": "The code of the error, e.g., \"validation/invalid_value\".",
"type": "string"
},
"examples": {
"description": "A list of example occurrences of the error, grouped by product.",
"items": {
"$ref": "DatafeedStatusExample"
},
"type": "array"
},
"count": {
"type": "string",
"description": "The number of occurrences of the error in the feed.",
"format": "uint64"
},
"message": {
"type": "string",
"description": "The error message, e.g., \"Invalid price\"."
}
},
"description": "An error occurring in the feed, like \"invalid price\"."
},
"OrdersUpdateMerchantOrderIdRequest": {
"properties": {
"merchantOrderId": {
"type": "string",
"description": "The merchant order id to be assigned to the order. Must be unique per merchant."
},
"operationId": {
"type": "string",
"description": "The ID of the operation. Unique across all operations for a given order."
}
},
"type": "object",
"id": "OrdersUpdateMerchantOrderIdRequest"
},
"OrderLineItemProductFee": {
"id": "OrderLineItemProductFee",
"properties": {
"name": {
"description": "Name of the fee.",
"type": "string"
},
"amount": {
"description": "Amount of the fee.",
"$ref": "Price"
}
},
"type": "object"
},
"TestOrderPaymentMethod": {
"properties": {
"lastFourDigits": {
"type": "string",
"description": "The last four digits of the card number."
},
"expirationYear": {
"type": "integer",
"description": "The card expiration year (4-digit, e.g. 2015).",
"format": "int32"
},
"type": {
"description": "The type of instrument. Note that real orders might have different values than the four values accepted by `createTestOrder`. Acceptable values are: - \"`AMEX`\" - \"`DISCOVER`\" - \"`MASTERCARD`\" - \"`VISA`\" ",
"type": "string"
},
"predefinedBillingAddress": {
"description": "The billing address. Acceptable values are: - \"`dwight`\" - \"`jim`\" - \"`pam`\" ",
"type": "string"
},
"expirationMonth": {
"type": "integer",
"format": "int32",
"description": "The card expiration month (January = 1, February = 2 etc.)."
}
},
"type": "object",
"id": "TestOrderPaymentMethod"
},
"OrdersCancelRequest": {
"id": "OrdersCancelRequest",
"properties": {
"reasonText": {
"description": "The explanation of the reason.",
"type": "string"
},
"reason": {
"type": "string",
"description": "The reason for the cancellation. Acceptable values are: - \"`customerInitiatedCancel`\" - \"`invalidCoupon`\" - \"`malformedShippingAddress`\" - \"`noInventory`\" - \"`other`\" - \"`priceError`\" - \"`shippingPriceError`\" - \"`taxError`\" - \"`undeliverableShippingAddress`\" - \"`unsupportedPoBoxAddress`\" "
},
"operationId": {
"type": "string",
"description": "The ID of the operation. Unique across all operations for a given order."
}
},
"type": "object"
},
"ProductsCustomBatchRequest": {
"properties": {
"entries": {
"type": "array",
"description": "The request entries to be processed in the batch.",
"items": {
"$ref": "ProductsCustomBatchRequestEntry"
}
}
},
"type": "object",
"id": "ProductsCustomBatchRequest"
},
"OrderRefund": {
"type": "object",
"id": "OrderRefund",
"properties": {
"reason": {
"type": "string",
"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`\" "
},
"amount": {
"description": "The amount that is refunded.",
"$ref": "Price"
},
"actor": {
"description": "The actor that created the refund. Acceptable values are: - \"`customer`\" - \"`googleBot`\" - \"`googleCustomerService`\" - \"`googlePayments`\" - \"`googleSabre`\" - \"`merchant`\" ",
"type": "string"
},
"creationDate": {
"type": "string",
"description": "Date on which the item has been created, in ISO 8601 format."
},
"reasonText": {
"description": "The explanation of the reason.",
"type": "string"
}
}
},
"InventoryCustomBatchResponse": {
"properties": {
"kind": {
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#inventoryCustomBatchResponse\".",
"type": "string"
},
"entries": {
"type": "array",
"items": {
"$ref": "InventoryCustomBatchResponseEntry"
},
"description": "The result of the execution of the batch requests."
}
},
"type": "object",
"id": "InventoryCustomBatchResponse"
},
"UnitInvoice": {
"id": "UnitInvoice",
"type": "object",
"properties": {
"additionalCharges": {
"items": {
"$ref": "UnitInvoiceAdditionalCharge"
},
"type": "array",
"description": "Additional charges for a unit, e.g. shipping costs."
},
"unitPriceTaxes": {
"items": {
"$ref": "UnitInvoiceTaxLine"
},
"description": "Tax amounts to apply to the unit price.",
"type": "array"
},
"unitPricePretax": {
"description": "[required] Price of the unit, before applying taxes.",
"$ref": "Price"
},
"promotions": {
"type": "array",
"items": {
"$ref": "Promotion"
},
"description": "Deprecated."
}
}
},
"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"
}
},
"id": "PosCustomBatchResponse"
},
"LiasettingsRequestGmbAccessResponse": {
"type": "object",
"properties": {
"kind": {
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#liasettingsRequestGmbAccessResponse\".",
"type": "string"
}
},
"id": "LiasettingsRequestGmbAccessResponse"
},
"TransitTableTransitTimeRowTransitTimeValue": {
"type": "object",
"id": "TransitTableTransitTimeRowTransitTimeValue",
"properties": {
"minTransitTimeInDays": {
"description": "Transit time range (min-max) in business days. 0 means same day delivery, 1 means next day delivery.",
"format": "uint32",
"type": "integer"
},
"maxTransitTimeInDays": {
"type": "integer",
"description": "Must be greater than or equal to `minTransitTimeInDays`.",
"format": "uint32"
}
}
},
"AccountStatusExampleItem": {
"id": "AccountStatusExampleItem",
"type": "object",
"properties": {
"valueOnLandingPage": {
"type": "string"
},
"title": {
"type": "string"
},
"link": {
"type": "string"
},
"itemId": {
"type": "string"
},
"submittedValue": {
"type": "string"
}
}
},
"TestOrderLineItem": {
"id": "TestOrderLineItem",
"properties": {
"unitTax": {
"description": "Deprecated. Ignored if provided.",
"$ref": "Price"
},
"shippingDetails": {
"description": "Required. Details of the requested shipping for the line item.",
"$ref": "OrderLineItemShippingDetails"
},
"returnInfo": {
"$ref": "OrderLineItemReturnInfo",
"description": "Required. Details of the return policy for the line item."
},
"quantityOrdered": {
"format": "uint32",
"description": "Required. Number of items ordered.",
"type": "integer"
},
"product": {
"description": "Required. Product data from the time of the order placement.",
"$ref": "TestOrderLineItemProduct"
}
},
"type": "object"
},
"DatafeedFetchSchedule": {
"description": "The required fields vary based on the frequency of fetching. For a monthly fetch schedule, day_of_month and hour are required. For a weekly fetch schedule, weekday and hour are required. For a daily fetch schedule, only hour is required.",
"id": "DatafeedFetchSchedule",
"properties": {
"dayOfMonth": {
"format": "uint32",
"type": "integer",
"description": "The day of the month the feed file should be fetched (1-31)."
},
"minuteOfHour": {
"description": "The minute of the hour the feed file should be fetched (0-59). Read-only.",
"type": "integer",
"format": "uint32"
},
"paused": {
"type": "boolean",
"description": "Whether the scheduled fetch is paused or not."
},
"hour": {
"type": "integer",
"format": "uint32",
"description": "The hour of the day the feed file should be fetched (0-23)."
},
"password": {
"type": "string",
"description": "An optional password for fetch_url."
},
"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"
},
"timeZone": {
"type": "string",
"description": "Time zone used for schedule. UTC by default. E.g., \"America/Los_Angeles\"."
},
"weekday": {
"type": "string",
"description": "The day of the week the feed file should be fetched. Acceptable values are: - \"`monday`\" - \"`tuesday`\" - \"`wednesday`\" - \"`thursday`\" - \"`friday`\" - \"`saturday`\" - \"`sunday`\" "
}
},
"type": "object"
},
"OrdersCustomBatchRequestEntryReturnRefundLineItem": {
"properties": {
"lineItemId": {
"description": "The ID of the line item to return. Either lineItemId or productId is required.",
"type": "string"
},
"reason": {
"type": "string",
"description": "The reason for the return. Acceptable values are: - \"`customerDiscretionaryReturn`\" - \"`customerInitiatedMerchantCancel`\" - \"`deliveredTooLate`\" - \"`expiredItem`\" - \"`invalidCoupon`\" - \"`malformedShippingAddress`\" - \"`other`\" - \"`productArrivedDamaged`\" - \"`productNotAsDescribed`\" - \"`qualityNotAsExpected`\" - \"`undeliverableShippingAddress`\" - \"`unsupportedPoBoxAddress`\" - \"`wrongProductShipped`\" "
},
"reasonText": {
"description": "The explanation of the reason.",
"type": "string"
},
"amountPretax": {
"description": "The amount that is refunded. If omitted, refundless return is assumed (same as calling returnLineItem method).",
"$ref": "Price"
},
"productId": {
"type": "string",
"description": "The ID of the product to return. This is the REST ID used in the products service. Either lineItemId or productId is required."
},
"amountTax": {
"$ref": "Price",
"description": "Tax amount that corresponds to refund amount in amountPretax. Optional, but if filled, then amountPretax must be set. Calculated automatically if not provided."
},
"quantity": {
"type": "integer",
"description": "The quantity to return and refund.",
"format": "uint32"
}
},
"id": "OrdersCustomBatchRequestEntryReturnRefundLineItem",
"type": "object"
},
"PosInventoryRequest": {
"id": "PosInventoryRequest",
"type": "object",
"properties": {
"storeCode": {
"type": "string",
"description": "Required. The identifier of the merchant's store. Either a `storeCode` inserted via the API or the code of the store in Google My Business."
},
"itemId": {
"description": "Required. A unique identifier for the item.",
"type": "string"
},
"contentLanguage": {
"type": "string",
"description": "Required. The two-letter ISO 639-1 language code for the item."
},
"price": {
"$ref": "Price",
"description": "Required. The current price of the item."
},
"quantity": {
"format": "int64",
"type": "string",
"description": "Required. The available quantity of the item."
},
"gtin": {
"description": "Global Trade Item Number.",
"type": "string"
},
"targetCountry": {
"type": "string",
"description": "Required. The CLDR territory code for the item."
},
"timestamp": {
"description": "Required. The inventory timestamp, in ISO 8601 format.",
"type": "string"
}
}
},
"AccountsLinkRequest": {
"properties": {
"action": {
"type": "string",
"description": "Action to perform for this link. The `\"request\"` action is only available to select merchants. Acceptable values are: - \"`approve`\" - \"`remove`\" - \"`request`\" "
},
"linkType": {
"description": "Type of the link between the two accounts. Acceptable values are: - \"`channelPartner`\" - \"`eCommercePlatform`\" ",
"type": "string"
},
"linkedAccountId": {
"description": "The ID of the linked account.",
"type": "string"
}
},
"type": "object",
"id": "AccountsLinkRequest"
},
"DatafeedsCustomBatchRequestEntry": {
"description": "A batch entry encoding a single non-batch datafeeds request.",
"type": "object",
"id": "DatafeedsCustomBatchRequestEntry",
"properties": {
"datafeed": {
"$ref": "Datafeed",
"description": "The data feed to insert."
},
"merchantId": {
"description": "The ID of the managing account.",
"format": "uint64",
"type": "string"
},
"method": {
"description": "The method of the batch entry. Acceptable values are: - \"`delete`\" - \"`fetchNow`\" - \"`get`\" - \"`insert`\" - \"`update`\" ",
"type": "string"
},
"datafeedId": {
"type": "string",
"format": "uint64",
"description": "The ID of the data feed to get, delete or fetch."
},
"batchId": {
"type": "integer",
"description": "An entry ID, unique within the batch request.",
"format": "uint32"
}
}
},
"PickupServicesPickupService": {
"properties": {
"serviceName": {
"type": "string",
"description": "The name of the pickup service (e.g., `\"Access point\"`). Always present."
},
"carrierName": {
"description": "The name of the carrier (e.g., `\"UPS\"`). Always present.",
"type": "string"
},
"country": {
"type": "string",
"description": "The CLDR country code of the carrier (e.g., \"US\"). Always present."
}
},
"id": "PickupServicesPickupService",
"type": "object"
},
"OrderMerchantProvidedAnnotation": {
"properties": {
"value": {
"type": "string",
"description": "Value for additional merchant provided (as key-value pairs) annotation about the line item."
},
"key": {
"description": "Key for additional merchant provided (as key-value pairs) annotation about the line item.",
"type": "string"
}
},
"type": "object",
"id": "OrderMerchantProvidedAnnotation"
},
"HolidayCutoff": {
"type": "object",
"id": "HolidayCutoff",
"properties": {
"deadlineTimezone": {
"description": "Timezone identifier for the deadline hour. A list of identifiers can be found in the AdWords API documentation. E.g. \"Europe/Zurich\". Required.",
"type": "string"
},
"deadlineDate": {
"description": "Date of the order deadline, in ISO 8601 format. E.g. \"2016-11-29\" for 29th November 2016. Required.",
"type": "string"
},
"holidayId": {
"type": "string",
"description": "Unique identifier for the holiday. Required."
},
"visibleFromDate": {
"type": "string",
"description": "Date on which the deadline will become visible to consumers in ISO 8601 format. E.g. \"2016-10-31\" for 31st October 2016. Required."
},
"deadlineHour": {
"type": "integer",
"description": "Hour of the day on the deadline date until which the order has to be placed to qualify for the delivery guarantee. Possible values are: 0 (midnight), 1, ..., 12 (noon), 13, ..., 23. Required.",
"format": "uint32"
}
}
},
"AccountIdentifier": {
"type": "object",
"id": "AccountIdentifier",
"properties": {
"merchantId": {
"format": "uint64",
"type": "string",
"description": "The merchant account ID, set for individual accounts and subaccounts."
},
"aggregatorId": {
"description": "The aggregator ID, set for aggregators and subaccounts (in that case, it represents the aggregator of the subaccount).",
"type": "string",
"format": "uint64"
}
}
},
"ProductsCustomBatchResponse": {
"id": "ProductsCustomBatchResponse",
"type": "object",
"properties": {
"entries": {
"items": {
"$ref": "ProductsCustomBatchResponseEntry"
},
"description": "The result of the execution of the batch requests.",
"type": "array"
},
"kind": {
"description": "Identifies what kind of resource this is. Value: the fixed string \"content#productsCustomBatchResponse\".",
"type": "string"
}
}
},
"AccountYouTubeChannelLink": {
"type": "object",
"id": "AccountYouTubeChannelLink",
"properties": {
"status": {
"type": "string",
"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."
},
"channelId": {
"description": "Channel ID.",
"type": "string"
}
}
},
"ProductstatusesCustomBatchRequestEntry": {
"description": "A batch entry encoding a single non-batch productstatuses request.",
"type": "object",
"properties": {
"destinations": {
"description": "If set, only issues for the specified destinations are returned, otherwise only issues for the Shopping destination.",
"items": {
"type": "string"
},
"type": "array"
},
"includeAttributes": {
"type": "boolean"
},
"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"
},
"batchId": {
"format": "uint32",
"type": "integer",
"description": "An entry ID, unique within the batch request."
},
"merchantId": {
"description": "The ID of the managing account.",
"type": "string",
"format": "uint64"
}
},
"id": "ProductstatusesCustomBatchRequestEntry"
}
},
"resources": {
"accounts": {
"methods": {
"custombatch": {
"scopes": [
"https://www.googleapis.com/auth/content"
],
"path": "content/v2/accounts/batch",
"flatPath": "content/v2/accounts/batch",
"id": "content.accounts.custombatch",
"request": {
"$ref": "AccountsCustomBatchRequest"
},
"description": "Retrieves, inserts, updates, and deletes multiple Merchant Center (sub-)accounts in a single request.",
"httpMethod": "POST",
"parameters": {
"dryRun": {
"location": "query",
"description": "Flag to simulate a request like in a live environment. If set to true, dry-run mode checks the validity of the request and returns errors (if any).",
"type": "boolean"
}
},
"parameterOrder": [],
"response": {
"$ref": "AccountsCustomBatchResponse"
}
},
"get": {
"response": {
"$ref": "Account"
},
"parameterOrder": [
"merchantId",
"accountId"
],
"httpMethod": "GET",
"id": "content.accounts.get",
"parameters": {
"accountId": {
"description": "The ID of the account.",
"required": true,
"location": "path",
"type": "string",
"format": "uint64"
},
"merchantId": {
"type": "string",
"description": "The ID of the managing account. If this parameter is not the same as accountId, then this account must be a multi-client account and `accountId` must be the ID of a sub-account of this account.",
"format": "uint64",
"required": true,
"location": "path"
}
},
"scopes": [
"https://www.googleapis.com/auth/content"
],
"path": "content/v2/{merchantId}/accounts/{accountId}",
"description": "Retrieves a Merchant Center account.",
"flatPath": "content/v2/{merchantId}/accounts/{accountId}"
},
"list": {
"flatPath": "content/v2/{merchantId}/accounts",
"parameters": {
"merchantId": {
"description": "The ID of the managing account. This must be a multi-client account.",
"required": true,
"location": "path",
"type": "string",
"format": "uint64"
},
"pageToken": {
"description": "The token returned by the previous request.",
"location": "query",
"type": "string"
},
"maxResults": {
"location": "query",
"format": "uint32",
"type": "integer",
"description": "The maximum number of accounts to return in the response, used for paging."
}
},
"id": "content.accounts.list",
"scopes": [
"https://www.googleapis.com/auth/content"
],
"description": "Lists the sub-accounts in your Merchant Center account.",
"response": {
"$ref": "AccountsListResponse"
},
"parameterOrder": [
"merchantId"
],
"path": "content/v2/{merchantId}/accounts",
"httpMethod": "GET"
},
"insert": {
"parameterOrder": [
"merchantId"
],
"flatPath": "content/v2/{merchantId}/accounts",
"httpMethod": "POST",
"request": {
"$ref": "Account"
},
"id": "content.accounts.insert",
"path": "content/v2/{merchantId}/accounts",
"parameters": {
"merchantId": {
"type": "string",
"description": "The ID of the managing account. This must be a multi-client account.",
"format": "uint64",
"required": true,
"location": "path"
},
"dryRun": {
"description": "Flag to simulate a request like in a live environment. If set to true, dry-run mode checks the validity of the request and returns errors (if any).",
"location": "query",
"type": "boolean"
}
},
"description": "Creates a Merchant Center sub-account.",
"response": {
"$ref": "Account"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"authinfo": {
"flatPath": "content/v2/accounts/authinfo",
"path": "content/v2/accounts/authinfo",
"id": "content.accounts.authinfo",
"parameters": {},
"parameterOrder": [],
"httpMethod": "GET",
"scopes": [
"https://www.googleapis.com/auth/content"
],
"description": "Returns information about the authenticated user.",
"response": {
"$ref": "AccountsAuthInfoResponse"
}
},
"link": {
"flatPath": "content/v2/{merchantId}/accounts/{accountId}/link",
"scopes": [
"https://www.googleapis.com/auth/content"
],
"httpMethod": "POST",
"path": "content/v2/{merchantId}/accounts/{accountId}/link",
"parameters": {
"accountId": {
"location": "path",
"required": true,
"type": "string",
"description": "The ID of the account that should be linked.",
"format": "uint64"
},
"merchantId": {
"required": true,
"format": "uint64",
"location": "path",
"type": "string",
"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."
}
},
"description": "Performs an action on a link between two Merchant Center accounts, namely accountId and linkedAccountId.",
"request": {
"$ref": "AccountsLinkRequest"
},
"id": "content.accounts.link",
"parameterOrder": [
"merchantId",
"accountId"
],
"response": {
"$ref": "AccountsLinkResponse"
}
},
"update": {
"path": "content/v2/{merchantId}/accounts/{accountId}",
"parameterOrder": [
"merchantId",
"accountId"
],
"parameters": {
"dryRun": {
"location": "query",
"description": "Flag to simulate a request like in a live environment. If set to true, dry-run mode checks the validity of the request and returns errors (if any).",
"type": "boolean"
},
"accountId": {
"type": "string",
"format": "uint64",
"required": true,
"description": "The ID of the account.",
"location": "path"
},
"merchantId": {
"location": "path",
"format": "uint64",
"type": "string",
"required": true,
"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."
}
},
"request": {
"$ref": "Account"
},
"flatPath": "content/v2/{merchantId}/accounts/{accountId}",
"description": "Updates a Merchant Center account. Any fields that are not provided are deleted from the resource.",
"httpMethod": "PUT",
"scopes": [
"https://www.googleapis.com/auth/content"
],
"id": "content.accounts.update",
"response": {
"$ref": "Account"
}
},
"claimwebsite": {
"path": "content/v2/{merchantId}/accounts/{accountId}/claimwebsite",
"parameters": {
"accountId": {
"type": "string",
"location": "path",
"description": "The ID of the account whose website is claimed.",
"format": "uint64",
"required": true
},
"merchantId": {
"format": "uint64",
"required": true,
"type": "string",
"location": "path",
"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."
},
"overwrite": {
"type": "boolean",
"location": "query",
"description": "Only available to selected merchants. When set to `True`, this flag removes any existing claim on the requested website by another account and replaces it with a claim from this account."
}
},
"id": "content.accounts.claimwebsite",
"httpMethod": "POST",
"parameterOrder": [
"merchantId",
"accountId"
],
"scopes": [
"https://www.googleapis.com/auth/content"
],
"flatPath": "content/v2/{merchantId}/accounts/{accountId}/claimwebsite",
"response": {
"$ref": "AccountsClaimWebsiteResponse"
},
"description": "Claims the website of a Merchant Center sub-account."
},
"delete": {
"description": "Deletes a Merchant Center sub-account.",
"parameters": {
"merchantId": {
"required": true,
"type": "string",
"description": "The ID of the managing account. This must be a multi-client account, and accountId must be the ID of a sub-account of this account.",
"format": "uint64",
"location": "path"
},
"dryRun": {
"type": "boolean",
"description": "Flag to simulate a request like in a live environment. If set to true, dry-run mode checks the validity of the request and returns errors (if any).",
"location": "query"
},
"force": {
"default": "false",
"description": "Flag to delete sub-accounts with products. The default value is false.",
"location": "query",
"type": "boolean"
},
"accountId": {
"location": "path",
"required": true,
"type": "string",
"format": "uint64",
"description": "The ID of the account."
}
},
"id": "content.accounts.delete",
"path": "content/v2/{merchantId}/accounts/{accountId}",
"flatPath": "content/v2/{merchantId}/accounts/{accountId}",
"parameterOrder": [
"merchantId",
"accountId"
],
"httpMethod": "DELETE",
"scopes": [
"https://www.googleapis.com/auth/content"
]
}
}
},
"orderinvoices": {
"methods": {
"createrefundinvoice": {
"parameters": {
"orderId": {
"description": "The ID of the order.",
"location": "path",
"type": "string",
"required": true
},
"merchantId": {
"format": "uint64",
"location": "path",
"description": "The ID of the account that manages the order. This cannot be a multi-client account.",
"type": "string",
"required": true
}
},
"path": "content/v2/{merchantId}/orderinvoices/{orderId}/createRefundInvoice",
"flatPath": "content/v2/{merchantId}/orderinvoices/{orderId}/createRefundInvoice",
"response": {
"$ref": "OrderinvoicesCreateRefundInvoiceResponse"
},
"parameterOrder": [
"merchantId",
"orderId"
],
"id": "content.orderinvoices.createrefundinvoice",
"httpMethod": "POST",
"request": {
"$ref": "OrderinvoicesCreateRefundInvoiceRequest"
},
"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."
},
"createchargeinvoice": {
"flatPath": "content/v2/{merchantId}/orderinvoices/{orderId}/createChargeInvoice",
"scopes": [
"https://www.googleapis.com/auth/content"
],
"id": "content.orderinvoices.createchargeinvoice",
"description": "Creates a charge invoice for a shipment group, and triggers a charge capture for orderinvoice enabled orders.",
"request": {
"$ref": "OrderinvoicesCreateChargeInvoiceRequest"
},
"path": "content/v2/{merchantId}/orderinvoices/{orderId}/createChargeInvoice",
"response": {
"$ref": "OrderinvoicesCreateChargeInvoiceResponse"
},
"parameterOrder": [
"merchantId",
"orderId"
],
"httpMethod": "POST",
"parameters": {
"orderId": {
"location": "path",
"description": "The ID of the order.",
"required": true,
"type": "string"
},
"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"
}
}
}
}
},
"products": {
"methods": {
"insert": {
"httpMethod": "POST",
"flatPath": "content/v2/{merchantId}/products",
"path": "content/v2/{merchantId}/products",
"request": {
"$ref": "Product"
},
"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.",
"id": "content.products.insert",
"parameterOrder": [
"merchantId"
],
"response": {
"$ref": "Product"
},
"parameters": {
"dryRun": {
"location": "query",
"type": "boolean",
"description": "Flag to simulate a request like in a live environment. If set to true, dry-run mode checks the validity of the request and returns errors (if any)."
},
"merchantId": {
"format": "uint64",
"required": true,
"location": "path",
"type": "string",
"description": "The ID of the account that contains the product. This account cannot be a multi-client account."
}
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"list": {
"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.",
"id": "content.products.list",
"httpMethod": "GET",
"path": "content/v2/{merchantId}/products",
"response": {
"$ref": "ProductsListResponse"
},
"flatPath": "content/v2/{merchantId}/products",
"parameters": {
"includeInvalidInsertedItems": {
"location": "query",
"description": "Flag to include the invalid inserted items in the result of the list request. By default the invalid items are not shown (the default value is false).",
"type": "boolean"
},
"maxResults": {
"location": "query",
"type": "integer",
"description": "The maximum number of products to return in the response, used for paging.",
"format": "uint32"
},
"pageToken": {
"type": "string",
"location": "query",
"description": "The token returned by the previous request."
},
"merchantId": {
"description": "The ID of the account that contains the products. This account cannot be a multi-client account.",
"format": "uint64",
"type": "string",
"location": "path",
"required": true
}
},
"parameterOrder": [
"merchantId"
]
},
"get": {
"parameterOrder": [
"merchantId",
"productId"
],
"description": "Retrieves a product from your Merchant Center account.",
"httpMethod": "GET",
"response": {
"$ref": "Product"
},
"id": "content.products.get",
"parameters": {
"productId": {
"type": "string",
"required": true,
"description": "The REST ID of the product.",
"location": "path"
},
"merchantId": {
"required": true,
"format": "uint64",
"type": "string",
"description": "The ID of the account that contains the product. This account cannot be a multi-client account.",
"location": "path"
}
},
"flatPath": "content/v2/{merchantId}/products/{productId}",
"scopes": [
"https://www.googleapis.com/auth/content"
],
"path": "content/v2/{merchantId}/products/{productId}"
},
"delete": {
"parameterOrder": [
"merchantId",
"productId"
],
"scopes": [
"https://www.googleapis.com/auth/content"
],
"httpMethod": "DELETE",
"path": "content/v2/{merchantId}/products/{productId}",
"flatPath": "content/v2/{merchantId}/products/{productId}",
"description": "Deletes a product from your Merchant Center account.",
"id": "content.products.delete",
"parameters": {
"productId": {
"type": "string",
"required": true,
"location": "path",
"description": "The REST ID of the product."
},
"merchantId": {
"type": "string",
"location": "path",
"format": "uint64",
"description": "The ID of the account that contains the product. This account cannot be a multi-client account.",
"required": true
},
"dryRun": {
"description": "Flag to simulate a request like in a live environment. If set to true, dry-run mode checks the validity of the request and returns errors (if any).",
"type": "boolean",
"location": "query"
}
}
},
"custombatch": {
"scopes": [
"https://www.googleapis.com/auth/content"
],
"response": {
"$ref": "ProductsCustomBatchResponse"
},
"path": "content/v2/products/batch",
"id": "content.products.custombatch",
"flatPath": "content/v2/products/batch",
"httpMethod": "POST",
"description": "Retrieves, inserts, and deletes multiple products in a single request.",
"parameterOrder": [],
"request": {
"$ref": "ProductsCustomBatchRequest"
},
"parameters": {
"dryRun": {
"description": "Flag to simulate a request like in a live environment. If set to true, dry-run mode checks the validity of the request and returns errors (if any).",
"type": "boolean",
"location": "query"
}
}
}
}
},
"liasettings": {
"methods": {
"list": {
"description": "Lists the LIA settings of the sub-accounts in your Merchant Center account.",
"path": "content/v2/{merchantId}/liasettings",
"scopes": [
"https://www.googleapis.com/auth/content"
],
"parameterOrder": [
"merchantId"
],
"id": "content.liasettings.list",
"parameters": {
"maxResults": {
"format": "uint32",
"location": "query",
"type": "integer",
"description": "The maximum number of LIA settings to return in the response, used for paging."
},
"pageToken": {
"description": "The token returned by the previous request.",
"location": "query",
"type": "string"
},
"merchantId": {
"location": "path",
"required": true,
"description": "The ID of the managing account. This must be a multi-client account.",
"format": "uint64",
"type": "string"
}
},
"flatPath": "content/v2/{merchantId}/liasettings",
"httpMethod": "GET",
"response": {
"$ref": "LiasettingsListResponse"
}
},
"custombatch": {
"id": "content.liasettings.custombatch",
"description": "Retrieves and/or updates the LIA settings of multiple accounts in a single request.",
"request": {
"$ref": "LiasettingsCustomBatchRequest"
},
"response": {
"$ref": "LiasettingsCustomBatchResponse"
},
"path": "content/v2/liasettings/batch",
"parameterOrder": [],
"flatPath": "content/v2/liasettings/batch",
"scopes": [
"https://www.googleapis.com/auth/content"
],
"parameters": {
"dryRun": {
"description": "Flag to simulate a request like in a live environment. If set to true, dry-run mode checks the validity of the request and returns errors (if any).",
"type": "boolean",
"location": "query"
}
},
"httpMethod": "POST"
},
"get": {
"response": {
"$ref": "LiaSettings"
},
"path": "content/v2/{merchantId}/liasettings/{accountId}",
"parameterOrder": [
"merchantId",
"accountId"
],
"id": "content.liasettings.get",
"flatPath": "content/v2/{merchantId}/liasettings/{accountId}",
"parameters": {
"merchantId": {
"type": "string",
"location": "path",
"format": "uint64",
"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.",
"required": true
},
"accountId": {
"type": "string",
"description": "The ID of the account for which to get or update LIA settings.",
"required": true,
"location": "path",
"format": "uint64"
}
},
"scopes": [
"https://www.googleapis.com/auth/content"
],
"description": "Retrieves the LIA settings of the account.",
"httpMethod": "GET"
},
"requestinventoryverification": {
"httpMethod": "POST",
"response": {
"$ref": "LiasettingsRequestInventoryVerificationResponse"
},
"path": "content/v2/{merchantId}/liasettings/{accountId}/requestinventoryverification/{country}",
"scopes": [
"https://www.googleapis.com/auth/content"
],
"id": "content.liasettings.requestinventoryverification",
"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.",
"required": true,
"format": "uint64",
"type": "string",
"location": "path"
},
"accountId": {
"location": "path",
"description": "The ID of the account that manages the order. This cannot be a multi-client account.",
"format": "uint64",
"required": true,
"type": "string"
},
"country": {
"description": "The country for which inventory validation is requested.",
"location": "path",
"required": true,
"type": "string"
}
},
"parameterOrder": [
"merchantId",
"accountId",
"country"
],
"flatPath": "content/v2/{merchantId}/liasettings/{accountId}/requestinventoryverification/{country}",
"description": "Requests inventory validation for the specified country."
},
"update": {
"scopes": [
"https://www.googleapis.com/auth/content"
],
"httpMethod": "PUT",
"flatPath": "content/v2/{merchantId}/liasettings/{accountId}",
"description": "Updates the LIA settings of the account. Any fields that are not provided are deleted from the resource.",
"parameters": {
"dryRun": {
"location": "query",
"description": "Flag to simulate a request like in a live environment. If set to true, dry-run mode checks the validity of the request and returns errors (if any).",
"type": "boolean"
},
"accountId": {
"location": "path",
"type": "string",
"required": true,
"format": "uint64",
"description": "The ID of the account for which to get or update LIA settings."
},
"merchantId": {
"description": "The ID of the managing account. If this parameter is not the same as accountId, then this account must be a multi-client account and `accountId` must be the ID of a sub-account of this account.",
"format": "uint64",
"location": "path",
"type": "string",
"required": true
}
},
"path": "content/v2/{merchantId}/liasettings/{accountId}",
"request": {
"$ref": "LiaSettings"
},
"id": "content.liasettings.update",
"response": {
"$ref": "LiaSettings"
},
"parameterOrder": [
"merchantId",
"accountId"
]
},
"requestgmbaccess": {
"response": {
"$ref": "LiasettingsRequestGmbAccessResponse"
},
"path": "content/v2/{merchantId}/liasettings/{accountId}/requestgmbaccess",
"httpMethod": "POST",
"parameters": {
"gmbEmail": {
"description": "The email of the Google My Business account.",
"location": "query",
"required": true,
"type": "string"
},
"accountId": {
"description": "The ID of the account for which GMB access is requested.",
"format": "uint64",
"required": true,
"location": "path",
"type": "string"
},
"merchantId": {
"location": "path",
"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.",
"required": true,
"type": "string",
"format": "uint64"
}
},
"description": "Requests access to a specified Google My Business account.",
"parameterOrder": [
"merchantId",
"accountId",
"gmbEmail"
],
"id": "content.liasettings.requestgmbaccess",
"flatPath": "content/v2/{merchantId}/liasettings/{accountId}/requestgmbaccess",
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"getaccessiblegmbaccounts": {
"response": {
"$ref": "LiasettingsGetAccessibleGmbAccountsResponse"
},
"parameters": {
"accountId": {
"type": "string",
"required": true,
"description": "The ID of the account for which to retrieve accessible Google My Business accounts.",
"format": "uint64",
"location": "path"
},
"merchantId": {
"required": true,
"location": "path",
"type": "string",
"description": "The ID of the managing account. If this parameter is not the same as accountId, then this account must be a multi-client account and `accountId` must be the ID of a sub-account of this account.",
"format": "uint64"
}
},
"flatPath": "content/v2/{merchantId}/liasettings/{accountId}/accessiblegmbaccounts",
"parameterOrder": [
"merchantId",
"accountId"
],
"description": "Retrieves the list of accessible Google My Business accounts.",
"httpMethod": "GET",
"id": "content.liasettings.getaccessiblegmbaccounts",
"path": "content/v2/{merchantId}/liasettings/{accountId}/accessiblegmbaccounts",
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"setposdataprovider": {
"flatPath": "content/v2/{merchantId}/liasettings/{accountId}/setposdataprovider",
"response": {
"$ref": "LiasettingsSetPosDataProviderResponse"
},
"path": "content/v2/{merchantId}/liasettings/{accountId}/setposdataprovider",
"httpMethod": "POST",
"parameters": {
"posExternalAccountId": {
"description": "The account ID by which this merchant is known to the POS data provider.",
"type": "string",
"location": "query"
},
"merchantId": {
"format": "uint64",
"location": "path",
"type": "string",
"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.",
"required": true
},
"country": {
"description": "The country for which the POS data provider is selected.",
"location": "query",
"type": "string",
"required": true
},
"accountId": {
"description": "The ID of the account for which to retrieve accessible Google My Business accounts.",
"format": "uint64",
"type": "string",
"location": "path",
"required": true
},
"posDataProviderId": {
"description": "The ID of POS data provider.",
"location": "query",
"type": "string",
"format": "uint64"
}
},
"id": "content.liasettings.setposdataprovider",
"description": "Sets the POS data provider for the specified country.",
"scopes": [
"https://www.googleapis.com/auth/content"
],
"parameterOrder": [
"merchantId",
"accountId",
"country"
]
},
"listposdataproviders": {
"scopes": [
"https://www.googleapis.com/auth/content"
],
"parameters": {},
"httpMethod": "GET",
"response": {
"$ref": "LiasettingsListPosDataProvidersResponse"
},
"path": "content/v2/liasettings/posdataproviders",
"parameterOrder": [],
"description": "Retrieves the list of POS data providers that have active settings for the all eiligible countries.",
"id": "content.liasettings.listposdataproviders",
"flatPath": "content/v2/liasettings/posdataproviders"
},
"setinventoryverificationcontact": {
"response": {
"$ref": "LiasettingsSetInventoryVerificationContactResponse"
},
"id": "content.liasettings.setinventoryverificationcontact",
"flatPath": "content/v2/{merchantId}/liasettings/{accountId}/setinventoryverificationcontact",
"path": "content/v2/{merchantId}/liasettings/{accountId}/setinventoryverificationcontact",
"description": "Sets the inventory verification contract for the specified country.",
"scopes": [
"https://www.googleapis.com/auth/content"
],
"parameterOrder": [
"merchantId",
"accountId",
"country",
"language",
"contactName",
"contactEmail"
],
"parameters": {
"contactName": {
"description": "The name of the inventory verification contact.",
"type": "string",
"location": "query",
"required": true
},
"merchantId": {
"required": true,
"format": "uint64",
"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",
"type": "string"
},
"country": {
"required": true,
"description": "The country for which inventory verification is requested.",
"type": "string",
"location": "query"
},
"contactEmail": {
"location": "query",
"required": true,
"type": "string",
"description": "The email of the inventory verification contact."
},
"accountId": {
"description": "The ID of the account that manages the order. This cannot be a multi-client account.",
"required": true,
"type": "string",
"format": "uint64",
"location": "path"
},
"language": {
"location": "query",
"description": "The language for which inventory verification is requested.",
"required": true,
"type": "string"
}
},
"httpMethod": "POST"
}
}
},
"accountstatuses": {
"methods": {
"custombatch": {
"description": "Retrieves multiple Merchant Center account statuses in a single request.",
"response": {
"$ref": "AccountstatusesCustomBatchResponse"
},
"id": "content.accountstatuses.custombatch",
"flatPath": "content/v2/accountstatuses/batch",
"parameterOrder": [],
"path": "content/v2/accountstatuses/batch",
"parameters": {},
"httpMethod": "POST",
"scopes": [
"https://www.googleapis.com/auth/content"
],
"request": {
"$ref": "AccountstatusesCustomBatchRequest"
}
},
"list": {
"response": {
"$ref": "AccountstatusesListResponse"
},
"id": "content.accountstatuses.list",
"parameterOrder": [
"merchantId"
],
"httpMethod": "GET",
"parameters": {
"merchantId": {
"format": "uint64",
"description": "The ID of the managing account. This must be a multi-client account.",
"location": "path",
"type": "string",
"required": true
},
"destinations": {
"description": "If set, only issues for the specified destinations are returned, otherwise only issues for the Shopping destination.",
"location": "query",
"repeated": true,
"type": "string"
},
"maxResults": {
"format": "uint32",
"description": "The maximum number of account statuses to return in the response, used for paging.",
"location": "query",
"type": "integer"
},
"pageToken": {
"type": "string",
"location": "query",
"description": "The token returned by the previous request."
}
},
"path": "content/v2/{merchantId}/accountstatuses",
"flatPath": "content/v2/{merchantId}/accountstatuses",
"description": "Lists the statuses of the sub-accounts in your Merchant Center account.",
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"get": {
"scopes": [
"https://www.googleapis.com/auth/content"
],
"parameterOrder": [
"merchantId",
"accountId"
],
"path": "content/v2/{merchantId}/accountstatuses/{accountId}",
"id": "content.accountstatuses.get",
"parameters": {
"destinations": {
"description": "If set, only issues for the specified destinations are returned, otherwise only issues for the Shopping destination.",
"location": "query",
"repeated": true,
"type": "string"
},
"accountId": {
"description": "The ID of the account.",
"required": true,
"location": "path",
"type": "string",
"format": "uint64"
},
"merchantId": {
"location": "path",
"description": "The ID of the managing account. If this parameter is not the same as accountId, then this account must be a multi-client account and `accountId` must be the ID of a sub-account of this account.",
"format": "uint64",
"required": true,
"type": "string"
}
},
"description": "Retrieves the status of a Merchant Center account. No itemLevelIssues are returned for multi-client accounts.",
"httpMethod": "GET",
"flatPath": "content/v2/{merchantId}/accountstatuses/{accountId}",
"response": {
"$ref": "AccountStatus"
}
}
}
},
"datafeedstatuses": {
"methods": {
"get": {
"path": "content/v2/{merchantId}/datafeedstatuses/{datafeedId}",
"flatPath": "content/v2/{merchantId}/datafeedstatuses/{datafeedId}",
"parameterOrder": [
"merchantId",
"datafeedId"
],
"scopes": [
"https://www.googleapis.com/auth/content"
],
"httpMethod": "GET",
"response": {
"$ref": "DatafeedStatus"
},
"description": "Retrieves the status of a datafeed from your Merchant Center account.",
"parameters": {
"country": {
"description": "The country for which to get the datafeed status. If this parameter is provided then language must also be provided. Note that this parameter is required for feeds targeting multiple countries and languages, since a feed may have a different status for each target.",
"type": "string",
"location": "query"
},
"merchantId": {
"type": "string",
"description": "The ID of the account that manages the datafeed. This account cannot be a multi-client account.",
"format": "uint64",
"location": "path",
"required": true
},
"datafeedId": {
"location": "path",
"description": "The ID of the datafeed.",
"format": "uint64",
"required": true,
"type": "string"
},
"language": {
"location": "query",
"description": "The language for which to get the datafeed status. If this parameter is provided then country must also be provided. Note that this parameter is required for feeds targeting multiple countries and languages, since a feed may have a different status for each target.",
"type": "string"
}
},
"id": "content.datafeedstatuses.get"
},
"custombatch": {
"id": "content.datafeedstatuses.custombatch",
"path": "content/v2/datafeedstatuses/batch",
"parameterOrder": [],
"scopes": [
"https://www.googleapis.com/auth/content"
],
"response": {
"$ref": "DatafeedstatusesCustomBatchResponse"
},
"request": {
"$ref": "DatafeedstatusesCustomBatchRequest"
},
"parameters": {},
"httpMethod": "POST",
"description": "Gets multiple Merchant Center datafeed statuses in a single request.",
"flatPath": "content/v2/datafeedstatuses/batch"
},
"list": {
"httpMethod": "GET",
"parameterOrder": [
"merchantId"
],
"response": {
"$ref": "DatafeedstatusesListResponse"
},
"scopes": [
"https://www.googleapis.com/auth/content"
],
"id": "content.datafeedstatuses.list",
"flatPath": "content/v2/{merchantId}/datafeedstatuses",
"path": "content/v2/{merchantId}/datafeedstatuses",
"description": "Lists the statuses of the datafeeds in your Merchant Center account.",
"parameters": {
"merchantId": {
"type": "string",
"required": true,
"location": "path",
"description": "The ID of the account that manages the datafeeds. This account cannot be a multi-client account.",
"format": "uint64"
},
"pageToken": {
"location": "query",
"type": "string",
"description": "The token returned by the previous request."
},
"maxResults": {
"description": "The maximum number of products to return in the response, used for paging.",
"location": "query",
"format": "uint32",
"type": "integer"
}
}
}
}
},
"orders": {
"methods": {
"getbymerchantorderid": {
"parameterOrder": [
"merchantId",
"merchantOrderId"
],
"description": "Retrieves an order using merchant order ID.",
"flatPath": "content/v2/{merchantId}/ordersbymerchantid/{merchantOrderId}",
"scopes": [
"https://www.googleapis.com/auth/content"
],
"id": "content.orders.getbymerchantorderid",
"path": "content/v2/{merchantId}/ordersbymerchantid/{merchantOrderId}",
"response": {
"$ref": "OrdersGetByMerchantOrderIdResponse"
},
"httpMethod": "GET",
"parameters": {
"merchantId": {
"required": true,
"type": "string",
"description": "The ID of the account that manages the order. This cannot be a multi-client account.",
"location": "path",
"format": "uint64"
},
"merchantOrderId": {
"location": "path",
"type": "string",
"required": true,
"description": "The merchant order ID to be looked for."
}
}
},
"updatemerchantorderid": {
"response": {
"$ref": "OrdersUpdateMerchantOrderIdResponse"
},
"parameterOrder": [
"merchantId",
"orderId"
],
"path": "content/v2/{merchantId}/orders/{orderId}/updateMerchantOrderId",
"scopes": [
"https://www.googleapis.com/auth/content"
],
"request": {
"$ref": "OrdersUpdateMerchantOrderIdRequest"
},
"id": "content.orders.updatemerchantorderid",
"httpMethod": "POST",
"description": "Updates the merchant order ID for a given order.",
"parameters": {
"merchantId": {
"required": true,
"description": "The ID of the account that manages the order. This cannot be a multi-client account.",
"format": "uint64",
"location": "path",
"type": "string"
},
"orderId": {
"location": "path",
"type": "string",
"required": true,
"description": "The ID of the order."
}
},
"flatPath": "content/v2/{merchantId}/orders/{orderId}/updateMerchantOrderId"
},
"refund": {
"request": {
"$ref": "OrdersRefundRequest"
},
"scopes": [
"https://www.googleapis.com/auth/content"
],
"parameterOrder": [
"merchantId",
"orderId"
],
"id": "content.orders.refund",
"httpMethod": "POST",
"flatPath": "content/v2/{merchantId}/orders/{orderId}/refund",
"path": "content/v2/{merchantId}/orders/{orderId}/refund",
"parameters": {
"merchantId": {
"required": true,
"location": "path",
"format": "uint64",
"description": "The ID of the account that manages the order. This cannot be a multi-client account.",
"type": "string"
},
"orderId": {
"required": true,
"description": "The ID of the order to refund.",
"type": "string",
"location": "path"
}
},
"response": {
"$ref": "OrdersRefundResponse"
},
"description": "Deprecated, please use returnRefundLineItem instead."
},
"custombatch": {
"httpMethod": "POST",
"scopes": [
"https://www.googleapis.com/auth/content"
],
"request": {
"$ref": "OrdersCustomBatchRequest"
},
"id": "content.orders.custombatch",
"flatPath": "content/v2/orders/batch",
"path": "content/v2/orders/batch",
"response": {
"$ref": "OrdersCustomBatchResponse"
},
"description": "Retrieves or modifies multiple orders in a single request.",
"parameters": {},
"parameterOrder": []
},
"acknowledge": {
"path": "content/v2/{merchantId}/orders/{orderId}/acknowledge",
"response": {
"$ref": "OrdersAcknowledgeResponse"
},
"id": "content.orders.acknowledge",
"parameters": {
"merchantId": {
"required": true,
"location": "path",
"format": "uint64",
"type": "string",
"description": "The ID of the account that manages the order. This cannot be a multi-client account."
},
"orderId": {
"type": "string",
"location": "path",
"description": "The ID of the order.",
"required": true
}
},
"parameterOrder": [
"merchantId",
"orderId"
],
"flatPath": "content/v2/{merchantId}/orders/{orderId}/acknowledge",
"scopes": [
"https://www.googleapis.com/auth/content"
],
"httpMethod": "POST",
"request": {
"$ref": "OrdersAcknowledgeRequest"
},
"description": "Marks an order as acknowledged."
},
"rejectreturnlineitem": {
"response": {
"$ref": "OrdersRejectReturnLineItemResponse"
},
"httpMethod": "POST",
"scopes": [
"https://www.googleapis.com/auth/content"
],
"id": "content.orders.rejectreturnlineitem",
"parameters": {
"merchantId": {
"location": "path",
"description": "The ID of the account that manages the order. This cannot be a multi-client account.",
"type": "string",
"format": "uint64",
"required": true
},
"orderId": {
"type": "string",
"required": true,
"description": "The ID of the order.",
"location": "path"
}
},
"request": {
"$ref": "OrdersRejectReturnLineItemRequest"
},
"parameterOrder": [
"merchantId",
"orderId"
],
"flatPath": "content/v2/{merchantId}/orders/{orderId}/rejectReturnLineItem",
"path": "content/v2/{merchantId}/orders/{orderId}/rejectReturnLineItem",
"description": "Rejects return on an line item."
},
"advancetestorder": {
"parameterOrder": [
"merchantId",
"orderId"
],
"flatPath": "content/v2/{merchantId}/testorders/{orderId}/advance",
"parameters": {
"merchantId": {
"location": "path",
"format": "uint64",
"type": "string",
"required": true,
"description": "The ID of the account that manages the order. This cannot be a multi-client account."
},
"orderId": {
"description": "The ID of the test order to modify.",
"location": "path",
"required": true,
"type": "string"
}
},
"description": "Sandbox only. Moves a test order from state \"`inProgress`\" to state \"`pendingShipment`\".",
"scopes": [
"https://www.googleapis.com/auth/content"
],
"httpMethod": "POST",
"response": {
"$ref": "OrdersAdvanceTestOrderResponse"
},
"path": "content/v2/{merchantId}/testorders/{orderId}/advance",
"id": "content.orders.advancetestorder"
},
"updateshipment": {
"parameters": {
"orderId": {
"type": "string",
"required": true,
"location": "path",
"description": "The ID of the order."
},
"merchantId": {
"description": "The ID of the account that manages the order. This cannot be a multi-client account.",
"type": "string",
"format": "uint64",
"required": true,
"location": "path"
}
},
"httpMethod": "POST",
"request": {
"$ref": "OrdersUpdateShipmentRequest"
},
"scopes": [
"https://www.googleapis.com/auth/content"
],
"parameterOrder": [
"merchantId",
"orderId"
],
"flatPath": "content/v2/{merchantId}/orders/{orderId}/updateShipment",
"description": "Updates a shipment's status, carrier, and/or tracking ID.",
"response": {
"$ref": "OrdersUpdateShipmentResponse"
},
"path": "content/v2/{merchantId}/orders/{orderId}/updateShipment",
"id": "content.orders.updateshipment"
},
"cancellineitem": {
"id": "content.orders.cancellineitem",
"response": {
"$ref": "OrdersCancelLineItemResponse"
},
"flatPath": "content/v2/{merchantId}/orders/{orderId}/cancelLineItem",
"httpMethod": "POST",
"request": {
"$ref": "OrdersCancelLineItemRequest"
},
"scopes": [
"https://www.googleapis.com/auth/content"
],
"path": "content/v2/{merchantId}/orders/{orderId}/cancelLineItem",
"description": "Cancels a line item, making a full refund.",
"parameterOrder": [
"merchantId",
"orderId"
],
"parameters": {
"orderId": {
"location": "path",
"required": true,
"description": "The ID of the order.",
"type": "string"
},
"merchantId": {
"location": "path",
"type": "string",
"format": "uint64",
"description": "The ID of the account that manages the order. This cannot be a multi-client account.",
"required": true
}
}
},
"get": {
"scopes": [
"https://www.googleapis.com/auth/content"
],
"flatPath": "content/v2/{merchantId}/orders/{orderId}",
"description": "Retrieves an order from your Merchant Center account.",
"path": "content/v2/{merchantId}/orders/{orderId}",
"parameters": {
"orderId": {
"location": "path",
"description": "The ID of the order.",
"required": true,
"type": "string"
},
"merchantId": {
"required": true,
"location": "path",
"format": "uint64",
"description": "The ID of the account that manages the order. This cannot be a multi-client account.",
"type": "string"
}
},
"httpMethod": "GET",
"parameterOrder": [
"merchantId",
"orderId"
],
"response": {
"$ref": "Order"
},
"id": "content.orders.get"
},
"setlineitemmetadata": {
"request": {
"$ref": "OrdersSetLineItemMetadataRequest"
},
"id": "content.orders.setlineitemmetadata",
"parameters": {
"merchantId": {
"location": "path",
"format": "uint64",
"type": "string",
"required": true,
"description": "The ID of the account that manages the order. This cannot be a multi-client account."
},
"orderId": {
"required": true,
"description": "The ID of the order.",
"location": "path",
"type": "string"
}
},
"flatPath": "content/v2/{merchantId}/orders/{orderId}/setLineItemMetadata",
"parameterOrder": [
"merchantId",
"orderId"
],
"description": "Sets (or overrides if it already exists) merchant provided annotations in the form of key-value pairs. A common use case would be to supply us with additional structured information about a line item that cannot be provided via other methods. Submitted key-value pairs can be retrieved as part of the orders resource.",
"scopes": [
"https://www.googleapis.com/auth/content"
],
"path": "content/v2/{merchantId}/orders/{orderId}/setLineItemMetadata",
"response": {
"$ref": "OrdersSetLineItemMetadataResponse"
},
"httpMethod": "POST"
},
"createtestreturn": {
"flatPath": "content/v2/{merchantId}/orders/{orderId}/testreturn",
"description": "Sandbox only. Creates a test return.",
"path": "content/v2/{merchantId}/orders/{orderId}/testreturn",
"response": {
"$ref": "OrdersCreateTestReturnResponse"
},
"id": "content.orders.createtestreturn",
"parameters": {
"orderId": {
"description": "The ID of the order.",
"location": "path",
"type": "string",
"required": true
},
"merchantId": {
"description": "The ID of the account that manages the order. This cannot be a multi-client account.",
"location": "path",
"required": true,
"format": "uint64",
"type": "string"
}
},
"parameterOrder": [
"merchantId",
"orderId"
],
"scopes": [
"https://www.googleapis.com/auth/content"
],
"httpMethod": "POST",
"request": {
"$ref": "OrdersCreateTestReturnRequest"
}
},
"shiplineitems": {
"response": {
"$ref": "OrdersShipLineItemsResponse"
},
"description": "Marks line item(s) as shipped.",
"flatPath": "content/v2/{merchantId}/orders/{orderId}/shipLineItems",
"httpMethod": "POST",
"parameterOrder": [
"merchantId",
"orderId"
],
"path": "content/v2/{merchantId}/orders/{orderId}/shipLineItems",
"parameters": {
"orderId": {
"type": "string",
"location": "path",
"required": true,
"description": "The ID of the order."
},
"merchantId": {
"location": "path",
"description": "The ID of the account that manages the order. This cannot be a multi-client account.",
"required": true,
"type": "string",
"format": "uint64"
}
},
"scopes": [
"https://www.googleapis.com/auth/content"
],
"request": {
"$ref": "OrdersShipLineItemsRequest"
},
"id": "content.orders.shiplineitems"
},
"gettestordertemplate": {
"path": "content/v2/{merchantId}/testordertemplates/{templateName}",
"id": "content.orders.gettestordertemplate",
"flatPath": "content/v2/{merchantId}/testordertemplates/{templateName}",
"parameterOrder": [
"merchantId",
"templateName"
],
"parameters": {
"merchantId": {
"location": "path",
"type": "string",
"format": "uint64",
"required": true,
"description": "The ID of the account that should manage the order. This cannot be a multi-client account."
},
"templateName": {
"type": "string",
"enumDescriptions": [
"",
"",
"",
"",
""
],
"required": true,
"description": "The name of the template to retrieve.",
"enum": [
"TEMPLATE1",
"TEMPLATE2",
"TEMPLATE1A",
"TEMPLATE1B",
"TEMPLATE3"
],
"location": "path"
},
"country": {
"location": "query",
"type": "string",
"description": "The country of the template to retrieve. Defaults to `US`."
}
},
"scopes": [
"https://www.googleapis.com/auth/content"
],
"httpMethod": "GET",
"response": {
"$ref": "OrdersGetTestOrderTemplateResponse"
},
"description": "Sandbox only. Retrieves an order template that can be used to quickly create a new order in sandbox."
},
"updatelineitemshippingdetails": {
"id": "content.orders.updatelineitemshippingdetails",
"description": "Updates ship by and delivery by dates for a line item.",
"path": "content/v2/{merchantId}/orders/{orderId}/updateLineItemShippingDetails",
"scopes": [
"https://www.googleapis.com/auth/content"
],
"response": {
"$ref": "OrdersUpdateLineItemShippingDetailsResponse"
},
"httpMethod": "POST",
"flatPath": "content/v2/{merchantId}/orders/{orderId}/updateLineItemShippingDetails",
"parameters": {
"orderId": {
"type": "string",
"description": "The ID of the order.",
"required": true,
"location": "path"
},
"merchantId": {
"type": "string",
"required": true,
"format": "uint64",
"location": "path",
"description": "The ID of the account that manages the order. This cannot be a multi-client account."
}
},
"parameterOrder": [
"merchantId",
"orderId"
],
"request": {
"$ref": "OrdersUpdateLineItemShippingDetailsRequest"
}
},
"canceltestorderbycustomer": {
"description": "Sandbox only. Cancels a test order for customer-initiated cancellation.",
"httpMethod": "POST",
"scopes": [
"https://www.googleapis.com/auth/content"
],
"request": {
"$ref": "OrdersCancelTestOrderByCustomerRequest"
},
"id": "content.orders.canceltestorderbycustomer",
"flatPath": "content/v2/{merchantId}/testorders/{orderId}/cancelByCustomer",
"path": "content/v2/{merchantId}/testorders/{orderId}/cancelByCustomer",
"response": {
"$ref": "OrdersCancelTestOrderByCustomerResponse"
},
"parameters": {
"merchantId": {
"format": "uint64",
"required": true,
"description": "The ID of the account that manages the order. This cannot be a multi-client account.",
"location": "path",
"type": "string"
},
"orderId": {
"required": true,
"location": "path",
"description": "The ID of the test order to cancel.",
"type": "string"
}
},
"parameterOrder": [
"merchantId",
"orderId"
]
},
"returnlineitem": {
"flatPath": "content/v2/{merchantId}/orders/{orderId}/returnLineItem",
"parameterOrder": [
"merchantId",
"orderId"
],
"id": "content.orders.returnlineitem",
"path": "content/v2/{merchantId}/orders/{orderId}/returnLineItem",
"response": {
"$ref": "OrdersReturnLineItemResponse"
},
"scopes": [
"https://www.googleapis.com/auth/content"
],
"parameters": {
"orderId": {
"required": true,
"description": "The ID of the order.",
"location": "path",
"type": "string"
},
"merchantId": {
"location": "path",
"type": "string",
"description": "The ID of the account that manages the order. This cannot be a multi-client account.",
"required": true,
"format": "uint64"
}
},
"request": {
"$ref": "OrdersReturnLineItemRequest"
},
"description": "Returns a line item.",
"httpMethod": "POST"
},
"instorerefundlineitem": {
"parameters": {
"orderId": {
"description": "The ID of the order.",
"location": "path",
"type": "string",
"required": true
},
"merchantId": {
"type": "string",
"format": "uint64",
"required": true,
"location": "path",
"description": "The ID of the account that manages the order. This cannot be a multi-client account."
}
},
"httpMethod": "POST",
"request": {
"$ref": "OrdersInStoreRefundLineItemRequest"
},
"flatPath": "content/v2/{merchantId}/orders/{orderId}/inStoreRefundLineItem",
"id": "content.orders.instorerefundlineitem",
"response": {
"$ref": "OrdersInStoreRefundLineItemResponse"
},
"scopes": [
"https://www.googleapis.com/auth/content"
],
"parameterOrder": [
"merchantId",
"orderId"
],
"path": "content/v2/{merchantId}/orders/{orderId}/inStoreRefundLineItem",
"description": "Deprecated. Notifies that item return and refund was handled directly by merchant outside of Google payments processing (e.g. cash refund done in store). 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 via Google then via an in-store return."
},
"list": {
"flatPath": "content/v2/{merchantId}/orders",
"httpMethod": "GET",
"parameterOrder": [
"merchantId"
],
"response": {
"$ref": "OrdersListResponse"
},
"parameters": {
"placedDateStart": {
"description": "Obtains orders placed after this date (inclusively), in ISO 8601 format.",
"location": "query",
"type": "string"
},
"acknowledged": {
"type": "boolean",
"location": "query",
"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. "
},
"statuses": {
"description": "Obtains orders that match any of the specified statuses. Please note that `active` is a shortcut for `pendingShipment` and `partiallyShipped`, and `completed` is a shortcut for `shipped`, `partiallyDelivered`, `delivered`, `partiallyReturned`, `returned`, and `canceled`.",
"location": "query",
"type": "string",
"enumDescriptions": [
"",
"",
"",
"",
"",
"",
"",
"",
"",
"",
""
],
"repeated": true,
"enum": [
"ACTIVE",
"COMPLETED",
"CANCELED",
"IN_PROGRESS",
"PENDING_SHIPMENT",
"PARTIALLY_SHIPPED",
"SHIPPED",
"PARTIALLY_DELIVERED",
"DELIVERED",
"PARTIALLY_RETURNED",
"RETURNED"
]
},
"placedDateEnd": {
"description": "Obtains orders placed before this date (exclusively), in ISO 8601 format.",
"type": "string",
"location": "query"
},
"pageToken": {
"description": "The token returned by the previous request.",
"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"
},
"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.",
"type": "integer",
"format": "uint32",
"location": "query"
},
"merchantId": {
"format": "uint64",
"description": "The ID of the account that manages the order. This cannot be a multi-client account.",
"type": "string",
"required": true,
"location": "path"
}
},
"id": "content.orders.list",
"scopes": [
"https://www.googleapis.com/auth/content"
],
"description": "Lists the orders in your Merchant Center account.",
"path": "content/v2/{merchantId}/orders"
},
"createtestorder": {
"httpMethod": "POST",
"request": {
"$ref": "OrdersCreateTestOrderRequest"
},
"description": "Sandbox only. Creates a test order.",
"scopes": [
"https://www.googleapis.com/auth/content"
],
"path": "content/v2/{merchantId}/testorders",
"flatPath": "content/v2/{merchantId}/testorders",
"response": {
"$ref": "OrdersCreateTestOrderResponse"
},
"id": "content.orders.createtestorder",
"parameters": {
"merchantId": {
"description": "The ID of the account that should manage the order. This cannot be a multi-client account.",
"location": "path",
"format": "uint64",
"type": "string",
"required": true
}
},
"parameterOrder": [
"merchantId"
]
},
"cancel": {
"parameterOrder": [
"merchantId",
"orderId"
],
"path": "content/v2/{merchantId}/orders/{orderId}/cancel",
"scopes": [
"https://www.googleapis.com/auth/content"
],
"request": {
"$ref": "OrdersCancelRequest"
},
"httpMethod": "POST",
"parameters": {
"orderId": {
"location": "path",
"type": "string",
"required": true,
"description": "The ID of the order to cancel."
},
"merchantId": {
"description": "The ID of the account that manages the order. This cannot be a multi-client account.",
"required": true,
"format": "uint64",
"type": "string",
"location": "path"
}
},
"response": {
"$ref": "OrdersCancelResponse"
},
"description": "Cancels all line items in an order, making a full refund.",
"flatPath": "content/v2/{merchantId}/orders/{orderId}/cancel",
"id": "content.orders.cancel"
},
"returnrefundlineitem": {
"path": "content/v2/{merchantId}/orders/{orderId}/returnRefundLineItem",
"parameters": {
"orderId": {
"required": true,
"description": "The ID of the order.",
"location": "path",
"type": "string"
},
"merchantId": {
"required": true,
"description": "The ID of the account that manages the order. This cannot be a multi-client account.",
"type": "string",
"location": "path",
"format": "uint64"
}
},
"id": "content.orders.returnrefundlineitem",
"request": {
"$ref": "OrdersReturnRefundLineItemRequest"
},
"parameterOrder": [
"merchantId",
"orderId"
],
"flatPath": "content/v2/{merchantId}/orders/{orderId}/returnRefundLineItem",
"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. Please also note that 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.",
"response": {
"$ref": "OrdersReturnRefundLineItemResponse"
},
"httpMethod": "POST"
}
}
},
"shippingsettings": {
"methods": {
"list": {
"description": "Lists the shipping settings of the sub-accounts in your Merchant Center account.",
"httpMethod": "GET",
"parameterOrder": [
"merchantId"
],
"path": "content/v2/{merchantId}/shippingsettings",
"id": "content.shippingsettings.list",
"response": {
"$ref": "ShippingsettingsListResponse"
},
"parameters": {
"pageToken": {
"location": "query",
"type": "string",
"description": "The token returned by the previous request."
},
"merchantId": {
"description": "The ID of the managing account. This must be a multi-client account.",
"format": "uint64",
"required": true,
"location": "path",
"type": "string"
},
"maxResults": {
"type": "integer",
"description": "The maximum number of shipping settings to return in the response, used for paging.",
"location": "query",
"format": "uint32"
}
},
"flatPath": "content/v2/{merchantId}/shippingsettings",
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"update": {
"parameters": {
"dryRun": {
"location": "query",
"type": "boolean",
"description": "Flag to simulate a request like in a live environment. If set to true, dry-run mode checks the validity of the request and returns errors (if any)."
},
"merchantId": {
"format": "uint64",
"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.",
"required": true,
"type": "string",
"location": "path"
},
"accountId": {
"required": true,
"type": "string",
"description": "The ID of the account for which to get/update shipping settings.",
"location": "path",
"format": "uint64"
}
},
"id": "content.shippingsettings.update",
"description": "Updates the shipping settings of the account. Any fields that are not provided are deleted from the resource.",
"path": "content/v2/{merchantId}/shippingsettings/{accountId}",
"response": {
"$ref": "ShippingSettings"
},
"flatPath": "content/v2/{merchantId}/shippingsettings/{accountId}",
"request": {
"$ref": "ShippingSettings"
},
"parameterOrder": [
"merchantId",
"accountId"
],
"scopes": [
"https://www.googleapis.com/auth/content"
],
"httpMethod": "PUT"
},
"get": {
"flatPath": "content/v2/{merchantId}/shippingsettings/{accountId}",
"response": {
"$ref": "ShippingSettings"
},
"parameterOrder": [
"merchantId",
"accountId"
],
"httpMethod": "GET",
"description": "Retrieves the shipping settings of the account.",
"scopes": [
"https://www.googleapis.com/auth/content"
],
"path": "content/v2/{merchantId}/shippingsettings/{accountId}",
"parameters": {
"accountId": {
"format": "uint64",
"description": "The ID of the account for which to get/update shipping settings.",
"location": "path",
"type": "string",
"required": true
},
"merchantId": {
"location": "path",
"format": "uint64",
"required": true,
"type": "string",
"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."
}
},
"id": "content.shippingsettings.get"
},
"getsupportedpickupservices": {
"flatPath": "content/v2/{merchantId}/supportedPickupServices",
"parameterOrder": [
"merchantId"
],
"parameters": {
"merchantId": {
"location": "path",
"type": "string",
"format": "uint64",
"required": true,
"description": "The ID of the account for which to retrieve the supported pickup services."
}
},
"description": "Retrieves supported pickup services for an account.",
"scopes": [
"https://www.googleapis.com/auth/content"
],
"response": {
"$ref": "ShippingsettingsGetSupportedPickupServicesResponse"
},
"httpMethod": "GET",
"path": "content/v2/{merchantId}/supportedPickupServices",
"id": "content.shippingsettings.getsupportedpickupservices"
},
"getsupportedcarriers": {
"parameters": {
"merchantId": {
"description": "The ID of the account for which to retrieve the supported carriers.",
"type": "string",
"format": "uint64",
"required": true,
"location": "path"
}
},
"description": "Retrieves supported carriers and carrier services for an account.",
"httpMethod": "GET",
"path": "content/v2/{merchantId}/supportedCarriers",
"response": {
"$ref": "ShippingsettingsGetSupportedCarriersResponse"
},
"id": "content.shippingsettings.getsupportedcarriers",
"scopes": [
"https://www.googleapis.com/auth/content"
],
"flatPath": "content/v2/{merchantId}/supportedCarriers",
"parameterOrder": [
"merchantId"
]
},
"custombatch": {
"parameters": {
"dryRun": {
"type": "boolean",
"description": "Flag to simulate a request like in a live environment. If set to true, dry-run mode checks the validity of the request and returns errors (if any).",
"location": "query"
}
},
"request": {
"$ref": "ShippingsettingsCustomBatchRequest"
},
"description": "Retrieves and updates the shipping settings of multiple accounts in a single request.",
"parameterOrder": [],
"response": {
"$ref": "ShippingsettingsCustomBatchResponse"
},
"httpMethod": "POST",
"flatPath": "content/v2/shippingsettings/batch",
"path": "content/v2/shippingsettings/batch",
"id": "content.shippingsettings.custombatch",
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"getsupportedholidays": {
"response": {
"$ref": "ShippingsettingsGetSupportedHolidaysResponse"
},
"scopes": [
"https://www.googleapis.com/auth/content"
],
"httpMethod": "GET",
"parameters": {
"merchantId": {
"required": true,
"type": "string",
"description": "The ID of the account for which to retrieve the supported holidays.",
"format": "uint64",
"location": "path"
}
},
"description": "Retrieves supported holidays for an account.",
"parameterOrder": [
"merchantId"
],
"id": "content.shippingsettings.getsupportedholidays",
"flatPath": "content/v2/{merchantId}/supportedHolidays",
"path": "content/v2/{merchantId}/supportedHolidays"
}
}
},
"productstatuses": {
"methods": {
"list": {
"flatPath": "content/v2/{merchantId}/productstatuses",
"parameters": {
"merchantId": {
"type": "string",
"description": "The ID of the account that contains the products. This account cannot be a multi-client account.",
"location": "path",
"required": true,
"format": "uint64"
},
"includeAttributes": {
"description": "Flag to include full product data in the results of the list request. The default value is false.",
"location": "query",
"type": "boolean"
},
"includeInvalidInsertedItems": {
"type": "boolean",
"location": "query",
"description": "Flag to include the invalid inserted items in the result of the list request. By default the invalid items are not shown (the default value is false)."
},
"destinations": {
"type": "string",
"description": "If set, only issues for the specified destinations are returned, otherwise only issues for the Shopping destination.",
"repeated": true,
"location": "query"
},
"maxResults": {
"location": "query",
"type": "integer",
"format": "uint32",
"description": "The maximum number of product statuses to return in the response, used for paging."
},
"pageToken": {
"location": "query",
"type": "string",
"description": "The token returned by the previous request."
}
},
"description": "Lists the statuses of the products in your Merchant Center account.",
"path": "content/v2/{merchantId}/productstatuses",
"scopes": [
"https://www.googleapis.com/auth/content"
],
"response": {
"$ref": "ProductstatusesListResponse"
},
"id": "content.productstatuses.list",
"httpMethod": "GET",
"parameterOrder": [
"merchantId"
]
},
"get": {
"httpMethod": "GET",
"parameterOrder": [
"merchantId",
"productId"
],
"description": "Gets the status of a product from your Merchant Center account.",
"scopes": [
"https://www.googleapis.com/auth/content"
],
"parameters": {
"destinations": {
"location": "query",
"type": "string",
"description": "If set, only issues for the specified destinations are returned, otherwise only issues for the Shopping destination.",
"repeated": true
},
"includeAttributes": {
"description": "Flag to include full product data in the result of this get request. The default value is false.",
"location": "query",
"type": "boolean"
},
"merchantId": {
"format": "uint64",
"location": "path",
"description": "The ID of the account that contains the product. This account cannot be a multi-client account.",
"required": true,
"type": "string"
},
"productId": {
"required": true,
"description": "The REST ID of the product.",
"type": "string",
"location": "path"
}
},
"flatPath": "content/v2/{merchantId}/productstatuses/{productId}",
"id": "content.productstatuses.get",
"response": {
"$ref": "ProductStatus"
},
"path": "content/v2/{merchantId}/productstatuses/{productId}"
},
"custombatch": {
"id": "content.productstatuses.custombatch",
"response": {
"$ref": "ProductstatusesCustomBatchResponse"
},
"path": "content/v2/productstatuses/batch",
"httpMethod": "POST",
"request": {
"$ref": "ProductstatusesCustomBatchRequest"
},
"flatPath": "content/v2/productstatuses/batch",
"parameters": {
"includeAttributes": {
"description": "Flag to include full product data in the results of this request. The default value is false.",
"location": "query",
"type": "boolean"
}
},
"description": "Gets the statuses of multiple products in a single request.",
"parameterOrder": [],
"scopes": [
"https://www.googleapis.com/auth/content"
]
}
}
},
"orderreports": {
"methods": {
"listtransactions": {
"httpMethod": "GET",
"flatPath": "content/v2/{merchantId}/orderreports/disbursements/{disbursementId}/transactions",
"response": {
"$ref": "OrderreportsListTransactionsResponse"
},
"path": "content/v2/{merchantId}/orderreports/disbursements/{disbursementId}/transactions",
"parameters": {
"merchantId": {
"required": true,
"format": "uint64",
"type": "string",
"location": "path",
"description": "The ID of the account that manages the order. This cannot be a multi-client account."
},
"transactionEndDate": {
"description": "The last date in which transaction occurred. In ISO 8601 format. Default: current date.",
"location": "query",
"type": "string"
},
"maxResults": {
"type": "integer",
"location": "query",
"description": "The maximum number of disbursements to return in the response, used for paging.",
"format": "uint32"
},
"pageToken": {
"type": "string",
"location": "query",
"description": "The token returned by the previous request."
},
"disbursementId": {
"description": "The Google-provided ID of the disbursement (found in Wallet).",
"type": "string",
"required": true,
"location": "path"
},
"transactionStartDate": {
"location": "query",
"description": "The first date in which transaction occurred. In ISO 8601 format.",
"type": "string"
}
},
"description": "Retrieves a list of transactions for a disbursement from your Merchant Center account.",
"parameterOrder": [
"merchantId",
"disbursementId"
],
"id": "content.orderreports.listtransactions",
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"listdisbursements": {
"id": "content.orderreports.listdisbursements",
"path": "content/v2/{merchantId}/orderreports/disbursements",
"scopes": [
"https://www.googleapis.com/auth/content"
],
"response": {
"$ref": "OrderreportsListDisbursementsResponse"
},
"parameters": {
"merchantId": {
"type": "string",
"required": true,
"location": "path",
"format": "uint64",
"description": "The ID of the account that manages the order. This cannot be a multi-client account."
},
"disbursementStartDate": {
"description": "The first date which disbursements occurred. In ISO 8601 format.",
"location": "query",
"type": "string"
},
"pageToken": {
"location": "query",
"type": "string",
"description": "The token returned by the previous request."
},
"maxResults": {
"format": "uint32",
"location": "query",
"description": "The maximum number of disbursements to return in the response, used for paging.",
"type": "integer"
},
"disbursementEndDate": {
"location": "query",
"description": "The last date which disbursements occurred. In ISO 8601 format. Default: current date.",
"type": "string"
}
},
"parameterOrder": [
"merchantId"
],
"description": "Retrieves a report for disbursements from your Merchant Center account.",
"httpMethod": "GET",
"flatPath": "content/v2/{merchantId}/orderreports/disbursements"
}
}
},
"accounttax": {
"methods": {
"get": {
"scopes": [
"https://www.googleapis.com/auth/content"
],
"path": "content/v2/{merchantId}/accounttax/{accountId}",
"id": "content.accounttax.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,
"format": "uint64",
"type": "string"
},
"accountId": {
"format": "uint64",
"description": "The ID of the account for which to get/update account tax settings.",
"required": true,
"location": "path",
"type": "string"
}
},
"httpMethod": "GET",
"parameterOrder": [
"merchantId",
"accountId"
],
"description": "Retrieves the tax settings of the account.",
"response": {
"$ref": "AccountTax"
},
"flatPath": "content/v2/{merchantId}/accounttax/{accountId}"
},
"update": {
"httpMethod": "PUT",
"parameterOrder": [
"merchantId",
"accountId"
],
"description": "Updates the tax settings of the account. Any fields that are not provided are deleted from the resource.",
"request": {
"$ref": "AccountTax"
},
"parameters": {
"accountId": {
"location": "path",
"description": "The ID of the account for which to get/update account tax settings.",
"required": true,
"type": "string",
"format": "uint64"
},
"merchantId": {
"location": "path",
"format": "uint64",
"type": "string",
"required": true,
"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."
},
"dryRun": {
"type": "boolean",
"location": "query",
"description": "Flag to simulate a request like in a live environment. If set to true, dry-run mode checks the validity of the request and returns errors (if any)."
}
},
"id": "content.accounttax.update",
"response": {
"$ref": "AccountTax"
},
"flatPath": "content/v2/{merchantId}/accounttax/{accountId}",
"path": "content/v2/{merchantId}/accounttax/{accountId}",
"scopes": [
"https://www.googleapis.com/auth/content"
]
},
"custombatch": {
"scopes": [
"https://www.googleapis.com/auth/content"
],
"response": {
"$ref": "AccounttaxCustomBatchResponse"
},
"flatPath": "content/v2/accounttax/batch",
"request": {
"$ref": "AccounttaxCustomBatchRequest"
},
"description": "Retrieves and updates tax settings of multiple accounts in a single request.",
"httpMethod": "POST",
"id": "content.accounttax.custombatch",
"parameterOrder": [],
"path": "content/v2/accounttax/batch",
"parameters": {
"dryRun": {
"location": "query",
"description": "Flag to simulate a request like in a live environment. If set to true, dry-run mode checks the validity of the request and returns errors (if any).",
"type": "boolean"
}
}
},
"list": {
"parameterOrder": [
"merchantId"
],
"description": "Lists the tax settings of the sub-accounts in your Merchant Center account.",
"scopes": [
"https://www.googleapis.com/auth/content"
],
"response": {
"$ref": "AccounttaxListResponse"
},
"path": "content/v2/{merchantId}/accounttax",
"flatPath": "content/v2/{merchantId}/accounttax",
"parameters": {
"maxResults": {
"description": "The maximum number of tax settings to return in the response, used for paging.",
"format": "uint32",
"location": "query",
"type": "integer"
},
"merchantId": {
"required": true,
"location": "path",
"type": "string",
"description": "The ID of the managing account. This must be a multi-client account.",
"format": "uint64"
},
"pageToken": {
"type": "string",
"description": "The token returned by the previous request.",
"location": "query"
}
},
"id": "content.accounttax.list",
"httpMethod": "GET"
}
}
},
"pos": {
"methods": {
"insert": {
"id": "content.pos.insert",
"request": {
"$ref": "PosStore"
},
"parameterOrder": [
"merchantId",
"targetMerchantId"
],
"httpMethod": "POST",
"description": "Creates a store for the given merchant.",
"parameters": {
"targetMerchantId": {
"type": "string",
"format": "uint64",
"required": true,
"location": "path",
"description": "The ID of the target merchant."
},
"merchantId": {
"description": "The ID of the POS or inventory data provider.",
"required": true,
"format": "uint64",
"type": "string",
"location": "path"
},
"dryRun": {
"location": "query",
"description": "Flag to simulate a request like in a live environment. If set to true, dry-run mode checks the validity of the request and returns errors (if any).",
"type": "boolean"
}
},
"response": {
"$ref": "PosStore"
},
"scopes": [
"https://www.googleapis.com/auth/content"
],
"flatPath": "content/v2/{merchantId}/pos/{targetMerchantId}/store",
"path": "content/v2/{merchantId}/pos/{targetMerchantId}/store"
},
"sale": {
"parameters": {
"merchantId": {
"location": "path",
"format": "uint64",
"description": "The ID of the POS or inventory data provider.",
"type": "string",
"required": true
},
"targetMerchantId": {
"required": true,
"location": "path",
"format": "uint64",
"description": "The ID of the target merchant.",
"type": "string"
},
"dryRun": {
"description": "Flag to simulate a request like in a live environment. If set to true, dry-run mode checks the validity of the request and returns errors (if any).",
"type": "boolean",
"location": "query"
}
},
"request": {
"$ref": "PosSaleRequest"
},
"flatPath": "content/v2/{merchantId}/pos/{targetMerchantId}/sale",
"id": "content.pos.sale",
"scopes": [
"https://www.googleapis.com/auth/content"
],
"httpMethod": "POST",
"path": "content/v2/{merchantId}/pos/{targetMerchantId}/sale",
"response": {
"$ref": "PosSaleResponse"
},
"description": "Submit a sale event for the given merchant.",
"parameterOrder": [
"merchantId",
"targetMerchantId"
]
},
"inventory": {
"parameters": {
"dryRun": {
"description": "Flag to simulate a request like in a live environment. If set to true, dry-run mode checks the validity of the request and returns errors (if any).",
"type": "boolean",
"location": "query"
},
"targetMerchantId": {
"required": true,
"description": "The ID of the target merchant.",
"format": "uint64",
"type": "string",
"location": "path"
},
"merchantId": {
"required": true,
"location": "path",
"format": "uint64",
"description": "The ID of the POS or inventory data provider.",
"type": "string"
}
},
"scopes": [
"https://www.googleapis.com/auth/content"
],
"id": "content.pos.inventory",
"parameterOrder": [
"merchantId",
"targetMerchantId"
],
"response": {
"$ref": "PosInventoryResponse"
},
"request": {
"$ref": "PosInventoryRequest"
},
"flatPath": "content/v2/{merchantId}/pos/{targetMerchantId}/inventory",
"httpMethod": "POST",
"description": "Submit inventory for the given merchant.",
"path": "content/v2/{merchantId}/pos/{targetMerchantId}/inventory"
},
"delete": {
"flatPath": "content/v2/{merchantId}/pos/{targetMerchantId}/store/{storeCode}",
"path": "content/v2/{merchantId}/pos/{targetMerchantId}/store/{storeCode}",
"id": "content.pos.delete",
"parameters": {
"dryRun": {
"location": "query",
"type": "boolean",
"description": "Flag to simulate a request like in a live environment. If set to true, dry-run mode checks the validity of the request and returns errors (if any)."
},
"targetMerchantId": {
"location": "path",
"required": true,
"type": "string",
"format": "uint64",
"description": "The ID of the target merchant."
},
"storeCode": {
"required": true,
"type": "string",
"location": "path",
"description": "A store code that is unique per merchant."
},
"merchantId": {
"description": "The ID of the POS or inventory data provider.",
"required": true,
"location": "path",
"type": "string",
"format": "uint64"
}
},
"description": "Deletes a store for the given merchant.",
"scopes": [
"https://www.googleapis.com/auth/content"
],
"httpMethod": "DELETE",
"parameterOrder": [
"merchantId",
"targetMerchantId",
"storeCode"
]
},
"get": {
"scopes": [
"https://www.googleapis.com/auth/content"
],
"parameters": {
"targetMerchantId": {
"location": "path",
"type": "string",
"required": true,
"format": "uint64",
"description": "The ID of the target merchant."
},
"merchantId": {
"location": "path",
"format": "uint64",
"type": "string",
"description": "The ID of the POS or inventory data provider.",
"required": true
},
"storeCode": {
"location": "path",
"description": "A store code that is unique per merchant.",
"type": "string",
"required": true
}
},
"id": "content.pos.get",
"description": "Retrieves information about the given store.",
"parameterOrder": [
"merchantId",
"targetMerchantId",
"storeCode"
],
"httpMethod": "GET",
"response": {
"$ref": "PosStore"
},
"flatPath": "content/v2/{merchantId}/pos/{targetMerchantId}/store/{storeCode}",
"path": "content/v2/{merchantId}/pos/{targetMerchantId}/store/{storeCode}"
},
"list": {
"description": "Lists the stores of the target merchant.",
"path": "content/v2/{merchantId}/pos/{targetMerchantId}/store",
"httpMethod": "GET",
"response": {
"$ref": "PosListResponse"
},
"parameterOrder": [
"merchantId",
"targetMerchantId"
],
"scopes": [
"https://www.googleapis.com/auth/content"
],
"flatPath": "content/v2/{merchantId}/pos/{targetMerchantId}/store",
"id": "content.pos.list",
"parameters": {
"targetMerchantId": {
"description": "The ID of the target merchant.",
"required": true,
"location": "path",
"type": "string",
"format": "uint64"
},
"merchantId": {
"type": "string",
"description": "The ID of the POS or inventory data provider.",
"required": true,
"location": "path",
"format": "uint64"
}
}
},
"custombatch": {
"description": "Batches multiple POS-related calls in a single request.",
"response": {
"$ref": "PosCustomBatchResponse"
},
"request": {
"$ref": "PosCustomBatchRequest"
},
"parameters": {
"dryRun": {
"type": "boolean",
"location": "query",
"description": "Flag to simulate a request like in a live environment. If set to true, dry-run mode checks the validity of the request and returns errors (if any)."
}
},
"httpMethod": "POST",
"parameterOrder": [],
"path": "content/v2/pos/batch",
"id": "content.pos.custombatch",
"flatPath": "content/v2/pos/batch",
"scopes": [
"https://www.googleapis.com/auth/content"
]
}
}
},
"datafeeds": {
"methods": {
"insert": {
"description": "Registers a datafeed configuration with your Merchant Center account.",
"flatPath": "content/v2/{merchantId}/datafeeds",
"scopes": [
"https://www.googleapis.com/auth/content"
],
"id": "content.datafeeds.insert",
"response": {
"$ref": "Datafeed"
},
"httpMethod": "POST",
"request": {
"$ref": "Datafeed"
},
"path": "content/v2/{merchantId}/datafeeds",
"parameters": {
"merchantId": {
"format": "uint64",
"description": "The ID of the account that manages the datafeed. This account cannot be a multi-client account.",
"location": "path",
"type": "string",
"required": true
},
"dryRun": {
"location": "query",
"description": "Flag to simulate a request like in a live environment. If set to true, dry-run mode checks the validity of the request and returns errors (if any).",
"type": "boolean"
}
},
"parameterOrder": [
"merchantId"
]
},
"get": {
"scopes": [
"https://www.googleapis.com/auth/content"
],
"description": "Retrieves a datafeed configuration from your Merchant Center account.",
"parameters": {
"merchantId": {
"format": "uint64",
"description": "The ID of the account that manages the datafeed. This account cannot be a multi-client account.",
"location": "path",
"type": "string",
"required": true
},
"datafeedId": {
"location": "path",
"type": "string",
"format": "uint64",
"description": "The ID of the datafeed.",
"required": true
}
},
"path": "content/v2/{merchantId}/datafeeds/{datafeedId}",
"id": "content.datafeeds.get",
"flatPath": "content/v2/{merchantId}/datafeeds/{datafeedId}",
"httpMethod": "GET",
"response": {
"$ref": "Datafeed"
},
"parameterOrder": [
"merchantId",
"datafeedId"
]
},
"fetchnow": {
"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 to update your product data.",
"flatPath": "content/v2/{merchantId}/datafeeds/{datafeedId}/fetchNow",
"httpMethod": "POST",
"parameterOrder": [
"merchantId",
"datafeedId"
],
"response": {
"$ref": "DatafeedsFetchNowResponse"
},
"scopes": [
"https://www.googleapis.com/auth/content"
],
"id": "content.datafeeds.fetchnow",
"path": "content/v2/{merchantId}/datafeeds/{datafeedId}/fetchNow",
"parameters": {
"merchantId": {
"location": "path",
"required": true,
"type": "string",
"description": "The ID of the account that manages the datafeed. This account cannot be a multi-client account.",
"format": "uint64"
},
"dryRun": {
"type": "boolean",
"description": "Flag to simulate a request like in a live environment. If set to true, dry-run mode checks the validity of the request and returns errors (if any).",
"location": "query"
},
"datafeedId": {
"location": "path",
"description": "The ID of the datafeed to be fetched.",
"required": true,
"type": "string",
"format": "uint64"
}
}
},
"custombatch": {
"parameters": {
"dryRun": {
"location": "query",
"type": "boolean",
"description": "Flag to simulate a request like in a live environment. If set to true, dry-run mode checks the validity of the request and returns errors (if any)."
}
},
"description": "Deletes, fetches, gets, inserts and updates multiple datafeeds in a single request.",
"id": "content.datafeeds.custombatch",
"scopes": [
"https://www.googleapis.com/auth/content"
],
"httpMethod": "POST",
"response": {
"$ref": "DatafeedsCustomBatchResponse"
},
"parameterOrder": [],
"flatPath": "content/v2/datafeeds/batch",
"path": "content/v2/datafeeds/batch",
"request": {
"$ref": "DatafeedsCustomBatchRequest"
}
},
"delete": {
"parameterOrder": [
"merchantId",
"datafeedId"
],
"httpMethod": "DELETE",
"path": "content/v2/{merchantId}/datafeeds/{datafeedId}",
"description": "Deletes a datafeed configuration from your Merchant Center account.",
"scopes": [
"https://www.googleapis.com/auth/content"
],
"id": "content.datafeeds.delete",
"parameters": {
"merchantId": {
"type": "string",
"format": "uint64",
"required": true,
"description": "The ID of the account that manages the datafeed. This account cannot be a multi-client account.",
"location": "path"
},
"datafeedId": {
"format": "uint64",
"type": "string",
"description": "The ID of the datafeed.",
"location": "path",
"required": true
},
"dryRun": {
"type": "boolean",
"location": "query",
"description": "Flag to simulate a request like in a live environment. If set to true, dry-run mode checks the validity of the request and returns errors (if any)."
}
},
"flatPath": "content/v2/{merchantId}/datafeeds/{datafeedId}"
},
"update": {
"path": "content/v2/{merchantId}/datafeeds/{datafeedId}",
"parameterOrder": [
"merchantId",
"datafeedId"
],
"response": {
"$ref": "Datafeed"
},
"id": "content.datafeeds.update",
"flatPath": "content/v2/{merchantId}/datafeeds/{datafeedId}",
"scopes": [
"https://www.googleapis.com/auth/content"
],
"parameters": {
"dryRun": {
"location": "query",
"type": "boolean",
"description": "Flag to simulate a request like in a live environment. If set to true, dry-run mode checks the validity of the request and returns errors (if any)."
},
"datafeedId": {
"location": "path",
"type": "string",
"format": "uint64",
"required": true,
"description": "The ID of the datafeed."
},
"merchantId": {
"description": "The ID of the account that manages the datafeed. This account cannot be a multi-client account.",
"type": "string",
"location": "path",
"required": true,
"format": "uint64"
}
},
"request": {
"$ref": "Datafeed"
},
"description": "Updates a datafeed configuration of your Merchant Center account. Any fields that are not provided are deleted from the resource.",
"httpMethod": "PUT"
},
"list": {
"description": "Lists the configurations for datafeeds in your Merchant Center account.",
"id": "content.datafeeds.list",
"path": "content/v2/{merchantId}/datafeeds",
"flatPath": "content/v2/{merchantId}/datafeeds",
"parameters": {
"maxResults": {
"format": "uint32",
"type": "integer",
"description": "The maximum number of products to return in the response, used for paging.",
"location": "query"
},
"merchantId": {
"required": true,
"description": "The ID of the account that manages the datafeeds. This account cannot be a multi-client account.",
"type": "string",
"format": "uint64",
"location": "path"
},
"pageToken": {
"description": "The token returned by the previous request.",
"type": "string",
"location": "query"
}
},
"parameterOrder": [
"merchantId"
],
"response": {
"$ref": "DatafeedsListResponse"
},
"scopes": [
"https://www.googleapis.com/auth/content"
],
"httpMethod": "GET"
}
}
},
"inventory": {
"methods": {
"set": {
"description": "Updates price and availability of a product in your Merchant Center account.",
"httpMethod": "POST",
"id": "content.inventory.set",
"scopes": [
"https://www.googleapis.com/auth/content"
],
"parameters": {
"merchantId": {
"location": "path",
"format": "uint64",
"type": "string",
"required": true,
"description": "The ID of the account that contains the product. This account cannot be a multi-client account."
},
"productId": {
"type": "string",
"description": "The REST ID of the product for which to update price and availability.",
"location": "path",
"required": true
},
"storeCode": {
"type": "string",
"required": true,
"location": "path",
"description": "The code of the store for which to update price and availability. Use `online` to update price and availability of an online product."
},
"dryRun": {
"location": "query",
"type": "boolean",
"description": "Flag to simulate a request like in a live environment. If set to true, dry-run mode checks the validity of the request and returns errors (if any)."
}
},
"response": {
"$ref": "InventorySetResponse"
},
"path": "content/v2/{merchantId}/inventory/{storeCode}/products/{productId}",
"request": {
"$ref": "InventorySetRequest"
},
"parameterOrder": [
"merchantId",
"storeCode",
"productId"
],
"flatPath": "content/v2/{merchantId}/inventory/{storeCode}/products/{productId}"
},
"custombatch": {
"request": {
"$ref": "InventoryCustomBatchRequest"
},
"httpMethod": "POST",
"description": "Updates price and availability for multiple products or stores in a single request. This operation does not update the expiration date of the products.",
"scopes": [
"https://www.googleapis.com/auth/content"
],
"id": "content.inventory.custombatch",
"path": "content/v2/inventory/batch",
"parameters": {
"dryRun": {
"type": "boolean",
"description": "Flag to simulate a request like in a live environment. If set to true, dry-run mode checks the validity of the request and returns errors (if any).",
"location": "query"
}
},
"response": {
"$ref": "InventoryCustomBatchResponse"
},
"flatPath": "content/v2/inventory/batch",
"parameterOrder": []
}
}
},
"orderreturns": {
"methods": {
"get": {
"parameterOrder": [
"merchantId",
"returnId"
],
"id": "content.orderreturns.get",
"description": "Retrieves an order return from your Merchant Center account.",
"scopes": [
"https://www.googleapis.com/auth/content"
],
"httpMethod": "GET",
"response": {
"$ref": "MerchantOrderReturn"
},
"path": "content/v2/{merchantId}/orderreturns/{returnId}",
"flatPath": "content/v2/{merchantId}/orderreturns/{returnId}",
"parameters": {
"merchantId": {
"required": true,
"location": "path",
"type": "string",
"description": "The ID of the account that manages the order. This cannot be a multi-client account.",
"format": "uint64"
},
"returnId": {
"description": "Merchant order return ID generated by Google.",
"location": "path",
"type": "string",
"required": true
}
}
},
"list": {
"parameterOrder": [
"merchantId"
],
"httpMethod": "GET",
"description": "Lists order returns in your Merchant Center account.",
"path": "content/v2/{merchantId}/orderreturns",
"scopes": [
"https://www.googleapis.com/auth/content"
],
"id": "content.orderreturns.list",
"response": {
"$ref": "OrderreturnsListResponse"
},
"flatPath": "content/v2/{merchantId}/orderreturns",
"parameters": {
"merchantId": {
"format": "uint64",
"required": true,
"type": "string",
"location": "path",
"description": "The ID of the account that manages the order. This cannot be a multi-client account."
},
"createdStartDate": {
"type": "string",
"location": "query",
"description": "Obtains order returns created after this date (inclusively), in ISO 8601 format."
},
"orderBy": {
"description": "Return the results in the specified order.",
"location": "query",
"type": "string",
"enumDescriptions": [
"",
""
],
"enum": [
"RETURN_CREATION_TIME_DESC",
"RETURN_CREATION_TIME_ASC"
]
},
"maxResults": {
"format": "uint32",
"type": "integer",
"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"
},
"createdEndDate": {
"description": "Obtains order returns created before this date (inclusively), in ISO 8601 format.",
"type": "string",
"location": "query"
},
"pageToken": {
"description": "The token returned by the previous request.",
"location": "query",
"type": "string"
}
}
}
}
}
},
"rootUrl": "https://shoppingcontent.googleapis.com/",
"description": "Manage your product listings and accounts for Google Shopping",
"discoveryVersion": "v1",
"version": "v2",
"basePath": ""
}
© 2015 - 2025 Weber Informatics LLC | Privacy Policy