نمای کلی CSS API
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
می توانید از CSS API برای مدیریت CSS و کنترل سبد محصولات CSS خود استفاده کنید.
CSS API طراحی مجدد ویژگی‌های CSS در Content API برای خرید است.
CSS API در مقابل Merchant API
درک تمایز بین CSS API و Merchant API کلید مدیریت موثر محصولات شما است. هر API هدف متفاوتی را دنبال می‌کند و بر روی انواع حساب‌ها و فضاهای ID مختلف عمل می‌کند:
CSS API (v1): از این API برای تمام قابلیت‌های مربوط به مدیریت حساب‌های CSS و محصولات CSS مرتبط با آن‌ها استفاده کنید. این API از نام میزبان css.googleapis.com استفاده می کند و برای عملیات محصول به شناسه دامنه CSS نیاز دارد.
- مثال:
POST https://css.googleapis.com/v1/accounts/{cssDomainId}/cssProductInputs:insert
Merchant API (v1): از این API برای همه قابلیت‌های مربوط به حساب‌های Merchant Center استاندارد و محصولات آن‌ها استفاده کنید. این API از نام میزبان merchantapi.googleapis.com استفاده می کند و به شناسه Merchant Center استاندارد نیاز دارد.
- مثال:
POST https://merchantapi.googleapis.com/v1/accounts/{merchantId}/productInputs:insert
نکته کلیدی: از شناسه دامنه CSS با Merchant API برای نقاط پایانی محصول استفاده نکنید و از شناسه Merchant Center با نقاط پایانی محصول CSS API استفاده نکنید. استفاده از شناسه اشتباه با API اشتباه منجر به خطا می شود.
CSS API و Merchant API با هم جایگزین Content API قدیمی‌تر برای خرید (نسخه 2.1) می‌شوند که دیگر نباید استفاده شود.
در اینجا چند دلیل برای ارتقاء به CSS API آورده شده است:
برای اطلاعات بیشتر به شروع به کار مراجعه کنید.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-08-13 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-13 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eThe CSS API enables managing CSS and controlling your CSS Products portfolio.\u003c/p\u003e\n"],["\u003cp\u003eThe CSS API offers new features, improved alignment with Google's API improvement proposals, and updated documentation and samples.\u003c/p\u003e\n"],["\u003cp\u003eUpgrading from the Content API for Shopping to the CSS API is recommended.\u003c/p\u003e\n"]]],[],null,["# CSS API overview\n\nYou can use the CSS API to manage your CSS and control your CSS Products\nportfolio.\n\nThe CSS API is a redesign of the CSS features in [Content API for\nShopping](/shopping-content).\n\nCSS API versus Merchant API\n---------------------------\n\nUnderstanding the distinction between the CSS API and the Merchant API is key\nto effectively managing your products. Each API serves a different purpose and\noperates on different account types and ID spaces:\n\n- **CSS API (v1):** Use this API for all functionalities related to managing\n CSS accounts and their associated CSS products. This API uses the\n `css.googleapis.com` hostname and requires a **CSS Domain ID** for product\n operations.\n\n - Example: `POST https://css.googleapis.com/v1/accounts/{cssDomainId}/cssProductInputs:insert`\n- **[Merchant API](https://developers.google.com/merchant/api/overview)\n (v1):** Use this API for all functionalities related to\n standard Merchant Center accounts and their products. This API uses the\n `merchantapi.googleapis.com` hostname and requires a standard **Merchant\n Center ID**.\n\n - Example: `POST https://merchantapi.googleapis.com/v1/accounts/{merchantId}/productInputs:insert`\n\n**Key takeaway:** Don't use a CSS Domain ID with the Merchant API for product\nendpoints, and don't use a Merchant Center ID with the CSS API product\nendpoints. Using the wrong ID with the wrong API will result in errors.\n\nThe CSS API and Merchant API together replace the older Content API for Shopping\n(v2.1), which should no longer be used.\n\nHere are some reasons to upgrade to the CSS API:\n\n- New features.\n- Improved alignment with Google's [API improvement proposals](//google.aip.dev/).\n- Updated documentation and [samples](/comparison-shopping-services/api/code-samples).\n\nSee [Get started](/comparison-shopping-services/api/guides/quickstart) for more\ninformation."]]
