Method: spreadsheets.values.append

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

string

Güncellenecek e-tablonun kimliği.
range

string

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

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. 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'dir.
responseDateTimeRenderOption

enum (DateTimeRenderOption)

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

İ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 (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 bulunamadıysa boş bırakılır.
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ı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.