Method: spreadsheets.values.append

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 itibaren sonraki satıra eklenir. Tabloların nasıl algılandığı ve verilerin nasıl eklendiğiyle ilgili ayrıntılar için rehbere ve örnek koda göz atın.

Arayan, e-tablo kimliğini, aralığı ve bir valueInputOption belirtmelidir. valueInputOption, yalnızca giriş verilerinin e-tabloya nasıl ekleneceğini (sütun düzeyinde veya satır bazında) kontrol eder. Verilerin hangi hücreye yazıldığı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 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 eklenmesi gerektiği.
includeValuesInResponse

boolean

Güncelleme yanıtının, eklenen hücrelerin değerlerini içermesi gerekip gerekmediğini belirler. Varsayılan olarak, yanıtlar güncellenmiş değerleri içermez.
responseValueRenderOption

enum (ValueRenderOption)

Yanıttaki değerlerin nasıl oluşturulması gerektiğini belirler. Varsayılan oluşturma seçeneği: FORMATTED_VALUE.
responseDateTimeRenderOption

enum (DateTimeRenderOption)

Yanıttaki tarihlerin, saatlerin ve sürelerin nasıl oluşturulması gerektiğini belirler. responseValueRenderOption FORMATTED_VALUE ise bu yoksayılır. Varsayılan dateTimetime oluşturma seçeneği SERIAL_NUMBER şeklindedir.

İstek içeriği

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

Yanıt gövdesi

E-tablodaki 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 (UpdateValuesResponse)
  }
}
Alanlar
spreadsheetId

string

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

string

Değerlerin eklendiği tablonun aralığı (A1 gösteriminde). Değerler eklenmeden önce. Tablo bulunamazsa boş.
updates

object (UpdateValuesResponse)

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

Veri Seçeneği Ekle

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

Sıralamalar
OVERWRITE Yeni veriler, yazıldığı alanlardaki mevcut verilerin üzerine yazılır. (Not: Sayfanın sonuna veri eklendiğinde, verilerin yazılabilmesi için yeni satırlar veya sütunlar eklenmeye devam eder.)
INSERT_ROWS Yeni veriler için satırlar eklenir.