গুগল শিটস এপিআই আপনাকে শিটে সারি এবং কলাম যোগ করতে, সরাতে এবং পরিবর্তন করতে দেয়। এই পৃষ্ঠার উদাহরণগুলিতে দেখানো হয়েছে কিভাবে শিটস এপিআই ব্যবহার করে কিছু সাধারণ সারি এবং কলাম অপারেশন সম্পন্ন করা যায়।
ভাষা নিরপেক্ষতার জন্য এই উদাহরণগুলো HTTP অনুরোধ আকারে উপস্থাপন করা হয়েছে। গুগল এপিআই ক্লায়েন্ট লাইব্রেরি ব্যবহার করে বিভিন্ন ভাষায় কীভাবে ব্যাচ আপডেট বাস্তবায়ন করতে হয় তা জানতে, “স্প্রেডশিট আপডেট করুন” দেখুন।
এই উদাহরণগুলিতে, SPREADSHEET_ID এবং SHEET_ID প্লেসহোল্ডারগুলি নির্দেশ করে যে আপনি কোথায় সেই আইডিগুলি প্রদান করবেন। আপনি স্প্রেডশিট URL-এ স্প্রেডশিট আইডি খুঁজে পেতে পারেন। আপনি spreadsheets.get মেথড ব্যবহার করে শীট আইডি পেতে পারেন। রেঞ্জগুলি A1 নোটেশন ব্যবহার করে নির্দিষ্ট করা হয়। একটি উদাহরণ রেঞ্জ হল Sheet1!A1:D5।
কলামের প্রস্থ বা সারির উচ্চতা সামঞ্জস্য করুন
নিম্নলিখিত spreadsheets.batchUpdate কোড নমুনাটি দেখায় কিভাবে UpdateDimensionPropertiesRequest ব্যবহার করে কলাম A-এর width প্রপার্টিকে ১৬০ পিক্সেলে আপডেট করা যায়। দ্বিতীয় একটি অনুরোধ প্রথম তিনটি সারির row height প্রপার্টিকে ৪০ পিক্সেলে আপডেট করে। 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 কোড নমুনাটি দেখায় কিভাবে কলামের বিষয়বস্তুর আকারের উপর ভিত্তি করে A:C কলামগুলির আকার পরিবর্তন করতে AutoResizeDimensionsRequest ব্যবহার করতে হয়। 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 কলামে দুটি খালি কলাম সন্নিবেশ করে। দ্বিতীয় অনুরোধটি সারি ১ থেকে শুরু করে তিনটি খালি সারি সন্নিবেশ করে।
dimension ফিল্ডটি নির্ধারণ করে যে অপারেশনটি একটি শীটের কলামে নাকি সারিতে প্রযোজ্য হবে।
যদি inheritFromBefore ফিল্ডটির মান `true` হয়, তবে এটি শীটস এপিআই-কে নির্দেশ দেয় যেন নতুন কলাম বা সারিগুলো পূর্ববর্তী সারি বা কলামের মতোই বৈশিষ্ট্য পায়। আর যদি `false` হয়, তবে এটি নতুন কলাম বা সারির পরের ডাইমেনশনগুলো থেকে বৈশিষ্ট্য গ্রহণ করে। সারি ১-এ একটি সারি অথবা কলাম A-তে একটি কলাম যোগ করার ক্ষেত্রে inheritFromBefore কখনোই `true` হতে পারে না।
অনুরোধ প্রোটোকলটি নিচে দেখানো হলো।
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
}
},
],
}