Mengelola produk
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Sub-API Produk memungkinkan Anda mengelola inventaris produk secara terprogram di Google Merchant Center. Anda dapat membuat, mengambil, memperbarui, dan menghapus produk,
sehingga Anda dapat mengintegrasikan sistem secara langsung dengan Google.
Konsep utama dalam Merchant API adalah perbedaan antara data yang Anda kirimkan dan produk akhir yang digunakan Google. Pemisahan ini memberikan model siklus proses data produk yang lebih jelas dan memberi Anda kontrol yang lebih akurat atas informasi produk. API mencerminkan hal ini dengan dua resource utama:
ProductInput:
Ini mewakili data produk mentah yang Anda kirimkan ke sumber data tertentu.
Anggap ini sebagai baris yang Anda upload dalam file feed atau data yang Anda kirimkan dengan panggilan API sebelum pemrosesan Merchant Center terjadi. Anda menggunakan resource ini untuk semua operasi penulisan (insert, patch, delete).
Product:
Ini adalah resource hanya baca yang merepresentasikan produk akhir yang diproses sebagaimana muncul di Merchant Center dan platform Google. Feed ini dibuat dari satu
ProductInput utama dan nol atau lebih banyak sumber ProductInput
tambahan setelah semua aturan dan pemrosesan feed diterapkan. Resource
ini mencakup status akhir produk dan masalah kualitas data.
Anda menggunakan resource ini untuk semua operasi baca (get, list).
Format dan persyaratan untuk semua atribut produk yang dikirimkan menggunakan resource
ProductInput ditentukan dalam Spesifikasi data produk.
Yang dapat Anda lakukan dengan sub-API Produk
Sub-API Produk memungkinkan Anda melakukan tugas utama berikut. Pelajari panduan untuk mengetahui petunjuk mendetail dan contoh kode untuk setiap kasus penggunaan.
- Menambahkan dan mengelola produk: Pelajari
cara menambahkan produk baru ke akun Anda, memberikan data tambahan untuk
produk yang sudah ada, dan menghapus produk yang tidak lagi Anda jual.
- Lakukan pembaruan rutin pada produk Anda: Pelajari cara melakukan pembaruan sebagian yang efisien pada atribut produk yang sering berubah, seperti harga dan ketersediaan.
- Mencantumkan data produk dan masalah produk: Cari tahu cara mengambil produk yang diproses, memeriksa status persetujuannya untuk berbagai tujuan, dan mengidentifikasi masalah kualitas data yang mungkin memengaruhi visibilitasnya.
Sebelum memulai
Sebelum menggunakan sub-API Produk, Anda harus membuat minimal satu sumber data API di akun Merchant Center Anda. Sub-API Produk hanya dapat menyisipkan atau memperbarui
produk di sumber data berjenis API. Untuk mengetahui petunjuknya, lihat panduan Mengelola sumber data API untuk upload produk.
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-08-22 UTC.
[null,null,["Terakhir diperbarui pada 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."]]
