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)
  },
  "economicOperator": {
    object (EconomicOperator)
  }
}
الحقول
name

string

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

string

تُستخدَم سمات merchantName وtelephone وurl وgeo لتسهيل مطابقة مستودع الشركاء مع التجّار المدرَجين حاليًا على "خرائط 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 بايت.
economicOperator

object (EconomicOperator)

اختيارية: يجب توفير معلومات المشغّل الاقتصادي المرتبطة بهذا التاجر المحدّد للامتثال للوائح التنظيمية. (اختياري)

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 المتوفّر في Merchant أو Service. ستؤدي رسالة فارغة (أي 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)

سيتضمّن إعداد ترميز المعاملات عادةً مَعلمة ترميز معاملات واحدة يكون مفتاحها هو "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: مَعلمة إنشاء الرموز المميّزة { key: "gateway" value: "adyen" } مَعلمة إنشاء الرموز المميّزة { key: "gatewayMerchantId" value: "yourId" }

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

enum (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 (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

اسم ظاهر للمستخدم للقيمة، مثل "شخصي".

الإرشاد

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

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

object (Text)

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

EconomicOperator

معلومات عن مشغّل المحتوى الاقتصادي للعرض.

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

object (Text)

مطلوب. الاسم والعنوان ورقم الهاتف وعنوان البريد الإلكتروني للمشغّل الاقتصادي، والذي يُعرَّف على أنّه المصنّع أو الممثّل المعتمَد أو المستورِد أو الموزّع أو مقدّم خدمة التوصيل أو أي شخص طبيعي أو اعتباري آخر يخضع لالتزامات متعلّقة بتصنيع المنتجات أو توفيرها أو طرحها في الخدمة تمثيل سلسلة بتنسيق حر للمشغّل الاقتصادي يمكن تنسيق هذه المعلومات باستخدام " " و "\n".

الطُرق

create

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

delete

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

getStatus

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

patch

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