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

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

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

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

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

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

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

নিচের spreadsheets.batchUpdate কোড নমুনাটি দেখায় কিভাবে A1:F10 রেঞ্জের প্রতিটি সেলকে একটি ড্যাশ, নীল উপরে এবং নীচের সীমানা দিতে UpdateBordersRequest ব্যবহার করতে হয়। 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, রবিবার 03 এপ্রিল 2016"।

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

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

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