- المصدر: التاجر
- PaymentRestrictions
- CreditCardRestrictions
- CreditCardType
- PaymentOption
- PaymentOptionType
- ActivationType
- UserPurchaseRestriction
- PaymentProcessorConfig
- المعالِج
- TokenizationConfig
- BillingInformationFormat
- بنود الخدمة
- MerchantMatchingHints
- ServiceAttribute
- القيمة
- نصائح
- الطُرق
المرجع: التاجر
معلومات عن التاجر المعروضة على منصة مجمّع السلع
تمثيل JSON |
---|
{ "name": string, "merchantName": string, "telephone": string, "url": string, "geo": { object ( |
الحقول | |
---|---|
name |
تمثّل هذه السمة اسم مورد التاجر، ويكون بالتنسيق |
merchantName |
يتم استخدام اسم MerchantName ورقم الهاتف وعنوان URL والموقع الجغرافي لإتاحة مطابقة مستودع الشركاء مع التجّار الحاليين على "خرائط Google". ولن يتم عرض هذه المعلومات. اسم التاجر |
telephone |
رقم الهاتف العام للتاجر، بما في ذلك رمز البلد والمنطقة، مثل +14567891234. |
url |
عنوان URL للموقع الإلكتروني العلني للتاجر. |
geo |
المعلومات الجغرافية للتاجر، بما في ذلك خط العرض وخط الطول والعنوان |
category |
تمثّل هذه السمة فئة النشاط التجاري على المنصّة التي يستخدمها العارض. |
numBookings30d |
تم إيقاف العمل بهذا الحقل. |
taxRateBasisPoints |
معدّل الضريبة للتاجر حسب نقاط الأساس (مئة من واحد في المئة). على سبيل المثال، إذا كان معدّل الضريبة هو 7.5%، يجب ضبط هذا الحقل على 750. في حال ترك هذا الحقل بدون ضبط أو ضبطه على 0، يكون السعر الإجمالي الذي يتم تحصيله من المستخدم مقابل أي خدمة يقدّمها هذا التاجر هو السعر المحدّد الذي تحدّده Service.price. يُفترض أن يكون سعر الخدمة معفى من الضرائب السارية أو شاملًا لها. لن تظهر الضرائب للمستخدم كعنصر منفصل. في حال ضبط هذا الحقل على أي قيمة غير صفرية، سيشمل السعر الإجمالي الذي يتم تحصيله من المستخدم مقابل أي خدمة يقدّمها هذا التاجر سعر الخدمة بالإضافة إلى الضريبة المفروضة باستخدام معدّل الضريبة المتوفّر هنا. سيتم تقريب الكسور في أصغر وحدة عملة (على سبيل المثال، كسور سنت واحد) باستخدام أقرب تقريب زوجي. وستظهر الضرائب للمستخدم كعنصر منفصل. تم إيقاف هذا الحقل نهائيًا. يُرجى استخدام taxRate بدلاً من ذلك. |
taxRate |
معدّل الضريبة للتاجر. يُلغي هذا الحقل، في حال توفّره، حقل taxRateBasisPoints المتوقّف. ستؤدي الرسالة الفارغة (على سبيل المثال: taxRate { }) إلى إعادة ضبط معدل الضريبة المُطبَّق على صفر. |
paymentRestrictions |
القيود المفروضة على طرق الدفع التي يقبلها هذا التاجر. نفترض أنّه لا تتوفّر أي قيود إذا لم يتم ضبط هذا الحقل. |
paymentOption[] |
خيارات الدفع المتاحة لهذا التاجر ستتمكّن الخدمات التابعة لهذا التاجر من وضع قيود فردية على خيارات الدفع التي تسمح بها. |
paymentProcessorConfig |
إعدادات لمعالجة عمليات الدفع المحوَّلة إلى رموز مميّزة، إذا كان التاجر يتيح استخدامها |
tokenizationConfig |
إعدادات لمعالجة عمليات الدفع المحوَّلة إلى رموز مميّزة، إذا كان التاجر يتيح استخدامها |
terms |
الأحكام والشروط الخاصة بالتاجر المحدّد والتي تظهر للمستخدم عندما يتم حجز خدمة من خلال ميزة "الحجز عبر Google". وبالإضافة إلى هذه الأحكام والشروط الخاصة بشريك العارض، يتم عرضها دائمًا للمستخدم ويجب عدم تقديمها هنا. |
brandId |
سلسلة مبهمة تحدّد العلامة التجارية الموجّهة للمستهلِكين والتي يجب استخدامها عند عرض إحالة الشريك يتيح هذا الحقل للشركاء الذين لديهم علامات تجارية متعدّدة موجّهة للمستهلكين تقديم تجّار لجميع العلامات التجارية ضمن الخلاصة نفسها. تتألف العلامة التجارية من سمات موجّهة للمستخدمين، مثل الاسم والشعار وبنود الخدمة وسياسة الخصوصية. في حال توفُّر علامة تجارية واحدة فقط شريكة موجّهة للمستهلكين، لا حاجة إلى ضبط هذا الحقل ويمكن تجاهله. في حال كان الشريك... ألا تمتلك علامات تجارية متعددة تستهدف المستهلكين؟ --> تجاهل هذا الحقل هل هناك علامات تجارية متعددة تم إعدادها؟
ملاحظة يجب توخّي الحذر: لا يحتاج معظم الشركاء إلى ضبط هذا الحقل. إذا أراد الشريك استخدام هذا الحقل، عليه التواصل معنا أولاً لإعداد علامات تجارية منفصلة، بما في ذلك العلامة التجارية التلقائية. |
matchingHints |
تلميحات لمساعدة Google في مطابقة تاجر مع مكان على "خرائط Google" ملاحظة: لا يحتاج معظم الشركاء إلى ضبط هذا الحقل، لأنّ Google ستطابق التجّار مع الأماكن على "خرائط Google" باستخدام المعلومات المقدَّمة أعلاه. (اختياري) |
serviceAttribute[] |
تعريفات أي سمات خدمة مستخدمة لوصف الخدمات الخاصة بهذا التاجر. (اختياري) |
actionLink[] |
اختياريّ. عنوان URL للإجراء مع اللغة المرتبطة وقائمة البلدان المحظورة والنوع والمنصة الاختيارية التي تشير إلى المنصة التي يجب تنفيذ هذا الإجراء عليها |
waitlistAdvisement |
اختياريّ. نصائح عامة من تاجر محدَّد بشأن مستخدم ينضم إلى قائمة انتظار من خلال ميزة "الحجز عبر Google" يجب أن يقتصر طول الحقول النصية الفردية في النصيحة على 100 بايت. |
PaymentRestrictions
القيود المفروضة على طرق الدفع التي يقبلها هذا التاجر.
تمثيل JSON |
---|
{
"creditCardRestrictions": {
object ( |
الحقول | |
---|---|
creditCardRestrictions |
القيود المفروضة على بطاقات الائتمان التي يقبلها هذا التاجر. نفترض أنّه يتم قبول جميع بطاقات الائتمان إذا لم يتم ضبط هذا الحقل. تجدر الإشارة إلى أنّ قائمة البطاقات المتوافقة مع CreditCardType سيزداد بمرور الوقت، مما يعني أن ترك هذه المواضيع الفارغة يؤدي إلى تهيئة للتغييرات المستقبلية. |
CreditCardRestrictions
القيود المفروضة على أنواع بطاقات الائتمان التي يقبلها هذا التاجر.
تمثيل JSON |
---|
{
"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 ( |
الحقول | |
---|---|
paymentOptionId |
ويُستخدم هذا المعرّف لتحديد خيار الدفع هذا. ينطبق هذا المعرّف على كل مجمّع السلع، وبالتالي فإنّ إعادة استخدام قيمة لدى عدة تجّار ستسمح للمستخدم بالدفع باستخدام خيار الدفع المناسب على كل منهما. عند إعادة استخدام معرّف لعدة تجار، سيؤدي تعديل أي قيمة لخيار دفع ضمن تاجر واحد إلى تعديل أي خيار دفع آخر يحمل المعرّف نفسه لدى تاجر مختلف. وبناءً على ذلك، من أفضل الممارسات أن تشترك جميع خيارات الدفع في المعرّف نفسه، وأن يتم تعديلها دائمًا إلى قيم متطابقة، وذلك لتجنب أي احتمال لسلوك غير مهم. |
name |
اسم خيار الدفع. يمكن أن يكون هذا مرئيًا للمستخدم. |
description |
وصف خيار الدفع. يمكن أن يكون هذا مرئيًا للمستخدم. |
price |
سعر خيار الدفع. |
taxRate |
معدّل الضريبة لخيار الدفع هذا. يُلغي هذا الحقل، في حال توفّره، حقل taxRate (معدّل الضريبة) الوارد في "التاجر" أو "الخدمة". ستؤدي الرسالة الفارغة (على سبيل المثال: taxRate { }) إلى إعادة ضبط معدل الضريبة المُطبَّق على صفر. |
paymentOptionType |
نوع خيار الدفع هذا. يمكن استخدام الحزمة مرة واحدة عند زيارة التطبيق، ويمكن استخدامها أكثر من مرة للحصول على حِزم، وإتاحة الاشتراكات بلا حدود. |
sessionCount |
عدد الجلسات التي يمكن استخدام خيار الدفع هذا لها. صالحة فقط للجلسات المتعددة / الحزم، حيث يجب أن تكون القيمة > 1- |
purchaseInterval |
يمكن شراء خيار الدفع خلال هذه الفترة. |
validInterval |
ويمكن استخدام خيار الدفع خلال هذه الفترة (على سبيل المثال، السعر الخاص لشهر كانون الثاني (يناير) 2017). وفي حال توفّره، يؤدي هذا الإجراء إلى إلغاء السمة validDuration وActivationType. |
validDuration |
مدة صلاحية خيار الدفع (مثل اشتراك لمدة 30 يومًا). مدة بالثواني مكونة من تسعة أرقام كسور كحد أقصى وتنتهي بالأرقام " |
activationType |
يحدد كيفية تحديد تاريخ بدء الصلاحية لخيار الدفع هذا. |
userRestriction |
يحظر المستخدمين المؤهَّلين لشراء خيار الدفع هذا. ويمكن استخدامها لحصر خيار الدفع الترويجي على مجموعة فرعية من المستخدمين. وإذا لم يتم ضبط السياسة، سيكون جميع المستخدمين مؤهَّلين. |
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 |
خيار دفع لا يمكن شراؤه إلا من قِبل المستخدمين الذين لم يشتروا أبدًا من التاجر نفسه من قبل. |
newToPaymentOption |
خيار دفع لا يمكن شراؤه إلا من قبل المستخدمين الذين لم يشتروا خيار الدفع نفسه من قبل. |
PaymentProcessorConfig
إعدادات للجهة المسؤولة عن معالجة المعاملات، يتم إعدادها لكل تاجر على حدة
تمثيل JSON |
---|
{
"processor": enum ( |
الحقول | |
---|---|
processor |
تحدّد هذه السمة الشريك المسؤول عن معالجة المعاملات التي تنطبق عليه هذه الإعدادات. |
publicKey |
هو المفتاح المستخدَم للتعريف عن هذا التاجر من خلال الجهة المسؤولة عن معالجة المعاملات. بالنسبة إلى Stripe، يُرجى الرجوع إلى: https://stripe.com/docs/dashboard#api-keys بالنسبة إلى Braintree، يُرجى الرجوع إلى: https://articles.braintreepayments.com/control-panel/important-gateway-credentials |
version |
رقم إصدار واجهة برمجة التطبيقات الذي يتم إرساله إلى الجهة المسؤولة عن معالجة المعاملات مع طلبات الدفع |
معالِج البيانات
تحدّد شريكًا محددًا لمعالجة عمليات الدفع.
عمليات التعداد | |
---|---|
PROCESSOR_UNSPECIFIED |
غير مستخدم |
PROCESSOR_STRIPE |
إعدادات للدفع باستخدام Stripe |
PROCESSOR_BRAINTREE |
إعدادات للدفع باستخدام Braintree |
TokenizationConfig
عملية ضبط للرموز المميّزة لمعالجة عمليات الدفع، يتم إعدادها لكل تاجر على حدة.
تمثيل JSON |
---|
{
"tokenizationParameter": {
string: string,
...
},
"billingInformationFormat": enum ( |
الحقول | |
---|---|
tokenizationParameter |
عادةً ما تشتمل تهيئة إنشاء الرموز المميزة على معلمة رمز مميّز واحدة يكون مفتاحها هو "المدخل". وقيمته هي اسم المعالج. وتعتمد بقية المعاملات على المعالج. يمكنك الاطّلاع على مستندات 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" } عنصر يحتوي على قائمة بأزواج |
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 ( |
الحقول | |
---|---|
url |
عنوان URL الخاص بالبنود والشروط اختياريًا. |
text |
النص الذي سيتم عرضه للمستخدم. استخدِم localizedText أدناه لعمليات الدمج الجديدة. |
localizedText |
النص المترجَم الذي سيتم عرضه للمستخدم |
MerchantMatchingHints
تلميحات تُستخدَم لمساعدة Google في مطابقة تاجر مع مكان على "خرائط Google"
تمثيل JSON |
---|
{ "placeId": string } |
الحقول | |
---|---|
placeId |
رقم تعريف المكان لأحد الأماكن في قاعدة بيانات "أماكن Google" وعلى "خرائط Google". اطّلع على https://developers.google.com/places/web-service/place-id للحصول على مزيد من المعلومات عن أرقام تعريف الأماكن. |
ServiceAttribute
سمات الخدمة هي فئات يحدِّدها الشركاء وتصف الخدمات المتوفّرة للتاجر. على سبيل المثال، قد يحدّد المصرف "نوع الحساب" سمة الخدمة مع القيم المحتملة "شخصي" و"نشاط تجاري"، بينما يمكن لصالون حلاقة تحديد "نوع الخدمة" service مع القيم المحتملة "قص الشعر" و"اللون" و"النمط".
تمثيل JSON |
---|
{
"attributeId": string,
"attributeName": string,
"value": [
{
object ( |
الحقول | |
---|---|
attributeId |
معرّف يعرّف بشكل فريد سمة الخدمة هذه من بين سمات أخرى للتاجر نفسه، مثل: "نوع الحساب". |
attributeName |
اسم مرئي للمستخدم لهذه السمة، مثال: "نوع الحساب". |
value[] |
جميع القيم الممكنة لسمة الخدمة هذه. |
القيمة
تمثّل هذه السمة قيمة محتملة لسمة خدمة معيّنة.
تمثيل JSON |
---|
{ "valueId": string, "valueName": string } |
الحقول | |
---|---|
valueId |
معرّف يعرّف هذه القيمة بشكل فريد من بين قيم أخرى لسمة الخدمة هذه، مثل: "شخصي". |
valueName |
اسم مرئي للمستخدم للقيمة، على سبيل المثال: "شخصية". |
نصيحة
النصائح التي تظهر للمستخدم عند الحجز من خلال ميزة "الحجز عبر Google"
تمثيل JSON |
---|
{
"text": {
object ( |
الحقول | |
---|---|
text |
رسالة مخصّصة يتم عرضها للمستخدم عند الحجز من خلال ميزة "الحجز عبر Google". |
الطُرق |
|
---|---|
|
تنشئ Merchant جديدة يديرها العارض المحدّد وتعيدها. |
|
يؤدي هذا الإجراء إلى حذف Merchant حالية يديرها العارض المحدّد. |
|
الحصول على MerchantStatus من Merchant . |
|
تعديل Merchant حالي يديره العارض المحدّد وإرجاعه |