Google Sheets API, sayfa oluşturmanıza, temizlemenize, kopyalamanıza, silmenize ve ayrıca özelliklerini kontrol edebilirler. Bu sayfadaki örneklerde, bazı ortak E-Tablolar işlemlerini Sheets API.
Bu örnekler, HTTP istekleri şeklinde sunulur. nötr. Bir toplu güncellemeyi farklı dillerde nasıl uygulayacağınızı öğrenmek için hakkında daha fazla bilgi edinmek için Güncelleme e-tablolar gibi).
Bu örneklerde SPREADSHEET_ID
ve SHEET_ID
yer tutucuları
bu kimlikleri nereye sağlayacağınızı belirtir. E-tabloyu
kimliği ekleyin. Şundan faydalanabilirsiniz:
sayfa kimliğini değiştirmek için
spreadsheets.get
yöntemini kullanabilirsiniz. İlgili içeriği oluşturmak için kullanılan
aralıklar A1 gösterimi kullanılarak belirtilir.
örnek aralık Sayfa1!A1:D5'tir.
Sayfa ekle
Aşağıdakiler
spreadsheets.batchUpdate
kod örneği,
AddSheetRequest
bir e-tabloya sayfa eklemeyi, aynı zamanda başlığı, ızgara boyutunu ve
sekme rengi.
Yanıt,
AddSheetResponse
içeren bir nesne içerir (örneğin, oluşturulan e-tablonun özelliklerine
SHEET_ID
) tıklayın.
İstek protokolü aşağıda gösterilmiştir.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID
:batchUpdate
{ "requests": [ { "addSheet": { "properties": { "title": "Deposits", "gridProperties": { "rowCount": 20, "columnCount": 12 }, "tabColor": { "red": 1.0, "green": 0.3, "blue": 0.4 } } } } ] }
Biçimleri korurken tüm değerlerin bulunduğu bir sayfayı temizle
Aşağıdakiler
spreadsheets.batchUpdate
kod örneği,
UpdateCellsRequest
seçeneğini kullanabilirsiniz.
userEnteredValue
alanı
Karşılık gelen bir değer olmadığında, değerleri temizleme talimatı olarak yorumlanır
değerindedir. Bu ayar diğer alanlarla da kullanılabilir. Örneğin,
fields
değeri şu şekilde değiştiriliyor:
userEnteredFormat
kaldırır
Sheets API tarafından desteklenen tüm biçimlendirmeler
işlemini yapar, ancak hücre değerlerini değiştirmeden bırakır.
İstek protokolü aşağıda gösterilmiştir.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID
:batchUpdate
{
"requests": [
{
"updateCells": {
"range": {
"sheetId": SHEET_ID
},
"fields": "userEnteredValue"
}
}
]
}
Bir e-tablodan diğerine sayfa kopyalama
Aşağıdakiler
spreadsheet.sheets.copyTo
kod örneği, SHEET_ID
tarafından belirtilen tek bir sayfanın nasıl kopyalanacağını gösterir
başka bir e-tabloya kopyalamanız gerekir.
İstek gövdesindeki TARGET_SPREADSHEET_ID
değişkeni
hedef e-tablo. Kopya, tüm değerleri, biçimlendirmeyi, formülleri ve
diğer özelliklerini de kullanabilirsiniz. Kopyalanan sayfanın başlığı "Kopyala
([orijinal sayfa başlığı]") yazın.
Yanıt,
SheetProperties
oluşturulan sayfanın özelliklerini açıklayan nesne.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID
/sheets/SHEET_ID
:copyTo
{
"destinationSpreadsheetId": "TARGET_SPREADSHEET_ID
"
}
Sayfa silme
Aşağıdakiler
spreadsheets.batchUpdate
kod örneği,
DeleteSheetRequest
tuşuna basarak SHEET_ID
ile belirtilen bir sayfayı silebilirsiniz.
İstek protokolü aşağıda gösterilmiştir.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID
:batchUpdate
{
"requests": [
{
"deleteSheet": {
"sheetId": SHEET_ID
}
}
]
}
Sayfa verilerini okuma
Aşağıdakiler
spreadsheets.get
kod örneği
e-tablo mülk bilgilerinin nasıl alınacağını gösterir
SHEET_ID
tarafından belirtilen bir e-tablodan
ve SPREADSHEET_ID
. Bu yöntem genellikle
belirli bir e-tablodaki sayfaların meta verileridir. Böylece,
bu sayfaları hedeflemenize olanak tanır. fields
sorgu parametresi yalnızca sayfa özelliğini belirtiyor
(hücre değeri verileri veya
e-tablonun tamamını) tıklayın.
GET https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID
?&fields=sheets.properties
Yanıt,
Spreadsheet
ve aynı zamanda bir
Sheet
nesnesi
SheetProperties
öğeler. Belirli bir yanıt alanı varsayılan değere ayarlanırsa atlanır
kullanıcı olabilir.
{
"sheets": [
{
"properties": {
"sheetId": SHEET_ID
,
"title": "Sheet1",
"index": 0,
"sheetType": "GRID",
"gridProperties": {
"rowCount": 100,
"columnCount": 20,
"frozenRowCount": 1
}
"tabColor": {
"blue": 1.0
}
},
...
],
}