[null,null,["最后更新时间 (UTC)：2025-08-13。"],[[["\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```"]]
