ضبط ترتيب الخدمات

المواصفات

للتأثير في ترتيب عرض الخدمات لتاجر معيّن، اضبط ranking_hint.score على كل Service في خلاصة الخدمات.
// Ranking hints for a service.
message ServiceRankingHint {
  // Arbitrary partner or merchant assigned rank for this service.
  //
  // Services with a higher score will be shown more prominently (e.g. shown
  // higher in lists). Note that other factors may also influence ranking, such
  // as price, availability, user history, etc.
  //
  // Optional. Must be non-negative if set.
  float score = 1 [features.field_presence = EXPLICIT];
}

عند عرض خدمات متعدّدة (مثال: الصفحة التي تظهر مباشرةً بعد الزر "حجز" والتي تعرض جميع الخدمات للمستخدم للاختيار من بينها)، سيتم استخدام Service.ranking_hint.score كإحدى الإشارات لطلب الخدمات. وكلما ارتفعت النتيجة، سيتم عرض الخدمة في الصفحة.

مثال

يقدّم التاجر 3 خدمات مثل "قص الشعر" و"الصبغة" و"تدليك فروة الرأس وقص الشعر"، ويفضّل أن يكون الطلب على النحو التالي:
  1. قص الشعر
  2. تدليك فروة الرأس وقص الشعر
  3. ألعاب التلوين
يمكن تحديد خلاصة الخدمة على النحو التالي:

الخدمات

{
  "service": [
    {
      "price": {
        "currency_code": "USD",
        "price_micros": 20000000
      },
      "service_id": "haircut",
      "prepayment_type": "NOT_SUPPORTED",
      "merchant_id": "beauty-1",
      "localized_service_name": {
        "value": "Haircut",
        "localized_value": [
          {
            "locale": "en",
            "value": "Haircut"
          }
        ]
      },
      "localized_description": {
        "value": "Get a haircut.",
        "localized_value": [
          {
            "locale": "en",
            "value": "Get a haircut."
          }
        ]
      },
      "ranking_hint": {
        "score": 30.0
      }
    },
    {
      "localized_service_name": {
        "value": "Coloring",
        "localized_value": [
          {
            "locale": "en",
            "value": "Coloring"
          }
        ]
      },
      "price": {
        "currency_code": "USD",
        "price_micros": 40000000
      },
      "service_id": "haircoloring",
      "prepayment_type": "NOT_SUPPORTED",
      "merchant_id": "beauty-1",
      "localized_description": {
        "value": "Get your hair dyed.",
        "localized_value": [
          {
            "locale": "en",
            "value": "Get your hair dyed."
          }
        ]
      },
      "ranking_hint": {
        "score": 10.0
      }
    },
    {
      "localized_service_name": {
        "value": "Scalp massage and Haircut",
        "localized_value": [
          {
            "locale": "en",
            "value": "Scalp massage and Haircut"
          }
        ]
      },
      "price": {
        "currency_code": "USD",
        "price_micros": 30000000
      },
      "service_id": "scalpmassage",
      "prepayment_type": "NOT_SUPPORTED",
      "merchant_id": "beauty-1",
      "localized_description": {
        "value": "Get a shampoo and scalp massage followed by a haircut.",
        "localized_value": [
          {
            "locale": "en",
            "value": "Get a shampoo and scalp massage followed by a haircut."
          }
        ]
      },
      "ranking_hint": {
        "score": 20.0
      }
    }
  ]
}
سيؤدي الترتيب المحدد أعلاه (بدون إشارات أخرى) إلى:

طلب الخدمات: قص الشعر، وتدليك فروة الرأس، وقص الشعر، والتلوين.