rocket
Content API for Shopping의 공식 후속 API인
Merchant API를 만나보세요.
update
새로운 Merchant API 기능, 버그 수정, 업데이트에 관한
최신 소식을 확인하세요.
add_alert
참고: Content API for Shopping은 2026년 8월 18일에 지원이 종료됩니다.
제품 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는 콜론으로 구분된 다음 4개 부분으로 구성됩니다.
- 채널('온라인' 또는 '오프라인')
- 콘텐츠 언어 (2자리 지정 사용, 예:
en 또는 fr)
- 피드 라벨 (피드 대상 국가의 두 자리 코드, 예:
US 또는 FR)
- 오퍼 ID
이를 channel:contentLanguage:feedLabel:offerId로 구성합니다(예: online:en:US:1111111111).
- 외부 판매자 ID (마켓)
마켓은 다중 판매자 계정에 업로드된 제공 항목에 external_seller_id를 할당해야 합니다. 이 필드는 개별 판매자를 나타냅니다.
external_seller_id 값은 대소문자를 구분하며 다음 기준을 충족해야 합니다.
- 길이: 1~50자
- 영숫자 ASCII 문자, 밑줄 (_), 하이픈 (-), 마침표 (.), 물결표 (~)만 사용할 수 있습니다.
이는 내부 seller_id 필드와 다릅니다.
다음 표에는 제품과 연결할 수 있는 일부 ID가 요약되어 있습니다.
| 속성 |
설명 |
예 |
메모 |
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자(영문 기준)여야 합니다. 대소문자를 구분합니다. 숫자, 특수문자(_, -, ., ~)를 사용할 수 있습니다.
|
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-13(UTC)
[null,null,["최종 업데이트: 2025-08-13(UTC)"],[[["\u003cp\u003eThe Merchant API is the new version of the Content API for Shopping and represents the future of product data integration with Google.\u003c/p\u003e\n"],["\u003cp\u003eThe beta version of the Merchant API is now available for developers to explore and help shape its future development.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can learn more about the benefits and features of the Merchant API, including how it can enhance integrations, in the official announcement blog post.\u003c/p\u003e\n"],["\u003cp\u003eProducts in the Merchant API are identified using various IDs, such as \u003ccode\u003eofferId\u003c/code\u003e, REST ID, \u003ccode\u003eproductId\u003c/code\u003e, and \u003ccode\u003eexternal_seller_id\u003c/code\u003e, each with specific characteristics and usage contexts.\u003c/p\u003e\n"],["\u003cp\u003eA comprehensive table provides detailed explanations and examples of different product ID attributes, outlining their purpose and format.\u003c/p\u003e\n"]]],["The beta version of the Merchant API, the new Content API for Shopping, is introduced. Merchants assign an `offerId` to products. Google assigns a unique REST ID in the format `channel:contentLanguage:feedLabel:offerId`; this is also the `productId` and `id` in API calls. Marketplaces assign `external_seller_id` to offers for multi-seller accounts, it has specific format requirements. The Merchant API offers integration improvements; details on this and providing feedback are available via a linked article.\n"],null,["# Product IDs\n\nHere are the different kinds of product IDs in the Content API for Shopping:\n\nOffer ID\n: An `offerId` is a string assigned to a product by a merchant. This ID\n represents an individual product.\n: `offerId` is unique to the set of offers in the Merchant Center database, and\n is usually a numeric sequential number.\n: `offerId` can be an internal SKU number that a merchant assigns to the product.\n\nREST ID\n: A REST ID is the unique identifier for a product assigned by Google.\n: REST ID is the `productId` for REST API calls.\n\n: REST IDs are aggregates with the format `online:en:label:1111111111`. The\n REST ID consists of the following 4 parts, separated by colons:\n\n 1. Channel (\"online\" or \"local\")\n 2. Content Language (using the 2-letter designation, for example `en` or `fr`)\n 3. Feed label (might be the two-letter code for the feed's target country, for example `US` or `FR`)\n 4. Offer ID\n\n: You put this together as `channel:contentLanguage:feedLabel:offerId`, for\n example, `online:en:US:1111111111`.\n\nExternal Seller ID (Marketplaces)\n\n: [Marketplaces](//support.google.com/merchants/answer/6363319)\n must assign an `external_seller_id` to offers uploaded to a multi-seller\n account. This field represents an individual seller.\n\n `external_seller_id` values are case-sensitive, and must meet the following\n criteria:\n\n - 1-50 characters in length\n - Only alphanumeric ASCII characters, and underscore (_), hyphen (-), period (.), and tilde (\\~)\n\n This isn't the same as the internal\n [`seller_id`](/shopping-content/reference/rest/v2.1/accounts) field.\n\nThe following table summarizes some of the IDs that can be associated with a\nproduct:\n\n| Attribute | Description | Example | Notes |\n|----------------------|---------------------------------------------------------------------------------------------------|------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------|\n| `offerId` | An ID assigned to a product by a merchant. | `1111111111` | String data type, unique identifier for a product's offer. |\n| REST ID | An ID assigned to a product by Google. In the format `channel:contentLanguage:feedLabel:offerId`. | `online:en:label:1111111111` | Full ID including `offerId`. |\n| `productId` | Used to refer to the REST ID in API calls. | `online:en:label:1111111111` | This is the REST ID of a product. |\n| `id` | Same value as REST ID and `productId`. | `online:en:label:1111111111` | Used inside JSON body of a product to refer to its `productId`. |\n| `external_seller_id` | A seller ID chosen by the Marketplace. | `example-Seller1` | Required for multi-seller accounts. Must be 1-50 characters. Case-sensitive. Digits, and special characters _, -, ., and \\~ are accepted. |"]]
