Bu kılavuzda, Google Docs API ve bir dokümanı toplu olarak nasıl güncelleyebileceğiniz.
Google Docs API'yi bir HTTP isteği veya yöntem kullanarak çağırabilirsiniz çağrının dile özgü istemci kitaplığında olması gerekir. Bunlar genel olarak eşdeğerdir.
Google Docs API, HTTP yanıtı döndürüyor ve bu yanıt genellikle ilgili sonucu isteği gönderir. İstekte bulunmak için bir istemci kitaplığı kullanırken, farklı bir şekilde döndürülür.
İstek yöntemleri
Docs API aşağıdaki yöntemleri destekler:
documents.create
: Bir boş Google Dokümanlar dokümanı.documents.get
: Döndürme a tam örneğini oluşturur. Döndürülen JSON dosyasını ayrıştırabilirsiniz. tıklayarak doküman içeriğini, biçimlendirmeyi ve diğer özellikleri ayıklayın.documents.batchUpdate
: Belgeye atomik olarak uygulanacak düzenleme isteklerinin listesini göndermelidir ve sonuç listesi döndürür.
documents.get
ve documents.batchUpdate
yöntemleri için documentId
gerekir
parametre olarak kullanabilirsiniz. documents.create
yöntemi
oluşturulan dokümanın bir örneğini döndürür. Bu örnekte
documentId
. documentId
hakkında daha fazla bilgi için bkz. Doküman
Kimlik.
Toplu güncellemeler
documents.batchUpdate
yöntemin
Her biri request
nesne
tek bir istek belirtin. Örneğin, bir paragrafı biçimlendirin ve ardından
satır içi resim ekleyin. Her istek uygulanmadan önce doğrulanır ve
istekler, toplu istekte göründükleri sıraya göre işlenir.
Toplu güncellemedeki tüm istekler atomik olarak uygulanır. Yani, müşteriye geçersiz hale gelirse güncellemenin tamamı başarısız olur ve (potansiyel olarak (bağlı olarak) nasıl uygulanır?
Bazı documents.batchUpdate
yöntemleri, yanıtlarda aşağıdaki konularda bilgi sağlar:
emin olun. Bu yöntemler yanıt
gövde
response
listesini içerir
nesneler'i tıklayın. Diğer isteklerin bilgi döndürmesi ve boş bir
yanıt ver. Yanıt listesindeki nesneler
talebinize ekleyebilirsiniz.
Toplu istek yapmaya yönelik popüler bir kalıp aşağıdaki gibidir:
requests = []
requests.append(first request)
requests.append(second request)
...
body = ... & requests & ...
...batchUpdate(body)
Tüm ayrıntılar için toplu istekle ilgili en iyi uygulamalara bakın
Docs API çağrılarınızı toplu hale getirme ve
documents.batchUpdate
referans belgelerden bahsedeceğiz.
Toplu güncelleme işlemleri
Çeşitli toplu güncelleme isteği türleri vardır. Aşağıda istek türleri şu şekilde gruplandırılır: kullanabilirsiniz.