Définir le délai de livraison d'un produit

Le délai de livraison d'un produit correspond à l'estimation du temps nécessaire pour qu'une commande soit livrée après avoir été passée. Les partenaires d'indicateurs de livraison peuvent utiliser cette fonctionnalité pour définir des délais de livraison pour des régions spécifiques au nom des marchands avec lesquels ils collaborent.

Important : Les marchands ne peuvent pas modifier ProductDeliveryTime directement. Les méthodes create et delete renvoient une erreur si la requête est envoyée par un marchand, et non par un partenaire d'indicateurs de livraison.

Les partenaires d'indicateurs de livraison peuvent utiliser cette ressource pour définir des délais de livraison pour des paires offre-région, et pour afficher ou supprimer des délais de livraison existants au nom des marchands auxquels ils sont associés. Une ressource ProductDeliveryTime stocke plusieurs délais de livraison, et il ne peut y avoir qu'une seule instance ProductDeliveryTime par offre.

Pour utiliser la ressource ProductDeliveryTime, authentifiez-vous avec votre propre compte Merchant Center, et non avec le compte marchand que vous mettez à jour.

create

Les partenaires d'indicateurs de livraison peuvent créer ou mettre à jour le délai de livraison d'un produit en appelant create à l'aide du merchantId du compte marchand à mettre à jour et d'une instance ProductDeliveryTime. Pour mettre à jour le délai de livraison d'un produit existant, assurez-vous de renseigner tous les champs ProductDeliveryTime, y compris ceux qui n'ont pas changé. Chaque requête create écrase l'instance précédente. Les champs non inclus sont donc perdus. Cette méthode renvoie l'instance ProductDeliveryTime avec les informations mises à jour que vous avez envoyées.

Chaque ProductDeliveryTime peut comporter jusqu'à 100 entrées areaDeliveryTimes.

POST https://shoppingcontent.googleapis.com/content/v2.1/merchantId/productdeliverytime

Voici un exemple de corps de requête :

{
  "productId": {
    "productId": "online:en:US:offer-id"
  }
  "areaDeliveryTimes": [
    {
      "deliveryArea": {
        "countryCode": "US"
        "postalCodeRange": {
          "firstPostalCode": "123*"
          "lastPostalCode": "456*"
        }
      }
      "deliveryTime": {
        "minHandlingTimeDays": "0"
        "maxHandlingTimeDays": "1"
        "minTransitTimeDays": "2"
        "maxTransitTimeDays": "4"
      }
    },
    {
      "deliveryArea": {
        "countryCode": "US"
        "administrativeAreaCode": "NY"
      }
      "deliveryTime": {
        "minHandlingTimeDays": "0"
        "maxHandlingTimeDays": "1"
        "minTransitTimeDays": "5"
        "maxTransitTimeDays": "7"
      }
    }
  ]
}

get

Obtenez le délai de livraison d'un produit en appelant get avec le merchantId du marchand et le productId. Cette méthode renvoie l'instance ProductDeliveryTime pour le productId donné.

GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/productdeliverytime/productId

delete

Les partenaires d'indicateurs de livraison peuvent supprimer le délai de livraison d'un produit en appelant delete avec le merchantId du marchand et le productId. Cette méthode renvoie une réponse vide.

DELETE https://shoppingcontent.googleapis.com/content/v2.1/merchantId/productdeliverytime/productId