İstekte verilen başlığı kullanarak boş bir doküman oluşturur. Sağlanan içerikler de dahil olmak üzere istekteki diğer alanlar yok sayı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 veriler içerir:
JSON gösterimi |
---|
{ "documentId": string, "title": string, "body": { object ( |
Alanlar | |
---|---|
documentId |
Yalnızca çıkış. Belgenin kimliği. |
title |
Belgenin başlığı. |
body |
Yalnızca çıkış. Dokümanın ana gövdesi. |
headers |
Yalnızca çıkış. Üstbilgide belirtilen dokümandaki başlıklar. |
footers |
Yalnızca çıkış. Dokümandaki altbilgi kimliğiyle eşleşen altbilgiler. |
footnotes |
Yalnızca çıkış. Dokümandaki, dipnot kimliğiyle düzenlenmiş dipnotlar. |
documentStyle |
Yalnızca çıkış. Belgenin stili. |
suggestedDocumentStyleChanges |
Yalnızca çıkış. Önerilen, öneri kimliği anahtarıyla dokümanın stilinde yapılan değişikliklerdir. |
namedStyles |
Yalnızca çıkış. Dokümanın adlandırılmış stilleri. |
suggestedNamedStylesChanges |
Yalnızca çıkış. Öneri kimliği temel alınarak dokümanın adlandırılmış stilleri için önerilen değişiklikler. |
lists |
Yalnızca çıkış. Belgede bulunan, liste kimliğinden oluşan listeler. |
namedRanges |
Yalnızca çıkış. Dokümanda ada göre adlandırılan adlandırılmış aralıklar. |
revisionId |
Yalnızca çıkış. Dokümanın düzeltme kimliği. Bir dokümanda hangi düzeltmenin uygulanacağını ve bu düzeltmeden sonra doküman düzenlenmişse isteğin nasıl davranması gerektiğini belirtmek için güncelleme isteklerinde kullanılabilir. Yalnızca kullanıcı doküman için düzenleme erişimine sahipse 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, geri verildikten sonraki 24 saat boyunca geçerli olacağı ve kullanıcılar arasında paylaşılamayacağı garanti edilir. Düzeltme kimliği aramalar arasında değiştirilmezse doküman değişmemiştir. Diğer yandan, değişen kimlik (aynı doküman ve kullanıcı için) genellikle dokümanın güncellendiği anlamına gelir. Bununla birlikte, değişen kimlik, kimlik biçimi değişiklikleri gibi dahili faktörlerden de kaynaklanabilir. |
suggestionsViewMode |
Yalnızca çıkış. Dokümana uygulanan öneri görünümü modu. Not: Bir dokümanı düzenlerken, değişiklikler |
inlineObjects |
Yalnızca çıkış. Dokümandaki nesne kimliği anahtarlı satır içi nesneler. |
positionedObjects |
Yalnızca çıkış. Dokümandaki nesne kimliği anahtarıyla konumlandırılmış nesneler. |
Yanıt gövdesi
Başarılı olursa yanıt gövdesi, yeni oluşturulan 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.