ข้อกำหนด TripOptionsError

ประเภทที่ใช้เมื่อรายงานข้อผิดพลาดในการเดินทาง ข้อผิดพลาดประเภทนี้พบได้ทั่วไปใน GetTripOptions และ GetBulkTripOptions

เมื่อมีการรายงานข้อผิดพลาด Google จะรอเป็นระยะเวลาหนึ่ง ก่อนที่จะส่งคำขออีกครั้ง ซึ่งจะมีผลกับทั้งการตอบกลับที่สำเร็จและการตอบกลับที่รายงานข้อผิดพลาด อย่างไรก็ตาม หากมีการทำเครื่องหมายข้อผิดพลาดเป็น "ลองอีกครั้งได้" Google จะลดเวลารอก่อนที่จะออกคำขอถัดไป อย่างมาก ซึ่งจะช่วยให้กู้คืนได้เร็วขึ้นในกรณีที่คาดว่าข้อผิดพลาดจะเกิดขึ้นชั่วคราว

ส่วนต่อไปนี้จะอธิบายประเภทข้อผิดพลาดที่อาจแสดงในฟิลด์ trip_options_error

คำจำกัดความของ Proto

message TripOptionsError {
  // Defines the type of error that occurred.
  // A "retryable" error indicates a transient issue, and Google may re-query
  // for the trip again shortly. A "not retryable" error indicates a
  // more permanent state, and Google will not query for this trip again in the
  // near future.
  enum TripOptionsErrorType {
    // The segment corresponding to one of the provided SegmentKeys cannot be
    // found. This error is not retryable.
    SEGMENT_KEY_NOT_FOUND = 1;

    // The data for the requested trip option is not up-to-date at the partner
    // and needs to be refreshed. For partners caching responses the refresh can
    // happen live during the API call. But if partner infrastructure or high
    // latency requires an asynchronous refresh, this error code can be used to
    // prompt Google to re-query the key later. This error is retryable.
    TRIP_OPTION_CACHE_STALE = 2;

    // An unexpected error happened during retrieval of this trip, indicating a
    // bug that needs to be fixed by the partner. This error is retryable.
    INTERNAL_ERROR = 3;

    // The trip was found but the partner considers it suboptimal and
    // chooses not to sell tickets for it. This error is not retryable.
    SUBOPTIMAL_ITINERARY = 4;

    // The trip was found but the partner is not allowed to sell tickets for it
    // due to general ticketing sale restrictions. This error is not retryable.
    TICKETING_PROHIBITED = 5;

    // The partner doesn't support pricing itineraries for the requested date.
    // This error is not retryable.
    BOOKING_WINDOW_NOT_SUPPORTED = 6;
  }

  TripOptionsErrorType error_type = 1;

  // This is not user-visible and is for logging and debugging purposes only.
  string error_message = 2;
}

ตัวอย่างข้อผิดพลาด JSON ของ TripOptionsError

{
  "error_type": "SEGMENT_KEY_NOT_FOUND",
  "error_message": "No matching segments found, no departures at 14:25"
}