- المورد: Merchant
- PaymentRestrictions
- CreditCardRestrictions
- CreditCardType
- PaymentOption
- PaymentOptionType
- ActivationType
- UserPurchaseRestriction
- PaymentProcessorConfig
- معالِج البيانات
- TokenizationConfig
- BillingInformationFormat
- البنود
- MerchantMatchingHints
- ServiceAttribute
- القيمة
- LinkoutTemplate
- تقديم الاستشارات
- EconomicOperator
- الطُرق
المورد: التاجر
معلومات عن تاجر متوفّر على منصة الجهة المجمّعة
| تمثيل JSON |
|---|
{ "name": string, "merchantName": string, "telephone": string, "url": string, "geo": { object ( |
| الحقول | |
|---|---|
name |
اسم مورد التاجر، والذي يكون بالتنسيق |
merchantName |
يتم استخدام merchantName وtelephone وعنوان URL وgeo للمساعدة في مطابقة مستودع الشريك مع التجار المتوفّرين حاليًا على "خرائط 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 للإجراء مع اللغة المرتبطة به وقائمة البلدان التي يقتصر عليها ونوعه والمنصة الاختيارية التي تشير إلى المنصة التي يجب تنفيذ هذا الإجراء عليها |
reservationLinkoutTemplate[] |
اختياريّ. نموذج الرابط الخارجي الذي يحدّد الطريقة التي يجب أن تنشئ بها Google عنوان URL الخاص بالشريك لحجز طاولة على منصته يُرجى العِلم أنّه سيتم حاليًا استخدام الأول فقط إذا تم تقديم عدة عناوين. يتضمّن نموذج معرّف الموارد المنتظم (URI) حقولاً سيتم ملؤها استنادًا إلى خيارات الحجز التي يحدّدها المستخدم، ويجب توفير جميع الحقول المطلوبة لإنشاء عنوان URL للحجز بنجاح: * (مطلوب) partySize، int: عدد الأشخاص الذين سيحجز لهم المستخدم. * (مطلوبة) selected_date_time، التاريخ والوقت بتنسيق ISO 8601 (https://en.wikipedia.org/wiki/ISO_8601): الوقت الذي يطلب فيه المستخدم إجراء حجز. * (اختياري) merchantId، سلسلة: معرّف التاجر الذي يطلب المستخدم إجراء حجز معه، ولا حاجة إليه إذا كان النموذج يتضمّن معرّف تاجر. * (اختياري) roomId، سلسلة: رقم تعريف الغرفة التي يطلب المستخدم حجزها. |
waitlistAdvisement |
اختياريّ. نصائح عامة من تاجر معيّن للمستخدم الذي ينضم إلى قائمة انتظار من خلال "الحجز عبر Google" يجب ألا يتجاوز طول حقول النص الفردية في النصيحة 100 بايت. |
economicOperator |
اختياريّ. معلومات المشغّل الاقتصادي المرتبطة بهذا التاجر المحدّد واللازمة للامتثال التنظيمي (اختياري) |
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 المتوفّر في Merchant أو Service. ستؤدي الرسالة الفارغة (أي 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 |
عادةً ما يتضمّن إعداد الترميز tokenizationParameter واحدًا يكون مفتاحه "gateway" وقيمته اسم المعالج. تعتمد بقية المَعلمات على المعالج. يمكنك الاطّلاع على مستندات Google Pay للحصول على مزيد من المعلومات. مثال على Braintree: tokenizationParameter { key: "gateway" value: "braintree" } tokenizationParameter { key: "braintree:apiVersion" value: "v1" } tokenizationParameter { key: "braintree:sdkVersion" value: "2.30.0" } tokenizationParameter { key: "braintree:merchantId" value: "abcdef" } tokenizationParameter { key: "braintree:clientKey" value: "production_xxx_yyy" } مثال على Stripe: tokenizationParameter { key: "gateway" value: "stripe" } tokenizationParameter { key: "stripe:version" value: "2018-02-28" } tokenizationParameter { key: "stripe:publishableKey" value: "pk_1234" } مثال على Adyen: tokenizationParameter { key: "gateway" value: "adyen" } tokenizationParameter { key: "gatewayMerchantId" value: "yourId" } عنصر يحتوي على قائمة بأزواج |
billingInformationFormat |
ضمِّن في رمز الدفع المميز معلومات الفوترة الخاصة بالمستخدم كما تم إدخالها في Google Pay باستخدام طريقة الدفع (انظر أعلاه). ترك الحقل فارغًا يعادل تحديد MIN. |
BillingInformationFormat
مقدار معلومات عنوان الفوترة المطلوب من المستخدم وتضمينه في الرمز المميّز تتوافق قيم التعداد مع المَعلمات في 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
سمات الخدمة هي فئات يحدّدها الشريك وتصف الخدمات التي يقدّمها التاجر. على سبيل المثال، قد يحدّد أحد المصارف سمة خدمة "نوع الحساب" بقيم محتملة هي "شخصي" و "تجاري"، بينما قد يحدّد صالون حلاقة سمة خدمة "نوع الخدمة" بقيم محتملة هي "قص الشعر" و"تلوين الشعر" و "تصفيف الشعر".
| تمثيل JSON |
|---|
{
"attributeId": string,
"attributeName": string,
"value": [
{
object ( |
| الحقول | |
|---|---|
attributeId |
معرّف يحدّد بشكل فريد سمة الخدمة هذه من بين سمات أخرى للتاجر نفسه، مثل "نوع الحساب". |
attributeName |
اسم يظهر للمستخدم لهذه السمة، مثل "نوع الحساب". |
value[] |
جميع القيم الممكنة لسمة الخدمة هذه |
القيمة
تمثّل هذه السمة قيمة محتملة لسمة خدمة معيّنة.
| تمثيل JSON |
|---|
{ "valueId": string, "valueName": string } |
| الحقول | |
|---|---|
valueId |
معرّف يحدّد هذه القيمة بشكل فريد بين القيم الأخرى لسمة الخدمة هذه، مثل "شخصي". |
valueName |
اسم مرئي للمستخدم للقيمة، مثل "شخصي". |
LinkoutTemplate
نموذج يحدّد الطريقة التي يجب أن تنشئ بها Google عناوين URL لموقع إلكتروني تابع لأحد الشركاء.
| تمثيل JSON |
|---|
{ "uriTemplate": string } |
| الحقول | |
|---|---|
uriTemplate |
يجب أن يتّبع نموذج معرّف الموارد المنتظم (URI) معيار RFC 6570، يمكنك الاطّلاع على https://datatracker.ietf.org/doc/html/rfc6570. يتوافق مع نماذج المستوى 1 وجميع النماذج المركّبة من المستوى 4، مثل http://example.com/book/{foo}?b={bar} * foo = 2 * bar = abc https://example.com/book/2?b=abc |
الإرشاد
النصائح التي تظهر للمستخدم عند الحجز من خلال ميزة "الحجز عبر Google"
| تمثيل JSON |
|---|
{
"text": {
object ( |
| الحقول | |
|---|---|
text |
رسالة مخصّصة سيتم عرضها للمستخدم عند الحجز من خلال "الحجز عبر Google" |
EconomicOperator
معلومات المشغّل الاقتصادي الخاص بالعارض
| تمثيل JSON |
|---|
{
"text": {
object ( |
| الحقول | |
|---|---|
text |
الحقل مطلوب. اسم المشغّل الاقتصادي وعنوانه ورقم هاتفه وعنوان بريده الإلكتروني، ويُعرَّف المشغّل الاقتصادي على أنّه المصنّع أو الممثّل المفوّض أو المستورد أو الموزّع أو مقدّم خدمة التنفيذ أو أي شخص طبيعي أو اعتباري آخر يخضع لالتزامات متعلقة بتصنيع المنتجات أو إتاحتها أو طرحها في السوق تمثيل السلسلة الحرة للمشغّل الاقتصادي. قد تتم تنسيق هذه المعلومات باستخدام " " و "\n". |
الطُرق |
|
|---|---|
|
تنشئ هذه الطريقة Merchant جديدًا يديره المجمّع المحدّد، وتعرضه. |
|
يحذف هذا الإجراء Merchant حاليًا يديره المجمّع المحدّد. |
|
احصل على MerchantStatus من Merchant. |
|
تعدّل هذه الطريقة Merchant حاليًا يديرها المجمّع المحدّد وتعرضها. |