می‌توانید از Merchant API برای به اشتراک گذاشتن موجودی‌ها، فروشگاه‌ها و داده‌های فروش خود با Google برای مشاهده و مدیریت بهتر استفاده کنید.
ویژگی های جدید
علاوه بر ویژگی‌های Content API، Merchant API ویژگی‌های جدید زیر را ارائه می‌کند:
- روشی برای بازیابی وضعیت ویژگی‌های سطح تاجر مربوط به یکپارچه‌سازی مشارکت خوراک‌های محلی
- روشی برای ارسال اعلان به یک خرده فروش
برای جزئیات بیشتر در مورد این روش‌ها، API مشارکت فیدهای محلی را ببینید.
درخواست ها
از فرمت URL درخواست زیر برای API شراکت فیدهای محلی استفاده کنید:
POST https://merchantapi.googleapis.com/lfp/v1beta/{PARENT}/lfpInventories:insert
برای اطلاعات بیشتر، روش: accounts.lfpInventories.insert را ببینید.
در اینجا یک مقایسه نمونه از Content API برای خرید با API شراکت فیدهای محلی برای درخواست درج موجودی آورده شده است:
| Content API | Merchant API | |
| URL | POST https://shoppingcontent.googleapis.com/content/v2.1/ {MERCHANT_ID} /pos/ {TARGETMERCHANT_ID} /inventory | POST https://merchantapi.googleapis.com/lfp/v1beta/ {PARENT} /lfpInventories:insert |
| شناسه ها | {MERCHANT_ID} /pos/ {TARGETMERCHANT_ID} | {PARENT} |
در اینجا یک مقایسه نمونه از Content API برای خرید با API شراکت فیدهای محلی برای درخواست درج یک فروش آورده شده است:
| Content API | Merchant API | |
| URL | POST https://shoppingcontent.googleapis.com/content/v2.1/ {MERCHANT_ID} /pos/ {TARGETMERCHANT_ID} /sale | POST https://merchantapi.googleapis.com/lfp/v1beta/ {PARENT} /lfpSales:insert |
| شناسه ها | {MERCHANT_ID} /pos/ {TARGETMERCHANT_ID} | {PARENT} |
در اینجا یک مقایسه نمونه از Content API برای خرید با API شراکت فیدهای محلی برای درخواست درج فروشگاه آورده شده است:
| Content API | Merchant API | |
| URL | POST https://shoppingcontent.googleapis.com/content/v2.1/ {MERCHANT_ID} /pos/ {TARGETMERCHANT_ID} /store | POST https://merchantapi.googleapis.com/lfp/v1beta/ {PARENT} /lfpStores:insert |
| شناسه ها | {MERCHANT_ID} /pos/ {TARGETMERCHANT_ID} | {PARENT} |
روش ها
این چیزی است که برای روش‌های API فروشگاه در API مشارکت فیدهای محلی تغییر کرده است:
| روش | URL در Content API برای خرید | URL در Merchant API | شناسه‌ها در Content API برای خرید | شناسه‌ها در Merchant API | توضیحات |
insert | POST https://shoppingcontent.googleapis.com/content/v2.1/ {MERCHANT_ID} /pos/ {TARGETMERCHANT_ID} /store | POST https://merchantapi.googleapis.com/lfp/v1beta/ {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/v1beta/ {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/v1beta/ {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/v1beta/ {parent=accounts/*} /lfpStores | / {MERCHANT_ID} /pos/ {TARGETMERCHANT_ID} | {PARENT} | {PARENT} در قالب accounts/ {IFP_PARTNER_ACCOUNT_ID} |
این چیزی است که برای روش‌های API موجودی در API مشارکت فیدهای محلی تغییر کرده است:
| روش | URL در Content API برای خرید | URL در Merchant API | شناسه‌ها در Content API برای خرید | شناسه‌ها در Merchant API | توضیحات |
insert | POST https://shoppingcontent.googleapis.com/content/v2.1/ {MERCHANT_ID} /pos/ {TARGETMERCHANT_ID} /store | POST https://merchantapi.googleapis.com/lfp/v1beta/ {PARENT} /lfpInventories:insert | {MERCHANT_ID} /pos/ {TARGETMERCHANT_ID} | {PARENT} | parent در قالب accounts/ {IFP_PARTNER_ACCOUNT_ID} |
این چیزی است که برای روش‌های API فروش در API مشارکت فیدهای محلی تغییر کرده است:
| روش | URL در Content API برای خرید | URL در Merchant API | شناسه‌ها در Content API برای خرید | شناسه‌ها در Merchant API | توضیحات |
insert | POST https://shoppingcontent.googleapis.com/content/v2.1/ {MERCHANT_ID} /pos/ {TARGETMERCHANT_ID} /store | POST https://merchantapi.googleapis.com/lfp/v1beta/ {PARENT} /lfpSales:insert | {MERCHANT_ID} /pos/ {TARGETMERCHANT_ID} | {PARENT} | {PARENT} در قالب accounts/ {IFP_PARTNER_ACCOUNT_ID} |
منابع
در اینجا چیزی است که برای منبع فروشگاه در API شراکت فیدهای محلی تغییر کرده است. فیلدهایی که در اینجا گنجانده نشده اند بدون تغییر هستند.
| Content API برای خرید | Merchant API | توضیحات |
| پشتیبانی نمی شود | name: string | اضافه شدن زمینه جدید برای متمایز کردن فروشگاه های مختلف |
| پشتیبانی نمی شود | targetAccount: integer | حساب تاجر برای درج موجودی |
targetCountry: string | regionCode: string | targetCountry به regionCode تغییر نام داده است |
websiteUrl: string | websiteUri: string | websiteUrl به websiteUri تغییر نام داده است |
kind: string | پشتیبانی نمی شود | kind در API مشارکت فیدهای محلی پشتیبانی نمی‌شود |
در اینجا چیزی است که برای درج موجودی تغییر کرده است. فیلدهایی که در اینجا گنجانده نشده اند بدون تغییر هستند.
| Content API برای خرید | Merchant 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 مشارکت فیدهای محلی پشتیبانی نمی‌شود. |
در اینجا چیزی است که برای درج یک فروش تغییر کرده است. فیلدهایی که در اینجا گنجانده نشده اند بدون تغییر هستند.
| Content API برای خرید | Merchant 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 مشارکت فیدهای محلی پشتیبانی نمی‌شود. |