শীট অপারেশন

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

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

এই উদাহরণগুলিতে, স্থানধারক SPREADSHEET_ID এবং SHEET_ID নির্দেশ করে যে আপনি কোথায় এই আইডিগুলি প্রদান করবেন। আপনি স্প্রেডশিট URL-এ স্প্রেডশিট আইডি খুঁজে পেতে পারেন। আপনি 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
      }
    }
  ]
}

শিটের ডেটা পড়ুন

নিম্নলিখিত spreadsheets.get কোড নমুনাটি দেখায় কিভাবে SHEET_ID এবং SPREADSHEET_ID দ্বারা নির্দিষ্ট করা স্প্রেডশিট থেকে শীট সম্পত্তির তথ্য পেতে হয়। এই পদ্ধতিটি প্রায়শই একটি নির্দিষ্ট স্প্রেডশিটের মধ্যে শীটের মেটাডেটা নির্ধারণ করতে ব্যবহৃত হয়, তাই অতিরিক্ত ক্রিয়াকলাপগুলি সেই শীটগুলিকে লক্ষ্য করতে পারে। 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
        }
      },
      ...
  ],
}