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

مطلوبة. معرّف 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

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