İstekte verilen başlığı kullanarak boş bir doküman oluşturur. Sağlanan içerikler de 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 gövdesi, aşağıdaki yapıya sahip verileri içerir:
JSON gösterimi |
---|
{ "documentId": string, "title": string, "tabs": [ { object ( |
Alanlar | |
---|---|
documentId |
Yalnızca çıkış. Belgenin kimliği. |
title |
Dokümanın başlığı. |
tabs[] |
Dokümanın parçası olan sekmeler. Sekmeler, başka bir sekmenin içine yerleştirilmiş bir sekme olan alt sekmeler içerebilir. Alt sekmeler, |
revisionId |
Yalnızca çıkış. Dokümanın düzeltme kimliği. Güncellemelerin hangi düzeltmeye uygulanacağını ve doküman bu düzeltmeden sonra düzenlenmişse isteğin nasıl davranması gerektiğini belirtmek için güncelleme isteklerinde 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. Döndürülen düzeltme kimliğinin, yalnızca iade edildikten sonra 24 saat boyunca geçerli olacağı garanti edilir ve bu kimlik kullanıcılar arasında paylaşılamaz. Çağrılar arasında düzeltme kimliği değişmiyorsa doküman da değişmemiştir. Buna karşılık, kimliğin değiştirilmesi (aynı doküman ve kullanıcı için) genellikle dokümanın güncellendiği anlamına gelir. Ancak kimliğin değiştirilmesi, kimlik biçimi değişiklikleri gibi dahili faktörlerden de kaynaklanıyor olabilir. |
suggestionsViewMode |
Yalnızca çıkış. Dokümana uygulanan öneriler görüntüleme modu. Not: Doküman düzenlenirken değişiklikler |
body |
Yalnızca çıkış. Dokümanın ana gövdesi. Eski alan: Bunun yerine, |
headers |
Yalnızca çıkış. Üstbilgi kimliğiyle birlikte sağlanan, dokümandaki başlıklar. Eski alan: Bunun yerine, |
footers |
Yalnızca çıkış. Dokümandaki, altbilgi kimliğiyle birlikte yayınlanan altbilgiler. Eski alan: Bunun yerine, |
footnotes |
Yalnızca çıkış. Dokümandaki dipnot kimliği ile belirtilmiş dipnotlar. Eski alan: Bunun yerine, |
documentStyle |
Yalnızca çıkış. Dokümanın stili. Eski alan: Bunun yerine, |
suggestedDocumentStyleChanges |
Yalnızca çıkış. Dokümanın stili için önerilen değişiklikler (öneri kimliği ile belirtilir). Eski alan: Bunun yerine, |
namedStyles |
Yalnızca çıkış. Dokümanın adlandırılmış stilleri. Eski alan: Bunun yerine, |
suggestedNamedStylesChanges |
Yalnızca çıkış. Dokümanın adlandırılmış stillerinde öneri kimliği ile belirtilen değişiklikler. Eski alan: Bunun yerine, |
lists |
Yalnızca çıkış. Liste kimliğiyle ilişkili olarak dokümandaki listeler. Eski alan: Bunun yerine, |
namedRanges |
Yalnızca çıkış. Dokümandaki adlandırılmış aralıklar (ada göre anahtarlarla belirtilir). Eski alan: Bunun yerine, |
inlineObjects |
Yalnızca çıkış. Dokümandaki, nesne kimliğiyle ilişkili satır içi nesneler. Eski alan: Bunun yerine, |
positionedObjects |
Yalnızca çıkış. Nesne kimliğiyle belirtilen dokümandaki konumlandırılmış nesneler. Eski alan: Bunun yerine, |
Yanıt gövdesi
Başarılı olursa yanıt gövdesi, yeni oluşturulmuş bir Document
örneğini 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ılavuzunu inceleyin.