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.