REST Resource: inventory.partners.merchants

{
  "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)
  }
}

string

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

string

تُستخدَم سمات merchantName وtelephone وurl وgeo لتسهيل مطابقة مستودع الشركاء مع التجّار المدرَجين حاليًا على "خرائط Google". لن يتم عرض هذه المعلومات.

اسم التاجر.

string

رقم الهاتف العلني للتاجر بما في ذلك رمزَي البلد والمنطقة، على سبيل المثال ‎+14567891234.

string

عنوان URL للموقع الإلكتروني العلني للتاجر

object (GeoCoordinates)

معلومات الموقع الجغرافي للتاجر، بما في ذلك خط العرض وخط الطول والعنوان

string

فئة النشاط التجاري في منصة المجمّع

string (int64 format)

تم إيقاف العمل بهذا الحقل.

integer (uint32 format)

معدّل الضريبة الذي يدفعه التاجر بالنقاط الأساسية (واحد من المائة من النسبة المئوية). على سبيل المثال، إذا كان معدّل الضريبة %7.5، يجب ضبط هذا الحقل على 750.

في حال عدم ضبط هذا الحقل أو ضبطه على 0، يكون السعر الإجمالي الذي يتم تحصيله من المستخدم مقابل أي خدمة يوفّرها هذا التاجر هو السعر الدقيق الذي يحدّده Service.price. يُفترض أن يكون سعر الخدمة معفى من الضرائب السارية أو أنّه يشملها. ولن تظهر الضرائب للمستخدم كعنصر منفصل.

في حال ضبط هذا الحقل على أي قيمة غير صفرية، سيتضمّن السعر الإجمالي الذي يتم تحصيله من المستخدم مقابل أي خدمة يوفّرها هذا التاجر سعر الخدمة بالإضافة إلى الضريبة التي تم احتسابها باستخدام معدّل الضريبة المقدَّم هنا. سيتم تقريب الكسور من أصغر وحدة عملة (مثل الكسور من سنت واحد) باستخدام التقريب إلى أقرب عدد صحيح. ستظهر الضرائب للمستخدم كعنصر منفصل.

تم إيقاف هذا الحقل نهائيًا، يُرجى استخدام taxRate بدلاً منه.

object (TaxRate)

معدّل الضريبة لدى التاجر في حال توفّر هذا الحقل، يتم تجاوز حقل taxRateBasisPoints الذي تم إيقافه نهائيًا. ستؤدي رسالة فارغة (أي taxRate { }) إلى إعادة ضبط معدّل الضريبة المطبَّق على القيمة صفر.

object (PaymentRestrictions)

القيود المفروضة على طرق الدفع التي يقبلها هذا التاجر نفترض عدم فرض أي قيود في حال عدم ضبط هذا الحقل.

object (PaymentOption)

خيارات الدفع المتاحة لهذا التاجر ستتمكّن الخدمات التابعة لهذا التاجر من الحدّ بشكل فردي من خيارات الدفع التي تسمح بها.

object (PaymentProcessorConfig)

إعدادات معالج دفعات يستخدم الرموز المميّزة، إذا كان التاجر يقدّم هذه الميزة

object (TokenizationConfig)

إعدادات معالج دفعات يستخدم الرموز المميّزة، إذا كان التاجر يقدّم هذه الميزة

object (Terms)

بنود وأحكام التاجر المحدّد التي يتم عرضها للمستخدم عند حجز خدمة من خلال ميزة "الحجز عبر Google" بالإضافة إلى ذلك، يتم دائمًا عرض أحكام وشروط شريك المحتوى المجمّع للمستخدم، ويجب عدم تقديمها هنا.

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

ملاحظة مهمة: لا يحتاج معظم الشركاء إلى ضبط هذا الحقل. إذا أراد الشريك استخدام هذا الحقل، عليه التواصل معنا أولاً لضبط علامات تجارية منفصلة، بما في ذلك العلامة التجارية التلقائية.

object (MerchantMatchingHints)

نصائح لمساعدة Google في مطابقة التاجر بمكان على "خرائط Google" ملاحظة: لا يحتاج معظم الشركاء إلى ضبط هذا الحقل، لأنّ Google ستطابق التجّار مع الأماكن على "خرائط Google" باستخدام المعلومات المقدّمة أعلاه. (اختياري)

object (ServiceAttribute)

تعريفات لأيّ سمات خدمة مستخدَمة لوصف الخدمات لهذا التاجر (اختياري)

object (ActionLink)

اختيارية: عنوان URL للإجراء مع اللغة المرتبطة به وقائمة البلدان التي يقتصر عليها الإجراء والنوع والمنصّة الاختيارية التي تشير إلى المنصّة التي يجب تنفيذ هذا الإجراء عليها

object (Advisement)

اختيارية: نصائح عامة من تاجر معيّن لمستخدم ينضم إلى قائمة انتظار من خلال ميزة "الحجز عبر Google" يجب ألا يزيد طول حقول النص الفردية في الإشعار عن 100 بايت.

object (EconomicOperator)

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

{
  "creditCardRestrictions": {
    object (CreditCardRestrictions)
  }
}

object (CreditCardRestrictions)

قيود على بطاقات الائتمان التي يقبلها هذا التاجر نفترض أنّه يتم قبول جميع بطاقات الائتمان في حال عدم ضبط هذا الحقل. يُرجى العلم أنّ قائمة البطاقات المتوافقة مع CreditCardType ستتزايد بمرور الوقت، ما يعني أنّ ترك هذا الحقل فارغًا سيؤدي إلى تغيير الإعدادات في المستقبل.

{
  "creditCardType": [
    enum (CreditCardType)
  ]
}

enum (CreditCardType)

قائمة ببطاقات الائتمان المتوافقة لا يمكن استخدام بطاقات الائتمان إذا كانت فارغة.

{
  "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)
  }
}

string

يُستخدَم هذا المعرّف لتحديد خيار الدفع هذا.

يكون رقم التعريف هذا موحّدًا على مستوى المجمّع بأكمله، وسيسمح إعادة استخدام قيمة معيّنة لدى تجّار متعدّدين للمستخدم بالدفع باستخدام خيار الدفع المقابل لدى هؤلاء التجّار.

عند إعادة استخدام معرّف لدى تجار متعدّدين، سيؤدي تعديل أي قيمة لخيار دفع تابع لتاجر واحد إلى تعديل أي خيار دفع آخر يحمل المعرّف نفسه تابعًا لتاجر مختلف. ولهذا السبب، من أفضل الممارسات أن تتشارك جميع خيارات الدفع المعرّف نفسه، وأن يتم تعديلها دائمًا إلى قيم متطابقة، لتجنّب أي احتمال لسلوك غير مرغوب فيه.

string

اسم خيار الدفع ويمكن أن يكون هذا المحتوى مرئيًا للمستخدم.

string

وصف لخيار الدفع ويمكن أن يكون هذا المحتوى مرئيًا للمستخدم.

object (Price)

سعر خيار الدفع

object (TaxRate)

معدّل الضريبة لخيار الدفع هذا في حال توفّر هذا الحقل، يتمّ تجاوز حقل taxRate المتوفّر في Merchant أو Service. ستؤدي رسالة فارغة (أي taxRate { }) إلى إعادة ضبط معدّل الضريبة المطبَّق على القيمة صفر.

enum (PaymentOptionType)

نوع خيار الدفع هذا يمكن استخدامها لمرة واحدة في البث المباشر بدون اشتراك، وعدة مرات في الحِزم، وبشكل غير محدود في الاشتراكات.

string (int64 format)

عدد الجلسات التي يمكن استخدام خيار الدفع هذا فيها لا يُسمَح باستخدامها إلا مع الحِزم أو الجلسات المتعددة، حيث يجب أن تكون القيمة أكبر من 1.

object (TimeRange)

يمكن شراء خيار الدفع خلال هذه الفترة.

object (TimeRange)

يمكن استخدام خيار الدفع خلال هذا الفاصل الزمني (مثل سعر خاص لشهر كانون الثاني (يناير) 2017). في حال توفّر هذه القيمة، يتمّ تجاوز validDuration وactivationType.

string (Duration format)

مدة صلاحية خيار الدفع (مثلاً، اشتراك لمدة 30 يومًا)

المدة بالثواني مع ما يصل إلى تسعة أرقام كسور، وتنتهي بـ "s". مثال: "3.5s".

enum (ActivationType)

تحدِّد هذه السمة كيفية تحديد تاريخ بدء صلاحية خيار الدفع هذا.

object (UserPurchaseRestriction)

تقييد المستخدمين المؤهَّلين لشراء خيار الدفع هذا يمكن استخدامها لتقييد خيار دفع ترويجي بمجموعة فرعية من المستخدمين. وفي حال عدم ضبطها، يكون جميع المستخدمين مؤهّلين.

{
  "newToMerchant": boolean,
  "newToPaymentOption": boolean
}

boolean

خيار دفع لا يمكن شراؤه إلا من قِبل المستخدمين الذين لم يسبق لهم الشراء من التاجر نفسه.

boolean

خيار دفع لا يمكن شراؤه إلا من قِبل المستخدمين الذين لم يسبق لهم شراء خيار الدفع نفسه.

{
  "processor": enum (Processor),
  "publicKey": string,
  "version": string
}

enum (Processor)

يحدِّد شريك جهة معالجة المعاملات الذي تنطبق عليه هذه الإعدادات.

string

المفتاح المستخدَم لتحديد هذا التاجر لدى جهة معالجة المعاملات.

بالنسبة إلى Stripe، يُرجى الرجوع إلى: https://stripe.com/docs/dashboard#api-keys. بالنسبة إلى Braintree، يُرجى الرجوع إلى: https://articles.braintreepayments.com/control-panel/important-gateway-credentials.

string

رقم إصدار واجهة برمجة التطبيقات الذي تم إرساله إلى جهة معالجة المعاملات مع طلبات الدفع

{
  "tokenizationParameter": {
    string: string,
    ...
  },
  "billingInformationFormat": enum (BillingInformationFormat)
}

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" }

enum (BillingInformationFormat)

يجب تضمين معلومات فوترة المستخدم في رمز الدفع كما تم إدخالها في Google Pay باستخدام طريقة الدفع المفضّلة (راجع أعلاه). ويؤدي ترك الحقل فارغًا إلى تحديد MIN.

{
  "url": string,
  "text": string,
  "localizedText": {
    object (Text)
  }
}

string

عنوان URL للأحكام والشروط، اختياريًا

string

النص الذي سيتم عرضه للمستخدم. استخدِم localizedText أدناه لعمليات الدمج الجديدة.

object (Text)

النص المترجَم الذي سيتم عرضه للمستخدم.

{
  "placeId": string
}

string

رقم تعريف المكان في قاعدة بيانات "أماكن Google" وعلى "خرائط Google" اطّلِع على https://developers.google.com/places/web-service/place-id للحصول على مزيد من المعلومات عن أرقام تعريف الأماكن.

{
  "attributeId": string,
  "attributeName": string,
  "value": [
    {
      object (Value)
    }
  ]
}

string

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

string

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

object (Value)

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

{
  "valueId": string,
  "valueName": string
}

string

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

string

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

{
  "text": {
    object (Text)
  }
}

object (Text)

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

{
  "text": {
    object (Text)
  }
}

object (Text)

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