Status

代表處理要求中的個別航班或市場時發生錯誤。

如果無法計算所要求項目的預估排放量,errors 欄位會包含一或多個 Status 物件,說明原因:

  • INVALID_ARGUMENT (code 3):回報所要求項目的輸入錯誤,例如缺少或無效的機場代碼、營運航空公司代碼、航班編號或出發日期。如果有多個輸入欄位無效,系統可能會傳回多個 Status 項目。
  • NOT_FOUND (code 5):表示沒有任何預估排放量符合要求的航班或市場輸入內容。
JSON 表示法
{
  "code": integer,
  "message": string,
  "details": [
    {
      "@type": string,
      field1: ...,
      ...
    }
  ]
}
欄位
code

integer

與 google.rpc.Code 列舉值對應的數字狀態碼:

  • 3 (INVALID_ARGUMENT):輸入錯誤 (例如缺少或無效的機場或航空公司代碼)。
  • 5 (NOT_FOUND):沒有符合要求輸入內容的預估排放量。
message

string

人類可讀的英文錯誤訊息,說明無法傳回所要求項目預估排放量的原因。

details[]

object

其他結構化錯誤詳細資料 (如有)。

包含任意類型欄位的物件。額外的 "@type" 欄位則包含能辨識類型的 URI。範例:{ "id": 1234, "@type": "types.example.com/standard/id" }。