شما میتوانید از رابط برنامهنویسی کاربردی فروشنده (Merchant API) برای مدیریت موجودی محلی (درون فروشگاه) و منطقهای استفاده کنید.
درخواستها
از فرمت URL درخواست زیر برای 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} .
در اینجا یک مقایسه نمونه برای درخواستهای موجودی محلی آورده شده است:
| مورد | API محتوا برای خرید | رابط برنامهنویسی کاربردی (API) فروشنده |
|---|---|---|
| آدرس اینترنتی | 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: به شما امکان میدهد موجودی محلی و منطقهای محصولات خود را حذف کنید.
در اینجا مقایسهای از روشهای موجود برای مدیریت موجودیها ارائه شده است:
| روش | API محتوا برای خرید | رابط برنامهنویسی کاربردی (API) فروشنده |
|---|---|---|
customBatch | بله | خیر |
insert | بله | بله |
list | خیر | بله |
delete | خیر | بله |
منابع
در اینجا تغییراتی که برای موجودیهای محلی و منطقهای ایجاد شده است، آورده شده است:
| API محتوا برای خرید | رابط برنامهنویسی کاربردی (API) فروشنده | توضیحات |
|---|---|---|
| پشتیبانی نمیشود | name:string | این فیلد، منابع LocalInventory و RegionalInventory را در یک product متمایز میکند. رابط برنامهنویسی کاربردی محتوا برای خرید، موجودی محلی را با storeCode و productId و موجودی منطقهای را با regionId و productId شناسایی میکند. |
| پشتیبانی نمیشود | account:string | فیلد جدیدی برای شناسایی حساب مرکز فروشندگان که 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 هستند. |