제품 ID

Content API for Shopping에는 다음과 같은 종류의 제품 ID가 있습니다.

오퍼 ID
offerId는 판매자가 제품에 할당한 문자열입니다. 이 ID는 개별 제품을 나타냅니다.
offerId은 판매자 센터 데이터베이스의 상품 집합에 대해 고유하며 일반적으로 숫자로 된 순차 번호입니다.
offerId은 판매자가 제품에 할당하는 내부 SKU 번호일 수 있습니다.
REST ID
REST ID는 Google에서 할당한 제품의 고유 식별자입니다.
REST ID는 REST API 호출의 productId입니다.

REST ID는 online:en:label:1111111111 형식의 집계입니다. REST ID는 콜론으로 구분된 다음 네 부분으로 구성됩니다.

  1. 채널 ('온라인' 또는 '오프라인')
  2. 콘텐츠 언어 (2자로 된 지정 사용, 예: en 또는 fr)
  3. 피드 라벨 (피드의 대상 국가를 나타내는 두 자리 코드일 수 있습니다. 예: US 또는 FR)
  4. 오퍼 ID

이를 channel:contentLanguage:feedLabel:offerId로 합칩니다(예: online:en:US:1111111111).

외부 판매자 ID (마켓)

마켓은 다중 판매자 계정에 업로드된 상품에 external_seller_id를 할당해야 합니다. 이 필드는 개인 판매자를 나타냅니다.

external_seller_id 값은 대소문자를 구분하며 다음 기준을 충족해야 합니다.

  • 1~50자(영문 기준)
  • 영숫자 ASCII 문자와 밑줄 (_), 하이픈 (-), 마침표 (.), 물결표 (~)만

이 필드는 내부 seller_id 필드와 다릅니다.

다음 표에는 제품과 연결할 수 있는 일부 ID가 요약되어 있습니다.

속성 설명 예시 Notes
offerId 판매자가 제품에 할당한 ID입니다. 1111111111 제품 제공 항목의 고유 식별자인 문자열 데이터 유형입니다.
REST ID Google에서 제품에 할당한 ID입니다. channel:contentLanguage:feedLabel:offerId 형식입니다. online:en:label:1111111111 offerId을(를) 포함한 전체 ID입니다.
productId API 호출에서 REST ID를 참조하는 데 사용됩니다. online:en:label:1111111111 제품의 REST ID입니다.
id REST ID 및 productId와 동일한 값입니다. online:en:label:1111111111 제품의 JSON 본문 내에서 productId를 참조하기 위해 사용됩니다.
external_seller_id 마켓에서 선택한 판매자 ID입니다. example-Seller1 복수 판매자 계정에 필요합니다. 1~50자(영문 기준)여야 합니다. 대소문자를 구분합니다. 숫자와 특수문자(_, -, ., ~)가 허용됩니다.