ส่งความคิดเห็น
Method: documents.create
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
สร้างเอกสารเปล่าโดยใช้ชื่อที่ระบุในคำขอ ระบบจะไม่สนใจช่องอื่นๆ ในคําขอ รวมถึงเนื้อหาที่ระบุ
แสดงผลเอกสารที่สร้างขึ้น
คำขอ HTTP
POST https://docs.googleapis.com/v1/documents
URL ใช้ไวยากรณ์การแปลง gRPC
เนื้อหาของคำขอ
เนื้อความของคำขอมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
การแสดง JSON
{
"documentId" : string ,
"title" : string ,
"tabs" : [
{
object (Tab
)
}
] ,
"revisionId" : string ,
"suggestionsViewMode" : enum (SuggestionsViewMode
) ,
"body" : {
object (Body
)
} ,
"headers" : {
string : {
object (Header
)
} ,
...
} ,
"footers" : {
string : {
object (Footer
)
} ,
...
} ,
"footnotes" : {
string : {
object (Footnote
)
} ,
...
} ,
"documentStyle" : {
object (DocumentStyle
)
} ,
"suggestedDocumentStyleChanges" : {
string : {
object (SuggestedDocumentStyle
)
} ,
...
} ,
"namedStyles" : {
object (NamedStyles
)
} ,
"suggestedNamedStylesChanges" : {
string : {
object (SuggestedNamedStyles
)
} ,
...
} ,
"lists" : {
string : {
object (List
)
} ,
...
} ,
"namedRanges" : {
string : {
object (NamedRanges
)
} ,
...
} ,
"inlineObjects" : {
string : {
object (InlineObject
)
} ,
...
} ,
"positionedObjects" : {
string : {
object (PositionedObject
)
} ,
...
}
}
ช่อง
document Id
string
เอาต์พุตเท่านั้น รหัสของเอกสาร
title
string
ชื่อเอกสาร
tabs[]
object (Tab
)
แท็บที่เป็นส่วนหนึ่งของเอกสาร
แท็บอาจมีแท็บย่อย ซึ่งเป็นแท็บที่ฝังอยู่ภายในแท็บอื่น แท็บย่อยจะแสดงด้วยช่อง Tab.childTabs
revision Id
string
เอาต์พุตเท่านั้น รหัสการแก้ไขของเอกสาร ใช้ได้ในคำขออัปเดตเพื่อระบุการแก้ไขของเอกสารที่จะใช้การอัปเดต และลักษณะการทํางานของคำขอหากมีการแก้ไขเอกสารนับตั้งแต่การแก้ไขนั้น ระบบจะป้อนข้อมูลเฉพาะในกรณีที่ผู้ใช้มีสิทธิ์แก้ไขเอกสาร
รหัสการแก้ไขไม่ใช่ตัวเลขตามลำดับ แต่เป็นสตริงแบบทึบ รูปแบบของรหัสการแก้ไขอาจเปลี่ยนแปลงเมื่อเวลาผ่านไป รหัสการแก้ไขที่แสดงจะใช้งานได้ภายใน 24 ชั่วโมงหลังจากที่แสดงเท่านั้น และไม่สามารถแชร์ระหว่างผู้ใช้ได้ หากรหัสการแก้ไขไม่เปลี่ยนแปลงระหว่างการเรียกใช้ แสดงว่าเอกสารไม่มีการเปลี่ยนแปลง ในทางกลับกัน รหัสที่เปลี่ยนแปลง (สำหรับเอกสารและผู้ใช้เดียวกัน) มักจะหมายความว่ามีการอัปเดตเอกสาร อย่างไรก็ตาม รหัสที่เปลี่ยนแปลงอาจเกิดจากปัจจัยภายใน เช่น การเปลี่ยนแปลงรูปแบบรหัส
suggestions View Mode
enum (SuggestionsViewMode
)
เอาต์พุตเท่านั้น โหมดมุมมองคำแนะนำที่ใช้กับเอกสาร
หมายเหตุ: เมื่อแก้ไขเอกสาร การเปลี่ยนแปลงจะต้องอิงตามเอกสารที่มี SUGGESTIONS_INLINE
body
object (Body
)
เอาต์พุตเท่านั้น เนื้อความหลักของเอกสาร
ช่องเดิม: ให้ใช้ Document.tabs.documentTab.body
แทน ซึ่งจะแสดงเนื้อหาเอกสารจริงจากแท็บทั้งหมดเมื่อตั้งค่าพารามิเตอร์ includeTabsContent
เป็น true
หากเป็น false
หรือไม่ได้ตั้งค่า ช่องนี้จะมีข้อมูลเกี่ยวกับแท็บแรกในเอกสาร
headers
map (key: string, value: object (Header
))
เอาต์พุตเท่านั้น ส่วนหัวในเอกสาร โดยจัดเรียงตามรหัสส่วนหัว
ช่องเดิม: ให้ใช้ Document.tabs.documentTab.headers
แทน ซึ่งจะแสดงเนื้อหาเอกสารจริงจากแท็บทั้งหมดเมื่อตั้งค่าพารามิเตอร์ includeTabsContent
เป็น true
หากเป็น false
หรือไม่ได้ตั้งค่า ช่องนี้จะมีข้อมูลเกี่ยวกับแท็บแรกในเอกสาร
footers
map (key: string, value: object (Footer
))
เอาต์พุตเท่านั้น ส่วนท้ายในเอกสาร โดยจัดเรียงตามรหัสส่วนท้าย
ช่องเดิม: ให้ใช้ Document.tabs.documentTab.footers
แทน ซึ่งจะแสดงเนื้อหาเอกสารจริงจากแท็บทั้งหมดเมื่อตั้งค่าพารามิเตอร์ includeTabsContent
เป็น true
หากเป็น false
หรือไม่ได้ตั้งค่า ช่องนี้จะประกอบด้วยข้อมูลเกี่ยวกับแท็บแรกในเอกสาร
footnotes
map (key: string, value: object (Footnote
))
เอาต์พุตเท่านั้น เชิงอรรถในเอกสาร โดยจัดเรียงตามรหัสเชิงอรรถ
ช่องเดิม: ให้ใช้ Document.tabs.documentTab.footnotes
แทน ซึ่งจะแสดงเนื้อหาเอกสารจริงจากแท็บทั้งหมดเมื่อตั้งค่าพารามิเตอร์ includeTabsContent
เป็น true
หากเป็น false
หรือไม่ได้ตั้งค่า ช่องนี้จะแสดงข้อมูลเกี่ยวกับแท็บแรกในเอกสาร
document Style
object (DocumentStyle
)
เอาต์พุตเท่านั้น รูปแบบของเอกสาร
ช่องเดิม: ให้ใช้ Document.tabs.documentTab.documentStyle
แทน ซึ่งจะแสดงเนื้อหาเอกสารจริงจากแท็บทั้งหมดเมื่อตั้งค่าพารามิเตอร์ includeTabsContent
เป็น true
หากเป็น false
หรือไม่ได้ตั้งค่า ช่องนี้จะมีข้อมูลเกี่ยวกับแท็บแรกในเอกสาร
suggested Document Style Changes
map (key: string, value: object (SuggestedDocumentStyle
))
เอาต์พุตเท่านั้น การเปลี่ยนแปลงที่แนะนำในสไตล์ของเอกสาร โดยจัดเรียงตามรหัสคำแนะนำ
ช่องเดิม: ให้ใช้ Document.tabs.documentTab.suggestedDocumentStyleChanges
แทน ซึ่งจะแสดงเนื้อหาเอกสารจริงจากแท็บทั้งหมดเมื่อตั้งค่าพารามิเตอร์ includeTabsContent
เป็น true
หากเป็น false
หรือไม่ได้ตั้งค่า ช่องนี้จะมีข้อมูลเกี่ยวกับแท็บแรกในเอกสาร
named Styles
object (NamedStyles
)
เอาต์พุตเท่านั้น รูปแบบที่มีชื่อของเอกสาร
ช่องเดิม: ให้ใช้ Document.tabs.documentTab.namedStyles
แทน ซึ่งจะแสดงเนื้อหาเอกสารจริงจากแท็บทั้งหมดเมื่อตั้งค่าพารามิเตอร์ includeTabsContent
เป็น true
หากเป็น false
หรือไม่ได้ตั้งค่า ช่องนี้จะประกอบด้วยข้อมูลเกี่ยวกับแท็บแรกในเอกสาร
suggested Named Styles Changes
map (key: string, value: object (SuggestedNamedStyles
))
เอาต์พุตเท่านั้น การเปลี่ยนแปลงที่แนะนำในสไตล์ที่มีชื่อของเอกสาร โดยจัดเรียงตามรหัสคำแนะนำ
ช่องเดิม: ให้ใช้ Document.tabs.documentTab.suggestedNamedStylesChanges
แทน ซึ่งจะแสดงเนื้อหาเอกสารจริงจากแท็บทั้งหมดเมื่อตั้งค่าพารามิเตอร์ includeTabsContent
เป็น true
หากเป็น false
หรือไม่ได้ตั้งค่า ช่องนี้จะมีข้อมูลเกี่ยวกับแท็บแรกในเอกสาร
lists
map (key: string, value: object (List
))
เอาต์พุตเท่านั้น รายการในเอกสาร โดยจัดเรียงตามรหัสรายการ
ช่องเดิม: ให้ใช้ Document.tabs.documentTab.lists
แทน ซึ่งจะแสดงเนื้อหาเอกสารจริงจากแท็บทั้งหมดเมื่อตั้งค่าพารามิเตอร์ includeTabsContent
เป็น true
หากเป็น false
หรือไม่ได้ตั้งค่า ช่องนี้จะมีข้อมูลเกี่ยวกับแท็บแรกในเอกสาร
named Ranges
map (key: string, value: object (NamedRanges
))
เอาต์พุตเท่านั้น ช่วงที่ตั้งชื่อในเอกสาร โดยจัดเรียงตามชื่อ
ช่องเดิม: ให้ใช้ Document.tabs.documentTab.namedRanges
แทน ซึ่งจะแสดงเนื้อหาเอกสารจริงจากแท็บทั้งหมดเมื่อตั้งค่าพารามิเตอร์ includeTabsContent
เป็น true
หากเป็น false
หรือไม่ได้ตั้งค่า ช่องนี้จะมีข้อมูลเกี่ยวกับแท็บแรกในเอกสาร
inline Objects
map (key: string, value: object (InlineObject
))
เอาต์พุตเท่านั้น ออบเจ็กต์ในบรรทัดในเอกสาร โดยคีย์ตามรหัสออบเจ็กต์
ช่องเดิม: ให้ใช้ Document.tabs.documentTab.inlineObjects
แทน ซึ่งจะแสดงเนื้อหาเอกสารจริงจากแท็บทั้งหมดเมื่อตั้งค่าพารามิเตอร์ includeTabsContent
เป็น true
หากเป็น false
หรือไม่ได้ตั้งค่า ช่องนี้จะมีข้อมูลเกี่ยวกับแท็บแรกในเอกสาร
positioned Objects
map (key: string, value: object (PositionedObject
))
เอาต์พุตเท่านั้น ออบเจ็กต์ที่มีตำแหน่งในเอกสาร โดยจัดเรียงตามรหัสออบเจ็กต์
ช่องเดิม: ให้ใช้ Document.tabs.documentTab.positionedObjects
แทน ซึ่งจะแสดงเนื้อหาเอกสารจริงจากแท็บทั้งหมดเมื่อตั้งค่าพารามิเตอร์ includeTabsContent
เป็น true
หากเป็น false
หรือไม่ได้ตั้งค่า ช่องนี้จะระบุข้อมูลเกี่ยวกับแท็บแรกในเอกสาร
เนื้อหาการตอบกลับ
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ Document
ที่สร้างขึ้นใหม่
ขอบเขตการให้สิทธิ์
ต้องใช้ขอบเขต OAuth ต่อไปนี้
https://www.googleapis.com/auth/documents
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
ดูข้อมูลเพิ่มเติมได้ที่คู่มือการให้สิทธิ์
ส่งความคิดเห็น
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 4.0 และตัวอย่างโค้ดได้รับอนุญาตภายใต้ใบอนุญาต Apache 2.0 เว้นแต่จะระบุไว้เป็นอย่างอื่น โปรดดูรายละเอียดที่นโยบายเว็บไซต์ Google Developers Java เป็นเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2024-11-30 UTC
หากต้องการบอกให้เราทราบเพิ่มเติม
[[["เข้าใจง่าย","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-11-30 UTC"],[[["Creates a new Google Docs document with the specified title, leaving all other content blank."],["Uses a POST request to `https://docs.googleapis.com/v1/documents` with the document title in the request body."],["Returns the newly created document object in the response."],["Requires authorization with specific Google Docs or Drive scopes."]]],[]]