সারি & কলাম অপারেশন

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

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

এই উদাহরণগুলিতে, স্থানধারক SPREADSHEET_ID এবং SHEET_ID নির্দেশ করে যে আপনি সেই IDগুলি কোথায় দেবেন৷ আপনি স্প্রেডশীট ইউআরএলে স্প্রেডশীট আইডি খুঁজে পেতে পারেন। আপনি 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 কোডের নমুনাটি কলামের বিষয়বস্তুর আকারের উপর ভিত্তি করে কলাম 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 ব্যবহার করতে হয় (যেমন একটি শীটের শীর্ষে খালি সারি প্রিপেন্ড করা)। প্রথম অনুরোধটি সি কলামে দুটি খালি কলাম সন্নিবেশ করায়। দ্বিতীয় অনুরোধটি 1 সারি থেকে শুরু করে তিনটি খালি সারি সন্নিবেশ করায়।

dimension ক্ষেত্র নির্ধারণ করে যে অপারেশনটি একটি পত্রকের কলাম বা সারিতে প্রযোজ্য কিনা।

সত্য হলে, inheritFromBefore ক্ষেত্রটি Sheets API-কে নতুন কলাম বা সারিগুলিকে আগের সারি বা কলামের মতো একই বৈশিষ্ট্য দিতে এবং মিথ্যা হলে, নতুন কলাম বা সারির পরের মাত্রাগুলি থেকে উত্তরাধিকারী হতে বলে৷ inheritFromBefore সত্য হতে পারে না যদি সারি 1 এ একটি সারি বা কলাম A এ একটি কলাম সন্নিবেশ করা হয়।

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

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 কোড নমুনাটি দেখায় কিভাবে কলাম A কে কলাম D অবস্থানে সরাতে MoveDimensionRequest ব্যবহার করতে হয়। একটি দ্বিতীয় অনুরোধ সারি 5-10 সারি 20 অবস্থানে নিয়ে যায়।

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