می توانید از Merchant API برای مدیریت موجودی محلی (در فروشگاه) و منطقه ای استفاده کنید.
درخواست ها
از فرمت URL درخواست زیر برای API فرعی Inventories استفاده کنید:
POST https://merchantapi.googleapis.com/inventories/v1beta/{parent}/regionalInventories
در Merchant API، Inventories sub-API و نقطه پایانی مربوطه به عنوان جمع، "Inventories" نامیده می شود.
در اینجا یک مقایسه نمونه از Content API برای خرید با Merchant Inventories API برای درخواستهای موجودی محلی آورده شده است:
Content API | Merchant API | |
---|---|---|
URL | https://shoppingcontent.googleapis.com/content/v2.1/ {merchantId} /products/ {productId} /localinventory | https://merchantapi.googleapis.com/inventories/v1beta/ {parent} /localInventories |
شناسه ها | {merchantId}/products/{productId} | {name} |
مواد و روش ها
Merchant API دو روش جدید را برای مدیریت موجودی معرفی می کند:
- موجودی های محلی و منطقه ای محصولات خود را فهرست کنید
- موجودی محلی و منطقه ای را از محصولات خود حذف کنید
در اینجا مقایسه ای از روش های موجودی در Content API برای خرید و Merchant Inventories API آورده شده است:
روش | Content API برای خرید | Merchant API |
---|---|---|
customBatch | آره | خیر |
insert | آره | آره |
list | خیر | آره |
delete | خیر | آره |
موجودی محلی
آنچه برای موجودی محلی در Merchant Inventories API تغییر کرده است:
Content API برای خرید | Merchant API | شرح |
---|---|---|
پشتیبانی نشده | name:string | فیلد جدیدی برای متمایز کردن منابع LocalInventory در product اضافه شد. Content API for Shopping موجودی محلی را براساس storeCode و productId شناسایی میکند. |
پشتیبانی نشده | account:string | فیلد جدیدی برای شناسایی حساب تجاری product و LocalInventory به آن اضافه شد. |
price: { | price: { | تعریف Price تغییر کرده است |
salePrice: { | salePrice: { | تعریف Price تغییر کرده است |
salePriceEffectiveDate: string | salePriceEffectiveDate: { | salePriceEffectiveDate از نوع TimePeriod جدید در API Merchant Inventories استفاده می کند. |
quantity:string, | quantity:integer | quantity به جای رشته در Merchant Inventories API یک عدد صحیح می گیرد. |
kind:string | پشتیبانی نشده | kind در API موجودی تجاری پشتیبانی نمیشود. |
پشتیبانی نشده | localShippingLabel:string | فیلد جدیدی برای برچسب گذاری خدمات حمل و نقل محلی در API موجودی تجاری Merchant Inventories اضافه شد. |
موجودی منطقه ای
آنچه برای موجودی منطقهای در Merchant Inventories API تغییر کرده است:
Content API برای خرید | Merchant API | شرح |
---|---|---|
پشتیبانی نشده | name:string | زمینه جدیدی برای متمایز کردن منابع regionalInventory در یک product اضافه شده است. Content API for Shopping موجودی منطقه ای را بر اساس regionId و productId شناسایی می کند. |
پشتیبانی نشده | account:string | فیلد جدیدی برای شناسایی حساب تاجری که product و regionalInventory متعلق به آن است، اضافه شد. |
"regionId": string | "region": string | regionID در Merchant Inventories API region نامیده می شود. |
price: { | price: { | تعریف Price تغییر کرده است |
salePrice: { | salePrice: { | تعریف Price تغییر کرده است |
salePriceEffectiveDate: string | salePriceEffectiveDate: { | salePriceEffectiveDate از نوع TimePeriod جدید در API Merchant Inventories استفاده می کند. |
kind:string | پشتیبانی نشده | kind در API موجودی تجاری پشتیبانی نمیشود. |