Method: spreadsheets.values.append

Bir e-tabloya değerler ekler. Giriş aralığı, mevcut verileri aramak ve bir "tablo" bulmak için kullanılır unutmayın. 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ği ile ilgili ayrıntılı bilgi için kılavuza ve örnek koda bakın.

Arayan kişi bir e-tablo kimliği, aralık ve valueInputOption belirtmelidir. valueInputOption yalnızca giriş verilerinin sayfaya nasıl ekleneceğini (sütun bazında veya satır bazında) kontrol eder. Verilerin hangi hücreye yazılmaya başlayacağı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 aralığın A1 gösterimi. Değerler, tablonun son satırından sonra eklenir.

Sorgu parametreleri

Parametreler
valueInputOption

enum (ValueInputOption)

Girdi 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çerip içermediğini belirler. Varsayılan olarak, yanıtlar güncellenen 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 değer yoksayılır. Varsayılan dateTime 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

Bir e-tablodaki 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ştur.
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ılavuzunu inceleyin.

InsertDataOption

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 eklenir.)
INSERT_ROWS Yeni veriler için satırlar eklenir.