- HTTP isteği
- Yol parametreleri
- Sorgu parametreleri
- İstek metni
- Yanıt metni
- Yetkilendirme kapsamları
- InsertDataOption
- Deneyin.
Bir e-tabloya değer ekler. Giriş aralığı, mevcut verileri aramak ve bu aralık içindeki bir "tablo"yu bulmak için kullanılır. Değerler, tablonun ilk sütunundan başlayarak sonraki satıra eklenir. Tabloların nasıl algılandığı ve verilerin nasıl eklendiğiyle ilgili belirli ayrıntılar için kılavuza ve örnek koda bakın.
Arayanın e-tablo kimliği, aralık ve valueInputOption
belirtmesi gerekir. valueInputOption
yalnızca giriş verilerinin sayfaya nasıl ekleneceğini (sütun veya satır bazında) kontrol eder. Verilerin yazılmaya başladığı hücreyi etkilemez.
HTTP isteği
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}:append
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Yol parametreleri
Parametreler | |
---|---|
spreadsheetId |
Güncellenecek e-tablonun kimliği. |
range |
Mantıksal bir veri tablosu aramak için aralığın A1 gösterimi. Değerler, tablonun son satırından sonra eklenir. |
Sorgu parametreleri
Parametreler | |
---|---|
valueInputOption |
Giriş verilerinin nasıl yorumlanması gerektiği. |
insertDataOption |
Giriş verilerinin nasıl ekleneceği. |
includeValuesInResponse |
Güncelleme yanıtının, eklenen hücrelerin değerlerini içerip içermeyeceğini belirler. Varsayılan olarak, yanıtlar güncellenmiş değerleri içermez. |
responseValueRenderOption |
Yanıttaki değerlerin nasıl oluşturulması gerektiğini belirler. Varsayılan oluşturma seçeneği |
responseDateTimeRenderOption |
Yanıttaki tarihlerin, saatlerin ve sürelerin nasıl oluşturulması gerektiğini belirler. |
İstek içeriği
İstek metni, ValueRange
öğesinin bir örneğini içerir.
Yanıt gövdesi
Bir e-tabloda bir değer aralığını güncellerken verilen yanıt.
Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:
JSON gösterimi |
---|
{
"spreadsheetId": string,
"tableRange": string,
"updates": {
object ( |
Alanlar | |
---|---|
spreadsheetId |
Güncellemelerin uygulandığı e-tablo. |
tableRange |
Değerlerin eklendiği tablonun aralığı (A1 gösteriminde) (değerler eklenmeden önce). Tablo bulunamadıysa boş bırakılır. |
updates |
Uygulanan güncellemelerle ilgili bilgiler. |
Yetkilendirme kapsamları
Aşağıdaki OAuth kapsamlarından birini gerektirir:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/spreadsheets
Daha fazla bilgi için Yetkilendirme kılavuzu'na bakın.
InsertDataOption
Yeni veriler girildiğinde mevcut verilerin nasıl değiştirileceğini belirler.
Sıralamalar | |
---|---|
OVERWRITE |
Yeni veriler, yazıldığı alanlardaki mevcut verilerin üzerine yazar. (Not: Sayfanın sonuna veri eklendiğinde, verilerin yazılabilmesi için yeni satırlar veya sütunlar eklenir.) |
INSERT_ROWS |
Yeni veriler için satırlar eklenir. |