服务 Feed

message ServiceFeed {
  option features.(pb.java).nest_in_file_class = YES;

  repeated Service data = 1;
}

// The definition of a service provided by a merchant.
message Service {
  option features.(pb.java).nest_in_file_class = YES;

  // An opaque string from an aggregator partner which uniquely identifies a
  // merchant.
  // (required)
  string merchant_id = 1 [
    features.field_presence = IMPLICIT,
    features.(pb.cpp).string_type = STRING
  ];

  // An opaque string of ASCII characters from an aggregator partner which
  // uniquely identifies the service.
  // Must be equal to or shorter than 100 characters.
  // (required)
  string service_id = 2 [
    features.field_presence = IMPLICIT,
    features.(pb.cpp).string_type = STRING
  ];

  // The name of the service, e.g. "Men's haircut". Possibly in several locales.
  // (required)
  Text localized_service_name = 3;

  // The name of the service category, e.g. "Haircut", "Shave", "Color".
  // Possibly in several locales. The category will be used to group services
  // when presented to the consumer.
  // Note: For merchants without categories on your website, you can group all
  // services into one category and use a generic name such as "All Services"
  // or "General." Merchants who have categories you should try to replicate
  // those categories.
  // (required)
  Text localized_service_category = 4;

  // The user-visible description of the service, possibly in several locales.
  // This field is not required for every services, but is strongly
  // recommended to be filled when available.
  // Important notes:
  //   * The recommended maximum size is 2,000 characters.
  // (optional)
  Text localized_service_description = 5;

  // The price of the service.
  // Note, if a service (or merchant) doesn't provide price up front, use
  // RangeInterpretation.INTERPRETATION_NOT_DISPLAYED as PriceInterpretation.
  // (required)
  ServicePrice service_price = 6;

  // An action link related to this service. Action link should deep link to the
  // 3P page with the preselected service.
  // Note: Only the first entry will be used. Other provided action links will
  // be ignored.
  // Optional, but highly recommended if service-level deep links are supported.
  // This enables service-level entrypoints on Google if provided.
  // Note: For merchants participating in Healthcare vertical should not provide
  // service-level deep link.
  // (optional)
  repeated ActionLink action_link = 8;

  // Duration of the service.
  // Note, if a service (or merchant) doesn't provide service duration, use
  // RangeInterpretation.INTERPRETATION_NOT_DISPLAYED as DurationInterpretation.
  // (required)
  ServiceDuration service_duration = 9;

  // Ranking hint for this service.
  // (optional)
  ServiceRankingHint ranking_hint = 10;

  // Bookability info for the service, required for agentic bookings on Google.
  // (optional)
  ServiceBookabilityInfo bookability_info = 11;

  // Policies for this service, required for agentic bookings on Google.
  // (optional)
  ServicePolicyInfo policy_info = 12;
}

// A possibly-localized text payload. Some Text fields may contain marked-up
// content.
message Text {
  option features.(pb.java).nest_in_file_class = YES;

  // Text value in an unknown locale, which will be displayed if
  // `localized_value` for the user locale is empty or missing. The locale for
  // this value may depend on the partner or service provider, and it should not
  // be assumed to be any specific language.
  // (required)
  string value = 1;

  // Per-locale text values.
  // (optional)
  repeated LocalizedString localized_value = 2;
}

// Describes how a range of values should be interpreted and displayed to the
// user.
enum RangeInterpretation {
  option features.(pb.cpp).enum_name_uses_string_view = false;
  option features.(pb.java).nest_in_file_class = YES;


  // When range represents an exact value (such that min value equals to max)
  // Will be interpreted as a specific value.
  //
  // Examples:
  //   $20 for a yoga class; 50 min haircut duration
  INTERPRETATION_EXACT = 1;

  // When only minimum of the range is known and displayed to consumers.
  // The maximum value will be decided based on other configurations
  // (e.g., price may go up if consumer selecting add-ons)
  //
  // Examples:
  //   $30 for dog grooming, but additional consumer choices may increase the
  //   price
  //   40 min massage, but there are also options for extending the time.
  INTERPRETATION_STARTS_AT = 2;

  // When the range is variable and both minimum and maximum values are known
  // and displayed to consumers.
  //
  // Examples:
  //   $30 - $60 for dog grooming, the exact price will depend on additional
  //   consumer choices.
  //   1 - 3 hour hair color service.
  INTERPRETATION_RANGE = 3;

  // When the range is variable and no min value is known. No information is
  // displayed to consumers ahead of time.
  //
  // Examples:
  //   A consultation for a home service
  INTERPRETATION_NOT_DISPLAYED = 4;
}

// The price of a service.
message ServicePrice {
  option features.(pb.java).nest_in_file_class = YES;

  // Describes how a Price should be interpreted and displayed to the user.
  // (required)
  RangeInterpretation price_interpretation = 1;

  // The minimum price of the service. Must be set if price_interpretation is
  // set to EXACT, STARTS_AT, or RANGE.
  // price is known.
  // (optional)
  Price min_price = 2;

  // The maximum price of the service. Must be set if price_interpretation is
  // set to RANGE.
  // (optional)
  Price max_price = 3;
}

// The price of a service or a fee.
message Price {
  option features.(pb.java).nest_in_file_class = YES;

  // The price in micro-units of the currency.
  // For example: 1.95 USD is 1950000 in micro-units.
  // If your price contains fractions of the smallest currency unit, then it
  // will be rounded using nearest even rounding (e.g. 2.5 cents rounded
  // to 2 cents, 3.5 cents rounded to 4 cents, 0.5 cents rounded to 0 cents,
  // 2.51 cents rounded to 3 cents).
  // (required)
  int64 price_micros = 1;

  // The currency of the price that is defined in ISO 4217.
  // (required)
  string currency_code = 2;

  // An optional and opaque string that identifies the pricing option that is
  // associated with the extended price.
  // (optional)
  string pricing_option_tag = 3;
}

// An action URL for a service.
message ActionLink {
  option features.(pb.java).nest_in_file_class = YES;


  // The entry point URL for this action link.
  // (required)
  string url = 1;
}

message ServiceDuration {
  option features.(pb.java).nest_in_file_class = YES;

  // Describes how a service duration should be interpreted and displayed to
  // the user.
  // Note, if a service (or merchant) doesn't provide service duration, use
  // 'INTERPRETATION_NOT_DISPLAYED' as DurationInterpretation.
  // (required)
  RangeInterpretation duration_interpretation = 1;

  // The minimum duration (in seconds) that the service may take. Must be set
  // if duration_interpretation is set to EXACT, STARTS_AT, or RANGE.
  // (required)
  int64 min_duration_sec = 2;

  // The maximum duration (in seconds) that the service may take. Must be set
  // if duration_interpretation is set to RANGE.
  // (optional)
  int64 max_duration_sec = 3;
}

// Ranking hints for a service.
message ServiceRankingHint {
  option features.(pb.java).nest_in_file_class = YES;

  // Arbitrary partner or merchant assigned rank for this service.
  //
  // Services with a lower score will be displayed more prominently (e.g.
  // displayed higher in lists).
  //
  // Ranking hints affect both the ordering of services within a service
  // category, and the ordering of the categories themselves. The ranking hint
  // for a category is assumed to be the minimum ranking hint of any item in the
  // category. Note that other factors may also influence the final ranking,
  // such as price, user history, etc.
  //
  // The recommended approach is to define a total ordering on all the services,
  // by assigning each one a unique integer ranking hint and ensuring that
  // ranking hint values don’t overlap between categories. For example, if we
  // want the preferred ordering of categories and services to be:
  // Category 1: A, B, C
  // Category 2: D, E, F
  // Then the simplest ranking hint scheme to indicate this would be:
  // A=1, B=2, C=3, D=4, E=5, F=6.
  //
  // Must be non-negative if set.
  // (optional)
  float score = 1;
}

// Bookability info for the service.
message ServiceBookabilityInfo {
  option features.(pb.java).nest_in_file_class = YES;

  // Indicates whether the service can be booked online.
  // (optional)
  bool is_online_bookable = 1;

  // Indicates whether payment is required when booking online.
  // (optional)
  bool payment_required = 2;

  // Indicates whether a credit card must be on file.
  // (optional)
  bool card_on_file_required = 3;

  // Indicates whether a One-Time Password (OTP), such as an email or SMS code,
  // is required when booking an appointment online.
  // (optional)
  bool otp_required = 4;

  // Indicates whether a user must sign in to book an appointment online.
  // (optional)
  bool sign_in_required = 5;
}

// Policy info for the service.
message ServicePolicyInfo {
  option features.(pb.java).nest_in_file_class = YES;

  // Policies for this service, required for agentic bookings on Google.
  // (optional)
  repeated ServicePolicy policies = 1;
}

// A named policy for the service.
// Displayed to the user when performing agentic bookings on Google.
message ServicePolicy {
  option features.(pb.java).nest_in_file_class = YES;

  // A partner-defined policy identifier, not user-facing and possibly not
  // unique. The partner can use this to identify a specific policy content
  // or version. Treated as an opaque identifier by Google.
  // (optional)
  string id = 1;

  // A user-facing localized name for this policy.
  //
  // Standard, Title Case naming is strongly recommended to ensure a clean,
  // consistent, and recognizable user experience. Avoid informal abbreviations
  // or shorthand (e.g., do NOT use "T&C", "T&Cs", "ToS", or "Cancel").
  //
  // Recommended standard names for common policy types:
  //   - "Terms & Conditions" (or "Terms and Conditions" / "Terms of Service")
  //   - "Privacy Policy" (or "Privacy")
  //   - "Cancellation Policy" (or "Refund Policy")
  //   - "Health & Safety Policy"
  //
  // (required)
  Text name = 2;

  // The content of the policy to be displayed or linked to the user.
  // (required)
  oneof content {
    // The textual content of the policy to be displayed to the user.
    Text text_content = 3;

    // The URL where the policy can be viewed.
    Text url_content = 4;
  }
}

// Instance of a string in one locale.
message LocalizedString {
  option features.(pb.java).nest_in_file_class = YES;

  // IETF BCP 47 language code, such as "en", "mas", "zh-Hant", "de-CH-1901".
  // See http://www.w3.org/International/articles/language-tags/.
  // (required)
  string locale = 1;

  // Message in the locale above (UTF-8).
  // (required)
  string value = 2;
}