rocket
تعرَّف على
Merchant API
الذي يحلّ رسميًا محلّ Content API for Shopping.
add_alert
ملاحظة: سيتم إيقاف Content API for Shopping نهائيًا في 18 أغسطس 2026.
اختبار مورد المنتجات
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
في ما يلي بعض الأمثلة التي يمكنك استخدامها لاختبار عملية التنفيذ باستخدام
مرجع واحد (products)
إضافة منتج
إنشاء ملف JSON صالح
المنتج.
إنشاء insert
طلب
مع بيانات المنتج ومعرّف التاجر:
POST https://shoppingcontent.googleapis.com/content/v2.1/merchantId/products
تأكَّد من تلقّي رمز الحالة HTTP 200.
عرض منتج
إنشاء get
طلب
مع معرّف التاجر و
productId:
GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/products/productId
تأكَّد من تلقّي رمز الحالة HTTP 200 ومن تلقّي بيانات JSON
المنتج.
تعديل منتج
يمكنك إنشاء ملف JSON جديد لمنتج. على سبيل المثال، غيّر حقلاً واحدًا في
JSON availability: in stock إلى availability: out of stock
المنتج الذي استخدمته لاختبار طلب insert.
إنشاء insert
طلب
مع بيانات المنتج الجديدة ومعرّف التاجر:
POST https://shoppingcontent.googleapis.com/content/v2.1/merchantId/products
تأكَّد من تلقّي رمز الحالة HTTP 200. بعد خمسة على الأقل
دقيقة، يمكنك تقديم طلب "get" آخر لتأكيد القيمة المعدّلة.
تم تطبيق availability: out of stock.
حذف منتج
إنشاء delete
طلب
مع معرّف التاجر و
productId:
DELETE https://shoppingcontent.googleapis.com/content/v2.1/merchantId/products/productId
تأكَّد من تلقّي رمز الحالة HTTP 204.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThis page provides examples of how to interact with the \u003ccode\u003eproducts\u003c/code\u003e resource using the Content API for Shopping.\u003c/p\u003e\n"],["\u003cp\u003eYou can add a new product by constructing valid JSON and making an \u003ccode\u003einsert\u003c/code\u003e request.\u003c/p\u003e\n"],["\u003cp\u003eView an existing product using a \u003ccode\u003eget\u003c/code\u003e request with your merchant ID and the product ID.\u003c/p\u003e\n"],["\u003cp\u003eUpdate a product's information by making an \u003ccode\u003einsert\u003c/code\u003e request with the updated JSON data.\u003c/p\u003e\n"],["\u003cp\u003eDelete a product using a \u003ccode\u003edelete\u003c/code\u003e request with your merchant ID and the product ID.\u003c/p\u003e\n"]]],["To add a product, create valid JSON for it, then send an `insert` request via POST with the data and merchant ID, expecting an `HTTP 200` response. To view, send a `get` request via GET with the merchant ID and product ID, confirming an `HTTP 200` status and the JSON. To update, create new JSON, make an `insert` POST request, and verify `HTTP 200` then check with `get`. To delete, send a `delete` request via DELETE with the ID, verifying an `HTTP 204` status.\n"],null,["# Testing the products resource\n\nHere are some examples you can use to test your implementation with the\n`products` resource.\n\nAdd a product\n-------------\n\n1. Construct [valid JSON for a\n product](/shopping-content/reference/rest/v2.1/products#resource:-product).\n\n2. Make an [`insert`\n request](/shopping-content/reference/rest/v2.1/products/insert#http-request)\n with the product data and your merchant ID:\n\n POST https://shoppingcontent.googleapis.com/content/v2.1/\u003cvar translate=\"no\"\u003emerchantId\u003c/var\u003e/products\n\n3. Verify that you receive an `HTTP 200` status code.\n\nView a product\n--------------\n\n1. Make a [`get`\n request](/shopping-content/reference/rest/v2.1/products/get#http-request)\n with your merchant ID, and the product's\n [productId](/shopping-content/guides/products/product-id):\n\n GET https://shoppingcontent.googleapis.com/content/v2.1/\u003cvar translate=\"no\"\u003emerchantId\u003c/var\u003e/products/\u003cvar translate=\"no\"\u003eproductId\u003c/var\u003e\n\n2. Verify that you receive an `HTTP 200` status code, and the JSON data for the\n product.\n\nUpdate a product\n----------------\n\n1. Construct the new JSON for a product. For example, change a single field in\n the JSON `availability: in stock`, to `availability: out of stock` for the\n product you used to test the `insert` call.\n\n2. Make an [`insert`\n request](/shopping-content/reference/rest/v2.1/products/insert#http-request)\n with the new product data and your merchant ID:\n\n POST https://shoppingcontent.googleapis.com/content/v2.1/\u003cvar translate=\"no\"\u003emerchantId\u003c/var\u003e/products\n\n3. Verify that you receive an `HTTP 200` status code. After at least five\n minutes, you can make another `get` request to confirm the updated value,\n `availability: out of stock`, was applied.\n\nDelete a product\n----------------\n\n1. Make a [`delete`\n request](/shopping-content/reference/rest/v2.1/products/delete#http-request)\n with your merchant ID, and the product's\n [`productId`](/shopping-content/guides/products/product-id):\n\n DELETE https://shoppingcontent.googleapis.com/content/v2.1/\u003cvar translate=\"no\"\u003emerchantId\u003c/var\u003e/products/\u003cvar translate=\"no\"\u003eproductId\u003c/var\u003e\n\n2. Verify that you receive an `HTTP 204` status code."]]
