배송 설정 개요

ShippingSettings 드림 리소스를 사용하면 계정의 배송 설정을 검색하고 업데이트할 수 있습니다.

Google에서 일부 제품의 예상 배송 기간을 자동으로 업데이트할 수 있습니다. 자세한 내용은 자동 사용 설정 개선사항을 참고하세요.

배송 설정 읽기, 쓰기, 업데이트

판매자 API 배송 서비스를 사용하려면 다음 단계를 따르세요.

  1. GET 요청을 실행하여 제품의 전체 배송 설정을 가져옵니다. 있습니다.
  2. 배송 설정을 수정합니다.
  3. 배송비 설정을 수정한 INSERT 요청을 전송합니다.

ETag

Etag는 비동기 업데이트를 방지하기 위해 인코딩된 토큰입니다. etag는 배송 설정 데이터 변경사항 사용자는 etag를 복사해야 함 GET 요청에서 INSERT 요청 본문으로 가져옵니다.

GET 요청과 INSERT 간에 배송 설정 데이터가 변경되는 경우 다른 GET 요청을 요청하는 오류 메시지가 나타납니다. 가장 최근의 etag 토큰을 가져옵니다. GET 요청을 호출하여 새 etag 토큰을 검색하고 새 etag 토큰을 INSERT 요청에 복사 본문입니다.

배송 설정 추가

shippingsettings.insert을(를) 사용하여 배송 설정을 추가하거나 업데이트하세요. 있습니다. 다음은 maxTransitDays를 7로 업데이트하는 샘플 요청입니다. 배송 서비스: GSA 배송 - $49.99 이상 무료 배송(계정 아래에) 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"
        }
      ]
    }
  ]
}

웨어하우스 설정

다음 JSON 샘플은 판매자 배송 설정을 사용하는 방법을 보여줍니다. 서비스를 사용하여 판매자 계정의 창고 정보를 관리합니다.

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

다음을 바꿉니다.

  • {street_address}: 창고 주소의 도로 수준 부분입니다.
  • {city}: 창고가 위치한 시/군/구, 구/군입니다.
  • {administrative_area}: 있습니다. 예: 주
  • {postal_code}: 우편번호
  • {region_code}: 문자열의 국가 코드입니다.
  • {minutes}: 마감 시간의 일부분(분 단위 시간)이 시작되어 창고에서 당일에 처리해야 합니다.
  • {handling_days}: 처리되는 데 걸린 일 수 창고에서 상품을 포장하고 배송합니다.

warehouses 리소스는 웨어하우스 목록입니다. 각 웨어하우스는 배송 서비스의 창고 기반 배송 기간에서 참조된 것으로 warehouse.name

창고 관리

판매자 API를 사용하여 창고를 관리하는 방법은 다음과 같습니다.

  1. GET 요청을 실행하여 기존 shippingsettings를 모두 가져옵니다. 수 있습니다
  2. GET 요청에서 UPDATE 요청에 shippingsettings를 복사합니다.

  3. warehouses 섹션에서 웨어하우스를 사용하려면 웨어하우스를 채웁니다. (INSERT 요청)

  4. shippingsettingswarehouses를 포함하는 UPDATE 요청을 실행합니다. 리소스를 배포합니다

다음은 Warehouse 1의 웨어하우스가 업데이트된 INSERT 요청 본문 샘플입니다. 뉴욕에서 마운틴뷰까지:

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

당일 배송 추가

Content API for Shopping을 사용하여 당일 배송을 구성할 수 있습니다. 오프라인 판매점 인벤토리가 있는 경우 당일 배송 서비스의 경우 shipment_typelocal_delivery를 사용합니다. 총 배송비 local_delivery 서비스는 현재 당일 배송으로 간주됩니다.

지역 배송에 대한 delivery_time 정보는 변경할 수 없습니다. 사용 shippingsettings.insert하여 오프라인 판매점 인벤토리에 당일 배송을 설정하세요 있습니다.

다음은 모든 매장에 당일 배송 서비스를 추가하는 샘플 요청 본문입니다. 계정:

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

익일 배송 추가

당일 배송 마감 시간 이후에 접수된 주문은 다음으로 예약됩니다. 일 배송을 기본값으로 설정합니다. 익일 배송을 사용 중지하려면 no_delivery_post_cutoff 필드를 true로 설정합니다. 익일 배송을 사용 중지하면 배송 서비스는 매일 마감 시간 전에만 표시됩니다.

익일 배송은 shipment_type이(가) 다음과 같은 경우에만 가능합니다. local_delivery

자세히 알아보기

Content API for Shopping에서 이전하는 방법에 대해 자세히 알아보려면 배송 이전을 참고하세요. 설정 관리를 참조하세요.