全部產品
Search

搜尋本產品

    ：GetCategories - 擷取分類及其子分類資訊

    文件中心

    ：GetCategories - 擷取分類及其子分類資訊

    更新時間：Dec 15, 2025

    調用本介面按ID或類型來篩選查詢指定的分類資訊，及其子分類（即下一級分類）的列表。

    調試

    您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

    調試

    授權資訊

    下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

    • 操作：是指具體的許可權點。

    • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

    • 資源類型：是指操作中支援授權的資源類型。具體說明如下：

      • 對於必選的資源類型，用前面加 * 表示。

      • 對於不支援資源級授權的操作，用全部資源表示。

    • 條件關鍵字：是指雲產品自身定義的條件關鍵字。

    • 關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    vod:GetCategories

    list

    *全部資源

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    CateId

    integer

    否

    分類別識別碼，傳入此參數，則可查詢指定 ID 的分類。僅支援傳入單個分類別識別碼。可通過以下方式擷取：

    49339****
    PageNo

    integer

    否

    子分類列表頁號。預設值為 1。

    1
    PageSize

    integer

    否

    子分類列表頁大小。預設值為 10，最大值為 100。

    10
    SortBy

    string

    否

    查詢結果排序。取值：

    • CreationTime:Desc（預設值）：按建立時間倒序。

    • CreationTime:Asc：按建立時間升序。

    CreationTime:Desc
    Type

    string

    否

    分類類型，傳入此參數，則可篩選查詢指定類型的分類。取值：

    • default：音視頻/圖片分類。

    • material：短視頻素材分類。

    default

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    返回結果。

    SubTotal

    integer

    子分類總數。

    2
    RequestId

    string

    請求 ID。

    25818875-5F78-4AF6-D7393642CA58****
    Category

    object

    分類的詳細資料。

    Type

    string

    分類類型。取值：

    • default：音視頻/圖片分類。

    • material：短視頻素材分類。

    default
    ParentId

    integer

    父分類別識別碼。

    100012****
    CateName

    string

    分類名稱。

    電影
    CateId

    integer

    分類別識別碼。

    100
    Level

    integer

    分類層級。取值：

    • 0：一級分類。

    • 1：二級分類。

    • 2：三級分類。

    0
    SubCategories

    object

    Category

    array<object>

    子分類的詳細資料。

    object

    Type

    string

    子分類的類型。取值：

    • default：音視頻/圖片分類。

    • material：短視頻素材分類。

    default
    CateName

    string

    分類名稱。

    電影
    ParentId

    integer

    父分類別識別碼。

    10020****
    CateId

    integer

    分類別識別碼。

    100
    SubTotal

    integer

    子分類總數。

    1
    Level

    integer

    分類層級。取值：

    • 0：一級分類。

    • 1：二級分類。

    • 2：三級分類。

    1

    樣本

    正常返回樣本

    JSON格式

    {
  "SubTotal": 2,
  "RequestId": "25818875-5F78-4AF6-D7393642CA58****",
  "Category": {
    "Type": "default",
    "ParentId": 0,
    "CateName": "電影",
    "CateId": 100,
    "Level": 0
  },
  "SubCategories": {
    "Category": [
      {
        "Type": "default",
        "CateName": "電影",
        "ParentId": 0,
        "CateId": 100,
        "SubTotal": 1,
        "Level": 1
      }
    ]
  }
}

    錯誤碼

    訪問錯誤中心查看更多錯誤碼。

    變更歷史

    更多資訊，參考變更詳情。