פיד שירות

יצירה והעלאה של פידים של שירותים

כשיוצרים ומעלים פידים של שירותים, חשוב לפעול לפי ההוראות הבאות:

  • צריך לפעול לפי המפרט שמתואר פיד שירות לקובצי נתוני שירות. צריך להשתמש בשמות ייחודיים של קובצי נתוני שירות בין העלאות. מומלץ לכלול חותמת זמן בשם הקובץ, לדוגמה, service1_1633621547.json.
  • במתאר של קבוצת הקבצים, מגדירים את השדה name לערך google.food_service. דוגמה של קובץ תיאור מופיעה בדוגמת JSON של קובץ תיאור. צריך להשתמש בשמות של קובצי מתאר ייחודיים בין העלאות. מומלץ לכלול חותמת זמן בשם הקובץ, לדוגמה, service1_1633621547.filesetdesc.json. צריך להעלות את קובץ התיאור לחשבון SFTP הגנרי.
  • צריך להעלות פידים לחשבון ה-SFTP הגנרי מדי יום כשהם מלאים מתבצע רענון.
  • אפשר למצוא מידע כללי על חשבון SFTP של פידים הגדרה > הקטע 'פידים' בפורטל השותפים.

    • בחירת תיבות בענן של פיד

  • אפשר למצוא את הסטטוס הכללי של הטמעת הפיד בקטע פידים > ההיסטוריה בפורטל השותפים.

הגדרות

הגדרת FeedServiceFeed

// Food Ordering Team's EPA Service Feeds Spec.
message FoodServiceFeed {
  // Service feed entity data.
  repeated ServiceData data = 1;
}

הגדרת ServiceData

// Service feed entity data.
message ServiceData {
  oneof type {
    FoodOrderingService service = 1;
    ServiceHours service_hours = 2;
    ServiceArea service_area = 3;
    Fee fee = 4;
  }
}

הגדרה של שירות הפניה אוטומטית להזמנה

message FoodOrderingService {
  // Unique identifier of the provided service.
  // Required.;

  enum ServiceType {
    SERVICE_TYPE_UNKNOWN = 0;
    DELIVERY = 1;
    TAKEOUT = 2;
  }

  // The type of the service.
  // Required and cannot be SERVICE_TYPE_UNKNOWN.;

  // The parent entity’s ID.
  // Required.;

  // Indicates if the entity is disabled.
  // Optional.
  bool disabled = 4 [features.field_presence = EXPLICIT];

  // The lead time given in the service entity will apply to all
  // the service hours unless an overridden property is set in the
  // service hours entity.
  // Required.;

  // Parent action detail's link ID.
  // Required.;
}

הגדרת זמן הגעה משוער

// Lead time range [min, max). At least one of min or max needs to be provided.
// A fixed value can be provided by setting both min and max to the same value.
message ETA {
  // Indicates a range of ETA duration.
  google.protobuf.Duration min_lead_time_duration = 1;
  google.protobuf.Duration max_lead_time_duration = 2;
}

הגדרת העמלות

message Fee {
  // Unique identifier to the Fee entity.
  // Required.;

  enum FeeType {
    FEE_TYPE_UNKNOWN = 0;
    DELIVERY = 1;
    SERVICE = 2;
  }

  // Indicates the nature of the service, e.g. delivery fee/service fee.
  // Required.;

  oneof amount {
    option (validator.one_of) = {

    // A fixed amount of fees to be collected.;

    // A range of fees that could be collected. Will mirror
    // madden.ingestion.MoneyRange for the starting point.
    MoneyRange range_amount = 4;

    // Fees in terms of amount percentage. Will mirror
    // madden.ingestion.QuantitativeValue for the starter.
    PercentageBasedFee cart_percentage = 5;
  }

  // Service association needs to be provided.
  // Required.;

  // Service area can be provided to further restrict eligibility of the
  // fee.
  // Optional.;
}

הגדרת MoneyRange

// Wrapper for a range of monetary amount that could be bounded or unbounded.
// At least one of min_amount or max_amount is required.
message MoneyRange {
  // Minimum amount.;

  // Maximum amount.;
}

ההגדרה של עמלה מבוססת-אחוזים

// Variable fee which changes based on the price of the order.
message PercentageBasedFee {
  // Optional, base fee not including the variable percentage based fee.;

  // Optional, overall range of possible values of the PercentageBasedFee.
  MoneyRange range = 2;

  // Optional, percentage representing an additional variable fee based on
  // the cart subtotal. E.g. 15.0 represents a fee of 15% of the cart.
  double percentage_of_cart_value =;
}

הגדרת אזור השירות

message ServiceArea {
  // Unique identifier.
  // Required.
  string area_id = 1;
  // Identifier to the parent service entity.
  // Required.
  repeated string service_ids = 2;
  // One of the following needs to be provided to define the service area.
  // Required.
  oneof region {

    GeoCircle circle = 3;
    Locality locality = 4;
    Polygon polygon = 5;
  }

  // Sets to true if the assigned area is excluded from serving.
  // Optional.
  optional bool excluded_area = 6;
}

הגדרת מעגל גיאוגרפי

// Geographical circular area described by a point and radius.
message GeoCircle {
  // Geographical center of the area.
  // Required.
  google.type.LatLng center =
      1;

  // Radius for the circular area, in meters. Must be greater than 0.
  // Required.
  double radius = 2;
}

הגדרת הרשות המוניציפאלית

// Geolocation of interests.
message Locality {
  string country_code = 1;

  // Postal code in the country's local format in string.
  string postal_code =
      2;
}

הגדרת הפוליגון

// Represents a polygon shaped region.
message Polygon {
  reserved 1;

  // List of S2Loops which defines a polygon. A point is considered in the
  // polygon if it is contained in odd number of loops.
  repeated Loop loops = 2;
}

הגדרת הלולאה

// Represents a loop of geo coordinates. This should be a valid S2Loop.
message Loop {
  // Points making the boundary of loop.
  repeated google.type.LatLng point =
      1;
}

ההגדרה של ServiceHours

// Service hours entity for ASAP/Advance orders.
message ServiceHours {
  // Unique identifier of the provided advance service hours.
  // Required.
  string hours_id =
      1;

  // The unique identifier of the Service entity correlated to this ServiceHours
  // entity.
  // Required.
  repeated string service_ids = 2;
  // The hours the orders can be fulfilled. For ASAP services, this is also
  // orderable time.
  // One of the fields (asap_hours/advance_hours) is required to be set.
  repeated AsapTimeWindow asap_hours = 3;
  repeated AdvanceTimeWindow advance_hours = 4;

  // When advance ordering services, this is the time windows the orders can be
  // placed.
  // Required when advance_hour is given. Invalid when asap_hour is given.
  repeated TimeOfDayWindow orderable_time = 5;

  // Indicates if the service hours are for special occasions
  // (e.g. Thanksgiving/...)
  // Optional
  bool special_hour = 6;
  // A timestamp window indicating the validity of the special hours.
  // Optional. Required if it's special hours.
  ValidityRange validity_range = 7;
}

ההגדרה של AsapTimeWindow

message AsapTimeWindow {
  // A time window the ASAP order can be placed and fulfilled.
  // Required.
  TimeOfDayWindow time_windows = 1;

  // Indicates the lead time, specific to service_time, the service can
  // be fulfilled.
  // Optional.
  ETA lead_time = 2;
}

ההגדרה של AdvanceTimeWindow

// The fulfillment time window for advance orders.
message AdvanceTimeWindow {
  // A time window the advance order can be fulfilled.
  // Required.
  TimeOfDayWindow time_windows = 1;
  // a window that an advance order can be placed.  For example, an advance
  // order must be placed at least 60 minutes ahead and not exceeding 2
  // days, the interval would be [PT60M, P2D).
  // Optional.
  DurationInterval advance_booking_interval = 2;
}

ההגדרה של TimeOfDayWindow

// The TimeWindow object is a composite entity that describes a list
// of windows the user's order can be either placed or fulfilled.
message TimeOfDayWindow {
  // The time window the order can be placed/fulfilled.
  // Required.
  TimeOfDayRange time_windows = 1;
  // The list of days in a week the windows are applied.
  // Required. If not given, we assume 7 days a week.
  repeated google.type.DayOfWeek day_of_week = 2;
}

הגדרת ValidityRange

// A closed-open timestamp range.
message ValidityRange {
  // The beginning time of the range (inclusive).
  // Optional.
  google.protobuf.Timestamp valid_from_time = 1;
  // The ending time of the range (exclusive).
  // Optional.
  google.protobuf.Timestamp valid_through_time = 2;
}

הגדרת DurationInterval

// A closed-open duration range.
message DurationInterval {
  // The minimum duration (inclusive).
  // Required.
  google.protobuf.Duration min_offset = 1;
  // The maximum duration (exclusive).
  // Required.
  google.protobuf.Duration max_offset = 2;
}

ההגדרה של TimeOfDayRange

// A closed-open time range.
message TimeOfDayRange {
  // A Time indicating the beginning time of the day of the range (inclusive).
  // Required. If not given, we assume 00:00:00.
  google.type.TimeOfDay open_time = 1;
  // A Time indicating the ending time of the day of the range (exclusive).
  // Required. If not given, we assume 23:59:59.
  google.type.TimeOfDay close_time = 2;
}

הפניות Proto חיצוניות:

דוגמאות של פיד שירות

פיד שירותים

שם הקובץ : services1_1697754089.json

{
  "data": [
    {
      "service": {
        "service_id": "service/entity002",
        "service_type": "DELIVERY",
        "parent_entity_id": "entity002",
        "lead_time": {
          "min_lead_time_duration": "600s",
          "max_lead_time_duration": "1800s"
        },
        "action_link_id": "delivery_link/entity002"
      }
    },
    {
      "fee": {
        "fee_id": "fee/entity002",
        "fee_type": "DELIVERY",
        "fixed_amount": {
          "currency_code": "USD",
          "units": 2,
          "nanos": 400000000
        },
        "service_ids": ["service/entity002"]
      }
    }
  ]
}

קובץ תיאור

שם הקובץ : services1_1697754089.filesetdesc.json

{
  "generation_timestamp": 1697754089,
  "name": "google.food_service",
  "data_file": ["services1_1697754089.json"]
}
הקודם
פיד פעולות
הבא
זמן אספקה ועמלות