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

مطلوب. حساب مقدّم الخدمة في برنامج "الشراكة في الخلاصات المحلية". التنسيق: accounts/{account}
lfp_inventory

LfpInventory

مطلوب. المستودع المطلوب إدراجه.

InsertLfpSaleRequest

رسالة طلب لطريقة InsertLfpSale

الحقول
parent

string

مطلوب. حساب مقدّم الخدمة في برنامج "الشراكة في الخلاصات المحلية". التنسيق: accounts/{lfp_partner}
lfp_sale

LfpSale

مطلوب. التخفيض المطلوب إدراجه.

InsertLfpStoreRequest

رسالة طلب لطريقة InsertLfpStore

الحقول
parent

string

مطلوب. تنسيق حساب مقدّم خدمة "الشراكة في الخلاصات المحلية": accounts/{account}
lfp_store

LfpStore

مطلوب. المتجر المطلوب إدراجه.

LfpInventory

المنتجات المتوفرة داخل المتجر للتاجر

الحقول
name

string

النتائج فقط. المعرّف اسم مورد LfpInventory التنسيق: accounts/{account}/lfpInventories/{target_merchant}~{store_code}~{offer}
target_account

int64

مطلوب. معرّف التاجر في Merchant Center الذي سيتم إرسال المستودع له
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

مطلوب. معرّف التاجر في Merchant Center الذي تريد إرسال معلومات التخفيض له
store_code

string

مطلوب. معرّف متجر التاجر إما storeCode تم إدراجه من خلال واجهة برمجة التطبيقات أو رمز المتجر في "الملف التجاري".
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

مطلوب. معرّف التاجر في Merchant Center الذي سيتم إرسال المتجر إليه.
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

اختيارية: عنوان URL للموقع الإلكتروني الخاص بالمتجر أو التاجر
place_id

string

اختيارية: رقم تعريف المكان على Google الخاص بالموقع الجغرافي للمتجر
matching_state_hint

string

اختيارية: النتائج فقط. تعديل بشأن سبب تعذّر المطابقة. لا يتمّ ضبط هذا الإعداد إلّا عندما يكون matchingState=STORE_MATCHING_STATE_FAILED.

القيم المحتملة هي:

  • "linked-store-not-found": لا تتوفّر أي متاجر في "الملف التجاري على Google" لمطابقتها.
  • "store-match-not-found": تعذّرت مطابقة LfpStore المقدّمة مع أيٍّ من متاجر "الملف التجاري على Google" التي تمّ ربطها. تم ربط حساب Merchant Center بشكل صحيح، وتتوفر المتاجر في "الملف التجاري على Google"، ولكنّ عنوان الموقع الجغرافي LfpStore لا يتطابق مع عناوين المتاجر في "الملف التجاري على Google". يُرجى تعديل عنوان LfpStore أو عنوان المتجر في "الملف التجاري على Google" ليصبحا مطابقين بشكل صحيح.
  • "store-match-unverified": تعذّرت مطابقة LfpStore المقدّمة مع أيٍّ من متاجر "الملف التجاري على Google" المرتبطة، لأنّه لم يتم إثبات ملكية متجر "الملف التجاري على Google" الذي تمت مطابقته. اتّبِع عملية إثبات الملكية في "الملف التجاري على Google" للمطابقة بشكل صحيح.

StoreMatchingState

حالة مطابقة LfpStore مع ملف تجاري على Google

عمليات التعداد
STORE_MATCHING_STATE_UNSPECIFIED لم يتم تحديد حالة مطابقة المتجر.
STORE_MATCHING_STATE_MATCHED تمت مطابقة LfpStore بنجاح مع متجر في "الملف التجاري على Google".
STORE_MATCHING_STATE_FAILED لم تتم مطابقة LfpStore مع متجر في "الملف التجاري على Google".

ListLfpStoresRequest

رسالة طلب لطريقة ListLfpStores

الحقول
parent

string

مطلوب. شريك برنامج "الشراكة في الخلاصات المحلية" التنسيق: 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 لاسترداد الصفحة التالية. في حال حذف هذا الحقل، لن تكون هناك صفحات لاحقة.