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.child_tabs

revisionId

string

เอาต์พุตเท่านั้น รหัสการแก้ไขของเอกสาร ใช้ได้ในคำขออัปเดตเพื่อระบุการแก้ไขของเอกสารที่จะใช้การอัปเดต และการทำงานของคำขอหากมีการแก้ไขเอกสารหลังจากการแก้ไขนั้น ระบบจะป้อนข้อมูลก็ต่อเมื่อผู้ใช้มีสิทธิ์แก้ไขเอกสาร

รหัสการแก้ไขไม่ใช่ตัวเลขตามลำดับ แต่เป็นสตริงที่คลุมเครือ รูปแบบของรหัสการแก้ไขอาจเปลี่ยนแปลงเมื่อเวลาผ่านไป เรารับประกันว่ารหัสการแก้ไขที่ส่งคืนจะใช้งานได้เป็นเวลา 24 ชั่วโมงหลังจากที่มีการส่งคืนมาแล้วเท่านั้น และไม่สามารถแชร์กับผู้ใช้รายอื่นได้ ถ้ารหัสการแก้ไขไม่มีการเปลี่ยนแปลงระหว่างการเรียก เอกสารนั้นจะไม่มีการเปลี่ยนแปลง ในทางกลับกัน รหัสที่เปลี่ยนแปลง (สำหรับเอกสารและผู้ใช้เดียวกัน) มักจะหมายถึงมีการอัปเดตเอกสารแล้ว อย่างไรก็ตาม รหัสที่เปลี่ยนแปลงยังอาจเกิดจากปัจจัยภายใน เช่น การเปลี่ยนแปลงรูปแบบรหัส

suggestionsViewMode

enum (SuggestionsViewMode)

เอาต์พุตเท่านั้น โหมดมุมมองคำแนะนำที่ใช้กับเอกสาร

หมายเหตุ: เมื่อแก้ไขเอกสาร การเปลี่ยนแปลงจะขึ้นอยู่กับเอกสารที่มี SUGGESTIONS_INLINE

body

object (Body)

เอาต์พุตเท่านั้น เนื้อหาหลักของเอกสาร

ช่องเดิม: ให้ใช้ Document.tabs.document_tab.body แทน ซึ่งจะแสดงเนื้อหาเอกสารจริงจากทุกแท็บเมื่อตั้งค่าพารามิเตอร์ includeTabsContent เป็น true หาก false หรือไม่ได้ตั้งค่า ช่องนี้จะมีข้อมูลเกี่ยวกับแท็บแรกในเอกสาร

headers

map (key: string, value: object (Header))

เอาต์พุตเท่านั้น ส่วนหัวในเอกสาร คีย์ตามรหัสส่วนหัว

ช่องเดิม: ให้ใช้ Document.tabs.document_tab.headers แทน ซึ่งจะแสดงเนื้อหาเอกสารจริงจากทุกแท็บเมื่อตั้งค่าพารามิเตอร์ includeTabsContent เป็น true หาก false หรือไม่ได้ตั้งค่า ช่องนี้จะมีข้อมูลเกี่ยวกับแท็บแรกในเอกสาร

footers

map (key: string, value: object (Footer))

เอาต์พุตเท่านั้น ส่วนท้ายในเอกสารคีย์ตามรหัสส่วนท้าย

ช่องเดิม: ให้ใช้ Document.tabs.document_tab.footers แทน ซึ่งจะแสดงเนื้อหาเอกสารจริงจากทุกแท็บเมื่อตั้งค่าพารามิเตอร์ includeTabsContent เป็น true หาก false หรือไม่ได้ตั้งค่า ช่องนี้จะมีข้อมูลเกี่ยวกับแท็บแรกในเอกสาร

footnotes

map (key: string, value: object (Footnote))

เอาต์พุตเท่านั้น เชิงอรรถในเอกสาร คีย์ตามรหัสเชิงอรรถ

ช่องเดิม: ให้ใช้ Document.tabs.document_tab.footnotes แทน ซึ่งจะแสดงเนื้อหาเอกสารจริงจากทุกแท็บเมื่อตั้งค่าพารามิเตอร์ includeTabsContent เป็น true หาก false หรือไม่ได้ตั้งค่า ช่องนี้จะมีข้อมูลเกี่ยวกับแท็บแรกในเอกสาร

documentStyle

object (DocumentStyle)

เอาต์พุตเท่านั้น รูปแบบของเอกสาร

ช่องเดิม: ให้ใช้ Document.tabs.document_tab.document_style แทน ซึ่งจะแสดงเนื้อหาเอกสารจริงจากทุกแท็บเมื่อตั้งค่าพารามิเตอร์ includeTabsContent เป็น true หาก false หรือไม่ได้ตั้งค่า ช่องนี้จะมีข้อมูลเกี่ยวกับแท็บแรกในเอกสาร

suggestedDocumentStyleChanges

map (key: string, value: object (SuggestedDocumentStyle))

เอาต์พุตเท่านั้น การเปลี่ยนแปลงที่แนะนำในรูปแบบของเอกสาร และใส่รหัสคำแนะนำ

ช่องเดิม: ให้ใช้ Document.tabs.document_tab.suggested_document_style_changes แทน ซึ่งจะแสดงเนื้อหาเอกสารจริงจากทุกแท็บเมื่อตั้งค่าพารามิเตอร์ includeTabsContent เป็น true หาก false หรือไม่ได้ตั้งค่า ช่องนี้จะมีข้อมูลเกี่ยวกับแท็บแรกในเอกสาร

namedStyles

object (NamedStyles)

เอาต์พุตเท่านั้น รูปแบบที่มีชื่อของเอกสาร

ช่องเดิม: ให้ใช้ Document.tabs.document_tab.named_styles แทน ซึ่งจะแสดงเนื้อหาเอกสารจริงจากทุกแท็บเมื่อตั้งค่าพารามิเตอร์ includeTabsContent เป็น true หาก false หรือไม่ได้ตั้งค่า ช่องนี้จะมีข้อมูลเกี่ยวกับแท็บแรกในเอกสาร

suggestedNamedStylesChanges

map (key: string, value: object (SuggestedNamedStyles))

เอาต์พุตเท่านั้น การเปลี่ยนแปลงที่แนะนำในรูปแบบที่มีชื่อของเอกสาร แยกตามรหัสคำแนะนำ

ช่องเดิม: ให้ใช้ Document.tabs.document_tab.suggested_named_styles_changes แทน ซึ่งจะแสดงเนื้อหาเอกสารจริงจากทุกแท็บเมื่อตั้งค่าพารามิเตอร์ includeTabsContent เป็น true หาก false หรือไม่ได้ตั้งค่า ช่องนี้จะมีข้อมูลเกี่ยวกับแท็บแรกในเอกสาร

lists

map (key: string, value: object (List))

เอาต์พุตเท่านั้น รายการในเอกสาร คีย์รายการตามรหัสรายการ

ช่องเดิม: ให้ใช้ Document.tabs.document_tab.lists แทน ซึ่งจะแสดงเนื้อหาเอกสารจริงจากทุกแท็บเมื่อตั้งค่าพารามิเตอร์ includeTabsContent เป็น true หาก false หรือไม่ได้ตั้งค่า ช่องนี้จะมีข้อมูลเกี่ยวกับแท็บแรกในเอกสาร

namedRanges

map (key: string, value: object (NamedRanges))

เอาต์พุตเท่านั้น ช่วงที่ตั้งชื่อแล้วในเอกสาร ผูกกับชื่อ

ช่องเดิม: ให้ใช้ Document.tabs.document_tab.named_ranges แทน ซึ่งจะแสดงเนื้อหาเอกสารจริงจากทุกแท็บเมื่อตั้งค่าพารามิเตอร์ includeTabsContent เป็น true หาก false หรือไม่ได้ตั้งค่า ช่องนี้จะมีข้อมูลเกี่ยวกับแท็บแรกในเอกสาร

inlineObjects

map (key: string, value: object (InlineObject))

เอาต์พุตเท่านั้น ออบเจ็กต์ในบรรทัดในเอกสาร คีย์ตามรหัสออบเจ็กต์

ช่องเดิม: ให้ใช้ Document.tabs.document_tab.inline_objects แทน ซึ่งจะแสดงเนื้อหาเอกสารจริงจากทุกแท็บเมื่อตั้งค่าพารามิเตอร์ includeTabsContent เป็น true หาก false หรือไม่ได้ตั้งค่า ช่องนี้จะมีข้อมูลเกี่ยวกับแท็บแรกในเอกสาร

positionedObjects

map (key: string, value: object (PositionedObject))

เอาต์พุตเท่านั้น ออบเจ็กต์ที่วางตำแหน่งในเอกสาร คีย์ตามรหัสออบเจ็กต์

ช่องเดิม: ให้ใช้ Document.tabs.document_tab.positioned_objects แทน ซึ่งจะแสดงเนื้อหาเอกสารจริงจากทุกแท็บเมื่อตั้งค่าพารามิเตอร์ includeTabsContent เป็น true หาก false หรือไม่ได้ตั้งค่า ช่องนี้จะมีข้อมูลเกี่ยวกับแท็บแรกในเอกสาร

เนื้อหาการตอบกลับ

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ที่สร้างขึ้นใหม่ Document

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth รายการใดรายการหนึ่งต่อไปนี้

  • https://www.googleapis.com/auth/documents
  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file

สำหรับข้อมูลเพิ่มเติม โปรดดูที่คู่มือการให้สิทธิ์