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)

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

وتعتمد بقية المعاملات على المعالج. اطّلِع على مستندات 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" القيمة: "adyen" } tokenizationParameter { 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".

EconomicOperator

معلومات عن المشغّل الاقتصادي الخاص بجهة التجميع

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

object (Text)

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

الطُرق

create

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

delete

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

getStatus

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

patch

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