ส่งความคิดเห็น
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
)
} ,
...
}
}
ช่อง
documentId
string
เอาต์พุตเท่านั้น รหัสของเอกสาร
title
string
ชื่อเอกสาร
tabs[]
object (Tab
)
แท็บที่เป็นส่วนหนึ่งของเอกสาร
แท็บอาจมีแท็บย่อย ซึ่งเป็นแท็บที่ฝังอยู่ภายในแท็บอื่น แท็บย่อยจะแสดงด้วยช่อง Tab.childTabs
revisionId
string
เอาต์พุตเท่านั้น รหัสการแก้ไขของเอกสาร ใช้ได้ในคำขออัปเดตเพื่อระบุการแก้ไขของเอกสารที่จะใช้การอัปเดต และลักษณะการทำงานของคำขอหากมีการแก้ไขเอกสารหลังจากการแก้ไขนั้น ระบบจะป้อนข้อมูลก็ต่อเมื่อผู้ใช้มีสิทธิ์แก้ไขเอกสาร
รหัสการแก้ไขไม่ใช่ตัวเลขตามลำดับ แต่เป็นสตริงที่คลุมเครือ รูปแบบของรหัสการแก้ไขอาจเปลี่ยนแปลงเมื่อเวลาผ่านไป รหัสการแก้ไขที่แสดงจะใช้งานได้ภายใน 24 ชั่วโมงหลังจากที่แสดงเท่านั้น และไม่สามารถแชร์ระหว่างผู้ใช้ได้ ถ้ารหัสการแก้ไขไม่มีการเปลี่ยนแปลงระหว่างการเรียก เอกสารนั้นจะไม่มีการเปลี่ยนแปลง ในทางกลับกัน รหัสที่เปลี่ยนแปลง (สำหรับเอกสารและผู้ใช้เดียวกัน) มักจะหมายถึงมีการอัปเดตเอกสารแล้ว อย่างไรก็ตาม รหัสที่เปลี่ยนแปลงยังอาจเกิดจากปัจจัยภายใน เช่น การเปลี่ยนแปลงรูปแบบรหัส
suggestionsViewMode
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
หรือไม่ได้ตั้งค่า ช่องนี้จะมีข้อมูลเกี่ยวกับแท็บแรกในเอกสาร
documentStyle
object (DocumentStyle
)
เอาต์พุตเท่านั้น รูปแบบของเอกสาร
ช่องเดิม: ให้ใช้ Document.tabs.documentTab.documentStyle
แทน ซึ่งจะแสดงเนื้อหาเอกสารจริงจากแท็บทั้งหมดเมื่อตั้งค่าพารามิเตอร์ includeTabsContent
เป็น true
หาก false
หรือไม่ได้ตั้งค่า ช่องนี้จะมีข้อมูลเกี่ยวกับแท็บแรกในเอกสาร
suggestedDocumentStyleChanges
map (key: string, value: object (SuggestedDocumentStyle
))
เอาต์พุตเท่านั้น การเปลี่ยนแปลงที่แนะนำในสไตล์ของเอกสาร โดยจัดเรียงตามรหัสคำแนะนำ
ช่องเดิม: ให้ใช้ Document.tabs.documentTab.suggestedDocumentStyleChanges
แทน ซึ่งจะแสดงเนื้อหาเอกสารจริงจากแท็บทั้งหมดเมื่อตั้งค่าพารามิเตอร์ includeTabsContent
เป็น true
หาก false
หรือไม่ได้ตั้งค่า ช่องนี้จะมีข้อมูลเกี่ยวกับแท็บแรกในเอกสาร
namedStyles
object (NamedStyles
)
เอาต์พุตเท่านั้น รูปแบบที่มีชื่อของเอกสาร
ช่องเดิม: ให้ใช้ Document.tabs.documentTab.namedStyles
แทน ซึ่งจะแสดงเนื้อหาเอกสารจริงจากแท็บทั้งหมดเมื่อตั้งค่าพารามิเตอร์ includeTabsContent
เป็น true
หากเป็น false
หรือไม่ได้ตั้งค่า ช่องนี้จะมีข้อมูลเกี่ยวกับแท็บแรกในเอกสาร
suggestedNamedStylesChanges
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
หรือไม่ได้ตั้งค่า ช่องนี้จะระบุข้อมูลเกี่ยวกับแท็บแรกในเอกสาร
namedRanges
map (key: string, value: object (NamedRanges
))
เอาต์พุตเท่านั้น ช่วงที่ตั้งชื่อแล้วในเอกสาร ผูกกับชื่อ
ช่องเดิม: ให้ใช้ Document.tabs.documentTab.namedRanges
แทน ซึ่งจะแสดงเนื้อหาเอกสารจริงจากทุกแท็บเมื่อตั้งค่าพารามิเตอร์ includeTabsContent
เป็น true
หากเป็น false
หรือไม่ได้ตั้งค่า ช่องนี้จะมีข้อมูลเกี่ยวกับแท็บแรกในเอกสาร
inlineObjects
map (key: string, value: object (InlineObject
))
เอาต์พุตเท่านั้น ออบเจ็กต์ในบรรทัดในเอกสาร คีย์ตามรหัสออบเจ็กต์
ช่องเดิม: ให้ใช้ Document.tabs.documentTab.inlineObjects
แทน ซึ่งจะแสดงเนื้อหาเอกสารจริงจากแท็บทั้งหมดเมื่อตั้งค่าพารามิเตอร์ includeTabsContent
เป็น true
หากเป็น false
หรือไม่ได้ตั้งค่า ช่องนี้จะมีข้อมูลเกี่ยวกับแท็บแรกในเอกสาร
positionedObjects
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-10-14 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-10-14 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."]]],[]]