می‌توانید از Merchant API برای هم‌رسانی موجودی‌ها، فروشگاه‌ها، و داده‌های فروش با Google استفاده کنید تا نمایان بودن و مدیریت بهتری داشته باشید.
ویژگی‌های جدید
علاوه‌بر ویژگی‌های Content API، Merchant API ویژگی‌های جدید زیر را ارائه می‌دهد:
- روشی برای بازیابی وضعیت ویژگی‌های سطح کسب‌وکار مربوط به ادغام شراکت در فیدهای محلی
- روشی برای ارسال اعلان به خرده‌فروش
برای جزئیات مربوط به این روش‌ها، میانای برنامه‌سازی کاربردی شراکت در فیدهای محلی را ببینید.
درخواست‌ها
از قالب نشانی وب درخواست زیر برای میانای برنامه‌سازی کاربردی شراکت در فیدهای محلی استفاده کنید:
POST https://merchantapi.googleapis.com/lfp/v1/{PARENT}/lfpInventories:insert
برای اطلاعات بیشتر، روش: accounts.lfpInventories.insert را ببینید.
در اینجا نمونه‌ای از مقایسه Content API for Shopping با میانای برنامه‌سازی کاربردی مشارکت فیدهای محلی برای درخواست درج موجودی ارائه شده است:
| میانای برنامه‌سازی کاربردی محتوا | میانای برنامه‌سازی کاربردی فروشنده | |
| نشانی وب |
POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/inventory
|
POST https://merchantapi.googleapis.com/lfp/v1/{PARENT}/lfpInventories:insert
|
| شناسه‌ها |
{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}
|
{PARENT} |
در اینجا نمونه‌ای از مقایسه «میانای برنامه‌سازی کاربردی محتوا برای خرید» با میانای برنامه‌سازی کاربردی مشارکت فیدهای محلی برای درخواست درج فروش آورده شده است:
| میانای برنامه‌سازی کاربردی محتوا | میانای برنامه‌سازی کاربردی فروشنده | |
| نشانی وب | POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/sale |
POST https://merchantapi.googleapis.com/lfp/v1/{PARENT}/lfpSales:insert |
| شناسه‌ها | {MERCHANT_ID}/pos/{TARGETMERCHANT_ID} |
{PARENT} |
در اینجا نمونه‌ای از مقایسه Content API for Shopping با میانای برنامه‌سازی کاربردی مشارکت فیدهای محلی برای درخواست درج فروشگاه آورده شده است:
| میانای برنامه‌سازی کاربردی محتوا | میانای برنامه‌سازی کاربردی فروشنده | |
| نشانی وب | POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store |
POST https://merchantapi.googleapis.com/lfp/v1/{PARENT}/lfpStores:insert |
| شناسه‌ها | {MERCHANT_ID}/pos/{TARGETMERCHANT_ID} |
{PARENT} |
روش‌ها
تغییرات روش‌های میانای برنامه‌سازی کاربردی فروشگاه در میانای برنامه‌سازی کاربردی شراکت در فیدهای محلی در اینجا آمده است:
| روش | نشانی وب در Content API ویژه Shopping | نشانی وب در Merchant API | شناسه‌ها در Content API ویژه Shopping | شناسه‌ها در Merchant API | شرح |
insert |
POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store |
POST https://merchantapi.googleapis.com/lfp/v1/{parent=accounts/*}/lfpStores:insert |
{MERCHANT_ID}/pos/{TARGETMERCHANT_ID} |
{PARENT} | parent در قالب accounts/{IFP_PARTNER_ACCOUNT_ID} است |
delete |
DELETE https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store/{STORE_CODE} |
DELETE https://merchantapi.googleapis.com/lfp/v1/{name=accounts/*/lfpStores/*} |
{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store/{STORE_CODE} |
{NAME} | name در قالب accounts/{IFP_PARTNER_ACCOUNT_ID}/lfpStores/{TARGETMERCHANT_ID}~{STORE_CODE} است |
get |
GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store/{STORE_CODE} |
GET https://merchantapi.googleapis.com/lfp/v1/{name=accounts/*/lfpStores/*} |
{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store/{STORE_CODE} |
{NAME} | name در قالب accounts/{IFP_PARTNER_ACCOUNT_ID}/lfpStores/{TARGETMERCHANT_ID}~{STORE_CODE} است |
list |
GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store |
GET https://merchantapi.googleapis.com/lfp/v1/{parent=accounts/*}/lfpStores |
/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID} |
{PARENT} | {PARENT} در قالب accounts/{IFP_PARTNER_ACCOUNT_ID} است |
تغییرات روش‌های API فهرست موجودی در API شراکت در فیدهای محلی:
| روش | نشانی وب در Content API ویژه Shopping | نشانی وب در Merchant API | شناسه‌ها در Content API ویژه Shopping | شناسه‌ها در Merchant API | شرح |
insert |
POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store |
POST https://merchantapi.googleapis.com/lfp/v1/{PARENT}/lfpInventories:insert |
{MERCHANT_ID}/pos/{TARGETMERCHANT_ID} |
{PARENT} | parent در قالب accounts/{IFP_PARTNER_ACCOUNT_ID} است |
تغییرات روش‌های API فروش در API شراکت در فیدهای محلی در اینجا آمده است:
| روش | نشانی وب در Content API ویژه Shopping | نشانی وب در Merchant API | شناسه‌ها در Content API ویژه Shopping | شناسه‌ها در Merchant API | شرح |
insert |
POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store |
POST https://merchantapi.googleapis.com/lfp/v1/{PARENT}/lfpSales:insert |
{MERCHANT_ID}/pos/{TARGETMERCHANT_ID} |
{PARENT} | {PARENT} در قالب accounts/{IFP_PARTNER_ACCOUNT_ID} است |
منابع
در اینجا مواردی که برای منبع فروشگاه در API شراکت در فیدهای محلی تغییر کرده است آورده شده است. فیلدهایی که در اینجا گنجانده نشده‌اند تغییر نمی‌کنند.
| Content API for Shopping | میانای برنامه‌سازی کاربردی فروشنده | شرح |
| پشتیبانی نمی‌شود | name: string |
فیلد جدیدی برای متمایز کردن فروشگاه‌های مختلف اضافه شد |
| پشتیبانی نمی‌شود | targetAccount: integer |
حساب Merchant Center برای درج موجودی‌ها |
targetCountry: string |
regionCode: string |
نام targetCountry به regionCode تغییر کرد |
websiteUrl: string |
websiteUri: string |
نام websiteUrl به websiteUri تغییر کرد |
kind: string |
پشتیبانی نمی‌شود | kind در میانای برنامه‌سازی کاربردی شراکت در فیدهای محلی پشتیبانی نمی‌شود |
آنچه برای درج موجودی تغییر کرده است. فیلدهایی که در اینجا گنجانده نشده‌اند تغییر نمی‌کنند.
| Content API for Shopping | میانای برنامه‌سازی کاربردی فروشنده | شرح |
| پشتیبانی نمی‌شود | name: string |
فیلد جدیدی برای متمایز کردن موجودی‌های مختلف اضافه شد |
| پشتیبانی نمی‌شود | targetAccount: integer |
حساب Merchant Center که موجودی‌ها در آن درج می‌شود. |
targetCountry: string |
regionCode: string |
نام targetCountry به regionCode تغییر کرد. کد قلمرو CLDR برای کشوری که محصول در آن فروخته می‌شود. |
itemId: string |
offerId: string |
نام itemId به offerId تغییر کرد |
quantity: string |
quantity: string |
quantity به‌روزرسانی شده است تا اختیاری باشد |
| پشتیبانی نمی‌شود | availability: string |
availability لازم است |
|
|
تعریف قیمت تغییر کرده است. برای اطلاعات بیشتر، به قیمت مراجعه کنید. |
timestamp: string |
collectionTime: string |
نام timestamp به collectionTime تغییر کرد |
kind: string |
پشتیبانی نمی‌شود | kind در میانای برنامه‌سازی کاربردی شراکت در فیدهای محلی پشتیبانی نمی‌شود. |
در اینجا آنچه برای درج فروش تغییر کرده است آورده شده است. فیلدهایی که در اینجا گنجانده نشده‌اند تغییر نمی‌کنند.
| Content API for Shopping | میانای برنامه‌سازی کاربردی فروشنده | شرح |
| پشتیبانی نمی‌شود | name: string |
فیلد جدیدی برای متمایز کردن موجودی‌های مختلف اضافه شد |
| پشتیبانی نمی‌شود | targetAccount:integer |
حساب Merchant Center برای درج فروش |
targetCountry: string |
regionCode: string |
کد قلمرو CLDR برای کشوری که محصول در آن فروخته می‌شود. |
itemId: string |
offerId: string |
نام itemId به offerId تغییر کرد |
|
|
تعریف قیمت تغییر کرده است. برای اطلاعات بیشتر، به قیمت مراجعه کنید. |
timestamp: string |
saleTime: string |
نام timestamp به saleTime تغییر کرد |
kind: string |
پشتیبانی نمی‌شود | kind در میانای برنامه‌سازی کاربردی شراکت در فیدهای محلی پشتیبانی نمی‌شود. |