REST Resource: inventory.partners.merchants

المرجع: التاجر

معلومات عن التاجر المعروضة على منصة مجمّع السلع

تمثيل JSON 
{
  "name": string,
  "merchantName": string,
  "telephone": string,
  "url": string,
  "geo": {
    object (GeoCoordinates)
  },
  "category": string,
  "numBookings30d": string,
  "taxRateBasisPoints": integer,
  "taxRate": {
    object (TaxRate)
  },
  "paymentRestrictions": {
    object (PaymentRestrictions)
  },
  "paymentOption": [
    {
      object (PaymentOption)
    }
  ],
  "paymentProcessorConfig": {
    object (PaymentProcessorConfig)
  },
  "tokenizationConfig": {
    object (TokenizationConfig)
  },
  "terms": {
    object (Terms)
  },
  "brandId": string,
  "matchingHints": {
    object (MerchantMatchingHints)
  },
  "serviceAttribute": [
    {
      object (ServiceAttribute)
    }
  ],
  "actionLink": [
    {
      object (ActionLink)
    }
  ],
  "waitlistAdvisement": {
    object (Advisement)
  }
}
الحقول
name

string

تمثّل هذه السمة اسم مورد التاجر، ويكون بالتنسيق partners/{partner_id}/merchants/{merchantId}.
merchantName

string

يتم استخدام اسم MerchantName ورقم الهاتف وعنوان URL والموقع الجغرافي لإتاحة مطابقة مستودع الشركاء مع التجّار الحاليين على "خرائط Google". ولن يتم عرض هذه المعلومات.

اسم التاجر
telephone

string

رقم الهاتف العام للتاجر، بما في ذلك رمز البلد والمنطقة، مثل +14567891234.
url

string

عنوان URL للموقع الإلكتروني العلني للتاجر.
geo

object (GeoCoordinates)

المعلومات الجغرافية للتاجر، بما في ذلك خط العرض وخط الطول والعنوان
category

string

تمثّل هذه السمة فئة النشاط التجاري على المنصّة التي يستخدمها العارض.
numBookings30d
(deprecated)

string (int64 format)

تم إيقاف العمل بهذا الحقل.
taxRateBasisPoints
(deprecated)

integer (uint32 format)

معدّل الضريبة للتاجر حسب نقاط الأساس (مئة من واحد في المئة). على سبيل المثال، إذا كان معدّل الضريبة هو 7.5%، يجب ضبط هذا الحقل على 750.

في حال ترك هذا الحقل بدون ضبط أو ضبطه على 0، يكون السعر الإجمالي الذي يتم تحصيله من المستخدم مقابل أي خدمة يقدّمها هذا التاجر هو السعر المحدّد الذي تحدّده Service.price. يُفترض أن يكون سعر الخدمة معفى من الضرائب السارية أو شاملًا لها. لن تظهر الضرائب للمستخدم كعنصر منفصل.

في حال ضبط هذا الحقل على أي قيمة غير صفرية، سيشمل السعر الإجمالي الذي يتم تحصيله من المستخدم مقابل أي خدمة يقدّمها هذا التاجر سعر الخدمة بالإضافة إلى الضريبة المفروضة باستخدام معدّل الضريبة المتوفّر هنا. سيتم تقريب الكسور في أصغر وحدة عملة (على سبيل المثال، كسور سنت واحد) باستخدام أقرب تقريب زوجي. وستظهر الضرائب للمستخدم كعنصر منفصل.

تم إيقاف هذا الحقل نهائيًا. يُرجى استخدام taxRate بدلاً من ذلك.
taxRate

object (TaxRate)

معدّل الضريبة للتاجر. يُلغي هذا الحقل، في حال توفّره، حقل taxRateBasisPoints المتوقّف. ستؤدي الرسالة الفارغة (على سبيل المثال: taxRate { }) إلى إعادة ضبط معدل الضريبة المُطبَّق على صفر.
paymentRestrictions

object (PaymentRestrictions)

القيود المفروضة على طرق الدفع التي يقبلها هذا التاجر. نفترض أنّه لا تتوفّر أي قيود إذا لم يتم ضبط هذا الحقل.
paymentOption[]

object (PaymentOption)

خيارات الدفع المتاحة لهذا التاجر ستتمكّن الخدمات التابعة لهذا التاجر من وضع قيود فردية على خيارات الدفع التي تسمح بها.
paymentProcessorConfig
(deprecated)

object (PaymentProcessorConfig)

إعدادات لمعالجة عمليات الدفع المحوَّلة إلى رموز مميّزة، إذا كان التاجر يتيح استخدامها
tokenizationConfig

object (TokenizationConfig)

إعدادات لمعالجة عمليات الدفع المحوَّلة إلى رموز مميّزة، إذا كان التاجر يتيح استخدامها
terms

object (Terms)

الأحكام والشروط الخاصة بالتاجر المحدّد والتي تظهر للمستخدم عندما يتم حجز خدمة من خلال ميزة "الحجز عبر Google". وبالإضافة إلى هذه الأحكام والشروط الخاصة بشريك العارض، يتم عرضها دائمًا للمستخدم ويجب عدم تقديمها هنا.
brandId

string

سلسلة مبهمة تحدّد العلامة التجارية الموجّهة للمستهلِكين والتي يجب استخدامها عند عرض إحالة الشريك يتيح هذا الحقل للشركاء الذين لديهم علامات تجارية متعدّدة موجّهة للمستهلكين تقديم تجّار لجميع العلامات التجارية ضمن الخلاصة نفسها.

تتألف العلامة التجارية من سمات موجّهة للمستخدمين، مثل الاسم والشعار وبنود الخدمة وسياسة الخصوصية.

في حال توفُّر علامة تجارية واحدة فقط شريكة موجّهة للمستهلكين، لا حاجة إلى ضبط هذا الحقل ويمكن تجاهله.

في حال كان الشريك...

ألا تمتلك علامات تجارية متعددة تستهدف المستهلكين؟ --> تجاهل هذا الحقل

هل هناك علامات تجارية متعددة تم إعدادها؟

  If this field is set
    --> Associated consumer-facing brand attribution is used

  If this field is unset or the empty string
    --> Default consumer-facing brand attribution is used

ملاحظة يجب توخّي الحذر: لا يحتاج معظم الشركاء إلى ضبط هذا الحقل. إذا أراد الشريك استخدام هذا الحقل، عليه التواصل معنا أولاً لإعداد علامات تجارية منفصلة، بما في ذلك العلامة التجارية التلقائية.
matchingHints

object (MerchantMatchingHints)

تلميحات لمساعدة Google في مطابقة تاجر مع مكان على "خرائط Google" ملاحظة: لا يحتاج معظم الشركاء إلى ضبط هذا الحقل، لأنّ Google ستطابق التجّار مع الأماكن على "خرائط Google" باستخدام المعلومات المقدَّمة أعلاه. (اختياري)
serviceAttribute[]

object (ServiceAttribute)

تعريفات أي سمات خدمة مستخدمة لوصف الخدمات الخاصة بهذا التاجر. (اختياري)
waitlistAdvisement

object (Advisement)

اختياريّ. نصائح عامة من تاجر محدَّد بشأن مستخدم ينضم إلى قائمة انتظار من خلال ميزة "الحجز عبر Google" يجب أن يقتصر طول الحقول النصية الفردية في النصيحة على 100 بايت.

PaymentRestrictions

القيود المفروضة على طرق الدفع التي يقبلها هذا التاجر.

تمثيل JSON 
{
  "creditCardRestrictions": {
    object (CreditCardRestrictions)
  }
}
الحقول
creditCardRestrictions

object (CreditCardRestrictions)

القيود المفروضة على بطاقات الائتمان التي يقبلها هذا التاجر. نفترض أنّه يتم قبول جميع بطاقات الائتمان إذا لم يتم ضبط هذا الحقل. تجدر الإشارة إلى أنّ قائمة البطاقات المتوافقة مع CreditCardType سيزداد بمرور الوقت، مما يعني أن ترك هذه المواضيع الفارغة يؤدي إلى تهيئة للتغييرات المستقبلية.

CreditCardRestrictions

القيود المفروضة على أنواع بطاقات الائتمان التي يقبلها هذا التاجر.

تمثيل JSON 
{
  "creditCardType": [
    enum (CreditCardType)
  ]
}
الحقول
creditCardType[]

enum (CreditCardType)

قائمة ببطاقات الائتمان المتوافقة ولا يُسمَح باستخدام بطاقات ائتمان إذا كانت فارغة.

CreditCardType

نوع بطاقة الائتمان

عمليات التعداد
CREDIT_CARD_TYPE_UNSPECIFIED غير مُستخدَم.
VISA بطاقة ائتمان Visa
MASTERCARD بطاقة ائتمان Mastercard
AMERICAN_EXPRESS بطاقة ائتمان American Express
DISCOVER بطاقة ائتمان Discover
JCB بطاقة ائتمان JCB.

PaymentOption

خيار دفع يمكن استخدامه للدفع مقابل الخدمات التي يقدّمها التاجر. يمكن مشاركة خيارات الدفع بين عدة تجار (على سبيل المثال، تجار ينتمون إلى السلسلة نفسها).

تمثيل JSON 
{
  "paymentOptionId": string,
  "name": string,
  "description": string,
  "price": {
    object (Price)
  },
  "taxRate": {
    object (TaxRate)
  },
  "paymentOptionType": enum (PaymentOptionType),
  "sessionCount": string,
  "purchaseInterval": {
    object (TimeRange)
  },
  "validInterval": {
    object (TimeRange)
  },
  "validDuration": string,
  "activationType": enum (ActivationType),
  "userRestriction": {
    object (UserPurchaseRestriction)
  }
}
الحقول
paymentOptionId

string

ويُستخدم هذا المعرّف لتحديد خيار الدفع هذا.

ينطبق هذا المعرّف على كل مجمّع السلع، وبالتالي فإنّ إعادة استخدام قيمة لدى عدة تجّار ستسمح للمستخدم بالدفع باستخدام خيار الدفع المناسب على كل منهما.

عند إعادة استخدام معرّف لعدة تجار، سيؤدي تعديل أي قيمة لخيار دفع ضمن تاجر واحد إلى تعديل أي خيار دفع آخر يحمل المعرّف نفسه لدى تاجر مختلف. وبناءً على ذلك، من أفضل الممارسات أن تشترك جميع خيارات الدفع في المعرّف نفسه، وأن يتم تعديلها دائمًا إلى قيم متطابقة، وذلك لتجنب أي احتمال لسلوك غير مهم.
name

string

اسم خيار الدفع. يمكن أن يكون هذا مرئيًا للمستخدم.
description

string

وصف خيار الدفع. يمكن أن يكون هذا مرئيًا للمستخدم.
price

object (Price)

سعر خيار الدفع.
taxRate

object (TaxRate)

معدّل الضريبة لخيار الدفع هذا. يُلغي هذا الحقل، في حال توفّره، حقل taxRate (معدّل الضريبة) الوارد في "التاجر" أو "الخدمة". ستؤدي رسالة فارغة (على سبيل المثال: taxRate { }) إلى إعادة ضبط معدل الضريبة المطبَّق على صفر.
paymentOptionType

enum (PaymentOptionType)

نوع خيار الدفع هذا. يمكن استخدام الحزمة مرة واحدة عند زيارة التطبيق، ويمكن استخدامها أكثر من مرة للحصول على حِزم، وإتاحة الاشتراكات بلا حدود.
sessionCount

string (int64 format)

عدد الجلسات التي يمكن استخدام خيار الدفع هذا لها. صالحة فقط للجلسات المتعددة / الحزم، حيث يجب أن تكون القيمة > 1-
purchaseInterval

object (TimeRange)

يمكن شراء خيار الدفع خلال هذه الفترة.
validInterval

object (TimeRange)

ويمكن استخدام خيار الدفع خلال هذه الفترة (على سبيل المثال، السعر الخاص لشهر كانون الثاني (يناير) 2017). وفي حال توفّره، يؤدي هذا الإجراء إلى إلغاء السمة validDuration وActivationType.
validDuration

string (Duration format)

مدة صلاحية خيار الدفع (مثل اشتراك لمدة 30 يومًا).

مدة بالثواني مكونة من تسعة أرقام كسور كحد أقصى وتنتهي بالأرقام "s" مثال: "3.5s"
activationType

enum (ActivationType)

يحدد كيفية تحديد تاريخ بدء الصلاحية لخيار الدفع هذا.
userRestriction

object (UserPurchaseRestriction)

يحظر المستخدمين المؤهَّلين لشراء خيار الدفع هذا. ويمكن استخدامها لحصر خيار الدفع الترويجي على مجموعة فرعية من المستخدمين. وإذا لم يتم ضبط السياسة، سيكون جميع المستخدمين مؤهَّلين.

PaymentOptionType

نوع خيار الدفع

عمليات التعداد
PAYMENT_OPTION_TYPE_UNSPECIFIED غير مُستخدَم.
PAYMENT_OPTION_SINGLE_USE لا يمكن استخدام خيار الدفع سوى مرة واحدة.
PAYMENT_OPTION_MULTI_USE يمكن استخدام خيار الدفع إذا كان عدد الجلسات أكبر من 0.
PAYMENT_OPTION_UNLIMITED يمكن استخدام خيار الدفع ضمن نطاقه الزمني الصالح - عدد الجلسات غير سارٍ.

ActivationType

يحدد كيفية تحديد تاريخ بدء الصلاحية.

عمليات التعداد
ACTIVATION_TYPE_UNSPECIFIED غير مُستخدَم.
ACTIVATION_ON_PURCHASE تبدأ الصلاحية من وقت الشراء.
ACTIVATION_ON_FIRST_USE تبدأ الصلاحية عند استخدام خيار الدفع للمرة الأولى.

UserPurchaseRestriction

تقييد المستخدمين المؤهلين لشراء خيار دفع.

تمثيل JSON 
{
  "newToMerchant": boolean,
  "newToPaymentOption": boolean
}
الحقول
newToMerchant

boolean

خيار دفع لا يمكن شراؤه إلا من قِبل المستخدمين الذين لم يشتروا أبدًا من التاجر نفسه من قبل.
newToPaymentOption

boolean

خيار دفع لا يمكن شراؤه إلا من قبل المستخدمين الذين لم يشتروا خيار الدفع نفسه من قبل.

PaymentProcessorConfig

إعدادات للجهة المسؤولة عن معالجة المعاملات، يتم إعدادها لكل تاجر على حدة

تمثيل JSON 
{
  "processor": enum (Processor),
  "publicKey": string,
  "version": string
}
الحقول
processor

enum (Processor)

تحدّد هذه السمة الشريك المسؤول عن معالجة المعاملات التي تنطبق عليه هذه الإعدادات.
publicKey

string

هو المفتاح المستخدَم للتعريف عن هذا التاجر من خلال الجهة المسؤولة عن معالجة المعاملات.

بالنسبة إلى Stripe، يُرجى الرجوع إلى: https://stripe.com/docs/dashboard#api-keys بالنسبة إلى Braintree، يُرجى الرجوع إلى: https://articles.braintreepayments.com/control-panel/important-gateway-credentials
version

string

رقم إصدار واجهة برمجة التطبيقات الذي يتم إرساله إلى الجهة المسؤولة عن معالجة المعاملات مع طلبات الدفع

معالِج البيانات

تحدّد شريكًا محددًا لمعالجة عمليات الدفع.

عمليات التعداد
PROCESSOR_UNSPECIFIED غير مستخدم
PROCESSOR_STRIPE إعدادات للدفع باستخدام Stripe
PROCESSOR_BRAINTREE إعدادات للدفع باستخدام Braintree

TokenizationConfig

عملية ضبط للرموز المميّزة لمعالجة عمليات الدفع، يتم إعدادها لكل تاجر على حدة.

تمثيل JSON 
{
  "tokenizationParameter": {
    string: string,
    ...
  },
  "billingInformationFormat": enum (BillingInformationFormat)
}
الحقول
tokenizationParameter

map (key: string, value: string)

عادةً ما تشتمل تهيئة إنشاء الرموز المميزة على معلمة رمز مميّز واحدة يكون مفتاحها هو "المدخل". وقيمته هي اسم المعالج.

وتعتمد بقية المعاملات على المعالج. يمكنك الاطّلاع على مستندات Google Pay للحصول على المزيد من المعلومات.

مثال على Braintree: Tokenization تعليق { key: "gateway" القيمة: "braintree" }Tokenizationparam { key: "braintree:apiVersion" القيمة: "v1" }Tokenizationparam { key: "braintree:sdkVersion" القيمة: "2.30.0" } Tokenizationparam { key: "braintree:merchantId" القيمة: "abcdef" } مَعلمة ترميز مميَّزة { key: "braintree:clientKey" القيمة: "production_xxx_yyy" }

مثال على Stripe: Tokenization أموال { key: "gateway" القيمة: "stripe" } }معلمة { key: "stripe:version" القيمة: "2018-02-28" } }معلمة ترميز { key: "stripe:publishableKey" القيمة: "pk_1234" }

مثال على Adyen: الرمز المميّز للمَعلمة { key: "gateway" القيمة: "adyen" }Tokenizationparam { key: "gatewayMerchantId" القيمة: "yourId" }

عنصر يحتوي على قائمة بأزواج "key": value مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" }
billingInformationFormat

enum (BillingInformationFormat)

يجب تضمين معلومات الفوترة الخاصة بالمستخدم في الرمز المميّز للدفع كما هو موضّح في Google Pay باستخدام طريقة الدفع الأساسية (انظر أعلاه). يتساوى ترك الحقل فارغًا مع تحديد MIN.

BillingInformationFormat

مقدار عنوان الفوترة المطلوب من المستخدم وتضمينه في الرمز المميّز. تتوافق قيم enum مع المَعلَمات في Google Pay API (يمكنك الاطّلاع على https://developers.google.com/pay/api/web/reference/object#BillingAddressParameters)).

عمليات التعداد
BILLING_INFORMATION_FORMAT_UNSPECIFIED لم يتم تحديده. القيم الافتراضية على MIN.
MIN الاسم ورمز البلد والرمز البريدي (إعدادات Google Pay التلقائية)
FULL الاسم وعنوان الشارع والمنطقة المحلية والمنطقة ورمز البلد والرمز البريدي.

البنود

هي مجموعة من القواعد والإرشادات التي يتم عرضها للمستخدم لإجراء حجز من خلال ميزة "الحجز عبر Google".

تمثيل JSON 
{
  "url": string,
  "text": string,
  "localizedText": {
    object (Text)
  }
}
الحقول
url

string

عنوان URL الخاص بالبنود والشروط اختياريًا.
text

string

النص الذي سيتم عرضه للمستخدم. استخدِم localizedText أدناه لعمليات الدمج الجديدة.
localizedText

object (Text)

النص المترجَم الذي سيتم عرضه للمستخدم

MerchantMatchingHints

تلميحات تُستخدَم لمساعدة Google في مطابقة تاجر مع مكان على "خرائط Google"

تمثيل JSON 
{
  "placeId": string
}
الحقول
placeId

string

رقم تعريف المكان لأحد الأماكن في قاعدة بيانات "أماكن Google" وعلى "خرائط Google". اطّلع على https://developers.google.com/places/web-service/place-id للحصول على مزيد من المعلومات عن أرقام تعريف الأماكن.

ServiceAttribute

سمات الخدمة هي فئات يحدِّدها الشركاء وتصف الخدمات المتوفّرة للتاجر. على سبيل المثال، قد يحدّد المصرف "نوع الحساب" سمة الخدمة مع القيم المحتملة "شخصي" و"نشاط تجاري"، بينما يمكن لصالون حلاقة تحديد "نوع الخدمة" service مع القيم المحتملة "قص الشعر" و"اللون" و"النمط".

تمثيل JSON 
{
  "attributeId": string,
  "attributeName": string,
  "value": [
    {
      object (Value)
    }
  ]
}
الحقول
attributeId

string

معرّف يعرّف بشكل فريد سمة الخدمة هذه من بين سمات أخرى للتاجر نفسه، مثل: "نوع الحساب".
attributeName

string

اسم مرئي للمستخدم لهذه السمة، مثال: "نوع الحساب".
value[]

object (Value)

جميع القيم الممكنة لسمة الخدمة هذه.

القيمة

تمثّل هذه السمة قيمة محتملة لسمة خدمة معيّنة.

تمثيل JSON 
{
  "valueId": string,
  "valueName": string
}
الحقول
valueId

string

معرّف يعرّف هذه القيمة بشكل فريد من بين قيم أخرى لسمة الخدمة هذه، مثل: "شخصي".
valueName

string

اسم مرئي للمستخدم للقيمة، على سبيل المثال: "شخصية".

نصيحة

النصائح التي تظهر للمستخدم عند الحجز من خلال ميزة "الحجز عبر Google"

تمثيل JSON 
{
  "text": {
    object (Text)
  }
}
الحقول
text

object (Text)

رسالة مخصّصة يتم عرضها للمستخدم عند الحجز من خلال ميزة "الحجز عبر Google".

الطُرق

create

 تنشئ Merchant جديدة يديرها العارض المحدّد وتعيدها.

delete

 يؤدي هذا الإجراء إلى حذف Merchant حالية يديرها العارض المحدّد.

getStatus

 الحصول على MerchantStatus من Merchant.

patch

 تعديل Merchant حالي يديره العارض المحدّد وإرجاعه