Requires the staged_uploads create permission. Creates short-lived targets for uploading file content directly to temporary storage. client_reference_id must be unique within this request, contain 1-128 letters, digits, underscores, or hyphens, and is correlation data rather than an idempotency key. Targets expire after about 10 minutes. Copy every returned form_fields value unchanged, append the file field last, and request a new target instead of reusing an expired target. A valid batch returns HTTP 200 even when one or every item has an item-level error.
需要 staged_uploads 建立權限。系統會建立短效上傳目標,讓檔案內容可直接上傳至暫存空間。 client_reference_id 在同一請求中必須唯一,長度為 1-128 個字元,且只能包含英文字母、數字、 底線或連字號;此欄位僅供關聯結果,並非冪等鍵。上傳目標約於 10 分鐘後到期。請原樣複製所有 form_fields 值,最後再加入 file 欄位;目標到期後請申請新的目標,不要重複使用。有效的批次請求 即使部分或所有項目發生項目層級錯誤,仍回傳 HTTP 200。
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
400INVALID_REQUEST, INVALID_CLIENT_REFERENCE, or DUPLICATE_CLIENT_REFERENCE
請求或參考 ID 無效
413BATCH_SIZE_EXCEEDED
超出批次大小限制
