می توانید از 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/ {MERCHANT_ID} /products/ {PRODUCT_ID} /localinventory | https://merchantapi.googleapis.com/inventories/v1beta/ {PARENT} /localInventories |
شناسه ها | {MERCHANT_ID}/products/{PRODUCT_ID} | {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 موجودی تجاری پشتیبانی نمیشود. |