শীট অপারেশন

Google Sheets API আপনাকে শীট তৈরি করতে, সাফ করতে, অনুলিপি করতে এবং মুছে ফেলতে এবং তাদের বৈশিষ্ট্যগুলিকে নিয়ন্ত্রণ করতে দেয়। এই পৃষ্ঠার উদাহরণগুলি ব্যাখ্যা করে যে আপনি কীভাবে শীট API এর সাথে কিছু সাধারণ পত্রক অপারেশনগুলি অর্জন করতে পারেন৷

এই উদাহরণগুলি ভাষা নিরপেক্ষ হওয়ার জন্য HTTP অনুরোধের আকারে উপস্থাপন করা হয়েছে। Google API ক্লায়েন্ট লাইব্রেরি ব্যবহার করে কিভাবে বিভিন্ন ভাষায় একটি ব্যাচ আপডেট বাস্তবায়ন করতে হয় তা জানতে, স্প্রেডশীট আপডেট করুন দেখুন।

এই উদাহরণগুলিতে, স্থানধারক SPREADSHEET_ID এবং SHEET_ID নির্দেশ করে যে আপনি সেই IDগুলি কোথায় দেবেন৷ আপনি স্প্রেডশীট ইউআরএলে স্প্রেডশীট আইডি খুঁজে পেতে পারেন। আপনি spreadsheets.get পদ্ধতি ব্যবহার করে শীট আইডি পেতে পারেন। A1 স্বরলিপি ব্যবহার করে রেঞ্জগুলি নির্দিষ্ট করা হয়েছে। একটি উদাহরণ পরিসীমা হল Sheet1!A1:D5।

একটি শীট যোগ করুন

নিচের spreadsheets.batchUpdate কোড নমুনাটি দেখায় কিভাবে একটি স্প্রেডশীটে একটি শীট যোগ করতে AddSheetRequest ব্যবহার করতে হয়, পাশাপাশি শিরোনাম, গ্রিডের আকার এবং ট্যাবের রঙ সেট করে।

প্রতিক্রিয়া একটি AddSheetResponse নিয়ে গঠিত, যেটিতে তৈরি শীটের বৈশিষ্ট্য সহ একটি বস্তু রয়েছে (যেমন এর SHEET_ID )।

অনুরোধ প্রোটোকল নীচে দেখানো হয়েছে.

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
          }
        }
      }
    }
  ]
}

বিন্যাস সংরক্ষণ করার সময় সমস্ত মানগুলির একটি শীট সাফ করুন

নিম্নলিখিত spreadsheets.batchUpdate কোড নমুনা দেখায় যে ফর্ম্যাটিং অপরিবর্তিত রেখে একটি শীট থেকে সমস্ত মান মুছে ফেলার জন্য কিভাবে UpdateCellsRequest ব্যবহার করতে হয়।

সংশ্লিষ্ট মান ছাড়াই userEnteredValue ক্ষেত্রটি নির্দিষ্ট করাকে পরিসরের মানগুলি পরিষ্কার করার নির্দেশ হিসাবে ব্যাখ্যা করা হয়। এই সেটিং অন্যান্য ক্ষেত্রের সাথেও ব্যবহার করা যেতে পারে। উদাহরণ স্বরূপ, fields মান পরিবর্তন করে userEnteredFormat পত্রক থেকে Sheets API দ্বারা সমর্থিত সমস্ত বিন্যাস সরিয়ে দেয়, কিন্তু ঘরের মানগুলি অপরিবর্তিত রাখে।

অনুরোধ প্রোটোকল নীচে দেখানো হয়েছে.

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate

{
  "requests": [
    {
      "updateCells": {
        "range": {
          "sheetId": SHEET_ID
        },
        "fields": "userEnteredValue"
      }
    }
  ]
}

একটি স্প্রেডশীট থেকে অন্য একটি শীট অনুলিপি করুন

নিম্নলিখিত spreadsheet.sheets.copyTo কোড নমুনা দেখায় কিভাবে SHEET_ID দ্বারা নির্দিষ্ট একটি একক শীট একটি স্প্রেডশীট থেকে অন্য স্প্রেডশীটে অনুলিপি করা যায়৷

অনুরোধের অংশে TARGET_SPREADSHEET_ID ভেরিয়েবলটি গন্তব্য স্প্রেডশীটটি নির্দিষ্ট করে৷ কপিটি মূলের সমস্ত মান, বিন্যাস, সূত্র এবং অন্যান্য বৈশিষ্ট্য বজায় রাখে। অনুলিপি করা পত্রকের শিরোনাম "[মূল পত্রকের শিরোনাম] কপি" এ সেট করা হয়েছে।

প্রতিক্রিয়া তৈরি করা শীটের বৈশিষ্ট্য বর্ণনা করে একটি SheetProperties অবজেক্ট নিয়ে গঠিত।

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID/sheets/SHEET_ID:copyTo

{
  "destinationSpreadsheetId": "TARGET_SPREADSHEET_ID"
}

একটি শীট মুছুন

নিম্নলিখিত spreadsheets.batchUpdate কোড নমুনাটি দেখায় যে কীভাবে SHEET_ID দ্বারা নির্দিষ্ট করা একটি শীট মুছতে DeleteSheetRequest ব্যবহার করতে হয়।

অনুরোধ প্রোটোকল নীচে দেখানো হয়েছে.

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate

{
  "requests": [
    {
      "deleteSheet": {
        "sheetId": SHEET_ID
      }
    }
  ]
}

শীট ডেটা পড়ুন

SHEET_ID এবং SPREADSHEET_ID দ্বারা নির্দিষ্ট করা স্প্রেডশীট থেকে কীভাবে শীট সম্পত্তির তথ্য পেতে হয় তা নিম্নলিখিত spreadsheets.get কোড নমুনাটি দেখায়। এই পদ্ধতিটি প্রায়শই একটি নির্দিষ্ট স্প্রেডশীটের মধ্যে শীটগুলির মেটাডেটা নির্ধারণ করতে ব্যবহৃত হয়, তাই অতিরিক্ত অপারেশনগুলি সেই শীটগুলিকে লক্ষ্য করতে পারে৷ fields ক্যোয়ারী প্যারামিটার নির্দিষ্ট করে শুধুমাত্র শীট সম্পত্তি ডেটা ফেরত দেওয়া উচিত (সেলের মান ডেটা বা সমগ্র স্প্রেডশীটের সাথে সম্পর্কিত ডেটার বিপরীতে)।

GET https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID?&fields=sheets.properties

প্রতিক্রিয়াটিতে একটি Spreadsheet সংস্থান রয়েছে, যেটিতে SheetProperties উপাদান সহ একটি Sheet বস্তু রয়েছে। একটি প্রদত্ত প্রতিক্রিয়া ক্ষেত্র ডিফল্ট মান সেট করা হলে, এটি প্রতিক্রিয়া থেকে বাদ দেওয়া হয়।

{
  "sheets": [
    {
      "properties": {
        "sheetId": SHEET_ID,
        "title": "Sheet1",
        "index": 0,
        "sheetType": "GRID",
        "gridProperties": {
          "rowCount": 100,
          "columnCount": 20,
          "frozenRowCount": 1
        }
        "tabColor": {
          "blue": 1.0
        }
      },
      ...
  ],
}