API شراکت فیدهای محلی

برنامه مشارکت فیدهای محلی به خرده‌فروشان اجازه می‌دهد بدون نیاز به ایجاد فیدهای موجودی محصول اصلی و محلی خود، در تبلیغات موجودی محلی و فهرست رایگان محصولات محلی شرکت کنند. خرده‌فروشان می‌توانند اطلاعات فروش و موجودی خود را در اختیار یک ارائه‌دهنده داده معتبر قرار دهند که می‌تواند آن اطلاعات را با گوگل به اشتراک بگذارد. برای مشاهده فهرست شرکای داده پشتیبانی‌شده، به «درباره برنامه مشارکت فیدهای محلی» مراجعه کنید.

شما می‌توانید با آپلود کردن فید موجودی محصولات محلی، موجودی محصولات محلی را اضافه کنید.

برای اضافه شدن ارائه‌دهنده داده‌های موجودی خود به مرکز فروشندگان، اطلاعات خود را در بخش بازخورد ارائه‌دهنده داده‌های نقطه فروش ارائه دهید تا محصول محلی در گوگل نمایش داده شود .

برای کسب اطلاعات بیشتر در مورد مهاجرت از API محتوا برای خرید، به بخش مشارکت در انتقال فیدهای محلی مراجعه کنید.

وضعیت پذیرش یک خرده‌فروش را بازیابی کنید

شما می‌توانید از متد lfpMerchantStates.get برای بازیابی وضعیت ویژگی‌های سطح فروشنده مربوط به ادغام مشارکت فیدهای محلی استفاده کنید. بر اساس ویژگی‌های ارائه شده، می‌توانید بررسی کنید که آیا ادغام طبق برنامه کار می‌کند یا اینکه آیا اقدام اضافی مورد نیاز است یا خیر.

GET https://merchantapi.googleapis.com/lfp/v1/accounts/{ACCOUNT_ID}/lfpMerchantStates/{TARGET_MERCHANT_ID}

درج موجودی کالا

برای درج موجودی، از درخواست زیر استفاده کنید:

POST https://merchantapi.googleapis.com/lfp/v1/{PARENT}/lfpInventories:insert

{
 "availability": "in stock",
 "collectionTime": "2024-01-08T08:00:00Z",
 "contentLanguage": "en",
 "gtin": "gtin",
 "offerId": "{OFFER_ID}",
 "pickupMethod": "buy",
 "pickupSla": "same day",
 "price": {
   "amountMicros": "1000000",
   "currencyCode": "USD"
 },
 "regionCode": "US",
 "storeCode": "{STORE_CODE}",
 "targetAccount": "{TARGETMERCHANT_ID}"
}

موارد زیر را جایگزین کنید:

• {PARENT} : فرمت accounts/ {ACCOUNT_ID} است، که در آن {ACCOUNT_ID} شناسه منحصر به فرد حساب مرکز پذیرندگان است.
• {OFFER_ID} : شناسه منحصر به فرد محصول.
• {STORE_CODE} : شناسه فروشگاه فروشنده.
• {TARGETMERCHANT_ID} : شناسه حساب کسب‌وکاری که می‌خواهید موجودی آن را ارسال کنید.

می‌توانید انتظار داشته باشید که پاسخ زیر را ببینید:

{
 "name": "accounts/{merchantId}/lfpInventories/{TARGETMERCHANT_ID}~{STORE_CODE}~{OFFER_ID}",
 "targetAccount": "{TARGETMERCHANT_ID}",
 "storeCode": "123",
 "offerId": "{OFFER_ID}",
 "regionCode": "US",
 "contentLanguage": "en",
 "gtin": "gtin",
 "price": {
   "amountMicros": "1000000",
   "currencyCode": "USD"
 },
 "availability": "in stock",
 "collectionTime": "2024-01-08T08:00:00Z",
 "pickupMethod": "buy",
 "pickupSla": "same day",
 "feedLabel": "US"
}

برای اطلاعات بیشتر، به متد: accounts.lfpInventories.insert مراجعه کنید.

درج آگهی فروش

برای درج آگهی فروش، از درخواست زیر استفاده کنید:

POST https://merchantapi.googleapis.com/lfp/v1/{PARENT}/lfpSales:insert

{
 "contentLanguage": "en",
 "gtin": "gtin",
 "offerId": "offerId",
 "price": {
   "amountMicros": "1000000",
   "currencyCode": "USD"
 },
 "quantity": 2,
 "regionCode": "US",
 "saleTime": "2024-01-08T08:00:00Z",
 "storeCode": "123",
 "targetAccount": "{TARGETMERCHANT_ID}"
}

موارد زیر را جایگزین کنید:

• {TARGETMERCHANT_ID} : شناسه حساب تجاری که قرار است فروش برای آن ثبت شود.

می‌توانید انتظار داشته باشید که پاسخ زیر را ببینید:

{
 "name": "accounts/1000005718521947/lfpSales/{UUID}",
 "targetAccount": "{TARGETMERCHANT_ID}",
 "storeCode": "123",
 "offerId": "offerId",
 "regionCode": "US",
 "contentLanguage": "en",
 "gtin": "gtin",
 "price": {
   "amountMicros": "1000000",
   "currencyCode": "USD"
 },
 "quantity": "2",
 "saleTime": "2024-01-08T08:00:00Z",
 "uid": "{UUID}",
 "feedLabel": "US"
}

برای اطلاعات بیشتر، به روش: accounts.lfpSales.insert مراجعه کنید.

فروشگاه را وارد کنید

برای درج فروشگاه، از درخواست زیر استفاده کنید:

POST https://merchantapi.googleapis.com/lfp/v1/{PARENT}/lfpStores:insert

{
 "storeAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA",
 "storeCode": "{STORE_CODE}",
 "targetAccount": "{TARGETMERCHANT_ID}"
}

موارد زیر را جایگزین کنید:

• {STORE_CODE} : شناسه منحصر به فرد فروشگاه.
• {TARGETMERCHANT_ID} : شناسه حساب کسب‌وکاری که فروشگاه برای آن ثبت می‌شود.

می‌توانید انتظار داشته باشید که پاسخ زیر را ببینید:

{
 "name": "accounts/{MERCHANT_ID}/lfpStores/{TARGETMERCHANT_ID}~{STORE_CODE}",
 "targetAccount": "1000005718454644",
 "storeCode": "{STORE_CODE}",
 "storeAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA",
 "matchingState": "STORE_MATCHING_STATE_MATCHED"
}

برای اطلاعات بیشتر، به accounts.lfpStores.insert مراجعه کنید.

ارسال اعلان به یک خرده فروش

شما می‌توانید از متد SendLfpNotification برای ارسال اعلان به یک خرده‌فروش استفاده کنید. برای مثال، می‌توانید از این متد برای ارسال اعلان ورود به سیستم به خرده‌فروش استفاده کنید.

POST https://merchantapi.googleapis.com/lfp/v1/accounts/{ACCOUNT_ID}/lfpNotifications:send

{
  "target_account": {TARGETMERCHANT_ID},
  "email_address": {EMAIL_ADDRESS},
  "type": {TYPE}
}

موارد زیر را جایگزین کنید:

• {ACCOUNT_ID} : شناسه منحصر به فرد حساب مرکز فروشندگان شما.
• {TARGETMERCHANT_ID} : شناسه منحصر به فرد حسابی که می‌خواهید اعلان را به آن ارسال کنید.
• {EMAIL_ADDRESS} : آدرس ایمیل حسابی که می‌خواهید اعلان به آن ارسال شود.
• {TYPE} : شما فقط می‌توانید مقدار رشته‌ای ONBOARDING_UI در این فیلد ارسال کنید.