Ürünlerinizi yönetme
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Ürünler alt API'si, Google Merchant Center'daki ürün envanterinizi programlı olarak yönetmenize olanak tanır. Ürün oluşturabilir, alabilir, güncelleyebilir ve silebilirsiniz. Böylece sistemlerinizi doğrudan Google ile entegre etme esnekliğine sahip olursunuz.
Merchant API'deki temel kavramlardan biri, gönderdiğiniz veriler ile Google'ın kullandığı nihai ürün arasındaki farktır. Bu ayrım, ürün verilerinin yaşam döngüsünün daha net bir modelini sunar ve ürün bilgileriniz üzerinde daha hassas kontrol sahibi olmanızı sağlar. API, bunu iki ana kaynakla yansıtır:
ProductInput:
Bu, belirli bir veri kaynağına gönderdiğiniz işlenmemiş ürün verilerini ifade eder.
Bunu, feed dosyasına yüklediğiniz satır veya Merchant Center'da herhangi bir işlem yapılmadan önce API çağrısıyla gönderdiğiniz veriler olarak düşünebilirsiniz. Bu kaynağı tüm yazma işlemleri (insert, patch, delete) için kullanırsınız.
Product:
Bu, Merchant Center'da ve Google platformlarında göründüğü şekliyle son, işlenmiş ürünü temsil eden salt okunur bir kaynaktır. Tüm feed kuralları ve işleme uygulandıktan sonra birincil ProductInput ve sıfır veya daha fazla ek ProductInput kaynağı kullanılarak oluşturulur. Bu kaynakta, ürünün nihai durumu ve veri kalitesiyle ilgili sorunlar yer alır.
Bu kaynağı tüm okuma işlemleri (get, list) için kullanırsınız.
ProductInput kaynağı kullanılarak gönderilen tüm ürün özelliklerinin biçimi ve koşulları Ürün verileri spesifikasyonunda tanımlanır.
Products alt API'si ile yapabilecekleriniz
Products alt API'si, aşağıdaki temel görevleri gerçekleştirmenize olanak tanır. Her kullanım alanıyla ilgili ayrıntılı talimatlar ve kod örnekleri için kılavuzları inceleyin.
- Ürün ekleme ve yönetme: Hesabınıza nasıl yeni ürün ekleyeceğinizi, mevcut ürünler için nasıl ek veriler sağlayacağınızı ve artık satmadığınız ürünleri nasıl sileceğinizi öğrenin.
- Ürünlerinizi sık sık güncelleyin: Fiyat ve stok durumu gibi sık değişen ürün özelliklerinde nasıl verimli ve kısmi güncellemeler yapacağınızı öğrenin.
- Ürün verilerinizi ve ürün sorunlarınızı listeleme: İşlenen ürünlerinizi nasıl alacağınızı, farklı hedefler için onay durumlarını nasıl kontrol edeceğinizi ve görünürlüklerini etkileyebilecek veri kalitesi sorunlarını nasıl belirleyeceğinizi öğrenin.
Başlamadan önce
Ürünler alt API'sini kullanmadan önce Merchant Center hesabınızda en az bir API veri kaynağı oluşturmanız gerekir. Products alt API'si yalnızca API türündeki veri kaynaklarına ürün ekleyebilir veya bu kaynaklardaki ürünleri güncelleyebilir. Talimatlar için Ürün yüklemeleri için API veri kaynaklarını yönetme rehberine bakın.
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-08-22 UTC.
[null,null,["Son güncelleme tarihi: 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."]]
