Google Sheets API'ye Genel Bakış
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Google Sheets API, e-tablolardaki verileri okumanıza ve değiştirmenize olanak tanıyan bir RESTful arayüzüdür. Sheets API ile şunları yapabilirsiniz:
- E-tablo oluşturma
- E-tablo hücre değerlerini okuma ve yazma
- E-tablo biçimlendirmesini güncelleme
- Bağlı sayfaları yönetme
Aşağıda, Sheets API'de kullanılan yaygın terimlerin listesi verilmiştir:
- E-tablo
Google E-Tablolar'daki birincil nesne. Her biri Cells içinde yapılandırılmış bilgiler içeren birden fazla Sheets içerebilir. spreadsheets
kaynağı, bir e-tabloyu temsil eder. Benzersiz bir spreadsheetId
değeri içerir.
- E-tablo kimliği
- E-tablonun benzersiz tanımlayıcısı. E-tabloya referans veren harfler, sayılar ve bazı özel karakterler içeren belirli bir dizedir ve e-tablonun URL'sinden türetilebilir. E-tablo adı değişse bile e-tablo kimlikleri sabit kalır.
https://docs.google.com/spreadsheets/d/SPREADSHEET_ID/edit?gid=SHEET_ID#gid=SHEET_ID
- Sayfa
E-tablodaki bir sayfa veya sekme. Sheets kaynağı bir sayfayı temsil eder. SheetProperties nesnesinin bir parçası olarak benzersiz bir sayısal sheetId değeri ve sayfa title içerir.
- Sayfa kimliği
- E-tablodaki belirli bir sayfanın benzersiz tanımlayıcısı. Bir sayfaya referans veren sayıları içeren belirli bir tam sayıdır ve e-tablonun URL'sinden elde edilebilir. Sayfa adı değişse bile sayfa kimlikleri sabit kalır. Örnek için E-tablo kimliği başlıklı makaleye bakın.
- Hücre
Bir sayfadaki tek bir metin veya veri alanı. Hücreler satırlar ve sütunlar halinde düzenlenir ve hücre aralığı olarak gruplandırılabilir. Cells
kaynağı her hücreyi temsil eder ancak benzersiz bir kimlik değerine sahip değildir.
Bunun yerine, hücreler satır ve sütun koordinatlarıyla tanımlanır.
- A1 gösterimi
- Sayfa adını ve sütun harfleri ile satır numaralarını kullanarak başlangıç ve bitiş hücre koordinatlarını içeren bir dizeyle hücreyi veya hücre aralığını tanımlamak için kullanılan söz dizimi. Bu yöntem, mutlak bir hücre aralığına başvururken en yaygın ve kullanışlı olanıdır.
Sheet1!A1:B2, Sayfa1'in ilk iki satır ve sütunundaki tüm hücreleri ifade eder.Sheet1!A:A, Sayfa1'in ilk sütunundaki tüm hücreleri ifade eder.Sheet1!1:2, Sayfa1'in ilk iki satırındaki tüm hücreleri ifade eder.Sheet1!A5:A, Sayfa1'in ilk sütunundaki 5. satırdan itibaren tüm hücreleri ifade eder.A1:B2, ilk görünür sayfadaki ilk iki satır ve sütundaki tüm hücreleri ifade eder.Sheet1, Sayfa1'deki tüm hücreleri ifade eder.'Jon's_Data'!A1:D5, "Jon's_Data" adlı bir sayfadaki ilk beş satır ve dört sütundaki tüm hücreleri ifade eder.'My Custom Sheet'!A:A, "Özel Sayfam" adlı bir sayfanın ilk sütunundaki tüm hücreleri ifade eder.'My Custom Sheet', "Özel Sayfam"daki tüm hücreleri ifade eder.
Boşluk veya özel karakter içeren sayfa adları için tek tırnak işareti gerekir.
İpucu: Mümkün olduğunda, e-tablolarınızdaki nesneler için farklı adlar kullanın. Örneğin, A1 (tırnak işareti olmadan) ilk görünür sayfadaki A1 hücresini ifade eder. 'A1', A1 adlı bir sayfayı ifade eder. Benzer şekilde, Sayfa1, Sayfa1 adlı bir sayfayı ifade eder. Ancak "Sayfa1" adlı bir adlandırılmış aralık varsa Sayfa1, adlandırılmış aralığı, 'Sheet1' ise sayfayı ifade eder.
- R1C1 gösterimi
- Sayfa adını ve satır numaraları ile sütun numaralarını kullanarak başlangıç ve bitiş hücre koordinatlarını içeren bir dizeyle bir hücreyi veya hücre aralığını tanımlamak için kullanılan söz dizimi. Bu yöntem, A1 gösteriminden daha az kullanılır ancak belirli bir hücrenin konumuna göre bir hücre aralığına referans verirken faydalı olabilir.
Sheet1!R1C1:R2C2, Sayfa1'in en üstteki iki satırındaki ilk iki hücreyi ifade eder.R1C1:R2C2, ilk görünür sayfadaki ilk iki satırın ilk iki hücresini ifade eder.Sheet1!R[3]C[1], geçerli hücrenin üç satır altında ve bir sütun sağındaki hücreyi ifade eder.
- Adlandırılmış aralık
- Bir uygulama genelinde referansları basitleştirmek için özel bir ada sahip tanımlanmış bir hücre veya hücre aralığı. A
FilterView
kaynağı, adlandırılmış bir aralığı temsil eder.
- Korumalı aralık
- Değiştirilemeyen tanımlı bir hücre veya hücre aralığı. A
ProtectedRange
kaynağı, korumalı bir aralığı temsil eder.
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-08-29 UTC.
[null,null,["Son güncelleme tarihi: 2025-08-29 UTC."],[],[],null,["# Google Sheets API Overview\n\nThe Google Sheets API is a RESTful interface that lets you read and modify a\nspreadsheet's data. The Sheets API lets you:\n\n- Create spreadsheets\n- Read and write spreadsheet cell values\n- Update spreadsheet formatting\n- Manage Connected Sheets\n\nThe following is a list of common terms used in the Sheets API:\n\n*Spreadsheet*\n\n: The primary object in Google Sheets. It can contain multiple `Sheets`, each\n with structured information contained in `Cells`. The\n [`spreadsheets`](/workspace/sheets/api/reference/rest/v4/spreadsheets)\n resource represents a spreadsheet. It contains a unique `spreadsheetId`\n value.\n\n *Spreadsheet ID*\n : The unique identifier for a spreadsheet. It's a particular string\n containing letters, numbers, and some special characters that reference a\n spreadsheet and it can be derived from the spreadsheet's URL. Spreadsheet\n IDs are stable, even if the spreadsheet name changes. \n\n https://docs.google.com/spreadsheets/d/\u003cvar translate=\"no\"\u003eSPREADSHEET_ID\u003c/var\u003e/edit?gid=\u003cvar translate=\"no\"\u003eSHEET_ID\u003c/var\u003e#gid=\u003cvar translate=\"no\"\u003eSHEET_ID\u003c/var\u003e\n\n*Sheet*\n\n: A page or tab within a spreadsheet. The\n [`Sheets`](/workspace/sheets/api/reference/rest/v4/spreadsheets/sheets) resource\n represents a sheet. It contains a unique numeric `sheetId` value and sheet\n `title` as part of the\n [`SheetProperties`](/workspace/sheets/api/reference/rest/v4/spreadsheets/sheets#sheetproperties)\n object.\n\n *Sheet ID*\n : The unique identifier for a specific sheet within a spreadsheet. It's a\n particular integer containing numbers that reference a sheet and it can be\n derived from the spreadsheet's URL. Sheet IDs are stable, even if the sheet\n name changes. For an example, see [Spreadsheet ID](#spreadsheet-id).\n\n*Cell*\n\n: An individual field of text or data within a sheet. Cells are arranged in rows\n and columns, and can be grouped as a range of cells. The\n [`Cells`](/workspace/sheets/api/reference/rest/v4/spreadsheets/cells)\n resource represents each cell, but it doesn't have a unique ID value.\n Instead, row and column coordinates identify the cells.\n\n *A1 notation*\n : A syntax used to define a cell or range of cells with a string that\n contains the sheet name plus the starting and ending cell coordinates using\n column letters and row numbers. This method is the most common and useful\n when referencing an absolute range of cells.\n - `Sheet1!A1:B2` refers to all the cells in the first two rows and columns of Sheet1.\n - `Sheet1!A:A` refers to all the cells in the first column of Sheet1.\n - `Sheet1!1:2` refers to all the cells in the first two rows of Sheet1.\n - `Sheet1!A5:A` refers to all the cells of the first column of Sheet 1, from row 5 onward.\n - `A1:B2` refers to all the cells in the first two rows and columns of the first visible sheet.\n - `Sheet1` refers to all the cells in Sheet1.\n - `'Jon's_Data'!A1:D5` refers to all the cells in the first five rows and four columns of a sheet named \"Jon's_Data.\"\n - `'My Custom Sheet'!A:A` refers to all the cells in the first column of a sheet named \"My Custom Sheet.\"\n - `'My Custom Sheet'` refers to all the cells in \"My Custom Sheet\".\n\n Single quotes are required for sheet names with spaces or special characters.\n\n **Tip** : Where possible, use distinct names for objects in your spreadsheets. For example, A1 (without quotes) refers to cell A1 in the first visible sheet. `'A1'` refers to a sheet with the name A1. Similarly, Sheet1 refers to a sheet with the name Sheet1. However, if there's a named range titled \"Sheet1\", then Sheet1 refers to the named range and `'Sheet1'` refers to the sheet.\n\n *R1C1 notation*\n : A syntax used to define a cell or range of cells with a string that\n contains the sheet name plus the starting and ending cell coordinates using\n row numbers and column numbers. This method is less common than A1 notation,\n but can be useful when referencing a range of cells relative to a given\n cell's position.\n - `Sheet1!R1C1:R2C2` refers to the first two cells in the top two rows of Sheet1.\n - `R1C1:R2C2` refers to the first two cells in the top two rows of the first visible sheet.\n - `Sheet1!R[3]C[1]` refers to the cell that is three rows below and one column to the right of the current cell.\n\n *Named range*\n : A defined cell or range of cells with a custom name to simplify references\n throughout an application. A\n [`FilterView`](/workspace/sheets/api/reference/rest/v4/spreadsheets/sheets#filterview)\n resource represents a named range.\n\n *Protected range*\n : A defined cell or range of cells that cannot be modified. A\n [`ProtectedRange`](/workspace/sheets/api/reference/rest/v4/spreadsheets/sheets#protectedrange)\n resource represents a protected range.\n\nRelated topics\n--------------\n\n- To learn about developing with Google Workspace APIs, including handling\n authentication and authorization, refer to [Develop on\n Google Workspace](/workspace/guides/get-started).\n\n- To learn how to configure and run a Sheets API app, try the\n [JavaScript quickstart](/workspace/sheets/api/quickstart/js)."]]
