মৌলিক বিন্যাস

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

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

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

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

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

কক্ষের সীমানা সম্পাদনা করুন

নিম্নলিখিত spreadsheets.batchUpdate কোড নমুনাটি দেখায় কিভাবে UpdateBordersRequest ব্যবহার করে A1:F10 রেঞ্জের প্রতিটি সেলকে একটি ড্যাশযুক্ত, নীল উপরের এবং নীচের সীমানা দিতে হয়। innerHorizontal ক্ষেত্রটি রেঞ্জের অভ্যন্তরে অনুভূমিক সীমানা তৈরি করে। ক্ষেত্রটি বাদ দিলে কেবল পুরো রেঞ্জের উপরে এবং নীচের সীমানা যুক্ত হবে।

৩ বাই ৩ টেবিল, প্রতিটি কক্ষে ড্যাশযুক্ত, নীল উপরে এবং নীচের সীমানা থাকবে।
চিত্র ১. প্রতিটি ঘরকে একটি ড্যাশযুক্ত, নীল উপরে এবং নীচের সীমানা দিয়ে একটি শীটে ফর্ম্যাট করুন।

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

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
  "requests": [
    {
      "updateBorders": {
        "range": {
          "sheetId": SHEET_ID,
          "startRowIndex": 0,
          "endRowIndex": 10,
          "startColumnIndex": 0,
          "endColumnIndex": 6
        },
        "top": {
          "style": "DASHED",
          "width": 1,
          "color": {
            "blue": 1.0
          },
        },
        "bottom": {
          "style": "DASHED",
          "width": 1,
          "color": {
            "blue": 1.0
          },
        },
        "innerHorizontal": {
          "style": "DASHED",
          "width": 1,
          "color": {
            "blue": 1.0
          },
        },
      }
    }
  ]
}

একটি হেডার সারি ফর্ম্যাট করুন

নিম্নলিখিত spreadsheets.batchUpdate কোড নমুনাটি দেখায় কিভাবে RepeatCellRequest ব্যবহার করে একটি শিটে হেডার সারি ফরম্যাট করতে হয়। প্রথম অনুরোধটি টেক্সটের রঙ, ব্যাকগ্রাউন্ড কালার, টেক্সট ফন্ট সাইজ এবং টেক্সটের ন্যায্যতা আপডেট করে এবং টেক্সটকে বোল্ড করে। range ফিল্ডে কলাম সূচকগুলি বাদ দিলে পুরো সারিটি ফরম্যাট হয়ে যায়। দ্বিতীয় অনুরোধটি শিটের বৈশিষ্ট্যগুলিকে সামঞ্জস্য করে যাতে হেডার সারিটি হিমায়িত হয়।

একটি শিটে একটি ফর্ম্যাট করা হেডার সারি সহ ৩ বাই ৩ টেবিল।
চিত্র ২। একটি শীটে হেডার সারিটি ফর্ম্যাট করুন।

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

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
  "requests": [
    {
      "repeatCell": {
        "range": {
          "sheetId": SHEET_ID,
          "startRowIndex": 0,
          "endRowIndex": 1
        },
        "cell": {
          "userEnteredFormat": {
            "backgroundColor": {
              "red": 0.0,
              "green": 0.0,
              "blue": 0.0
            },
            "horizontalAlignment" : "CENTER",
            "textFormat": {
              "foregroundColor": {
                "red": 1.0,
                "green": 1.0,
                "blue": 1.0
              },
              "fontSize": 12,
              "bold": true
            }
          }
        },
        "fields": "userEnteredFormat(backgroundColor,textFormat,horizontalAlignment)"
      }
    },
    {
      "updateSheetProperties": {
        "properties": {
          "sheetId": SHEET_ID,
          "gridProperties": {
            "frozenRowCount": 1
          }
        },
        "fields": "gridProperties.frozenRowCount"
      }
    }
  ]
}

কোষগুলি মার্জ করুন

নিম্নলিখিত spreadsheets.batchUpdate কোড নমুনাটি দেখায় কিভাবে MergeCellsRequest ব্যবহার করে কোষগুলিকে একত্রিত করতে হয়। প্রথম অনুরোধটি A1:B2 পরিসরকে একটি একক কক্ষে একত্রিত করে। দ্বিতীয় অনুরোধটি A3:B6 এর কলামগুলিকে একত্রিত করে, এবং সারিগুলিকে পৃথক করে।

একটি শীটে মার্জ করা ঘর সহ ৩ বাই ৩ টেবিল।
চিত্র ৩। একটি শীটে কোষ একত্রিত করুন।

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

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
  "requests": [
    {
      "mergeCells": {
        "range": {
          "sheetId": SHEET_ID,
          "startRowIndex": 0,
          "endRowIndex": 2,
          "startColumnIndex": 0,
          "endColumnIndex": 2
        },
        "mergeType": "MERGE_ALL"
      }
    },
    {
      "mergeCells": {
        "range": {
          "sheetId": SHEET_ID,
          "startRowIndex": 2,
          "endRowIndex": 6,
          "startColumnIndex": 0,
          "endColumnIndex": 2
        },
        "mergeType": "MERGE_COLUMNS"
      }
    },
  ]
}

একটি ব্যাপ্তির জন্য একটি কাস্টম তারিখ সময় বা দশমিক বিন্যাস সেট করুন

নিম্নলিখিত spreadsheets.batchUpdate কোড নমুনাটি দেখায় কিভাবে RepeatCellRequest ব্যবহার করে সেল আপডেট করে কাস্টম ডেটটাইম এবং নম্বর ফর্ম্যাট তৈরি করতে হয়। প্রথম অনুরোধটি A1:A10 রেঞ্জের সেলগুলিকে কাস্টম ডেটটাইম ফর্ম্যাট hh:mm:ss am/pm, ddd mmm dd yyyy দেয়। এই ফর্ম্যাটে একটি উদাহরণ ডেটটাইম হল: "02:05:07 PM, Sun Apr 03 2016"।

দ্বিতীয় অনুরোধটি B1:B10 এর কোষগুলিকে #,##0.0000 কাস্টম সংখ্যা বিন্যাস দেয়, যা নির্দেশ করে যে সংখ্যাগুলিকে কমা বিভাজক দিয়ে গোষ্ঠীভুক্ত করা উচিত, দশমিকের পরে 4টি সংখ্যা থাকা উচিত এবং একটি অগ্রণী শূন্য ছাড়া বাকি সমস্ত বাদ দেওয়া উচিত। উদাহরণস্বরূপ, "3.14" সংখ্যাটি "3.1400" হিসাবে রেন্ডার করা হয়েছে, যেখানে "12345.12345" "12,345.1235" হিসাবে রেন্ডার করা হয়েছে।

আরও তথ্যের জন্য, তারিখ এবং সংখ্যা বিন্যাস দেখুন।

একটি শীটে কাস্টম তারিখ-সময় এবং সংখ্যা বিন্যাস সহ 3 বাই 3 টেবিল।
চিত্র ৪। একটি শীটে কাস্টম তারিখ-সময় এবং সংখ্যা বিন্যাস রাখার জন্য ঘরগুলি আপডেট করুন।

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

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
  "requests": [
    {
      "repeatCell": {
        "range": {
          "sheetId": SHEET_ID,
          "startRowIndex": 0,
          "endRowIndex": 10,
          "startColumnIndex": 0,
          "endColumnIndex": 1
        },
        "cell": {
          "userEnteredFormat": {
            "numberFormat": {
              "type": "DATE",
              "pattern": "hh:mm:ss am/pm, ddd mmm dd yyyy"
            }
          }
        },
        "fields": "userEnteredFormat.numberFormat"
      }
    },
    {
      "repeatCell": {
        "range": {
          "sheetId": SHEET_ID,
          "startRowIndex": 0,
          "endRowIndex": 10,
          "startColumnIndex": 1,
          "endColumnIndex": 2
        },
        "cell": {
          "userEnteredFormat": {
            "numberFormat": {
              "type": "NUMBER",
              "pattern": "#,##0.0000"
            }
          }
        },
        "fields": "userEnteredFormat.numberFormat"
      }
    }
  ]
}