REST Resource: accounts.lfpStores

المرجع: LfpStore

متجر للتاجر سيتم استخدام هذه السمة لمطابقة البيانات مع متجر ضمن "الملف التجاري على Google" الخاص بالتاجر المستهدَف. إذا تعذّر العثور على متجر مطابق، لن يتم استخدام المستودعات أو المبيعات التي تم إرسالها مع رمز المتجر.

تمثيل JSON 
{
  "name": string,
  "targetAccount": string,
  "storeCode": string,
  "storeAddress": string,
  "gcidCategory": [
    string
  ],
  "matchingState": enum (StoreMatchingState),
  "storeName": string,
  "phoneNumber": string,
  "websiteUri": string,
  "placeId": string,
  "matchingStateHint": string
}
الحقول
name

string

النتائج فقط. المُعرّف. اسم مورد LfpStore. تنسيق الملف: accounts/{account}/lfpStores/{target_merchant}~{storeCode}
targetAccount

string (int64 format)

مطلوبة. معرّف Merchant Center للتاجر المطلوب إرسال المتجر إليه.
storeCode

string

مطلوبة. غير قابل للتغيير. معرّف متجر فريد للتاجر المستهدَف
storeAddress

string

مطلوبة. تمثّل هذه السمة عنوان الشارع الخاص بالمتجر. مثال: 1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA.
gcidCategory[]

string

اختياريّ. رقم تعريف فئة نشاطي التجاري على Google.
matchingState

enum (StoreMatchingState)

اختياريّ. النتائج فقط. حالة المطابقة مع "الملف التجاري على Google" يمكنك الانتقال إلى matchingStateHint للحصول على مزيد من التفاصيل في حال عدم العثور على نتيجة مطابقة.
storeName

string

اختياريّ. اسم التاجر أو المتجر
phoneNumber

string

اختياريّ. تمثّل هذه السمة رقم هاتف المتجر بالتنسيق E.164. مثلاً: +15556767888
websiteUri

string

اختياريّ. عنوان URL للموقع الإلكتروني الخاص بالمتجر أو التاجر
placeId

string

اختياريّ. رقم تعريف المكان على Google الخاص بالموقع الجغرافي للمتجر
matchingStateHint

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".

الطُرق

delete

 يؤدي هذا الإجراء إلى حذف متجر خاص بالتاجر المستهدَف.

get

 يسترد معلومات حول متجر.

insert

 إدراج متجر للتاجر المستهدَف

list

 يسرد المتاجر الخاصة بالتاجر المستهدَف الذي يحدّده الفلتر في ListLfpStoresRequest.