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 مراجعه کنید.

LfpSaleService

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

InsertLfpSale

rpc InsertLfpSale( InsertLfpSaleRequest ) returns ( LfpSale )

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

محدوده مجوز

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

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

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

LfpStoreService

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

DeleteLfpStore

rpc DeleteLfpStore( DeleteLfpStoreRequest ) returns ( Empty )

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

محدوده مجوز

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

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

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

GetLfpStore

rpc GetLfpStore( GetLfpStoreRequest ) returns ( LfpStore )

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

محدوده مجوز

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

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

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

InsertLfpStore

rpc InsertLfpStore( InsertLfpStoreRequest ) returns ( LfpStore )

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

محدوده مجوز

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

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

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

ListLfpStores

rpc ListLfpStores( ListLfpStoresRequest ) returns ( ListLfpStoresResponse )

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

محدوده مجوز

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

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

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

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 Place مکان فروشگاه.

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 برای بازیابی صفحه بعدی ارسال شود. اگر این قسمت حذف شود، هیچ صفحه بعدی وجود ندارد.