Package google.shopping.merchant.lfp.v1beta

شاخص

LfpInventoryService

خدمات برای شریک LFP برای ارسال موجودی های محلی برای یک تاجر.

InsertLfpInventory

rpc InsertLfpInventory( InsertLfpInventoryRequest ) returns ( LfpInventory )

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

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/content

برای اطلاعات بیشتر، بهOAuth 2.0 Overview .

LfpSaleService

خدمات برای شریک LFP برای ارسال داده های فروش برای یک تاجر.

InsertLfpSale

rpc InsertLfpSale( InsertLfpSaleRequest ) returns ( LfpSale )

یک LfpSale برای تاجر داده شده درج می کند.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/content

برای اطلاعات بیشتر، بهOAuth 2.0 Overview .

LfpStoreService

خدمات برای شریک LFP برای ارائه فروشگاه های محلی برای یک تاجر.

DeleteLfpStore

rpc DeleteLfpStore( DeleteLfpStoreRequest ) returns ( Empty )

فروشگاهی را برای یک تاجر هدف حذف می کند.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/content

برای اطلاعات بیشتر، بهOAuth 2.0 Overview .

GetLfpStore

rpc GetLfpStore( GetLfpStoreRequest ) returns ( LfpStore )

اطلاعات مربوط به یک فروشگاه را بازیابی می کند.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/content

برای اطلاعات بیشتر، بهOAuth 2.0 Overview .

InsertLfpStore

rpc InsertLfpStore( InsertLfpStoreRequest ) returns ( LfpStore )

فروشگاهی را برای تاجر هدف درج می کند. اگر فروشگاهی با همان کد فروشگاه از قبل وجود داشته باشد، جایگزین خواهد شد.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/content

برای اطلاعات بیشتر، بهOAuth 2.0 Overview .

ListLfpStores

rpc ListLfpStores( ListLfpStoresRequest ) returns ( ListLfpStoresResponse )

فروشگاه‌های تاجر هدف را که توسط فیلتر در ListLfpStoresRequest مشخص شده است، فهرست می‌کند.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/content

برای اطلاعات بیشتر، بهOAuth 2.0 Overview .

DeleteLfpStoreRequest

درخواست پیام برای متد DeleteLfpStore.

فیلدها
name

string

مورد نیاز. نام فروشگاهی که باید برای حساب تاجر هدف حذف شود. قالب: accounts/{account}/lfpStores/{target_merchant}~{store_code}

GetLfpStoreRequest

درخواست پیام برای متد GetLfpStore .

فیلدها
name

string

مورد نیاز. نام فروشگاهی که باید بازیابی شود. قالب: accounts/{account}/lfpStores/{target_merchant}~{store_code}

InsertLfpInventoryRequest

درخواست پیام برای متد InsertLfpInventory .

فیلدها
parent

string

مورد نیاز. حساب ارائه دهنده LFP. قالب: accounts/{account}

lfp_ inventory

LfpInventory

مورد نیاز. موجودی برای درج.

InsertLfpSaleRequest

درخواست پیام برای متد InsertLfpSale.

فیلدها
parent

string

مورد نیاز. حساب ارائه دهنده LFP. قالب: accounts/{lfp_partner}

lfp_ sale

LfpSale

مورد نیاز. فروش برای درج.

InsertLfpStoreRequest

درخواست پیام برای متد InsertLfpStore.

فیلدها
parent

string

مورد نیاز. قالب حساب ارائه‌دهنده LFP: accounts/{account}

lfp_ store

LfpStore

مورد نیاز. فروشگاه برای درج.

LfpInventory

موجودی محلی برای تاجر.

فیلدها
name

string

فقط خروجی شناسه. نام منبع LfpInventory . قالب: accounts/{account}/lfpInventories/{target_merchant}~{store_code}~{offer}

target_ account

int64

مورد نیاز. شناسه مرکز تجاری تاجر برای ارسال موجودی.

store_ code

string

مورد نیاز. شناسه فروشگاه تاجر. یا کد فروشگاه درج شده از طریق InsertLfpStore یا کد فروشگاه در نمایه کسب و کار.

offer_ id

string

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

توجه : اگر تاجر همان محصول را نو و دست دوم بفروشد، باید شناسه های متفاوتی داشته باشد.

region_ code

string

مورد نیاز. کد قلمرو CLDR برای کشوری که محصول در آن فروخته می شود.

content_ language

string

مورد نیاز. کد زبان دو حرفی ISO 639-1 برای مورد.

price

Price

اختیاری. قیمت فعلی محصول.

availability

string

مورد نیاز. موجودی محصول در این فروشگاه برای مقادیر مشخصه پذیرفته شده، مشخصات داده موجودی محصول محلی را ببینید

collection_ time

Timestamp

اختیاری. زمان جمع آوری موجودی. در صورت تنظیم نشدن، بر روی زمان ارسال موجودی تنظیم می شود.

gtin

string

اختیاری. شماره کالای تجارت جهانی محصول.

quantity

int64

اختیاری. تعداد محصول موجود در این فروشگاه باید بزرگتر یا مساوی صفر باشد.

pickup_ method

string

اختیاری. روش دریافت پشتیبانی شده برای این پیشنهاد. مگر اینکه مقدار "پشتیبانی نمی شود"، این فیلد باید همراه با pickupSla ارسال شود. برای مقادیر مشخصه پذیرفته شده، مشخصات داده موجودی محصول محلی را ببینید.

pickup_ sla

string

اختیاری. تاریخ پیش بینی شده که یک سفارش نسبت به تاریخ سفارش آماده تحویل است. باید همراه با pickupMethod ارسال شود. برای مقادیر مشخصه پذیرفته شده، مشخصات داده موجودی محصول محلی را ببینید.

feed_ label

string

اختیاری. برچسب خوراک برای محصول اگر این تنظیم نشده باشد، به طور پیش‌فرض روی regionCode خواهد بود.

LfpSale

فروش برای تاجر

فیلدها
name

string

فقط خروجی شناسه. نام منبع LfpSale . قالب: accounts/{account}/lfpSales/{sale}

target_ account

int64

مورد نیاز. شناسه مرکز تجاری تاجر برای ارسال فروش.

store_ code

string

مورد نیاز. شناسه فروشگاه تاجر. یا یک storeCode درج شده از طریق API یا کد فروشگاه در نمایه تجاری.

offer_ id

string

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

توجه : اگر تاجر همان محصول را نو و دست دوم بفروشد، باید شناسه های متفاوتی داشته باشد.

region_ code

string

مورد نیاز. کد قلمرو CLDR برای کشوری که محصول در آن فروخته می شود.

content_ language

string

مورد نیاز. کد زبان دو حرفی ISO 639-1 برای مورد.

gtin

string

مورد نیاز. شماره کالای تجارت جهانی محصول فروخته شده.

price

Price

مورد نیاز. قیمت واحد محصول.

quantity

int64

مورد نیاز. تغییر نسبی مقدار موجود. برای اقلام برگشتی منفی است.

sale_ time

Timestamp

مورد نیاز. مهر زمانی برای فروش

uid

string

فقط خروجی سیستم شناسه منحصر به فرد جهانی برای LfpSale ایجاد کرد.

feed_ label

string

اختیاری. برچسب خوراک برای محصول اگر این تنظیم نشده باشد، به طور پیش‌فرض روی regionCode خواهد بود.

LfpStore

فروشگاهی برای تاجر این برای مطابقت با فروشگاهی تحت نمایه کسب و کار Google تاجر مورد نظر استفاده خواهد شد. اگر فروشگاه منطبقی پیدا نشد، از موجودی‌ها یا فروش‌های ارسالی با کد فروشگاه استفاده نمی‌شود.

فیلدها
name

string

فقط خروجی شناسه. نام منبع LfpStore . قالب: accounts/{account}/lfpStores/{target_merchant}~{store_code}

target_ account

int64

مورد نیاز. شناسه مرکز تجاری تاجر برای ارسال فروشگاه.

store_ code

string

مورد نیاز. تغییرناپذیر. شناسه فروشگاهی که برای تاجر هدف منحصر به فرد است.

store_ address

string

مورد نیاز. آدرس خیابان فروشگاه. مثال: 1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA.

gcid_ category[]

string

اختیاری. شناسه دسته Google برای کسب و کار من .

matching_ state

StoreMatchingState

اختیاری. فقط خروجی وضعیت تطبیق با نمایه کسب و کار Google. اگر مطابقت یافت نشد، برای جزئیات بیشتر به matchingStateHint مراجعه کنید.

store_ name

string

اختیاری. نام تاجر یا فروشگاه.

phone_ number

string

اختیاری. شماره تلفن فروشگاه با فرمت E.164 . مثال: +15556767888

website_ uri

string

اختیاری. نشانی وب سایت فروشگاه یا تاجر.

place_ id

string

اختیاری. شناسه مکان Google مکان فروشگاه.

matching_ state_ hint

string

اختیاری. فقط خروجی اشاره به اینکه چرا تطبیق شکست خورده است. این فقط زمانی تنظیم می‌شود که matchingState = STORE_MATCHING_STATE_FAILED باشد.

مقادیر ممکن عبارتند از:

  • " linked-store-not-found ": هیچ فروشگاه Google Business Profile برای مطابقت موجود نیست.
  • " store-match-not-found ": LfpStore ارائه شده را نمی توان با هیچ یک از فروشگاه های مرتبط نمایه کسب و کار Google مطابقت داد. حساب Merchant Center به درستی متصل شده است و فروشگاه‌ها در نمایه کسب‌وکار Google در دسترس هستند، اما آدرس مکان LfpStore با آدرس‌های فروشگاه‌های Google Business Profile مطابقت ندارد. آدرس LfpStore یا آدرس فروشگاه نمایه کسب و کار Google را به‌روزرسانی کنید تا درست مطابقت داشته باشد.
  • " store-match-unverified ": LfpStore ارائه شده را نمی توان با هیچ یک از فروشگاه های مرتبط نمایه کسب و کار Google مطابقت داد، زیرا فروشگاه نمایه کسب و کار Google منطبق تأیید نشده است. برای مطابقت صحیح، فرآیند تأیید نمایه کسب و کار Google را طی کنید.

StoreMatchingState

وضعیت تطبیق LfpStore با نمایه کسب و کار Google.

Enums
STORE_MATCHING_STATE_UNSPECIFIED وضعیت تطبیق ذخیره نامشخص است.
STORE_MATCHING_STATE_MATCHED LfpStore با موفقیت با فروشگاه نمایه کسب و کار Google مطابقت یافته است.
STORE_MATCHING_STATE_FAILED LfpStore با فروشگاه نمایه کسب و کار Google مطابقت ندارد.

ListLfpStoresRequest

درخواست پیام برای متد ListLfpStores.

فیلدها
parent

string

مورد نیاز. شریک LFP. قالب: accounts/{account}

target_ account

int64

مورد نیاز. شناسه Merchant Center تاجر برای فهرست کردن فروشگاه‌ها.

page_ size

int32

اختیاری. حداکثر تعداد منابع LfpStore برای بازگرداندن حساب داده شده. اگر تعداد فروشگاه های حساب داده شده کمتر از pageSize باشد، سرویس کمتر از این مقدار را برمی گرداند. مقدار پیش فرض 250 است. حداکثر مقدار 1000 است. اگر مقداری بالاتر از حداکثر مشخص شده باشد، pageSize به صورت پیش‌فرض به حداکثر خواهد رسید.

page_ token

string

اختیاری. یک نشانه صفحه، دریافت شده از تماس قبلی ListLfpStoresRequest . رمز صفحه را برای بازیابی صفحه بعدی ارائه دهید. هنگام صفحه بندی، تمام پارامترهای دیگر ارائه شده به ListLfpStoresRequest باید با فراخوانی که توکن صفحه را ارائه می کند مطابقت داشته باشد. توکن در پاسخ به درخواست قبلی به عنوان nextPageToken بازگشت.

ListLfpStoresResponse

پیام پاسخ برای متد ListLfpStores.

فیلدها
lfp_ stores[]

LfpStore

فروشگاه ها از تاجر مشخص شده.

next_ page_ token

string

یک نشانه، که می تواند به عنوان pageToken برای بازیابی صفحه بعدی ارسال شود. اگر این قسمت حذف شود، هیچ صفحه بعدی وجود ندارد.