要求與回應
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
本指南介紹了構成
Google Docs API,以及如何批次更新文件。
您可以透過 HTTP 要求或使用方法叫用 Google Docs API
叫用特定語言用戶端程式庫。
這兩項指標相當大同小異。
Google Docs API 會傳回 HTTP 回應,當中通常包含
叫用清單。使用用戶端程式庫發出要求時,
會以特定語言的方式傳回回應。
要求方法
Docs API 支援下列方法:
documents.get
和 documents.batchUpdate
方法需要 documentId
做為指定目標文件的參數。documents.create
方法
會傳回所建立文件的例項,您可以從中讀取
documentId
。如要進一步瞭解 documentId
,請參閱「文件
ID:
批次更新
documents.batchUpdate
方法會採用 request
物件的清單,每個物件都會指定要執行的單一要求。例如為段落設定格式
新增內嵌圖片每個請求在套用前都會經過驗證,
系統會依據要求在批次要求中的顯示順序處理。
系統會以不可分割的形式套用批次更新中的所有要求。也就是說,如果任何要求皆無效,則整個更新作業都會失敗,且不會套用任何 (可能的依附) 變更。
某些 documents.batchUpdate
方法會提供回應,其中包含已套用要求的相關資訊。這些方法會傳回回應
內文
包含 response
清單
如需儲存大量結構化物件
建議使用 Cloud Bigtable其他要求則不需要傳回資訊,且會將空白顯示為
回覆。回應清單中的物件具有與
對應的要求
以下是提出批次要求的熱門模式:
requests = []
requests.append(first request)
requests.append(second request)
...
body = ... & requests & ...
...batchUpdate(body)
如要進一步瞭解如何批次處理 Google 文件 API 呼叫,請參閱批次要求最佳做法,以及documents.batchUpdate
的參考說明文件,瞭解要求和回應類型。
批次更新作業
批次更新要求有多種類型,接下來是
要求類型,分組到
不同的類別
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2024-09-11 (世界標準時間)。
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"缺少我需要的資訊"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"過於複雜/步驟過多"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"過時"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"翻譯問題"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"示例/程式碼問題"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"其他"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"容易理解"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"確實解決了我的問題"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"其他"
}]
{"lastModified": "\u4e0a\u6b21\u66f4\u65b0\u6642\u9593\uff1a2024-09-11 (\u4e16\u754c\u6a19\u6e96\u6642\u9593)\u3002"}
[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["缺少我需要的資訊","missingTheInformationINeed","thumb-down"],["過於複雜/步驟過多","tooComplicatedTooManySteps","thumb-down"],["過時","outOfDate","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["示例/程式碼問題","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間:2024-09-11 (世界標準時間)。"]]