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

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

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

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

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

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

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

GET https://merchantapi.googleapis.com/lfp/v1beta/accounts/{ACCOUNT_ID}/lfpState/{TARGET_MERCHANT_ID}

درج موجودی

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

POST https://merchantapi.googleapis.com/lfp/v1beta/{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} شناسه منحصربه‌فرد حساب Merchant Center است.
  • {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/v1beta/{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/v1beta/{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/v1beta/accounts/{ACCOUNT_ID}/lfpNotifications:send

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

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

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