Impostare i tempi di consegna dei prodotti

Desideriamo presentarti la versione beta dell'API Merchant Center. È la nuova versione API Content for Shopping e per il futuro.

Per informazioni su come l'API Merchant può migliorare l'integrazione e su come puoi contribuire a dare forma al in futuro, consulta la sezione Annunci la versione beta dell'API Merchant.

I tempi di consegna dei prodotti sono una stima del tempo necessario per un ordine da consegnare dopo il posizionamento. Indicatori di spedizione partner possono utilizzare questo per impostare i tempi di consegna per regioni specifiche per conto dei commercianti con cui collaborano.

Importante: i commercianti non possono modificare direttamente ProductDeliveryTime. Le create e I metodi delete restituiscono un errore se il richiedente è un commerciante, non un indirizzo di spedizione per gli indicatori.

I partner degli indicatori di spedizione possono utilizzare questa risorsa per impostare i tempi di consegna per coppie offerta-regione e di visualizzare o eliminare i tempi di consegna esistenti per conto i commercianti a cui sono collegati. Uno. ProductDeliveryTime archivi di risorse più tempi di consegna e può esserci un solo ProductDeliveryTime per offerta.

Per utilizzare la risorsa ProductDeliveryTime, esegui l'autenticazione come tuo commerciante Center, non l'account commerciante che stai aggiornando.

create

I partner degli indicatori di spedizione possono creare o aggiornare i tempi di consegna di un prodotto tramite chiamata create con merchantIddell'account commerciante da aggiornare e ProductDeliveryTime in esecuzione in un'istanza Compute Engine. Per aggiornare i tempi di consegna di un prodotto esistente, assicurati di indicare tutti i campi ProductDeliveryTime, inclusi quelli non modificati. Ciascuna La richiesta create sovrascrive l'istanza precedente, quindi i campi che non includi si perdono. Questo metodo restituisce l'istanza ProductDeliveryTime con le informazioni aggiornate che invii.

Ogni ProductDeliveryTime può avere al massimo 100 areaDeliveryTimes le voci corrispondenti.

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

Ecco un esempio di corpo della richiesta:

{
  "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

Ottieni i tempi di consegna di un prodotto chiamando get con la merchantId e productId. Questo metodo restituisce ProductDeliveryTime per il productId specificato.

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

elimina

I partner per gli indicatori di spedizione possono eliminare i tempi di consegna di un prodotto chiamando delete con la merchantId e productId. Questo metodo restituisce una risposta vuota.

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