Method: documents.create

Membuat dokumen kosong menggunakan judul yang diberikan dalam permintaan. Kolom lain dalam permintaan, termasuk konten yang diberikan, akan diabaikan.

Menampilkan dokumen yang dibuat.

Permintaan HTTP

POST https://docs.googleapis.com/v1/documents

URL menggunakan sintaksis gRPC Transcoding.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi 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)
    },
    ...
  }
}
Kolom
documentId

string

Hanya output. ID dokumen.

title

string

Judul dokumen.

tabs[]

object (Tab)

Tab yang merupakan bagian dari dokumen.

Tab dapat berisi tab turunan, yaitu tab yang berada di dalam tab lain. Tab turunan direpresentasikan oleh kolom Tab.child_tabs.

revisionId

string

Hanya output. ID revisi dokumen. Dapat digunakan dalam permintaan update untuk menentukan revisi dokumen mana yang akan diterapkan update dan bagaimana permintaan harus berperilaku jika dokumen telah diedit sejak revisi tersebut. Hanya diisi jika pengguna memiliki akses edit ke dokumen.

ID revisi bukan nomor urut, melainkan string buram. Format ID revisi dapat berubah dari waktu ke waktu. ID revisi yang dikembalikan hanya dijamin valid selama 24 jam setelah ID tersebut dikembalikan dan tidak dapat dibagikan ke pengguna lain. Jika ID revisi tidak berubah di antara panggilan, dokumen tidak berubah. Sebaliknya, ID yang berubah (untuk dokumen dan pengguna yang sama) biasanya berarti dokumen telah diperbarui. Namun, perubahan ID juga dapat disebabkan oleh faktor internal seperti perubahan format ID.

suggestionsViewMode

enum (SuggestionsViewMode)

Hanya output. Mode tampilan saran yang diterapkan ke dokumen.

Catatan: Saat mengedit dokumen, perubahan harus didasarkan pada dokumen dengan SUGGESTIONS_INLINE.

body

object (Body)

Hanya output. Isi utama dokumen.

Kolom lama: Sebagai gantinya, gunakan Document.tabs.document_tab.body, yang mengekspos konten dokumen sebenarnya dari semua tab saat parameter includeTabsContent disetel ke true. Jika false atau tidak disetel, kolom ini berisi informasi tentang tab pertama dalam dokumen.

headers

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

Hanya output. Header dalam dokumen, yang dikunci oleh ID header.

Kolom lama: Sebagai gantinya, gunakan Document.tabs.document_tab.headers, yang mengekspos konten dokumen sebenarnya dari semua tab saat parameter includeTabsContent disetel ke true. Jika false atau tidak disetel, kolom ini berisi informasi tentang tab pertama dalam dokumen.

footers

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

Hanya output. Footer dalam dokumen, dikunci dengan ID footer.

Kolom lama: Sebagai gantinya, gunakan Document.tabs.document_tab.footers, yang mengekspos konten dokumen sebenarnya dari semua tab saat parameter includeTabsContent disetel ke true. Jika false atau tidak disetel, kolom ini berisi informasi tentang tab pertama dalam dokumen.

footnotes

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

Hanya output. Catatan kaki dalam dokumen, yang dikunci dengan ID catatan kaki.

Kolom lama: Sebagai gantinya, gunakan Document.tabs.document_tab.footnotes, yang mengekspos konten dokumen sebenarnya dari semua tab saat parameter includeTabsContent disetel ke true. Jika false atau tidak disetel, kolom ini berisi informasi tentang tab pertama dalam dokumen.

documentStyle

object (DocumentStyle)

Hanya output. Gaya dokumen.

Kolom lama: Sebagai gantinya, gunakan Document.tabs.document_tab.document_style, yang mengekspos konten dokumen sebenarnya dari semua tab saat parameter includeTabsContent disetel ke true. Jika false atau tidak disetel, kolom ini berisi informasi tentang tab pertama dalam dokumen.

suggestedDocumentStyleChanges

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

Hanya output. Perubahan yang disarankan pada gaya dokumen, yang dikunci oleh ID saran.

Kolom lama: Sebagai gantinya, gunakan Document.tabs.document_tab.suggested_document_style_changes, yang mengekspos konten dokumen sebenarnya dari semua tab saat parameter includeTabsContent disetel ke true. Jika false atau tidak disetel, kolom ini berisi informasi tentang tab pertama dalam dokumen.

namedStyles

object (NamedStyles)

Hanya output. Gaya dokumen yang telah diberi nama.

Kolom lama: Sebagai gantinya, gunakan Document.tabs.document_tab.named_styles, yang mengekspos konten dokumen sebenarnya dari semua tab saat parameter includeTabsContent disetel ke true. Jika false atau tidak disetel, kolom ini berisi informasi tentang tab pertama dalam dokumen.

suggestedNamedStylesChanges

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

Hanya output. Perubahan yang disarankan pada gaya dokumen yang telah diberi nama, yang dikunci oleh ID saran.

Kolom lama: Sebagai gantinya, gunakan Document.tabs.document_tab.suggested_named_styles_changes, yang mengekspos konten dokumen sebenarnya dari semua tab saat parameter includeTabsContent disetel ke true. Jika false atau tidak disetel, kolom ini berisi informasi tentang tab pertama dalam dokumen.

lists

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

Hanya output. Daftar dalam dokumen, dikunci oleh ID daftar.

Kolom lama: Sebagai gantinya, gunakan Document.tabs.document_tab.lists, yang mengekspos konten dokumen sebenarnya dari semua tab saat parameter includeTabsContent disetel ke true. Jika false atau tidak disetel, kolom ini berisi informasi tentang tab pertama dalam dokumen.

namedRanges

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

Hanya output. Rentang bernama dalam dokumen, yang dikunci berdasarkan nama.

Kolom lama: Sebagai gantinya, gunakan Document.tabs.document_tab.named_ranges, yang mengekspos konten dokumen sebenarnya dari semua tab saat parameter includeTabsContent disetel ke true. Jika false atau tidak disetel, kolom ini berisi informasi tentang tab pertama dalam dokumen.

inlineObjects

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

Hanya output. Objek inline dalam dokumen, yang dikunci oleh ID objek.

Kolom lama: Sebagai gantinya, gunakan Document.tabs.document_tab.inline_objects, yang mengekspos konten dokumen sebenarnya dari semua tab saat parameter includeTabsContent disetel ke true. Jika false atau tidak disetel, kolom ini berisi informasi tentang tab pertama dalam dokumen.

positionedObjects

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

Hanya output. Objek yang diposisikan dalam dokumen, yang dikunci oleh ID objek.

Kolom lama: Sebagai gantinya, gunakan Document.tabs.document_tab.positioned_objects, yang mengekspos konten dokumen sebenarnya dari semua tab saat parameter includeTabsContent disetel ke true. Jika false atau tidak disetel, kolom ini berisi informasi tentang tab pertama dalam dokumen.

Isi respons

Jika berhasil, isi respons memuat instance Document yang baru dibuat.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

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

Untuk informasi selengkapnya, lihat Panduan otorisasi.