Ta strona została przetłumaczona przez Cloud Translation API.

Omówienie ustawień dostawy

ShippingSettings Zasób umożliwia pobieranie i aktualizowanie ustawień dostawy na koncie.

Google może automatycznie aktualizować przewidywany czas dostawy w przypadku niektórych produktów. Więcej informacji znajdziesz w artykule Włączanie automatycznych aktualizacji .

Odczytywanie, zapisywanie i aktualizowanie ustawień dostawy

Aby korzystać z usługi dostawy w ramach interfejsu Merchant API:

Wyślij prośbę o: GET, aby uzyskać pełne ustawienia dostawy koncie.
Zmodyfikuj ustawienia dostawy.
Wyślij prośbę o: INSERT ze zmienionymi ustawieniami dostawy.

ETag

Etag to zakodowany token zapobiegający aktualizacjom asynchronicznym. ETag zmienia się, gdy którekolwiek z danych ustawień dostawy ulegną zmianie. Użytkownicy muszą skopiować tag, który uzyskanych z żądania GET do treści żądania INSERT.

Jeśli dane dotyczące ustawień dostawy różnią się między prośbami GET a INSERT request, pojawia się komunikat o błędzie z prośbą o kolejną prośbę GET do pobierz najnowszy token etag. Musisz zadzwonić do prośby o: GET, aby pobierz nowy token etag i skopiuj nowy token etag do żądania INSERT .

Dodawanie ustawień dostawy

Użyj shippingsettings.insert, aby dodać lub zaktualizować ustawienia dostawy koncie. Oto przykładowe żądanie, które zmienia maxTransitDays na 7 Usługa dostawy o nazwie Dostawa GSA – bezpłatna dostawa powyżej 49, 99 USD na koncie 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"
        }
      ]
    }
  ]
}

Ustaw magazyny

Poniższy przykładowy plik JSON pokazuje, jak korzystać z ustawień dostawy sprzedawcy usługa zarządzania informacjami o magazynie na Twoim koncie sprzedawcy:

"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"
      ]
    }
  }
]

Zastąp następujące elementy:

{street_address}: część adresu magazynu, która znajduje się na poziomie ulicy.
{city}: miasto, miejscowość lub gmina, w którym znajduje się magazyn.
{administrative_area}: jednostka administracyjna kraju. Na przykład stan.
{postal_code}: kod pocztowy.
{region_code}: kod kraju w ciągu znaków.
{minutes}: minuty w wyznaczonym czasie, do którego zamówienie musi zostać złożone, aby zostało przetworzone przez magazyn jeszcze tego samego dnia.
{handling_days}: liczba dni, które są potrzebne do wykonania tej czynności. aby zapakować i wysłać towar.

Zasób warehouses to lista magazynów. Każdy magazyn można odwołany do czasu dostawy opartego na magazynie w usłudze dostawy warehouse.name

Zarządzanie hurtowniami

Aby zarządzać magazynami za pomocą interfejsu Merchant API:

Wyślij żądanie GET, aby pobrać wszystkie istniejące shippingsettings i magazyny.
Skopiuj shippingsettings z żądania GET do żądania UPDATE.

Uwaga: jeśli nie skopiujesz wszystkich istniejących shippingsettings, zostaną one usunięte. z Twojego konta w prośbie INSERT.
Zapełnij hurtownie, jeśli chcesz ich używać w sekcji warehouses dla żądania INSERT.
Utwórz żądanie UPDATE zawierające elementy shippingsettings i warehouses i zasobami Google Cloud.

Oto przykładowa treść żądania INSERT z aktualizacją magazynu dla hurtowni 1 z Nowego Jorku do 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"
        }
      ]
    }
  ]
}

Dodaj dostawę tego samego dnia

Aby skonfigurować dostawę tego samego dnia, możesz użyć interfejsu Content API for Shopping jeśli masz lokalny asortyment. Usługi dostawy tego samego dnia local_delivery jako shipment_type. Cała dostawa: local_delivery usługi są obecnie uznawane za dostawy tego samego dnia.

Nie możesz zmienić informacji atrybutu delivery_time w przypadku dostaw lokalnych. Używaj shippingsettings.insert, aby skonfigurować dostawę tego samego dnia dla lokalnego asortymentu usług.

Oto przykładowa treść żądania, która dodaje usługę dostawy tego samego dnia do wszystkich sklepów dla Twojego konta:

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

Dodaj dostawę następnego dnia

Zamówienia złożone po ostatecznym terminie dostawy tego samego dnia są zaplanowane na następny dzień domyślnie dostawa w ciągu dnia. Aby wyłączyć dostawę następnego dnia, ustaw parametr no_delivery_post_cutoff ma wartość true (prawda). Jeśli wyłączysz dostawę następnego dnia, usługi dostawy są widoczne tylko codziennie przed ostatecznym terminem dostawy.

Dostawa następnego dnia jest dostępna tylko wtedy, gdy shipment_type local_delivery

Więcej informacji

Aby dowiedzieć się więcej o migracji z Content API for Shopping, zapoznaj się z artykułem Migracja dostawy i zarządzaniem ustawieniami.