Local Feeds Partnership API

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

می‌توانید با بارگذاری فید سیاهه محصول محلی، سیاهه محصول محلی اضافه کنید.

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

برای آشنایی با انتقال از «میانای برنامه‌سازی کاربردی محتوا برای خرید»، به انتقال مشارکت فیدهای محلی مراجعه کنید.

بازیابی وضعیت آماده‌سازی فروشنده

می‌توانید از روش 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": "{TARGET_MERCHANT_ID}"
}

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

  • {PARENT}: قالب آن accounts/{ACCOUNT_ID} است که {ACCOUNT_ID} شناسه یکتای حساب Merchant Center است.
  • ‫{OFFER_ID}: شناسه یکتای محصول.
  • {STORE_CODE}: شناسه فروشگاه فروشنده.
  • {TARGET_MERCHANT_ID}: شناسه حساب کسب‌وکاری که می‌خواهید فهرست موجودی را برای آن ارسال کنید.

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

{
 "name": "accounts/{ACCOUNT_ID}/lfpInventories/{TARGET_MERCHANT_ID}~{STORE_CODE}~{OFFER_ID}",
 "targetAccount": "{TARGET_MERCHANT_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": "{TARGET_MERCHANT_ID}"
}

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

  • {TARGET_MERCHANT_ID}: شناسه حساب کسب‌وکاری که فروش برای آن ارسال می‌شود.

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

{
 "name": "accounts/{ACCOUNT_ID}/lfpSales/{UUID}",
 "targetAccount": "{TARGET_MERCHANT_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": "{TARGET_MERCHANT_ID}"
}

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

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

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

{
 "name": "accounts/{ACCOUNT_ID}/lfpStores/{TARGET_MERCHANT_ID}~{STORE_CODE}",
 "targetAccount": "{TARGET_MERCHANT_ID}",
 "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}: شناسه یکتای حساب Merchant Center شما.
  • {TARGETMERCHANT_ID}: شناسه یکتای حسابی که می‌خواهید اعلان را به آن ارسال کنید.
  • {EMAIL_ADDRESS}: نشانی ایمیل حسابی که می‌خواهید اعلان را به آن ارسال کنید.
  • {TYPE}: فقط می‌توانید مقدار رشته ONBOARDING_UI را در این فیلد وارد کنید.