สร้างและอัปโหลดฟีดบริการ
เมื่อสร้างและอัปโหลดฟีดบริการ โปรดทําตามวิธีการต่อไปนี้
- ปฏิบัติตามข้อกำหนดที่อธิบายไว้ใน
ฟีดบริการ
สำหรับไฟล์ข้อมูลบริการ คุณต้องใช้ชื่อไฟล์ข้อมูลบริการที่ไม่ซ้ำกันระหว่างการอัปโหลด
ขอแนะนำให้ใส่การประทับเวลาในชื่อไฟล์ เช่น
service1_1633621547.json
- ในข้อบ่งชี้ชุดไฟล์ ให้ตั้งค่าช่อง
name
เป็นgoogle.food_service
หากต้องการดูตัวอย่างไฟล์ข้อบ่งชี้ ให้อ้างอิงจากตัวอย่าง JSON ของไฟล์คำอธิบาย คุณต้องใช้ชื่อไฟล์ตัวบ่งชี้ที่ไม่ซ้ำกันระหว่างการอัปโหลด ขอแนะนำให้ใส่การประทับเวลาในชื่อไฟล์ เช่นservice1_1633621547.filesetdesc.json
ไฟล์ข้อบ่งชี้จะต้องอัปโหลดไปยังดรอปบ็อกซ์ SFTP ทั่วไป - ฟีดต้องอัปโหลดไปที่ดรอปบ็อกซ์ SFTP ทั่วไปทุกวันโดย รีเฟรช
- คุณสามารถดูข้อมูลดรอปบ็อกซ์ SFTP สำหรับฟีดทั่วไปได้ใน การกำหนดค่า > ฟีดของพอร์ทัลพาร์ทเนอร์
- คุณดูสถานะการนำเข้าฟีดทั่วไปได้ใน ฟีด > ส่วนประวัติของพอร์ทัลพาร์ทเนอร์
คำจำกัดความ
คำจำกัดความของ FoodServiceFeed
// 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.; }
คำจำกัดความของ PercentageBasedFee
// 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; }
คำจำกัดความของ GeoCircle
// 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; }
คำจำกัดความของเวลาบริการ
// 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 ภายนอก
- google.type.Money.proto
- google.type.latlng.proto
- google.type.dayofweek.proto
- google.type.timeofday.proto
- google.protobuf.duration.proto
- google.protobuf.timestamp.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"] }