Method: spreadsheets.values.append

Bir e-tabloya değer ekler. Giriş aralığı, mevcut verileri aramak ve bu aralıktaki bir "tabloyu" bulmak için kullanılır. Değerler, tablonun ilk sütunundan başlayarak tablonun sonraki satırına eklenir. Tabloların nasıl algılandığı ve verilerin nasıl eklendiğiyle ilgili ayrıntılı bilgi için kılavuzu ve örnek kodu inceleyin.

Arayan, e-tablo kimliğini, aralığı ve bir valueInputOption belirtmelidir. valueInputOption yalnızca giriş verilerinin e-tabloya nasıl ekleneceğini (sütun veya satır bazında) kontrol eder, verilerin hangi hücreye yazılmaya başlanacağını 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

string

Güncellenecek e-tablonun kimliği.
range

string

Mantıksal bir veri tablosu aramak için bir aralığın A1 gösterimi. Değerler, tablonun son satırından sonra eklenir.

Sorgu parametreleri

Parametreler
valueInputOption

enum (ValueInputOption)

Giriş verilerinin nasıl yorumlanması gerektiği.
insertDataOption

enum (InsertDataOption)

Giriş verilerinin nasıl ekleneceği.
includeValuesInResponse

boolean

Güncelleme yanıtının, eklenen hücrelerin değerlerini içerip içermeyeceğini belirler. Yanıtlar varsayılan olarak güncellenmiş değerleri içermez.
responseValueRenderOption

enum (ValueRenderOption)

Yanıttaki değerlerin nasıl oluşturulacağını belirler. Varsayılan oluşturma seçeneği FORMATTED_VALUE'tür.
responseDateTimeRenderOption

enum (DateTimeRenderOption)

Yanıttaki tarih, saat ve sürelerin nasıl oluşturulacağını belirler. responseValueRenderOption FORMATTED_VALUE ise bu yoksayılır. Varsayılan dateTime oluşturma seçeneği SERIAL_NUMBER'tür.

İstek içeriği

İstek metni, ValueRange öğesinin bir örneğini içerir.

Yanıt gövdesi

E-tabloda bir değer aralığı güncellendiğinde 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 (UpdateValuesResponse)
  }
}
Alanlar
spreadsheetId

string

Güncellemelerin uygulandığı e-tablo.
tableRange

string

Değerlerin ekleneceği tablonun (A1 gösterimindeki) aralığı (değerlerin eklenmesinden önce). Tablo bulunamadıysa boştur.
updates

object (UpdateValuesResponse)

Uygulanan güncellemeler hakkında bilgi.

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ılavuzuna bakın.

InsertDataOption

Yeni veriler girildiğinde mevcut verilerin nasıl değiştirileceğini belirler.

Sıralamalar
OVERWRITE Yeni veriler, yazıldığı alanlarda mevcut verilerin üzerine yazılır. (Not: E-tablonun sonuna veri eklediğinizde, verilerin yazılabilmesi için yeni satırlar veya sütunlar eklenir.)
INSERT_ROWS Yeni veriler için satırlar eklenir.