Method: documents.create

İstekte belirtilen başlığı kullanarak boş bir doküman oluşturur. Sağlanan içerikler dahil olmak üzere istekteki diğer alanlar yoksayılır.

Oluşturulan dokümanı döndürür.

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

İstek içeriği

İstek metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi
{
  "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)
    },
    ...
  }
}
Alanlar
documentId

string

Yalnızca çıkış. Belgenin kimliği.

title

string

Dokümanın başlığı.

tabs[]

object (Tab)

Bir dokümanın parçası olan sekmeler.

Sekmeler, başka bir sekmenin içine yerleştirilmiş alt sekmeler içerebilir. Alt sekmeler Tab.childTabs alanıyla temsil edilir.

revisionId

string

Yalnızca çıkış. Belgenin düzeltme kimliği. Güncelleme isteklerinde, güncellemelerin hangi doküman düzeltmesine uygulanacağını ve doküman bu düzeltmeden sonra düzenlenmişse isteğin nasıl davranacağını belirtmek için kullanılabilir. Yalnızca kullanıcının dokümana düzenleme erişimi varsa doldurulur.

Düzeltme kimliği, sıralı bir sayı değil, opak bir dizedir. Düzeltme kimliğinin biçimi zaman içinde değişebilir. İade edilen düzeltme kimliğinin yalnızca iade edildikten sonraki 24 saat boyunca geçerli olacağı garanti edilir ve kullanıcılar arasında paylaşılamaz. Düzeltme kimliği, aramalar arasında değişmediyse doküman değiştirilmemiştir. Buna karşılık, aynı doküman ve kullanıcı için değişen bir kimlik genellikle dokümanın güncellendiği anlamına gelir. Ancak kimliğin değişmesi, kimlik biçimi değişiklikleri gibi dahili faktörlerden de kaynaklanabilir.

suggestionsViewMode

enum (SuggestionsViewMode)

Yalnızca çıkış. Dokümana öneriler görüntüleme modu uygulandı.

Not: Bir dokümanı düzenlerken değişiklikler, SUGGESTIONS_INLINE içeren bir dokümana dayalı olmalıdır.

body

object (Body)

Yalnızca çıkış. Belgenin ana metni.

Eski alan: Bunun yerine, includeTabsContent parametresi true olarak ayarlandığında tüm sekmelerdeki gerçek doküman içeriğini gösteren Document.tabs.documentTab.body değerini kullanın. false veya ayarlanmamışsa bu alan, belgedeki ilk sekmeyle ilgili bilgileri içerir.

headers

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

Yalnızca çıkış. Üstbilgi kimliğine göre anahtarlanmış, belgedeki üstbilgiler.

Eski alan: Bunun yerine, includeTabsContent parametresi true olarak ayarlandığında tüm sekmelerdeki gerçek doküman içeriğini gösteren Document.tabs.documentTab.headers değerini kullanın. false veya ayarlanmamışsa bu alan, belgedeki ilk sekmeyle ilgili bilgileri içerir.

footers

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

Yalnızca çıkış. Belgedeki altbilgiler, altbilgi kimliğine göre anahtarlanmıştır.

Eski alan: Bunun yerine, includeTabsContent parametresi true olarak ayarlandığında tüm sekmelerdeki gerçek doküman içeriğini gösteren Document.tabs.documentTab.footers değerini kullanın. false veya ayarlanmamışsa bu alan, belgedeki ilk sekmeyle ilgili bilgileri içerir.

footnotes

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

Yalnızca çıkış. Dipnot kimliğine göre anahtarlanmış, dokümandaki dipnotlar.

Eski alan: Bunun yerine, includeTabsContent parametresi true olarak ayarlandığında tüm sekmelerdeki gerçek doküman içeriğini gösteren Document.tabs.documentTab.footnotes değerini kullanın. false veya ayarlanmamışsa bu alan, belgedeki ilk sekmeyle ilgili bilgileri içerir.

documentStyle

object (DocumentStyle)

Yalnızca çıkış. Belgenin stili.

Eski alan: Bunun yerine, includeTabsContent parametresi true olarak ayarlandığında tüm sekmelerdeki gerçek doküman içeriğini gösteren Document.tabs.documentTab.documentStyle değerini kullanın. false veya ayarlanmamışsa bu alan, belgedeki ilk sekmeyle ilgili bilgileri içerir.

suggestedDocumentStyleChanges

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

Yalnızca çıkış. Öneri kimliğine göre anahtarlanmış, dokümanın stilinde önerilen değişiklikler.

Eski alan: Bunun yerine, includeTabsContent parametresi true olarak ayarlandığında tüm sekmelerdeki gerçek doküman içeriğini gösteren Document.tabs.documentTab.suggestedDocumentStyleChanges değerini kullanın. false veya ayarlanmamışsa bu alan, belgedeki ilk sekmeyle ilgili bilgileri içerir.

namedStyles

object (NamedStyles)

Yalnızca çıkış. Dokümanın adlandırılmış stilleri.

Eski alan: Bunun yerine, includeTabsContent parametresi true olarak ayarlandığında tüm sekmelerdeki gerçek doküman içeriğini gösteren Document.tabs.documentTab.namedStyles değerini kullanın. false veya ayarlanmamışsa bu alan, belgedeki ilk sekmeyle ilgili bilgileri içerir.

suggestedNamedStylesChanges

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

Yalnızca çıkış. Önerilen değişiklikler, öneri kimliğine göre anahtarlandırılmış olarak dokümanın adlandırılmış stillerinde yapılır.

Eski alan: Bunun yerine, includeTabsContent parametresi true olarak ayarlandığında tüm sekmelerdeki gerçek doküman içeriğini gösteren Document.tabs.documentTab.suggestedNamedStylesChanges değerini kullanın. false veya ayarlanmamışsa bu alan, belgedeki ilk sekmeyle ilgili bilgileri içerir.

lists

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

Yalnızca çıkış. Belgedeki listeler, liste kimliğine göre anahtarlanır.

Eski alan: Bunun yerine, includeTabsContent parametresi true olarak ayarlandığında tüm sekmelerdeki gerçek doküman içeriğini gösteren Document.tabs.documentTab.lists değerini kullanın. false veya ayarlanmamışsa bu alan, belgedeki ilk sekmeyle ilgili bilgileri içerir.

namedRanges

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

Yalnızca çıkış. Dokümanda adlarına göre anahtarlanmış adlandırılmış aralıklar.

Eski alan: Bunun yerine, includeTabsContent parametresi true olarak ayarlandığında tüm sekmelerdeki gerçek doküman içeriğini gösteren Document.tabs.documentTab.namedRanges değerini kullanın. false veya ayarlanmamışsa bu alan, belgedeki ilk sekmeyle ilgili bilgileri içerir.

inlineObjects

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

Yalnızca çıkış. Nesne kimliğine göre anahtarlanmış, dokümandaki satır içi nesneler.

Eski alan: Bunun yerine, includeTabsContent parametresi true olarak ayarlandığında tüm sekmelerdeki gerçek doküman içeriğini gösteren Document.tabs.documentTab.inlineObjects değerini kullanın. false veya ayarlanmamışsa bu alan, belgedeki ilk sekmeyle ilgili bilgileri içerir.

positionedObjects

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

Yalnızca çıkış. Nesne kimliğine göre anahtarlanmış, belgedeki konumlandırılmış nesneler.

Eski alan: Bunun yerine, includeTabsContent parametresi true olarak ayarlandığında tüm sekmelerdeki gerçek doküman içeriğini gösteren Document.tabs.documentTab.positionedObjects değerini kullanın. false veya ayarlanmamışsa bu alan, belgedeki ilk sekmeyle ilgili bilgileri içerir.

Yanıt gövdesi

Başarılı olursa yanıt metni, yeni oluşturulmuş bir Document örneği içerir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

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

Daha fazla bilgi için Yetkilendirme kılavuzuna bakın.