오프라인 제품 인벤토리 피드는 각 매장에서 판매하는 제품의 목록입니다. 속성은 모든 상품에 필수인 속성, 특정 상품 유형에 필수인 속성, 권장 속성으로 구분됩니다.
인벤토리 가격과 재고는 매장별로 자주 변경될 수 있습니다. 피드 빈도를 높여 인벤토리 데이터를 더 자주 업데이트할 수 있습니다. 피드 빈도에 문제가 발생하는 경우 문의 양식을 사용해 지원팀에 문의해 주세요. 또한 오프라인 매장을 판매자 센터 계정에 동기화하는 데 최대 24시간이 걸릴 수 있으므로 계정을 연결하거나 비즈니스 프로필에서 판매점 코드를 변경하거나 업데이트한 후 24시간이 지난 다음에 인벤토리 피드를 업로드하는 것이 좋습니다.
API를 통해 제품 데이터를 제출하려면 Google Content API에 대해 자세히 알아보세요.
오프라인 제품 인벤토리 피드 제출
파일 형식: 오프라인 제품 인벤토리 피드는 탭으로 구분된 텍스트 파일 또는 XML 파일 형식으로 사용하거나 API를 통해 사용할 수 있습니다.
새 오프라인 제품 인벤토리 피드 만들기: 새 오프라인 제품 인벤토리 피드를 만들고 등록하려면 이 안내를 따르세요.
중요: 오프라인 제품 인벤토리 피드 사양의 일부 속성에는 공백 및 밑줄이 포함되어 있습니다. 파일 형식에 맞춰 아래 가이드라인을 따라 적절한 문자 및 공백을 포함한 속성을 제출하세요.
- 탭으로 구분된 피드: 공백이 필수이며 속성에 밑줄이 포함된 경우 '_' 대신 공백을 사용합니다.
- XML API 또는 JSON API: 밑줄이 필수이며 수신 시 공백으로 변환됩니다.
속성 요구사항 요약
| 속성 | 제출 요구사항 | |
|---|---|---|
| 필수 인벤토리 세부정보 |
판매점 코드 |
모든 제품의 필수 속성입니다. 참고: 판매점 코드 |
| 선택적 인벤토리 세부정보 |
할인가 적용일 수량 |
해당하는 경우 피드의 각 상품에 가격, 수량, 당일 배송에 대한 세부정보를 제공하는 것이 좋습니다. 전국 기본 가격인 경우 가격은 선택사항입니다. 매장별 가격이 변경되는 경우 가격을 제공해야 합니다. |
| 선택적 매장 수령 세부정보 |
수령 방법 수령 SLA |
해당하는 경우 매장에서 수령할 수 있는 피드 내 모든 상품에 사용하는 것이 좋습니다. 중요: 2024년 9월 1일부터 제품의 매장 수령을 사용 설정하기 위해 더 이상 수령 방법 |
| 지역 배송 세부정보(선택사항) | 오프라인 배송물 라벨[local shipping label] |
개별 매장의 특정 제품만 당일 배송이 적용되는 당일 배송 서비스를 제공하려는 경우 피드에 필요합니다. |
필수 인벤토리 세부정보
매장별로 상품당 기본 인벤토리 정보를 설명하는 속성입니다.
[store_code] - 비즈니스 프로필의 매장 식별자
각 지역 비즈니스의 고유한 영숫자 식별자입니다. 이 속성은 대소문자를 구분하며 비즈니스 프로필에 제출한 판매점 코드와 일치해야 합니다.
필수 여부: 피드에 속한 모든 상품의 필수사항입니다.
| 유형 | 텍스트(문자열) |
| 텍스트/탭 구분 예 | Store123 |
| XML 예 | <g:store_code>Store123</g:store_code> |
[id] - 상품 식별자
모든 매장에서 고유한 상품의 영숫자 제품 식별자입니다.
여러 매장에서 동일한 상품을 판매하는 경우 여러 판매점 코드에 동일한 ID가 표시됩니다. 매장당 ID[id] 속성 1개를 포함시키고 재고[availability] 속성을 사용하여 해당 매장에 제품의 재고가 있는지를 표시해야 합니다.
한 국가에 동일한 유형의 피드가 여러 개 있는 경우에도 서로 다른 피드에 있는 상품의 ID는 고유해야 합니다. SKU가 재고 전체에서 고유하며 아래의 요구사항을 충족하는 경우 이 속성에 SKU를 사용하는 것이 좋습니다.
필수 여부: 피드에 속한 모든 상품의 필수사항입니다.
| 유형 | 텍스트(문자열) |
| 텍스트/탭 구분 예 | 421486 |
| XML 예 | <g:id>421486</g:id> |
중요:
- 기본 및 오프라인 제품 인벤토리 피드에 동일한 ID 값을 사용합니다.
- 시작 및 후행 공백과 캐리지 리턴(0x0D)은 제거됩니다.
- 각 캐리지 리턴(0x0D) 및 공백 문자(공백 속성이 있는 유니코드 문자) 시퀀스는 단일 공백(0x20)으로 대체됩니다.
- 유효한 유니코드 문자만 허용되며 다음 문자는 제외됩니다.
- 제어 문자(캐리지 리턴 0x0D 제외)
- 기능 문자
- 개인 사용 영역 문자
- 서로게이트 쌍
- 미할당 코드 포인트(특히 0x10FFFF보다 큰 모든 코드 포인트)
- 상품을 제출한 후에는 데이터 피드를 업데이트하거나 이후 다른 제품에 사용할 때 ID
[id]속성을 변경할 수 없습니다. - 매장에서 구입할 수 있는 제품만 포함합니다.
[availability] - 상품의 재고 현황
- '재고 있음': 오프라인 매장에 상품의 재고가 있다는 것을 나타냅니다.
- '재고 없음': 오프라인 매장에 상품의 재고가 없다는 것을 나타냅니다.
- '한정 재고 수량': 오프라인 매장에 상품의 재고가 몇 개 남지 않았음을 나타냅니다.
- '매장 입고 완료(배송 주문만 가능)': 상품이 오프라인 매장에 전시되어 있으며 배송 주문이 가능함을 나타냅니다(예: 창고에서 출고해야 하는 냉장고). 수량
[quantity]속성도 제공하는 경우 매장 입고 완료(배송 주문만 가능) 상품에 값 '1'을 사용합니다.
| 유형 | 텍스트(문자열). 허용된 값인 '재고 있음', '재고 없음', '한정 재고 수량' 또는 '입고 완료(배송 주문만 가능)' 중 하나여야 합니다. |
| 텍스트/탭 구분 예 | 재고 있음 |
| XML 예 | <g:availability>in stock</g:availability> |
선택적 인벤토리 세부정보
이 속성을 사용하면 상품의 가격, 수량, 재고에 관한 추가 정보를 제공할 수 있습니다.
[price] - 상품의 가격
상품의 정가입니다. 인벤토리 피드 및 기본 피드에 가격 값을 제출하면 인벤토리 피드 가격이 연결된 매장의 기본 피드에 있는 가격보다 우선 적용됩니다.
필수 여부: 피드에 속한 모든 상품의 필수사항입니다.
| 유형 | 숫자(통화는 매장이 위치한 국가에 따라 자동으로 할당됨) |
| 텍스트/탭 구분 예 | 299990.00 |
| XML 예 | <g:price>299990.00</g:price> |
[sale_price] - 상품의 광고된 할인가
이 피드와 오프라인 제품 피드의 가격[price] 속성을 매장별로 재정의한 값을 나타내는 광고된 임시 할인가입니다.
할인가 적용일[sale_price_effective_date] 속성은 할인가가 적용되는 시기를 결정하므로 할인가가 있는 모든 상품에 대해 이 속성을 제출하는 것이 좋습니다. 할인가 적용일을 제출하지 않으면 할인가는 상품이 피드에 제출되어 있는 내내 적용됩니다.
| 유형 | 숫자 |
| 텍스트/탭 구분 예 | 279990.00 |
| XML 예 | <g:sale_price>279990.00</g:sale_price> |
[sale_price_effective_date] 속성에 만료된 값을 포함하세요.[sale_price_effective_date] - 상품 할인이 적용되는 기간
광고된 할인가가 유효한 기간입니다.
| 유형 | 텍스트(문자열), ISO8601, 시작일과 종료일을 슬래시(/)로 구분함 |
| 텍스트/탭 구분 예 |
UTC 예: 모든 시간 값은 24시간 형식을 사용합니다. |
| XML 예 | <g:sale_price_effective_date>2021-07-19T09:00-0800/2021-07-26T21:00-0800</g:sale_price_effective_date> |
[quantity] - 재고가 있는 상품의 수
매장에 재고가 있는 상품의 수입니다. 일시적으로 재고가 없는 상품을 제출하는 경우 이 속성에 '0' 값을 포함합니다.
수량은 더 이상 필수 속성이 아닙니다. 대신 모든 인벤토리에 재고를 제출해야 합니다.
| 유형 | 정수 |
| 텍스트/탭 구분 예 | 4 |
| XML 예 | <g:quantity>4</g:quantity> |
중요:
- Google은 상품의 재고가 3개 이상일 경우 '재고 있음', 1~2개일 경우 '한정 재고 수량', 0개일 경우 '재고 없음'으로 간주합니다.
- 수량과 재고를 제출하면 재고와 수량 중 낮은 값을 기준으로 인벤토리가 분류됩니다.
선택적 매장 수령 세부정보
오프라인 제품 인벤토리 피드에 매장별 수령 정보에 대한 다음과 같은 속성을 추가하세요.
수령 방법[pickup_method] - 상품의 매장 수령 옵션
[pickup_method]이 필요하지 않습니다.이 상품의 수령 옵션을 지정하세요.
- '구입': 전체 거래가 온라인에서 진행됩니다.
- '예약': 온라인에서 예약된 상품이 오프라인 매장에서 거래됩니다.
- '매장 배송': 온라인에서 구매된 상품이 고객이 수령할 오프라인 매장으로 배송됩니다.
- '지원되지 않음': 상품의 매장 수령이 불가능합니다.
| 유형 | 텍스트(문자열). 다음과 같이 허용되는 4가지 값 중 하나여야 합니다.
'구입', '예약', '매장 배송’ 또는 '지원되지 않음' |
| 텍스트/탭 구분 예 | 구입 |
| XML 예 | <g:pickup_method>buy</g:pickup_method> |
[pickup_sla] - 상품 매장 수령 타임라인
주문한 날짜로부터 상품 수령이 가능할 것으로 예상되는 날짜를 지정합니다.
- '당일': 주문 당일 상품 수령이 가능함을 나타내며 마감 시간이 적용됩니다.
- '다음날': 주문한 다음 날 상품 수령이 가능함을 나타냅니다.
- '2일': 상품이 2일 이내에 고객이 수령할 매장으로 배송될 예정임을 나타냅니다.
- '3일': 상품이 3일 이내에 고객이 수령할 매장으로 배송될 예정임을 나타냅니다.
- '4일': 상품이 4일 이내에 고객이 수령할 매장으로 배송될 예정임을 나타냅니다.
- '5일': 상품이 5일 이내에 고객이 수령할 매장으로 배송될 예정임을 나타냅니다.
- '6일': 상품이 6일 이내에 고객이 수령할 매장으로 배송될 예정임을 나타냅니다.
- '1주일 이상': 고객이 수령할 매장으로 상품이 배송되기까지 일주일 이상 소요됨을 나타냅니다.
| 유형 | 텍스트(문자열). 다음과 같이 허용되는 8가지 값 중 하나여야 합니다.
'당일', '다음날', '2일', '3일', '4일', '5일', '6일' 또는 '1주일 이상' |
| 텍스트/탭 구분 예 | 당일 |
| XML 예 | <g:pickup_sla>same day</g:pickup_sla> |
지역 배송 세부정보(선택사항)
지역 배송 정보를 위해 이 속성을 오프라인 제품 인벤토리 피드에 추가하세요.
오프라인 배송물 라벨[local_shipping_label]
특정 매장의 오프라인 판매점 인벤토리 중 일부에만 당일 배송이 적용되는 당일 배송을 설정하려면 오프라인 배송물 라벨[local_shipping_label] 속성을 오프라인 제품 인벤토리 피드에 추가해야 합니다.
이 속성에 제출한 값은 당일 배송 라벨 또는 계정 수준 당일 배송 설정에서 만든 라벨의 이름이어야 합니다. 각 당일 배송 라벨은 하나의 고유한 당일 배송 설정 그룹을 나타내며 오프라인 제품 인벤토리 피드에서 선택한 대상 제품에 추가됩니다.
당일 배송 상품을 추가 구성하려면 최대 배송 반경을 마일 또는 킬로미터 단위로 설정할 수 있습니다. 당일 배송 주문 마감 시간은 영업 종료 몇 시간 전 또는 특정 시간으로 설정할 수 있습니다. 당일 배송 상품을 마감 시간 이후에 주문하는 경우 다음 날 배송이 가능한지 표시할 수 있습니다.
모든 매장 및 모든 제품에서 당일 배송을 제공하는 경우 또는 자격요건을 충족하는 매장 목록의 모든 제품에서 당일 배송을 제공하는 경우 이 속성은 선택사항입니다. 당일 배송에 대해 자세히 알아보기