Google E-Tablolar API'si sayfa oluşturmanıza, temizlemenize, kopyalamanıza, silmenize ve ayrıca özelliklerini kontrol etmenize olanak sağlar. Bu sayfadaki örnekler, bazı yaygın E-Tablolar işlemlerini E-Tablolar API'sini kullanarak nasıl gerçekleştirebileceğinizi gösterir.
Bu örnekler, dilsiz olması için HTTP istekleri biçiminde sunulur. Google API istemci kitaplıklarını kullanarak farklı dillerde toplu güncellemenin nasıl uygulanacağını öğrenmek için E-tabloları güncelleme bölümüne bakın.
Bu örneklerde SPREADSHEET_ID ve SHEET_ID yer tutucuları, bu kimlikleri nereye gireceğinizi belirtir. E-tablo kimliğini e-tablonun URL'sinde bulabilirsiniz. Sayfa kimliğini spreadsheets.get yöntemini kullanarak alabilirsiniz. Aralıklar, A1 gösterimi kullanılarak belirtilir. Sayfa1!A1:D5 örnek aralıktır.
Sayfa ekle
Aşağıdaki spreadsheets.batchUpdate kod örneğinde, AddSheetRequest ile e-tabloya sayfa eklemenin yanı sıra başlığı, ızgara boyutunu ve sekme rengini nasıl ayarlayabileceğiniz gösterilmiştir.
Yanıt, oluşturulan sayfanın özelliklerine (SHEET_ID gibi) sahip bir nesneyi içeren AddSheetResponse öğesinden oluşur.
İ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 yer aldığı bir sayfayı temizle
Aşağıdaki spreadsheets.batchUpdate kod örneğinde, biçimlendirmeyi değiştirmeden bir sayfadaki tüm değerleri kaldırmak için UpdateCellsRequest özelliğinin nasıl kullanılacağı gösterilmektedir.
userEnteredValue alanının karşılık gelen bir değer olmadan belirtilmesi, aralıktaki değerleri temizleme talimatı olarak yorumlanır. Bu ayar diğer alanlarla da kullanılabilir. Örneğin, fields değerinin userEnteredFormat olarak değiştirilmesi, E-Tablolar API'si tarafından desteklenen tüm biçimlendirmeleri sayfadan kaldırır 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 sayfayı bir e-tablodan diğerine kopyalama
Aşağıdaki spreadsheet.sheets.copyTo kod örneğinde, SHEET_ID tarafından belirtilen tek bir sayfanın bir e-tablodan diğerine nasıl kopyalanacağı gösterilmektedir.
İstek gövdesindeki TARGET_SPREADSHEET_ID değişkeni, hedef e-tabloyu belirtir. Kopya, orijinalin tüm değerlerini, biçimlendirmesini, formüllerini ve diğer özelliklerini korur. Kopyalanan sayfanın başlığı "Kopya [orijinal sayfa başlığı]" olarak ayarlanır.
Yanıt, oluşturulan sayfanın özelliklerini açıklayan bir SheetProperties nesnesinden oluşur.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID/sheets/SHEET_ID:copyTo
{
"destinationSpreadsheetId": "TARGET_SPREADSHEET_ID"
}
Sayfa silme
Aşağıdaki spreadsheets.batchUpdate kod örneğinde, SHEET_ID tarafından belirtilen bir sayfayı silmek için DeleteSheetRequest kodunun nasıl kullanılacağı gösterilmektedir.
İ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ğıdaki spreadsheets.get kod örneğinde, SHEET_ID ve SPREADSHEET_ID ile belirtilen bir e-tablodan e-tablo özellik bilgilerinin nasıl alınacağı gösterilmektedir. Bu yöntem genellikle belirli bir e-tablodaki sayfaların meta verilerini belirlemek için kullanılır. Böylece ek işlemler bu sayfaları hedefleyebilir. fields sorgu parametresi, hücre değeri verileri veya e-tablonun tamamıyla ilgili verilerin aksine, yalnızca sayfa özelliği verilerinin döndürülmesi gerektiğini belirtir.
GET https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID?&fields=sheets.properties
Yanıt, SheetProperties öğelerine sahip bir Sheet nesnesi içeren bir Spreadsheet kaynağından oluşur. Belirli bir yanıt alanı varsayılan değere ayarlanırsa yanıttan çıkarılır.
{
"sheets": [
{
"properties": {
"sheetId": SHEET_ID,
"title": "Sheet1",
"index": 0,
"sheetType": "GRID",
"gridProperties": {
"rowCount": 100,
"columnCount": 20,
"frozenRowCount": 1
}
"tabColor": {
"blue": 1.0
}
},
...
],
}