调用Google Transcoder API按时间排序作业列表报错求助

调用listJobs接口报排序字段不支持的错误，是因为Google Transcoder API的orderBy参数仅支持作业对象的顶层可排序字段，不支持传入Timestamp类型的嵌套子属性（比如你写的createTime.seconds属于嵌套字段，服务端没有做对应排序实现，会直接返回参数非法）。
虽然通用AIP规范定义了排序语法，但每个API实际支持的排序字段由服务端单独开放，不能直接根据返回结构的嵌套字段猜排序参数。

1. 优先使用服务端原生排序 #

直接传入顶层时间字段名即可，无需追加.seconds后缀，目前该接口支持的排序字段包括createTime、startTime、endTime、name、state，支持追加asc（升序，默认）、desc（降序）指定排序方向。
修改请求代码示例：

const result = await client.listJobs({
    parent: client.locationPath(this.projectId, this.location),
    pageSize: params.pageSize,
    // 示例：按创建时间倒序，最新创建的作业排在最前
    orderBy: 'createTime desc'
}, {
    autoPaginate: false
});

其他常用排序写法：

• 按创建时间升序：orderBy: 'createTime'
• 按作业开始时间倒序：orderBy: 'startTime desc'
• 按作业结束时间升序：orderBy: 'endTime asc'

2. 本地兜底排序（适配自定义需求） #

如果需要实现服务端不支持的排序规则（比如多字段组合排序、基于时间的自定义规则排序），可以在拿到接口返回的当前页作业列表后，在业务层做本地排序。注意该方式仅对当前分页内的数据生效，如需跨分页全局排序，需要拉取全量作业数据后再统一处理，数据量较大时不推荐使用。
本地按创建时间倒序的代码示例：

const [jobs, pageToken, paginatedResp] = result;
const sortedJobs = jobs.sort((prev, curr) => {
    // 把Timestamp转成毫秒级时间戳做比较
    const prevTs = Number(prev.createTime.seconds) * 1000 + Math.floor(prev.createTime.nanos / 1e6);
    const currTs = Number(curr.createTime.seconds) * 1000 + Math.floor(curr.createTime.nanos / 1e6);
    // 倒序返回currTs - prevTs，升序返回prevTs - currTs
    return currTs - prevTs;
});

• 不要仅凭返回数据结构推断支持的排序字段，未在API文档中明确标注支持的字段，哪怕返回结构里存在，传入后也大概率报参数错误
• 本地排序无法保证跨分页的全局顺序，业务允许的情况下优先用服务端排序能力

内容的提问来源于stack exchange，提问作者Luciano Salemme