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