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 بطاقة "اقتراحات" الائتمانية
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

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 example: iconizationParameter { key: "gateway" value: "braintree" } iconizationParameter { key: "braintree:apiVersion" value: "v1" } iconizationParameter { key: "braintree:sdkVersion" value: "2.30.0" } icon: "2.30.0" } icon: "braintree:clientdefrainId" value:braintree:clientdefId" value: abcreization {مَعلمة> key: "braintree:clientdrainId" value:

مثال على Stripe: لَملَمة الرمز المميز { key: "gateway" value: "stripe" } مَعلمة الرمز المميّز { key: "stripe:version" value: "2018-02-28" } الرمز المميّز { key: "stripe:publishableKey" value: "pk_1234" }

مثال على Adyen: معلمة مميزة معلَمة { key: "gateway" value: "adyen" } currencyizationParameter { key: "gatewayMerchantId" value: "yourId" }

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

enum (BillingInformationFormat)

أدرِج معلومات الفوترة الخاصة بالمستخدم في الرمز المميّز للدفع كما أدخلها في Google Pay باستخدام طريقة الدفع (FOP) (انظر أعلاه). يعادل ترك الحقل فارغًا تحديد 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 (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

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

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

string

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

string

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

object (Value)

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

القيمة

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

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

string

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

string

اسم للقيمة مرئي للمستخدم، مثل "Personal".

تقديم النصيحة

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

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

object (Text)

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

الطُرق

create

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

delete

 لحذف Merchant حالي يديره مجمّع السلع المحدَّد.

getStatus

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

patch

 لتعديل عنصر Merchant حالي يديره مجمّع السلع المحدَّد، ثم إرجاعه