제품 관리
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
제품 하위 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 데이터 소스 관리 가이드를 참고하세요.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-22(UTC)
[null,null,["최종 업데이트: 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,["# Manage your products\n\nThe Products sub-API lets you programmatically manage your product inventory in\nGoogle Merchant Center. You can create, retrieve, update, and delete products,\ngiving you the flexibility to integrate your systems directly with Google.\n\nA key concept in Merchant API is the distinction between the data you submit and\nthe final product that Google uses. This separation provides a clearer model of\nthe product data lifecycle and gives you more precise control over your product\ninformation. The API reflects this with two main resources:\n\n- **[`ProductInput`](/merchant/api/reference/rest/products_v1/accounts.productInputs#ProductInput):**\n This represents the raw product data you submit to a specific data source.\n Think of this as the row you upload in a feed file or the data you submit\n with an API call before any Merchant Center processing happens. You use this\n resource for all **write** operations (`insert`, `patch`, `delete`).\n\n- **[`Product`](/merchant/api/reference/rest/products_v1/accounts.products#Product):**\n This is a read-only resource that represents the final, processed product as\n it appears in Merchant Center and on Google surfaces. It is built from one\n primary `ProductInput` and zero or more supplemental `ProductInput`\n resources after all feed rules and processing have been applied. This\n resource includes the product's final status and any data quality issues.\n You use this resource for all **read** operations (`get`, `list`).\n\nThe format and requirements for all product attributes submitted using the\n`ProductInput` resource are defined in the [Product data\nspecification](https://support.google.com/merchants/answer/7052112).\n\nWhat you can do with the Products sub-API\n-----------------------------------------\n\nThe Products sub-API lets you to perform the following key tasks. Explore the\nguides for detailed instructions and code samples for each use case.\n\n- [Add and manage products](/merchant/api/guides/products/add-manage): Learn how to add new products to your account, provide supplemental data for existing ones, and delete products you no longer sell.\n- [Make frequent updates to your\n products](/merchant/api/guides/products/frequent-updates): Discover how to make efficient, partial updates to product attributes that change often, such as price and availability.\n- [List your products data and product\n issues](/merchant/api/guides/products/list-products-data-issues): Find out how to retrieve your processed products, check their approval status for different destinations, and identify any data quality issues that may be affecting their visibility.\n\nBefore you begin\n----------------\n\nBefore using the Products sub-API, you must create at least one API data source\nin your Merchant Center account. The Products sub-API can only insert or update\nproducts in data sources of type `API`. For instructions, see the [Manage API\ndata sources for product uploads](/merchant/api/guides/data-sources/api-sources) guide."]]
