Method: spreadsheets.get

Belirtilen kimliğe sahip e-tabloyu döndürür. Arayan, e-tablo kimliğini belirtmelidir.

Varsayılan olarak, kılavuzlardaki veriler döndürülmez. Izgara verilerini 2 şekilde ekleyebilirsiniz:

  • HTTP'de fields URL parametresini kullanarak istediğiniz alanları listeleyen bir alan maskesi belirtin.

  • includeGridData URL parametresini doğru olarak ayarlayın. Alan maskesi ayarlanırsa includeGridData parametresi yoksayılır.

Büyük e-tablolar için en iyi uygulama olarak yalnızca istediğiniz belirli e-tablo alanlarını alın.

Yalnızca e-tablo verilerinin alt kümelerini almak için ranges URL parametresini kullanın. Aralıklar, A1 gösterimi kullanılarak belirtilir. Tek bir hücre (ör. A1) veya birden fazla hücre (ör. A1:D5) tanımlayabilirsiniz. Ayrıca, aynı e-tablodaki diğer sayfalardan hücreler alabilir (ör. Sheet2!A1:C4) veya birden fazla aralığı aynı anda alabilirsiniz (ör. ?ranges=A1:D5&ranges=Sheet2!A1:C4). Aralığı sınırladığınızda, e-tablonun yalnızca istenen aralıklarla kesişen kısımları döndürülür.

HTTP isteği

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

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

Yol parametreleri

Parametreler
spreadsheetId

string

İstenen e-tablo.

Sorgu parametreleri

Parametreler
ranges[]

string

E-tablodan alınacak aralıklar.
includeGridData

boolean

Izgara verileri döndürülmelidirse doğru (true) değerini döndürür. İstek sırasında bir alan maskesi ayarlanmışsa bu parametre yoksayılır.
excludeTablesInBandedRanges

boolean

Tabloların bantlı aralıklara dahil edilmemesi gerekiyorsa doğru değerini alır. Ayarlanmamışsa yanlış değerini alır.
commentsViewMode

enum (CommentsViewMode)

E-tabloya uygulanacak yorum görüntüleme modu. Bu sayede, e-tabloyu yorumlar çıkarılmış veya eklenmiş şekilde görüntüleyebilirsiniz. Belirtilmezse COMMENTS_VIEW_MODE_OMITTED kullanılır.

İstek metni

İstek metni boş olmalıdır.

Yanıt metni

Başarılıysa yanıt metni, Spreadsheet öğesinin bir örneğini içerir.

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'nu inceleyin.