Ustawianie kolejności usług

Specyfikacja

Aby wpłynąć na kolejność wyświetlania usług danego sprzedawcy, ustaw ranking_hint.score dla każdego elementu Service w pliku danych usługi.
// 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];
}

W przypadku wyświetlania kilku usług (na przykład bezpośrednio za przyciskiem „Zarezerwuj” wyświetlającym wszystkie usługi, z których użytkownik może wybrać) skorzystamy z Service.ranking_hint.score jako jednego z sygnałów do zamawiania Usług. Im wyższy wynik, tym wyżej strona zostanie wyświetlona na stronie.

Przykład

Sprzedawca oferuje 3 usługi „Strzyżenie”, „Koloryzacja”, „Masaż skóry głowy i strzyżenie”, a preferowane przez niego zamówienie jest następujące:
  1. Strzyżenie
  2. Masaż głowy i strzyżenie
  3. Kolorowanki
Plik danych usługi można określić w ten sposób:

Usługi

{
  "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
      }
    }
  ]
}
Kolejność określona powyżej (bez innych sygnałów) da wynik:

Kolejność usług: strzyżenie, masaż skóry głowy, koloryzacja.