شما میتوانید از رابط برنامهنویسی کاربردی فروشنده (Merchant API) برای اشتراکگذاری موجودیها، فروشگاهها و دادههای فروش خود با گوگل استفاده کنید تا قابلیت مشاهده و مدیریت بهتری داشته باشید.
ویژگیهای جدید
علاوه بر ویژگیهای API محتوا، API فروشنده ویژگیهای جدید زیر را ارائه میدهد:
- روشی برای بازیابی وضعیت ویژگیهای سطح کسبوکار مربوط به ادغام مشارکت فیدهای محلی
- روشی برای ارسال اعلان به یک خرده فروش
برای جزئیات بیشتر در مورد این روشها، به API مشارکت فیدهای محلی مراجعه کنید.
درخواستها
از قالب URL درخواست زیر برای API مشارکت فیدهای محلی استفاده کنید:
POST https://merchantapi.googleapis.com/lfp/v1/{PARENT}/lfpInventories:insert
برای اطلاعات بیشتر، به متد: accounts.lfpInventories.insert مراجعه کنید.
در اینجا نمونهای از مقایسهی API محتوا برای خرید با API مشارکت فیدهای محلی برای درخواست درج موجودی کالا آورده شده است:
| رابط برنامهنویسی کاربردی محتوا | رابط برنامهنویسی کاربردی (API) فروشنده | |
| آدرس اینترنتی | 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} |
در اینجا نمونهای از مقایسهی رابط برنامهنویسی کاربردی محتوا برای خرید با رابط برنامهنویسی کاربردی مشارکت فیدهای محلی برای درخواست درج فروش آورده شده است:
| رابط برنامهنویسی کاربردی محتوا | رابط برنامهنویسی کاربردی (API) فروشنده | |
| آدرس اینترنتی | 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} |
در اینجا نمونهای از مقایسهی API محتوا برای خرید با API مشارکت فیدهای محلی برای درخواست درج فروشگاه آورده شده است:
| رابط برنامهنویسی کاربردی محتوا | رابط برنامهنویسی کاربردی (API) فروشنده | |
| آدرس اینترنتی | 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} |
روشها
در اینجا تغییراتی که برای متدهای API فروشگاه در API مشارکت فیدهای محلی ایجاد شده است را مشاهده میکنید:
| روش | URL در API محتوا برای خرید | URL در API فروشنده | شناسهها در 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 مشارکت فیدهای محلی ایجاد شده است را مشاهده میکنید:
| روش | URL در API محتوا برای خرید | URL در API فروشنده | شناسهها در 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 مشارکت فیدهای محلی ایجاد شده است را مشاهده میکنید:
| روش | URL در API محتوا برای خرید | URL در API فروشنده | شناسهها در 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 مشارکت فیدهای محلی تغییر کرده است، آورده شده است. فیلدهایی که در اینجا ذکر نشدهاند، بدون تغییر باقی میمانند.
| API محتوا برای خرید | رابط برنامهنویسی کاربردی (API) فروشنده | توضیحات |
| پشتیبانی نمیشود | name: string | فیلد جدیدی برای تمایز فروشگاههای مختلف اضافه شد |
| پشتیبانی نمیشود | targetAccount: integer | حساب مرکز بازرگانان برای درج موجودی برای |
targetCountry: string | regionCode: string | نام targetCountry به regionCode تغییر یافته است |
websiteUrl: string | websiteUri: string | websiteUrl به websiteUri تغییر نام داده است. |
kind: string | پشتیبانی نمیشود | kind در API مشارکت فیدهای محلی پشتیبانی نمیشود |
در اینجا مواردی که برای درج موجودی تغییر کرده است را مشاهده میکنید. فیلدهایی که در اینجا ذکر نشدهاند، بدون تغییر باقی میمانند.
| API محتوا برای خرید | رابط برنامهنویسی کاربردی (API) فروشنده | توضیحات |
| پشتیبانی نمیشود | name: string | فیلد جدیدی برای تمایز موجودیهای مختلف اضافه شد |
| پشتیبانی نمیشود | targetAccount: integer | حساب مرکز بازرگانان برای درج موجودی کالا. |
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 در API مشارکت فیدهای محلی پشتیبانی نمیشود. |
در اینجا مواردی که برای درج فروش تغییر کرده است را مشاهده میکنید. فیلدهایی که در اینجا ذکر نشدهاند، بدون تغییر باقی میمانند.
| API محتوا برای خرید | رابط برنامهنویسی کاربردی (API) فروشنده | توضیحات |
| پشتیبانی نمیشود | name: string | فیلد جدیدی برای تمایز موجودیهای مختلف اضافه شد |
| پشتیبانی نمیشود | targetAccount:integer | حساب مرکز بازرگانان برای درج فروش |
targetCountry: string | regionCode: string | کد منطقه CLDR برای کشوری که محصول در آن فروخته میشود. |
itemId: string | offerId: string | itemId به offerId تغییر نام داده است |
| قیمت: { شیء (قیمت) } | تعریف قیمت تغییر کرده است. برای اطلاعات بیشتر، به قیمت مراجعه کنید. |
timestamp: string | saleTime: string | timestamp به saleTime تغییر نام داده شده است |
kind: string | پشتیبانی نمیشود | kind در API مشارکت فیدهای محلی پشتیبانی نمیشود. |