제품 하위 API를 사용하면 Google 판매자 센터에서 제품 인벤토리를 프로그래매틱 방식으로 관리할 수 있습니다. 제품을 생성, 검색, 업데이트, 삭제할 수 있으므로 시스템을 Google과 직접 통합할 수 있습니다.
Merchant API의 핵심 개념은 제출하는 데이터와 Google에서 사용하는 최종 제품 간의 차이입니다. 이렇게 분리하면 제품 데이터 수명 주기를 더 명확하게 파악하고 제품 정보를 더 정확하게 관리할 수 있습니다. API는 다음 두 가지 주요 리소스를 통해 이를 반영합니다.
ProductInput:
특정 데이터 소스에 제출하는 원시 제품 데이터를 나타냅니다.
판매자 센터에서 처리하기 전에 피드 파일에 업로드하는 행 또는 API 호출로 제출하는 데이터라고 생각하면 됩니다. 모든 쓰기 작업 (insert, patch, delete)에 이 리소스를 사용합니다.
Product:
판매자 센터 및 Google 플랫폼에 표시되는 최종 처리된 제품을 나타내는 읽기 전용 리소스입니다. 모든 피드 규칙과 처리가 적용된 후 하나의 기본 ProductInput와 0개 이상의 보조 ProductInput 리소스에서 빌드됩니다. 이 리소스에는 제품의 최종 상태와 데이터 품질 문제가 포함됩니다.
모든 읽기 작업 (get, list)에 이 리소스를 사용합니다.
ProductInput 리소스를 사용하여 제출된 모든 제품 속성의 형식과 요구사항은 제품 데이터 사양에 정의되어 있습니다.
Products 하위 API로 할 수 있는 작업
제품 하위 API를 사용하면 다음과 같은 주요 작업을 수행할 수 있습니다. 각 사용 사례에 대한 자세한 안내와 코드 샘플은 가이드를 참고하세요.
제품 추가 및 관리: 계정에 새 제품을 추가하고, 기존 제품의 보조 데이터를 제공하고, 더 이상 판매하지 않는 제품을 삭제하는 방법을 알아봅니다.
제품을 자주 업데이트하기: 가격 및 재고와 같이 자주 변경되는 제품 속성을 효율적으로 부분 업데이트하는 방법을 알아보세요.
제품 데이터 및 제품 문제 나열: 처리된 제품을 가져오고, 다양한 대상의 승인 상태를 확인하고, 노출에 영향을 미칠 수 있는 데이터 품질 문제를 파악하는 방법을 알아봅니다.
시작하기 전에
제품 하위 API를 사용하려면 판매자 센터 계정에서 하나 이상의 API 데이터 소스를 만들어야 합니다. 제품 하위 API는 API 유형의 데이터 소스에만 제품을 삽입하거나 업데이트할 수 있습니다. 자세한 내용은 제품 업로드를 위한 API 데이터 소스 관리 가이드를 참고하세요.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-08-22(UTC)"],[[["\u003cp\u003eThe Merchant Products API allows you to programmatically manage your product data, including inserting, updating, retrieving, and deleting products.\u003c/p\u003e\n"],["\u003cp\u003eProducts are managed through two key resources: \u003ccode\u003eproductInputs\u003c/code\u003e (representing input data) and \u003ccode\u003eproducts\u003c/code\u003e (representing processed products in the Shopping database).\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eproductInputs\u003c/code\u003e can be primary or supplementary and are used to construct the final \u003ccode\u003eproduct\u003c/code\u003e that appears in your online or local store catalogs.\u003c/p\u003e\n"],["\u003cp\u003eThe API offers advantages over file-based uploads, such as faster response times and real-time updates.\u003c/p\u003e\n"],["\u003cp\u003eBefore using the API, ensure you have a data source set up and are familiar with Shopping Ads and free listings policies.\u003c/p\u003e\n"]]],["The Merchant Products API allows programmatic product data management via `productInputs` and `products` resources. Actions include inserting `productInput` data with required fields like `channel`, `offerId`, `contentLanguage`, and `feedLabel` using `accounts.productInputs.insert`. Processed products can be retrieved using `accounts.products.get` and listed with `accounts.products.list`. Product inputs are deleted using `accounts.productInputs.delete`, specifying the data source. Products are built from primary and supplemental data sources, enabling real-time catalog management. You can use Batch mode to manage many products.\n"],null,[]]
