Method: spreadsheets.values.batchGet

E-tablodan bir veya daha fazla değer aralığı döndürür. Çağrıyı yapan kişi, e-tablo kimliğini ve bir veya daha fazla aralığı belirtmelidir.

HTTP isteği

GET https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchGet

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
spreadsheetId

string

Verilerin alınacağı e-tablonun kimliği.

Sorgu parametreleri

Parametreler
ranges[]

string

Değerlerin alınacağı aralığın A1 gösterimi veya R1C1 gösterimi.
majorDimension

enum (Dimension)

Sonuçların kullanması gereken ana boyut.

Örneğin, e-tablo verileri A1=1,B1=2,A2=3,B2=4 ise ranges=["A1:B2"],majorDimension=ROWS isteği [[1,2],[3,4]] sonucunu, ranges=["A1:B2"],majorDimension=COLUMNS isteği içinse [[1,3],[2,4]] sonucunu döndürür.
valueRenderOption

enum (ValueRenderOption)

Değerlerin çıkışta nasıl gösterilmesi gerektiği. Varsayılan oluşturma seçeneği ValueRenderOption.FORMATTED_VALUE'dir.
dateTimeRenderOption

enum (DateTimeRenderOption)

Tarihler, saatler ve sürelerin çıkışta nasıl temsil edilmesi gerektiği. valueRenderOption 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 boş olmalıdır.

Yanıt gövdesi

Bir e-tabloda birden fazla değer aralığı alınırken yanıt.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "spreadsheetId": string,
  "valueRanges": [
    {
      object (ValueRange)
    }
  ]
}
Alanlar
spreadsheetId

string

Verilerin alındığı e-tablonun kimliği.
valueRanges[]

object (ValueRange)

İstenen değerler. ValueRanges öğelerinin sırası, istenen aralıkların sıralamasıyla aynıdır.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/spreadsheets
  • https://www.googleapis.com/auth/spreadsheets.readonly

Daha fazla bilgi için Yetkilendirme kılavuzu'na bakın.