Stay organized with collections
Save and categorize content based on your preferences.
Product delivery time is an estimate of the time it takes for an order
to be delivered after it’s placed. Shipping signals
partners can use this
feature to set delivery times for specific regions on behalf of the merchants
they partner with.
Shipping signals partners can use this resource to set delivery times for
offer-region pairs, and to view or delete existing delivery times on behalf of
merchants they’re linked to. One
ProductDeliveryTime resource stores
multiple delivery times, and there can be only one ProductDeliveryTime
instance per offer.
To use the ProductDeliveryTime resource, authenticate as your own Merchant
Center account, not the merchant account you’re updating.
create
Shipping signals partners can create or update a product delivery time by
calling create with the
merchantIdof the merchant account to update, and a ProductDeliveryTime
instance. To update an existing product delivery time, make sure you provide
all ProductDeliveryTime fields, including those that haven’t changed. Each
create request overwrites the previous instance, so fields you don’t include
are lost. This method returns the ProductDeliveryTime instance with the
updated information you submit.
Each ProductDeliveryTime can have at most 100 areaDeliveryTimes
entries.
POST https://shoppingcontent.googleapis.com/content/v2.1/merchantId/productdeliverytime
Get the delivery time of a product by calling
get with the merchant’s
merchantId and the productId. This method returns the ProductDeliveryTime
instance for the given productId.
GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/productdeliverytime/productId
delete
Shipping signals partners can delete a product’s delivery time by calling
delete with the merchant’s
merchantId and the productId. This method returns an empty response.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-13 UTC."],[[["\u003cp\u003eThe Merchant API is the new version of the Content API for Shopping and enables shipping signals partners to manage product delivery times on behalf of merchants.\u003c/p\u003e\n"],["\u003cp\u003eShipping signals partners can create, update, retrieve, and delete product delivery times using the \u003ccode\u003eProductDeliveryTime\u003c/code\u003e resource.\u003c/p\u003e\n"],["\u003cp\u003eMerchants cannot directly edit product delivery times; only shipping signals partners have the authority to manage this information.\u003c/p\u003e\n"],["\u003cp\u003eWhen creating or updating delivery times, provide all \u003ccode\u003eProductDeliveryTime\u003c/code\u003e fields, as each request overwrites the previous instance.\u003c/p\u003e\n"],["\u003cp\u003eA \u003ccode\u003eProductDeliveryTime\u003c/code\u003e resource can contain up to 100 \u003ccode\u003eareaDeliveryTimes\u003c/code\u003e entries, allowing for delivery time specifications across various regions.\u003c/p\u003e\n"]]],["The Merchant API's beta version is introduced, replacing the Content API for Shopping. Shipping signals partners can manage product delivery times for merchants using the `ProductDeliveryTime` resource. Partners can `create` or update delivery times, ensuring all fields are provided as each request overwrites previous data. Partners can also `get` delivery times using a product ID and `delete` them. Merchants cannot directly edit this information. Each `ProductDeliveryTime` can include up to 100 `areaDeliveryTimes`.\n"],null,["# Set product delivery time\n\nProduct delivery time is an estimate of the time it takes for an order\nto be delivered after it's placed. [Shipping signals\npartners](//support.google.com/merchants/answer/11197995) can use this\nfeature to set delivery times for specific regions on behalf of the merchants\nthey partner with.\n| **Important:** Merchants can't edit `ProductDeliveryTime` directly. The `create` and `delete` methods return an error if the requester is a merchant, not a shipping signals partner.\n\nShipping signals partners can use this resource to set delivery times for\noffer-region pairs, and to view or delete existing delivery times on behalf of\nmerchants they're linked to. One\n[`ProductDeliveryTime`](/shopping-content/reference/rest/v2.1/productdeliverytime) resource stores\nmultiple delivery times, and there can be only one `ProductDeliveryTime`\ninstance per offer.\n\nTo use the `ProductDeliveryTime` resource, authenticate as your own Merchant\nCenter account, not the merchant account you're updating.\n\ncreate\n------\n\nShipping signals partners can create or update a product delivery time by\ncalling [`create`](/shopping-content/reference/rest/v2.1/productdeliverytime/create) with the\n`merchantId`of the merchant account to update, and a `ProductDeliveryTime`\ninstance. To update an existing product delivery time, make sure you provide\nall `ProductDeliveryTime` fields, including those that haven't changed. Each\n`create` request overwrites the previous instance, so fields you don't include\nare lost. This method returns the `ProductDeliveryTime` instance with the\nupdated information you submit.\n\nEach `ProductDeliveryTime` can have at most 100 `areaDeliveryTimes`\nentries. \n\n```text\nPOST https://shoppingcontent.googleapis.com/content/v2.1/merchantId/productdeliverytime\n```\n\nHere's a sample request body: \n\n {\n \"productId\": {\n \"productId\": \"online:en:US:offer-id\"\n }\n \"areaDeliveryTimes\": [\n {\n \"deliveryArea\": {\n \"countryCode\": \"US\"\n \"postalCodeRange\": {\n \"firstPostalCode\": \"123*\"\n \"lastPostalCode\": \"456*\"\n }\n }\n \"deliveryTime\": {\n \"minHandlingTimeDays\": \"0\"\n \"maxHandlingTimeDays\": \"1\"\n \"minTransitTimeDays\": \"2\"\n \"maxTransitTimeDays\": \"4\"\n }\n },\n {\n \"deliveryArea\": {\n \"countryCode\": \"US\"\n \"administrativeAreaCode\": \"NY\"\n }\n \"deliveryTime\": {\n \"minHandlingTimeDays\": \"0\"\n \"maxHandlingTimeDays\": \"1\"\n \"minTransitTimeDays\": \"5\"\n \"maxTransitTimeDays\": \"7\"\n }\n }\n ]\n }\n\nget\n---\n\nGet the delivery time of a product by calling\n[`get`](/shopping-content/reference/rest/v2.1/productdeliverytime/get) with the merchant's\n`merchantId` and the `productId`. This method returns the `ProductDeliveryTime`\ninstance for the given `productId`. \n\n```text\nGET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/productdeliverytime/productId\n```\n\ndelete\n------\n\nShipping signals partners can delete a product's delivery time by calling\n[`delete`](/shopping-content/reference/rest/v2.1/productdeliverytime/delete) with the merchant's\n`merchantId` and the `productId`. This method returns an empty response. \n\n```text\nDELETE https://shoppingcontent.googleapis.com/content/v2.1/merchantId/productdeliverytime/productId\n```"]]