商品を管理する
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
Products サブ API を使用すると、Google Merchant Center で商品在庫をプログラムで管理できます。商品を作成、取得、更新、削除できるため、システムを Google と直接統合する柔軟性が得られます。
Merchant API の重要なコンセプトは、送信するデータと Google が使用する最終的なプロダクトの違いです。この分離により、商品データのライフサイクルがより明確になり、商品情報をより正確に管理できるようになります。API は、次の 2 つのメインリソースでこれを反映します。
ProductInput:
特定のデータソースに送信する商品データ（未加工）を表します。これは、フィード ファイルでアップロードする行、または Merchant Center の処理が行われる前に API 呼び出しで送信するデータと考えることができます。このリソースは、すべての書き込みオペレーション（insert、patch、delete）で使用します。
Product:
これは、Merchant Center と Google のサービスに表示される最終的な処理済み商品を表す読み取り専用リソースです。すべてのフィードルールと処理が適用された後、1 つのプライマリ ProductInput リソースと 0 個以上の補足 ProductInput リソースから構築されます。このリソースには、商品の最終ステータスとデータ品質の問題が含まれます。このリソースは、すべての読み取りオペレーション（get、list）で使用します。
ProductInput リソースを使用して送信されるすべての商品属性の形式と要件は、商品データ仕様で定義されています。
Products サブ API でできること
Products サブ API を使用すると、次の主なタスクを実行できます。各ユースケースの詳細な手順とコードサンプルについては、ガイドをご覧ください。
- 商品を追加、管理する: アカウントに新しい商品を追加する方法、既存の商品に補助データを提供する方法、販売しなくなった商品を削除する方法について説明します。
- 商品を頻繁に更新する: 価格や在庫状況など、頻繁に変化する商品属性を効率的に部分更新する方法をご確認ください。
- 商品データと商品の問題を一覧表示する: 処理済みの商品を取得する方法、さまざまな掲載先での承認ステータスを確認する方法、商品の掲載に影響する可能性のあるデータ品質の問題を特定する方法について説明します。
始める前に
Products サブ API を使用する前に、Merchant Center アカウントで少なくとも 1 つの API データソースを作成する必要があります。Products サブ API は、タイプ API のデータソースの商品を挿入または更新することしかできません。手順については、商品アップロード用の API データソースを管理するガイドをご覧ください。
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は 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."]]
