Stay organized with collectionsSave 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
partnerscan 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. OneProductDeliveryTimeresource stores
multiple delivery times, and there can be only oneProductDeliveryTimeinstance per offer.
To use theProductDeliveryTimeresource, 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
callingcreatewith themerchantIdof the merchant account to update, and aProductDeliveryTimeinstance. To update an existing product delivery time, make sure you provide
allProductDeliveryTimefields, including those that haven’t changed. Eachcreaterequest overwrites the previous instance, so fields you don’t include
are lost. This method returns theProductDeliveryTimeinstance with the
updated information you submit.
EachProductDeliveryTimecan have at most 100areaDeliveryTimesentries.
POST https://shoppingcontent.googleapis.com/content/v2.1/merchantId/productdeliverytime
Get the delivery time of a product by callinggetwith the merchant’smerchantIdand theproductId. This method returns theProductDeliveryTimeinstance for the givenproductId.
GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/productdeliverytime/productId
delete
Shipping signals partners can delete a product’s delivery time by callingdeletewith the merchant’smerchantIdand theproductId. 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```"]]