গুগল শিটস এপিআই আপনাকে শিটে সারি এবং কলাম যোগ করতে, অপসারণ করতে এবং পরিচালনা করতে দেয়। এই পৃষ্ঠার উদাহরণগুলি দেখায় যে কীভাবে শিটস এপিআই দিয়ে কিছু সাধারণ সারি এবং কলাম ক্রিয়াকলাপ অর্জন করা যেতে পারে।
এই উদাহরণগুলি ভাষা নিরপেক্ষ থাকার জন্য HTTP অনুরোধের আকারে উপস্থাপন করা হয়েছে। Google API ক্লায়েন্ট লাইব্রেরি ব্যবহার করে বিভিন্ন ভাষায় ব্যাচ আপডেট কীভাবে বাস্তবায়ন করতে হয় তা জানতে, আপডেট স্প্রেডশিট দেখুন।
এই উদাহরণগুলিতে, স্থানধারক SPREADSHEET_ID এবং SHEET_ID নির্দেশ করে যে আপনি কোথায় এই আইডিগুলি প্রদান করবেন। আপনি স্প্রেডশিট URL-এ স্প্রেডশিট আইডি খুঁজে পেতে পারেন। আপনি spreadsheets.get পদ্ধতি ব্যবহার করে শিট আইডি পেতে পারেন। A1 নোটেশন ব্যবহার করে রেঞ্জগুলি নির্দিষ্ট করা হয়েছে। একটি উদাহরণ রেঞ্জ হল Sheet1!A1:D5।
কলামের প্রস্থ বা সারির উচ্চতা সামঞ্জস্য করুন
নিম্নলিখিত spreadsheets.batchUpdate কোড নমুনাটি দেখায় কিভাবে UpdateDimensionPropertiesRequest ব্যবহার করে কলাম A এর প্রস্থ বৈশিষ্ট্যটি 160 পিক্সেলে আপডেট করতে হয়। দ্বিতীয় অনুরোধটি প্রথম তিনটি সারির সারি উচ্চতা বৈশিষ্ট্যটি 40 পিক্সেলে আপডেট করে। dimension ক্ষেত্রটি নির্ধারণ করে যে অপারেশনটি একটি শীটের কলাম বা সারিতে প্রযোজ্য কিনা।
অনুরোধ প্রোটোকলটি নীচে দেখানো হয়েছে।
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate{
"requests": [
{
"updateDimensionProperties": {
"range": {
"sheetId": SHEET_ID,
"dimension": "COLUMNS",
"startIndex": 0,
"endIndex": 1
},
"properties": {
"pixelSize": 160
},
"fields": "pixelSize"
}
},
{
"updateDimensionProperties": {
"range": {
"sheetId": SHEET_ID,
"dimension": "ROWS",
"startIndex": 0,
"endIndex": 3
},
"properties": {
"pixelSize": 40
},
"fields": "pixelSize"
}
}
]
}খালি সারি বা কলাম যোগ করুন
নিম্নলিখিত spreadsheets.batchUpdate কোড নমুনাটি দেখায় কিভাবে সারি এবং কলাম যোগ করার জন্য AppendDimensionRequest ব্যবহার করতে হয়। প্রথম অনুরোধটি একটি শীটের শেষে তিনটি খালি সারি যুক্ত করে, যখন দ্বিতীয়টি একটি খালি কলাম যুক্ত করে। dimension ক্ষেত্রটি নির্ধারণ করে যে অপারেশনটি একটি শীটের কলাম বা সারিতে প্রযোজ্য কিনা।
অনুরোধ প্রোটোকলটি নীচে দেখানো হয়েছে।
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate{
"requests": [
{
"appendDimension": {
"sheetId": SHEET_ID,
"dimension": "ROWS",
"length": 3
}
},
{
"appendDimension": {
"sheetId": SHEET_ID,
"dimension": "COLUMNS",
"length": 1
}
}
]
}স্বয়ংক্রিয়ভাবে একটি কলামের আকার পরিবর্তন করুন
নিম্নলিখিত spreadsheets.batchUpdate কোড নমুনাটি দেখায় কিভাবে AutoResizeDimensionsRequest ব্যবহার করে কলামের কন্টেন্টের আকারের উপর ভিত্তি করে কলাম A:C আকার পরিবর্তন করতে হয়। dimension ক্ষেত্রটি নির্দেশ করে যে অপারেশনটি শীটের কলামের ক্ষেত্রে প্রযোজ্য।
অনুরোধ প্রোটোকলটি নীচে দেখানো হয়েছে।
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate{
"requests": [
{
"autoResizeDimensions": {
"dimensions": {
"sheetId": SHEET_ID,
"dimension": "COLUMNS",
"startIndex": 0,
"endIndex": 3
}
}
}
]
}স্বয়ংক্রিয়ভাবে একটি সারির আকার পরিবর্তন করুন
নিম্নলিখিত spreadsheets.batchUpdate কোড নমুনাটি দেখায় কিভাবে AutoResizeDimensionsRequest ব্যবহার করে প্রথম তিনটি সারির সারির উচ্চতা সাফ করতে হয়। এরপর প্রতিটি সারির কোষের বিষয়বস্তুর উপর ভিত্তি করে সারির উচ্চতা গতিশীলভাবে বৃদ্ধি পায়। dimension ক্ষেত্রটি নির্দেশ করে যে অপারেশনটি শীটের সারিতে প্রযোজ্য।
অনুরোধ প্রোটোকলটি নীচে দেখানো হয়েছে।
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate{
"requests": [
{
"autoResizeDimensions": {
"dimensions": {
"sheetId": SHEET_ID,
"dimension": "ROWS",
"startIndex": 0,
"endIndex": 3
}
}
}
]
}সারি বা কলাম মুছুন
নিম্নলিখিত spreadsheets.batchUpdate কোড নমুনাটি দেখায় যে কীভাবে DeleteDimensionRequest ব্যবহার করে একটি শীটের প্রথম তিনটি সারি মুছে ফেলা যায়। দ্বিতীয় অনুরোধটি কলাম B:D মুছে দেয়। dimension ক্ষেত্রটি নির্ধারণ করে যে অপারেশনটি একটি শীটের কলাম বা সারিতে প্রযোজ্য কিনা।
অনুরোধ প্রোটোকলটি নীচে দেখানো হয়েছে।
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate{
"requests": [
{
"deleteDimension": {
"range": {
"sheetId": SHEET_ID,
"dimension": "ROWS",
"startIndex": 0,
"endIndex": 3
}
}
},
{
"deleteDimension": {
"range": {
"sheetId": SHEET_ID,
"dimension": "COLUMNS",
"startIndex": 1,
"endIndex": 4
}
}
},
],
}একটি খালি সারি বা কলাম ঢোকান
নিম্নলিখিত spreadsheets.batchUpdate কোড নমুনাটি দেখায় কিভাবে InsertDimensionRequest ব্যবহার করে একটি নির্দিষ্ট সূচীতে কলাম বা সারি সন্নিবেশ করাতে হয় (যেমন একটি শীটের শীর্ষে খালি সারিগুলি প্রিপেন্ড করা)। প্রথম অনুরোধটি কলাম C-তে দুটি খালি কলাম সন্নিবেশ করায়। দ্বিতীয় অনুরোধটি সারি 1 থেকে শুরু করে তিনটি খালি সারি সন্নিবেশ করায়।
dimension ক্ষেত্রটি নির্ধারণ করে যে অপারেশনটি একটি শীটের কলাম বা সারিতে প্রযোজ্য কিনা।
যদি সত্য হয়, তাহলে inheritFromBefore ক্ষেত্রটি Sheets API-কে নতুন কলাম বা সারিগুলিকে পূর্ববর্তী সারি বা কলামের মতো একই বৈশিষ্ট্য দিতে বলে এবং যদি মিথ্যা হয়, তাহলে নতুন কলাম বা সারির পরে মাত্রা থেকে উত্তরাধিকারী হতে বলে। সারি ১-এ একটি সারি বা কলাম A-তে একটি কলাম সন্নিবেশ করালে inheritFromBefore সত্য হতে পারে না।
অনুরোধ প্রোটোকলটি নীচে দেখানো হয়েছে।
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate{
"requests": [
{
"insertDimension": {
"range": {
"sheetId": SHEET_ID,
"dimension": "COLUMNS",
"startIndex": 2,
"endIndex": 4
},
"inheritFromBefore": true
}
},
{
"insertDimension": {
"range": {
"sheetId": SHEET_ID,
"dimension": "ROWS",
"startIndex": 0,
"endIndex": 3
},
"inheritFromBefore": false
}
},
],
}একটি সারি বা কলাম সরান
নিম্নলিখিত spreadsheets.batchUpdate কোড নমুনাটি দেখায় কিভাবে MoveDimensionRequest ব্যবহার করে কলাম A কে কলাম D অবস্থানে সরাতে হয়। দ্বিতীয় অনুরোধটি ৫-১০ নম্বর সারিকে ২০ নম্বর সারি অবস্থানে নিয়ে যায়।
dimension ক্ষেত্র নির্ধারণ করে যে অপারেশনটি কোনও শীটের কলাম বা সারিতে প্রযোজ্য কিনা। destinationIndex ক্ষেত্র নির্ধারণ করে যে শূন্য-ভিত্তিক শুরু সূচক ব্যবহার করে উৎস ডেটা কোথায় সরানো হবে।
অনুরোধ প্রোটোকলটি নীচে দেখানো হয়েছে।
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate{
"requests": [
{
"moveDimension": {
"source": {
"sheetId": SHEET_ID,
"dimension": "COLUMNS",
"startIndex": 0,
"endIndex": 1
},
"destinationIndex": 3
}
},
{
"moveDimension": {
"source": {
"sheetId": SHEET_ID,
"dimension": "ROWS",
"startIndex": 4,
"endIndex": 10
},
"destinationIndex": 19
}
},
],
}