Cette page a été traduite par l'API Cloud Translation.

Présentation des paramètres de livraison

La ShippingSettings vous permet de récupérer et de mettre à jour les paramètres de livraison de votre compte.

Google peut automatiquement mettre à jour le délai de livraison estimé pour certains produits. Pour en savoir plus, consultez la section Activer le paramètre automatique améliorations.

Consulter, modifier ou modifier les paramètres de livraison

Pour utiliser le service de livraison de l'API Merchant Center, procédez comme suit:

Envoyez une requête GET pour récupérer l'ensemble des paramètres de livraison de votre Google Cloud.
Modifiez les paramètres de livraison.
Envoyez une requête INSERT avec les paramètres de livraison modifiés.

ETag

Etag est un jeton encodé permettant d'éviter les mises à jour asynchrones. L'ETag change lorsque toute modification des données des paramètres de livraison. Les utilisateurs doivent copier l’ETag qu’ils obtenu à partir de la requête GET vers le corps de la requête INSERT.

Si les données des paramètres de livraison changent entre la requête GET et la INSERT vous recevez un message d'erreur vous demandant d'envoyer une autre demande GET récupérer le jeton ETag le plus récent. Vous devez appeler la requête GET pour Récupérez le nouveau jeton ETag et copiez-le dans la requête INSERT. .

Ajouter vos paramètres de livraison

Utilisez shippingsettings.insert pour ajouter ou modifier les paramètres de livraison de votre Google Cloud. Voici un exemple de requête qui met à jour maxTransitDays sur 7 pour une Service de livraison appelé Livraison GSA – Livraison gratuite à partir de 49,99 €, via votre compte 10.

POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/{accountId}/shippingSettings/

{
  "services": [
    {
      "name": "FedEx",
      "active": true,
      "deliveryCountries": ["US"],
      "currencyCode": "USD",
      "deliveryTime": {
        "minTransitDays": 4,
        "maxTransitDays": 6,
        "minHandlingDays": 0,
        "maxHandlingDays": 0
      },
      "rateGroups": [
        {
          "singleValue": {
            "flatRate": {
              "amountMicros": 5990000,
              "currencyCode": "USD"
            }
          },
          "name": "All products"
        }
      ]
    },
    {
      "name": "GSA Shipping - Free Ship Over $49.99",
      "active": true,
      "deliveryCountries": "US",
      "currencyCode": "USD",
      "deliveryTime": {
        "minTransitDays": 3,
        "maxTransitDays": 7,
        "minHandlingDays": 1,
        "maxHandlingDays": 2
      },
      "rateGroups": [
        {
          "mainTable": {
            "rowHeaders": {
              "prices": [
                {
                  "amountMicros": 49990000,
                  "currencyCode": "USD"
                },
                {
                  "amountMicros": -1,
                  "currencyCode": "USD"
                }
              ]
            },
            "rows": [
              {
                "cells": [
                  {
                    "flatRate": {
                      "amountMicros": 6990000,
                      "currencyCode": "USD"
                    }
                  }
                ]
              },
              {
                "cells": [
                  {
                    "flatRate": {
                      "amountMicros": 0,
                      "currencyCode": "USD"
                    }
                  }
                ]
              }
            ]
          },
          "name": "Free Ship Over $49.99"
        }
      ]
    }
  ]
}

Définir les entrepôts

L'exemple JSON suivant montre comment utiliser les paramètres de livraison du marchand pour gérer les informations d'entrepôt pour votre compte marchand:

"warehouses": [
  {
    "name": "warehouse 1",
    "shippingAddress": {
      "streetAddress": {street_address},
      "city": {city},
      "administrativeArea": {administrative_area},
      "postalCode": {postal_code},
      "regionCode": {region_code}
    },
    "cutoffTime": {
      "minutes": {minutes}
    },
    "handlingDays": {handling_days},
    "businessDaysConfig": {
      "businessDays": [
        "MONDAY", "SUNDAY"
      ]
    }
  }
]

Remplacez les éléments suivants :

{street_address}: partie de l'adresse de l'entrepôt située au niveau de la rue.
{city}: ville ou commune où se trouve l'entrepôt.
{administrative_area}: subdivision administrative du pays. Par exemple, l'État.
{postal_code}: code postal.
{region_code}: code pays dans la chaîne.
{minutes}: minutes faisant partie de l'heure limite jusqu'à laquelle une commande doit être passée pour être traitée le jour même par l'entrepôt.
{handling_days}: nombre de jours nécessaires entrepôt pour emballer et expédier un article.

La ressource warehouses est une liste d'entrepôts. Chaque entrepôt peut être selon le délai de livraison basé sur l'entrepôt du service de livraison jusqu'au warehouse.name

Gérez vos entrepôts

Voici comment utiliser l'API Merchant Center pour gérer vos entrepôts:

Envoyez une requête GET pour récupérer tous vos shippingsettings existants et des entrepôts de données.
Copiez l'élément shippingsettings de la requête GET dans la requête UPDATE.

Remarque :Si vous ne copiez pas toutes les shippingsettings existantes, elles seront supprimées de votre compte dans la requête INSERT.
Renseignez les entrepôts si vous souhaitez les utiliser dans la section warehouses. pour la requête INSERT.
Envoyez une requête UPDATE contenant shippingsettings et warehouses. ressources.

Voici un exemple de corps de requête INSERT avec l'entrepôt pour l'entrepôt 1 mis à jour de New York à Mountain View:

{
  "services": [
    {
      "name": "Standard Shipping",
      "active": true,
      "deliveryCountries": ["US", "UK"],
      "currencyCode": "USD",
      "deliveryTime": {
        "minHandlingDays": 0,
        "maxHandlingDays": 1,
        "warehouseBasedDeliveryTimes": [
{"carrier": "Fedex"
 "carrierService": "ground"
 "warehouse": "Warehouse 1"
},
{"carrier": "Fedex"
 "carrierService": "2 days"
 "warehouse": "Warehouse 2"
}
]
      },
      "rateGroups": [
        {
          "singleValue": {
            "flatRate": {
              "amountMicros": 0,
              "currencyCode": "USD"
            }
          },
          "name": "Standard Shipping"
        }
      ],
    },
    {
      "name": "Expedited",
            "flatRate": {
              "amountMicros": 9990000,
              "currencyCode": "USD"
            }
          },
          "name": "Expedited"
        }
      ],
    }
  ],
  "warehouses": [
    {
      "name": "Warehouse1",
      "shippingAddress": [
        {
        "streetAddress": "1111 shoreline street"
          "city": "Mountain View",
          "administrativeArea": "CA"
        }
      ]
    },
    {
      "name": "Warehouse 2",
      "country": "US",
      "postalCodeRanges": [
        {
        "streetAddress": "1111 5th avenue"
          "city": "New York",
          "administrativeArea": "NY"
        }
      ]
    }
  ]
}

Ajouter la livraison le même jour

Content API for Shopping vous permet de configurer la livraison le même jour si vous disposez d'un inventaire en magasin. Les services de livraison le jour même ont local_delivery comme shipment_type. Toutes les livraisons à local_delivery services sont considérés comme des livraisons le jour même à ce moment-là.

Vous ne pouvez pas modifier les informations delivery_time pour les livraisons locales. Utilisez shippingsettings.insert afin de configurer la livraison le même jour pour votre inventaire en magasin produits.

Voici un exemple de corps de requête qui ajoute un service de livraison le même jour à tous les magasins pour votre compte:

{
  "name": "accounts/accountId/shippingSettings",
  "services": [
    {
      "name": "Local Delivery",
      "active": true,
      "shipmentType": "local_delivery",
      "deliveryCountries": "US",
      "currencyCode": "USD",
      "rateGroups": [
        {
          "singleValue": {
            "flatRate": {
              "amountMicros": 0,
              "currencyCode": "USD"
            }
          }
        }
      ],
      "storeConfig": {
        "storeServiceType": "all stores",
        "storeCodes": [],
        "cutoffConfig": {
          "storeCloseOffsetHours": 2,
          "noDeliveryPostCutoff": true
        },
        "serviceRadius": {
          "value": 4,
          "unit": "Miles"
        }
      }
    }
  ]
}

Ajouter la livraison le jour suivant

Les commandes passées après l'heure limite pour la livraison le même jour sont programmées pour le jour suivant. le nombre de jours par défaut. Pour désactiver la livraison le jour suivant, définissez Champ no_delivery_post_cutoff sur "true". Si vous désactivez la livraison le jour suivant, les services de livraison ne sont visibles qu'avant l'heure limite pour commander chaque jour.

La livraison le jour suivant n'est disponible que lorsque shipment_type est local_delivery

En savoir plus

Pour en savoir plus sur la migration depuis Content API for Shopping, consultez Migrer la livraison depuis Content API for Shopping. gestion des paramètres de sécurité.