- 리소스: ShippingSettings
- 서비스
- DeliveryTime
- CutoffTime
- TransitTable
- TransitTimeRow
- TransitTimeValue
- BusinessDayConfig
- 평일
- WarehouseBasedDeliveryTime
- RateGroup
- Value
- Table
- 헤더
- 무게
- WeightUnit
- LocationIdSet
- 행
- CarrierRate
- ShipmentType
- MinimumOrderValueTable
- StoreCodeSetWithMov
- StoreConfig
- StoreServiceType
- CutoffConfig
- LocalCutoffTime
- 거리
- 단위
- LoyaltyProgram
- LoyaltyProgramTiers
- 창고
- 주소
- WarehouseCutoffTime
- 메서드
리소스: ShippingSettings
판매자 계정의 배송 설정
JSON 표현 |
---|
{ "name": string, "services": [ { object ( |
필드 | |
---|---|
name |
식별자. 배송 설정의 리소스 이름입니다. 형식: |
services[] |
선택사항입니다. 대상 계정의 서비스 목록입니다. |
warehouses[] |
선택사항입니다. |
etag |
필수 항목입니다. 이 필드는 비동기 문제를 방지하는 데 사용됩니다. get 호출과 insert 호출 간에 배송 설정 데이터가 변경되지 않았는지 확인합니다. 사용자는 다음 단계를 따라야 합니다.
|
서비스
배송 서비스
JSON 표현 |
---|
{ "deliveryCountries": [ string ], "rateGroups": [ { object ( |
필드 | |
---|---|
delivery |
필수 항목입니다. 서비스가 적용되는 국가의 CLDR 지역 코드입니다. |
rate |
선택사항입니다. 배송비 요율 그룹 정의 마지막 항목에만 빈 |
loyalty |
선택사항입니다. 이 배송 서비스가 제한되는 포인트 제도입니다. |
service |
필수 항목입니다. 서비스의 자유 형식 이름입니다. 타겟 계정 내에서 고유해야 합니다. |
active |
필수 항목입니다. 배송 서비스의 활성 상태를 노출하는 불리언입니다. |
currency |
이 서비스가 적용되는 통화의 CLDR 코드입니다. 요금 그룹의 가격과 일치해야 합니다. |
delivery |
필수 항목입니다. 제품 주문부터 배송까지의 다양한 측면에 소요된 시간입니다. |
shipment |
이 서비스에서 주문 제품을 배송하는 위치 유형입니다. |
minimum |
이 서비스의 최소 주문 금액입니다. 설정된 경우 고객이 이 금액 이상을 지출해야 함을 나타냅니다. 서비스 내의 모든 가격은 동일한 통화를 사용해야 합니다. minimumOrderValueTable과 함께 설정할 수 없습니다. |
minimum |
매장별로 픽업 처리 유형의 최소 주문 금액을 보여주는 표입니다. minimumOrderValue와 함께 설정할 수 없습니다. |
store |
제품이 배송되는 매장 목록입니다. 이 속성은 오프라인 배송 유형에만 유효합니다. |
DeliveryTime
제품 주문부터 배송까지의 다양한 측면에 소요된 시간입니다.
JSON 표현 |
---|
{ "warehouseBasedDeliveryTimes": [ { object ( |
필드 | |
---|---|
warehouse |
선택사항입니다. 선택한 운송업체의 설정에 따라 배송 시간이 창고 (배송 출발지 위치)별로 계산되어야 함을 나타냅니다. 이 필드를 설정하면 [배송 기간][[google.shopping.content.bundles.ShippingSetting.DeliveryTime] 의 다른 운송 시간 관련 필드는 설정하면 안 됩니다. |
min |
배송에 소요되는 최소 영업일 수입니다. 0은 당일 배송을, 1은 익일 배송을 의미합니다. |
max |
운송에 소요되는 최대 영업일 수입니다. 0은 당일 배송을, 1은 익일 배송을 의미합니다. |
cutoff |
영업일 기준 마감 시간 정의 구성하지 않으면 기본적으로 오전 8시(PST)가 마감 시간으로 설정됩니다. |
min |
주문 제품이 발송되기까지 걸리는 최소 영업일 수입니다. 0은 당일 배송을, 1은 익일 배송을 의미합니다. 'minHandlingDays'와 'maxHandlingDays'는 동시에 설정하거나 설정하지 않아야 합니다. |
max |
주문 제품이 발송되기까지 걸리는 최대 영업일 수입니다. 0은 당일 배송을, 1은 익일 배송을 의미합니다. |
transit |
운송 시간 표, 행 및 열 측정기준에 따라 운송에 소요된 영업일 수 |
handling |
주문을 처리할 수 있는 영업일입니다. 제공하지 않으면 월요일~금요일 영업일이 간주됩니다. |
transit |
주문 제품이 배송 중일 수 있는 영업일입니다. 제공하지 않으면 월요일~금요일 영업일이 간주됩니다. |
CutoffTime
영업일 기준 마감 시간 정의
JSON 표현 |
---|
{ "hour": integer, "minute": integer, "timeZone": string } |
필드 | |
---|---|
hour |
필수 항목입니다. 당일 처리를 위해 주문해야 하는 마감 시간입니다. |
minute |
필수 항목입니다. 당일 처리를 위해 주문해야 하는 마감 시간의 분입니다. |
time |
필수 항목입니다. 시간대 식별자 예: 'Europe/Zurich' |
TransitTable
운송 시간 표, 행 및 열 측정기준에 따라 운송에 소요된 영업일 수 minTransitDays
, maxTransitDays
또는 transitTimeTable
중 하나를 설정할 수 있지만 둘 다 설정할 수는 없습니다.
JSON 표현 |
---|
{
"postalCodeGroupNames": [
string
],
"transitTimeLabels": [
string
],
"rows": [
{
object ( |
필드 | |
---|---|
postal |
필수 항목입니다. 지역 이름 목록 |
transit |
필수 항목입니다. 운송 시간 라벨 목록 마지막 값은 |
rows[] |
필수 항목입니다. |
TransitTimeRow
postalCodeGroupNames
또는 transitTimeLabels
측정기준 세트가 하나만 있는 경우 해당 측정기준의 값이 하나씩 있는 행이 여러 개 있습니다. 측정기준이 두 개인 경우 각 행은 postalCodeGroupNames
에, 열 (값)은 transitTimeLabels
에 해당합니다.
JSON 표현 |
---|
{
"values": [
{
object ( |
필드 | |
---|---|
values[] |
필수 항목입니다. 영업일 기준 운송 시간 범위 (최소-최대)입니다. |
TransitTimeValue
영업일 기준 운송 시간 범위 (최소-최대)입니다.
JSON 표현 |
---|
{ "minTransitDays": integer, "maxTransitDays": integer } |
필드 | |
---|---|
min |
영업일 기준 최소 운송 시간 범위입니다. 0은 당일 배송을, 1은 익일 배송을 의미합니다. |
max |
|
BusinessDayConfig
창고의 영업일입니다.
JSON 표현 |
---|
{
"businessDays": [
enum ( |
필드 | |
---|---|
business |
필수 항목입니다. 일반 영업일 비워 둘 수 없습니다. |
평일
열거형 | |
---|---|
WEEKDAY_UNSPECIFIED |
|
MONDAY |
|
TUESDAY |
|
WEDNESDAY |
|
THURSDAY |
|
FRIDAY |
|
SATURDAY |
|
SUNDAY |
WarehouseBasedDeliveryTime
선택한 운송업체의 설정에 따라 배송 시간이 창고 (배송 출발지 위치)별로 계산되어야 함을 나타냅니다. 이 필드를 설정하면 deliveryTime
의 다른 운송 시간 관련 필드는 설정할 수 없습니다.
JSON 표현 |
---|
{ "carrier": string, "carrierService": string, "warehouse": string } |
필드 | |
---|---|
carrier |
필수 항목입니다. 이동통신사(예: |
carrier |
필수 항목입니다. 이동통신사 서비스(예: |
warehouse |
필수 항목입니다. 창고 이름입니다. [warehouse][ShippingSetting.warehouses.name]과 일치해야 합니다. |
RateGroup
배송비 요율 그룹 정의 마지막 항목에만 빈 applicableShippingLabels
('기타'를 의미)가 허용됩니다. 다른 applicableShippingLabels
는 겹쳐서는 안 됩니다.
JSON 표현 |
---|
{ "applicableShippingLabels": [ string ], "subtables": [ { object ( |
필드 | |
---|---|
applicable |
필수 항목입니다. 이 요율 그룹이 적용되는 제품을 정의하는 배송물 라벨 목록입니다. 이는 배타적 논리합입니다. 요금 그룹이 적용되려면 라벨 중 하나만 일치하면 됩니다. 서비스의 마지막 요금 그룹에 대해서만 비어 있을 수 있습니다. |
subtables[] |
선택사항입니다. |
carrier |
선택사항입니다. |
single |
요금 그룹의 값입니다 (예: 고정 요금 10달러). |
main |
|
name |
선택사항입니다. 요금 그룹의 이름입니다. 설정된 경우 배송 서비스 내에서 고유해야 합니다. |
값
요금 그룹의 단일 값 또는 요금 그룹 표의 셀 값입니다. noShipping
, flatRate
, pricePercentage
, carrier_rateName
, subtable_name
중 하나만 설정해야 합니다.
JSON 표현 |
---|
{
"noShipping": boolean,
"flatRate": {
object ( |
필드 | |
---|---|
no |
이 값이 true이면 제품을 배송할 수 없습니다. 설정 시 true여야 하며 다른 모든 필드가 설정되지 않은 경우에만 설정할 수 있습니다. |
flat |
고정 요금입니다. 다른 모든 필드가 설정되지 않은 경우에만 설정할 수 있습니다. |
price |
소수점 표기법으로 숫자로 표시된 가격의 비율입니다 (예: |
carrier |
동일한 요금 그룹에 정의된 운송업체 요금을 참조하는 운송업체 요금의 이름입니다. 다른 모든 필드가 설정되지 않은 경우에만 설정할 수 있습니다. |
subtable |
하위 표의 이름입니다. 테이블 셀에서만 설정할 수 있으며 (예: 단일 값에는 설정할 수 없음) 다른 모든 필드가 설정되지 않은 경우에만 설정할 수 있습니다. |
표
singleValue
가 충분히 표현적이지 않은 경우 요금 그룹을 정의하는 테이블입니다.
JSON 표현 |
---|
{ "rows": [ { object ( |
필드 | |
---|---|
rows[] |
필수 항목입니다. 테이블을 구성하는 행 목록입니다. 길이는 |
name |
테이블 이름입니다. 하위 표에 필요하며 기본 표에서는 무시됩니다. |
row |
필수 항목입니다. 테이블 행의 헤더입니다. |
column |
테이블 열의 헤더입니다. 선택사항: 설정하지 않으면 테이블에 측정기준이 하나만 있습니다. |
헤더
테이블의 행 또는 열 헤더 목록으로, 비어 있지 않습니다. prices
, weights
, num_items
, postalCodeGroupNames
또는 location
중 하나만 설정해야 합니다.
JSON 표현 |
---|
{ "prices": [ { object ( |
필드 | |
---|---|
prices[] |
필수 항목입니다. 포함된 주문 가격 상한의 목록입니다. price amountMicros = -1을 설정하면 마지막 가격의 값이 무한대가 될 수 있습니다. 예를 들어 |
weights[] |
필수 항목입니다. 포함된 주문 중량 상한값 목록입니다. price amountMicros = -1을 설정하면 마지막 가중치 값이 무한대가 될 수 있습니다. 예를 들어 |
number |
필수 항목입니다. 항목 수의 상한값을 포함하는 목록입니다. 마지막 값은 |
postal |
필수 항목입니다. 우편 그룹 이름 목록입니다. 마지막 값은 |
locations[] |
필수 항목입니다. 위치 ID 세트 목록입니다. 비어 있지 않아야 합니다. 다른 모든 필드가 설정되지 않은 경우에만 설정할 수 있습니다. |
무게
가중치는 문자열 값과 단위로 표시됩니다.
JSON 표현 |
---|
{
"unit": enum ( |
필드 | |
---|---|
unit |
필수 항목입니다. 중량 단위입니다. 허용되는 값은 kg 및 lb입니다. |
amount |
필수 항목입니다. 마이크로 단위로 숫자로 표시된 중량입니다 (100만 마이크로는 통화 표준 단위 1개에 해당, 예: 1kg = 1000000마이크로). 이 필드는 -1로 설정하여 무한대로 설정할 수도 있습니다. 이 필드는 -1 및 양의 값만 지원합니다. |
WeightUnit
중량 단위입니다.
열거형 | |
---|---|
WEIGHT_UNIT_UNSPECIFIED |
단위 미지정 |
POUND |
lb 단위로 표시됩니다. |
KILOGRAM |
kg 단위로 표시됩니다. |
LocationIdSet
위치 ID 세트 목록입니다. 비어 있지 않아야 합니다. 다른 모든 필드가 설정되지 않은 경우에만 설정할 수 있습니다.
JSON 표현 |
---|
{ "locationIds": [ string ] } |
필드 | |
---|---|
location |
필수 항목입니다. 비어 있지 않은 위치 ID 목록입니다. 모두 동일한 위치 유형 (예: 주)이어야 합니다. |
행
셀 목록을 포함합니다.
JSON 표현 |
---|
{
"cells": [
{
object ( |
필드 | |
---|---|
cells[] |
필수 항목입니다. 행을 구성하는 셀 목록입니다. 2차원 테이블의 경우 |
CarrierRate
mainTable
또는 singleValue
에서 참조할 수 있는 이동통신사 요금 목록입니다. 지원되는 운송업체 서비스는 https://support.google.com/merchants/answer/12577710?ref_topic=12570808&sjid=10662598224319463032-NC#zippy=%2Cdelivery-cost-rate-type%2Ccarrier-rate-au-de-uk-and-us-only에 정의되어 있습니다.
JSON 표현 |
---|
{
"name": string,
"carrier": string,
"carrierService": string,
"originPostalCode": string,
"percentageAdjustment": string,
"flatAdjustment": {
object ( |
필드 | |
---|---|
name |
필수 항목입니다. 운송업체 요금의 이름입니다. 요금 그룹별로 고유해야 합니다. |
carrier |
필수 항목입니다. 이동통신사 서비스(예: |
carrier |
필수 항목입니다. 이동통신사 서비스(예: |
origin |
필수 항목입니다. 이 운송업체 요금의 배송 출발지입니다. |
percentage |
선택사항입니다. 배송비 요율 배수 수정자를 10진수 숫자로 표시합니다. 음수일 수 있습니다. 예를 들어 |
flat |
선택사항입니다. 배송비 요율 추가 수정자 음수일 수 있습니다. 예를 들어 |
ShipmentType
배송 서비스의 배송 유형입니다.
열거형 | |
---|---|
SHIPMENT_TYPE_UNSPECIFIED |
이 서비스에서 배송 유형을 지정하지 않았습니다. |
DELIVERY |
이 서비스는 고객이 선택한 주소로 주문 제품을 배송합니다. |
LOCAL_DELIVERY |
이 서비스는 고객이 선택한 주소로 주문 제품을 배송합니다. 주문 제품은 근처 오프라인 매장에서 배송됩니다. |
COLLECTION_POINT |
이 서비스는 고객이 선택한 주소로 주문 제품을 배송합니다. 주문 제품이 화물 취급소에서 발송됩니다. |
MinimumOrderValueTable
매장별로 픽업 처리 유형의 최소 주문 금액을 보여주는 표입니다.
JSON 표현 |
---|
{
"storeCodeSetWithMovs": [
{
object ( |
필드 | |
---|---|
store |
필수 항목입니다. 동일한 최소 주문 금액 (MOV)을 공유하는 매장 코드 세트 목록입니다. 세트는 2개 이상 필요하며 마지막 세트는 비워야 합니다. 이는 '다른 모든 저장소의 MOV'를 나타냅니다. 각 매장 코드는 모든 세트에서 한 번만 표시될 수 있습니다. 서비스 내의 모든 가격은 동일한 통화를 사용해야 합니다. |
StoreCodeSetWithMov
동일한 최소 주문 금액을 공유하는 매장 코드 세트 목록입니다. 세트는 2개 이상 필요하며 마지막 세트는 비워야 합니다. 이는 '다른 모든 저장소의 MOV'를 나타냅니다. 각 매장 코드는 모든 세트에서 한 번만 표시될 수 있습니다. 서비스 내의 모든 가격은 동일한 통화를 사용해야 합니다.
JSON 표현 |
---|
{
"storeCodes": [
string
],
"value": {
object ( |
필드 | |
---|---|
store |
선택사항입니다. 고유한 상점 코드 목록 또는 포괄을 위한 빈 목록입니다. |
value |
지정된 매장의 최소 주문 금액입니다. |
StoreConfig
제품이 배송되는 매장 목록입니다. 이 속성은 오프라인 배송 유형에만 유효합니다.
JSON 표현 |
---|
{ "storeCodes": [ string ], "storeServiceType": enum ( |
필드 | |
---|---|
store |
선택사항입니다. 오프라인 배송을 제공하는 매장 코드 목록입니다. 비어 있으면 |
store |
이 판매자가 등록한 모든 매장 또는 일부 매장에서 지역 배송을 제공하는지 여부를 나타냅니다. |
cutoff |
당일 오프라인 배송과 관련된 구성이 종료됩니다. |
service |
최대 배송 반경 이 입력란은 오프라인 배송 유형에만 필요합니다. |
StoreServiceType
판매자가 등록한 모든 매장 또는 일부 매장에서 지역 배송을 제공하는지 나타냅니다.
열거형 | |
---|---|
STORE_SERVICE_TYPE_UNSPECIFIED |
스토어 서비스 유형을 지정하지 않았습니다. |
ALL_STORES |
이 판매자가 등록한 현재 및 향후 모든 매장에서 오프라인 배송을 제공하는지 여부를 나타냅니다. |
SELECTED_STORES |
storeCodes 에 등록된 매장만 오프라인 배송이 가능하다는 것을 나타냅니다. |
CutoffConfig
당일 오프라인 배송과 관련된 구성이 종료됩니다.
JSON 표현 |
---|
{
"localCutoffTime": {
object ( |
필드 | |
---|---|
local |
당일 오프라인 배송이 종료되는 시간입니다. |
store |
로컬 배송 처리에만 유효합니다. 매장 폐쇄까지 몇 시간 남았는지 나타내는 마감 시간입니다. |
no |
배송 서비스가 n일 이내 지역 배송으로 구성된 경우 판매자는 n+1일 이내 지역 배송을 표시하지 않을 수 있습니다. 예를 들어 배송 서비스에서 당일 배송을 정의하고 마감 시간이 지났다면 이 필드를 |
LocalCutoffTime
당일 오프라인 배송이 종료되는 시간입니다.
JSON 표현 |
---|
{ "hour": string, "minute": string } |
필드 | |
---|---|
hour |
당일 처리를 위해 오프라인 배송 주문을 몇 시까지 해야 하는지 지정합니다. |
minute |
당일 처리하려면 몇 분 이내에 오프라인 배송 주문을 해야 합니다. |
거리
최대 배송 반경 이 입력란은 오프라인 배송 유형에만 필요합니다.
JSON 표현 |
---|
{
"value": string,
"unit": enum ( |
필드 | |
---|---|
value |
거리의 정수 값입니다. |
unit |
단위는 국가에 따라 다를 수 있으며 마일과 킬로미터를 포함하도록 매개변수화됩니다. |
단위
단위는 국가에 따라 다를 수 있으며 마일과 킬로미터를 포함하도록 매개변수화됩니다.
열거형 | |
---|---|
UNIT_UNSPECIFIED |
단위 미지정 |
MILES |
단위: 마일 |
KILOMETERS |
단위: 킬로미터 |
LoyaltyProgram
판매자가 제공하는 포인트 제도입니다.
JSON 표현 |
---|
{
"loyaltyProgramTiers": [
{
object ( |
필드 | |
---|---|
loyalty |
선택사항입니다. 이 배송 서비스의 포인트 제도 등급입니다. |
program |
판매자 센터의 포인트 제도 설정에 설정된 포인트 제도 라벨입니다. 이 하위 속성을 사용하면 Google에서 요건을 충족하는 제품에 포인트 멤버십을 매핑할 수 있습니다. |
LoyaltyProgramTiers
판매자 포인트 제도의 하위 집합입니다.
JSON 표현 |
---|
{ "tierLabel": string } |
필드 | |
---|---|
tier |
등급 라벨[tierLabel] 하위 속성은 제품 수준 혜택을 각 등급별로 구분합니다. 이 값도 판매자 센터의 포인트 멤버십 설정에서 설정되며 포인트 멤버십에 등급이 1개만 있는 경우에도 데이터 소스 변경을 위해 필요합니다. |
창고
인벤토리를 저장하고 처리하는 처리 창고입니다.
JSON 표현 |
---|
{ "name": string, "shippingAddress": { object ( |
필드 | |
---|---|
name |
필수 항목입니다. 창고의 이름입니다. 계정 내에서 고유해야 합니다. |
shipping |
필수 항목입니다. 창고의 배송지 주소입니다. |
cutoff |
필수 항목입니다. 주문을 수락하고 처리를 시작할 수 있는 가장 늦은 시간입니다. 이후 주문은 다음 날 처리됩니다. 시간은 창고 우편번호를 기준으로 합니다. |
handling |
필수 항목입니다. 이 창고에서 상품을 포장하고 배송하는 데 걸리는 일수입니다. 이 속성은 창고 수준이지만 상품의 속성을 기반으로 제품 수준에서 재정의할 수 있습니다. |
business |
창고의 영업일입니다. 설정하지 않으면 기본적으로 월요일~금요일입니다. |
주소
창고의 배송지 주소입니다.
JSON 표현 |
---|
{ "streetAddress": string, "city": string, "administrativeArea": string, "postalCode": string, "regionCode": string } |
필드 | |
---|---|
street |
주소의 상세 주소입니다. 예: |
city |
필수 항목입니다. 시, 마을 또는 코뮌 종속 지역 또는 하위 지역 (예: 동네 또는 교외)도 포함될 수 있습니다. |
administrative |
필수 항목입니다. 국가의 최상위 행정 구역 단위입니다. 예를 들어 캘리포니아 ('CA')와 같은 주 또는 퀘벡 ('QC')과 같은 도입니다. |
postal |
필수 항목입니다. 우편번호 (예: '94043') |
region |
필수 항목입니다. CLDR 국가 코드 (예: 'US') |
WarehouseCutoffTime
주문을 수락하고 처리를 시작할 수 있는 가장 늦은 시간입니다. 이후 주문은 다음 날 처리됩니다. 시간은 창고 우편번호를 기준으로 합니다.
JSON 표현 |
---|
{ "hour": integer, "minute": integer } |
필드 | |
---|---|
hour |
필수 항목입니다. 창고에서 당일에 주문을 처리하려면 몇 시까지 주문해야 하는지 마감 시간의 시간을 나타냅니다. 시간은 창고의 시간대를 기준으로 합니다. |
minute |
필수 항목입니다. 창고에서 당일에 주문을 처리하려면 몇 시까지 주문해야 하는지 마감 시간의 분입니다. 분은 창고의 시간대를 기준으로 합니다. |
메서드 |
|
---|---|
|
배송 설정 정보를 가져옵니다. |
|
판매자의 배송 설정을 배송 요청 설정으로 대체합니다. |