می توانید از Merchant API برای مدیریت موجودی محلی (در فروشگاه) و منطقه ای استفاده کنید.
درخواست ها
از فرمت URL درخواست زیر برای API Merchant Inventories استفاده کنید:
POST https://merchantapi.googleapis.com/inventories/v1/{PARENT}/regionalInventories
POST https://merchantapi.googleapis.com/inventories/v1/{PARENT}/localInventories
{PARENT} این قالب را خواهد داشت: حسابها/ {ACCOUNT_ID} /products/ {PRODUCT_ID} .
در اینجا یک مقایسه نمونه برای درخواستهای موجودی محلی آورده شده است:
مورد | Content API برای خرید | Merchant API |
---|---|---|
URL | https://shoppingcontent.googleapis.com/content/v2.1/ {MERCHANT_ID} /products/ {PRODUCT_ID} /localinventory | https://merchantapi.googleapis.com/inventories/v1/ {PARENT} /localInventories |
شناسه ها | {MERCHANT_ID}/products/{PRODUCT_ID} | {NAME} |
روش ها
Merchant API دو روش جدید را برای مدیریت موجودی معرفی می کند:
-
list
: به شما امکان می دهد موجودی محلی و منطقه ای محصولات خود را فهرست کنید. -
delete
: به شما امکان می دهد موجودی محلی و منطقه ای محصولات خود را حذف کنید.
در اینجا مقایسه ای از روش های موجود برای مدیریت موجودی ها آورده شده است:
روش | Content API برای خرید | Merchant API |
---|---|---|
customBatch | بله | خیر |
insert | بله | بله |
list | خیر | بله |
delete | خیر | بله |
منابع
در اینجا آنچه برای موجودی های محلی و منطقه ای تغییر کرده است:
Content API برای خرید | Merchant API | توضیحات |
---|---|---|
پشتیبانی نمی شود | name:string | این زمینه منابع LocalInventory و RegionalInventory را در یک product متمایز می کند. Content API برای خرید، موجودی محلی را بر اساس storeCode و productId ، و موجودی منطقهای را بر اساس regionId و productId شناسایی میکند. |
پشتیبانی نمی شود | account:string | فیلد جدیدی برای شناسایی حساب Merchant Center که product و LocalInventory متعلق به آن است، اضافه شد. |
price: { object (Price) } | price: { | تعریف Price تغییر کرده است |
salePrice: { | salePrice: { | تعریف Price تغییر کرده است |
salePriceEffectiveDate: string | salePriceEffectiveDate: { | salePriceEffectiveDate از شی TimePeriod جدید در API Merchant Inventories استفاده می کند. |
kind:string | پشتیبانی نمی شود | API از kind پشتیبانی نمی کند. |
quantity:string | quantity:integer | quantity به جای رشته در موجودی محلی یک عدد صحیح می گیرد. |
پشتیبانی نمی شود | localShippingLabel:string | فیلد جدیدی برای شناسایی حساب مرکز تجاری product و regionalInventory به آن اضافه شد. |
"regionId": string | "region": string | regionID اکنون برای موجودی منطقه ای region نامیده می شود. |
رشته های نوع string با مجموعه ای از مقادیر تعریف شده | فیلدهای نوع enum با مجموعه ای از مقادیر تعریف شده | فیلدهای درون ویژگیهای موجودی با مجموعه مقادیر تعریف شده (مثلاً availability ، pickupMethod ) اکنون از نوع enum هستند. |