이 페이지는 Cloud Translation API를 통해 번역되었습니다.

배송 설정 개요

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

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

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

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

GET 요청을 실행하여 계정의 전체 배송 설정을 가져옵니다.
배송 설정을 수정합니다.
수정된 배송 설정으로 INSERT 요청을 보냅니다.

ETag

ETag는 비동기 업데이트를 방지하기 위해 인코딩된 토큰입니다. 배송 설정 데이터가 변경되면 etag가 변경됩니다. 사용자는 GET 요청에서 가져온 eTag를 INSERT 요청 본문에 복사해야 합니다.

GET 요청과 INSERT 요청 간에 배송 설정 데이터가 변경되면 최신 etag 토큰을 검색하기 위한 다른 GET 요청을 요청하는 오류 메시지가 표시됩니다. GET 요청을 호출하여 새 etag 토큰을 가져오고 새 etag 토큰을 INSERT 요청 본문에 복사해야 합니다.

배송 설정 추가

shippingsettings.insert를 사용하여 계정의 배송 설정을 추가하거나 업데이트합니다. 다음은 계정 10의 GSA Shipping - Free Ship Over $49.99라는 배송 서비스의 maxTransitDays를 7로 업데이트하는 샘플 요청입니다.

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를 통해 배송 서비스의 창고 기반 배송 시간을 참조할 수 있습니다.

창고 관리

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

GET 요청을 실행하여 기존의 모든 shippingsettings 및 창고를 검색합니다.
GET 요청에서 UPDATE 요청으로 shippingsettings를 복사합니다.

참고: 기존 shippingsettings를 모두 복사하지 않으면 INSERT 요청에서 계정에서 삭제됩니다.
INSERT 요청의 warehouses 섹션에서 창고를 사용하려면 창고를 채웁니다.
shippingsettings 및 warehouses 리소스가 포함된 UPDATE 요청을 만듭니다.

다음은 뉴욕에서 마운틴뷰로 업데이트된 창고 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_type는 local_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에서 이전하는 방법을 알아보려면 배송 설정 관리 이전을 참고하세요.