İ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 ( |
Alanlar | |
---|---|
documentId |
Yalnızca çıkış. Belgenin kimliği. |
title |
Dokümanın başlığı. |
tabs[] |
Bir 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. İ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. Çağrılar arasında düzeltme kimliği değişmiyorsa doküman da değişmemiş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ştirilmesi, kimlik biçimi değişiklikleri gibi dahili faktörlerden de kaynaklanıyor olabilir. |
suggestionsViewMode |
Yalnızca çıkış. Dokümana uygulanan öneri 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ış. Belgedeki altbilgiler, altbilgi kimliğine göre anahtarlanmıştır. Eski alan: Bunun yerine, |
footnotes |
Yalnızca çıkış. Dokümandaki dipnot kimliği ile belirtilmiş dipnotlar. Eski alan: Bunun yerine, |
documentStyle |
Yalnızca çıkış. Belgenin 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ış. Ö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, |
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 anahtarlamalı). Eski alan: Bunun yerine, |
inlineObjects |
Yalnızca çıkış. Nesne kimliğine göre anahtarlanmış, dokümandaki satır içi nesneler. Eski alan: Bunun yerine, |
positionedObjects |
Yalnızca çıkış. Nesne kimliğine göre anahtarlanmış, dokümanda konumlandırılmış nesneler. Eski alan: Bunun yerine, |
Yanıt gövdesi
Başarılı olursa yanıt metni, 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ılavuzuna bakın.