মৌলিক লেখা

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

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

যাইহোক, সাধারণ মানের লেখার জন্য spreadsheets.values.update পদ্ধতি বা spreadsheets.values.batchUpdate পদ্ধতি ব্যবহার করা সহজ।

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

এই উদাহরণগুলিতে, স্থানধারক SPREADSHEET_ID নির্দেশ করে যেখানে আপনি স্প্রেডশীট আইডি প্রদান করবেন, যা স্প্রেডশীট URL থেকে আবিষ্কার করা যেতে পারে। যে ব্যাপ্তিতে লিখতে হবে তা A1 স্বরলিপি ব্যবহার করে নির্দিষ্ট করা হয়েছে। একটি উদাহরণ পরিসীমা হল Sheet1!A1:D5।

একটি একক পরিসীমা লিখুন

একটি নতুন, ফাঁকা স্প্রেডশীট দিয়ে শুরু করে, নিচের spreadsheets.values.update কোড নমুনাটি দেখায় কিভাবে একটি পরিসরে মান লিখতে হয়। ValueInputOption ক্যোয়ারী প্যারামিটার প্রয়োজন এবং লিখিত মান পার্স করা হয়েছে কিনা তা নির্ধারণ করে (উদাহরণস্বরূপ, একটি স্ট্রিং একটি তারিখে রূপান্তরিত হয় কিনা)।

রিকোয়েস্ট বডি হল একটি ValueRange অবজেক্ট যা লেখার জন্য পরিসীমা মান বর্ণনা করে। majorDimension ক্ষেত্রটি নির্দেশ করে যে অ্যারেগুলি সারি দ্বারা সংগঠিত মানগুলির তালিকা। লক্ষ্য পরিসরে বিদ্যমান মানগুলি ওভাররাইট করা হয়েছে৷

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

PUT https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID/values/Sheet1!A1:D5?valueInputOption=VALUE_INPUT_OPTION

{
  "range": "Sheet1!A1:D5",
  "majorDimension": "ROWS",
  "values": [
    ["Item", "Cost", "Stocked", "Ship Date"],
    ["Wheel", "$20.50", "4", "3/1/2016"],
    ["Door", "$15", "2", "3/15/2016"],
    ["Engine", "$100", "1", "3/20/2016"],
    ["Totals", "=SUM(B2:B4)", "=SUM(C2:C4)", "=MAX(D2:D4)"]
  ],
}

প্রতিক্রিয়া একটি UpdateValuesResponse অবজেক্ট নিয়ে গঠিত, যেমন এটি:

{
  "spreadsheetId": SPREADSHEET_ID,
  "updatedRange": "Sheet1!A1:D5",
  "updatedRows": 5,
  "updatedColumns": 4,
  "updatedCells": 20,
}

ফলস্বরূপ শীট নিম্নলিখিত মত দেখায়:

	ক	খ	গ	ডি
1	আইটেম	খরচ	মজুদকৃত	জাহাজের তারিখ
2	চাকা	$20.50	4	3/1/2016
3	দরজা	$15	2	3/15/2016
4	ইঞ্জিন	$100	1	3/20/2016
5	মোট	$135.5	7	3/20/2016

একটি পরিসরে বেছে বেছে লিখুন

একটি পরিসরে মান লেখার সময়, সংশ্লিষ্ট অ্যারের উপাদানগুলিকে null এ সেট করে কিছু বিদ্যমান ঘর পরিবর্তন করা এড়াতে এটি সম্ভব। এটিতে একটি খালি স্ট্রিং ( "" ) লিখে একটি ঘর সাফ করাও সম্ভব।

উপরের উদাহরণ দ্বারা উত্পাদিত একই ডেটা সম্বলিত একটি শীট দিয়ে শুরু করে, নিম্নলিখিত spreadsheets.values.update কোড নমুনাটি দেখায় যে কীভাবে মানগুলিকে B1:D4 রেঞ্জে লিখতে হয়, বেছে বেছে কিছু ঘর অপরিবর্তিত রেখে অন্যগুলি পরিষ্কার করে৷ ValueInputOption ক্যোয়ারী প্যারামিটার প্রয়োজন এবং লিখিত মান পার্স করা হয়েছে কিনা তা নির্ধারণ করে (উদাহরণস্বরূপ, একটি স্ট্রিং একটি তারিখে রূপান্তরিত হয় কিনা)।

রিকোয়েস্ট বডি হল একটি ValueRange অবজেক্ট যা লেখার জন্য পরিসীমা মান বর্ণনা করে। majorDimension ক্ষেত্র নির্দেশ করে যে অ্যারেগুলি কলাম দ্বারা সংগঠিত মানগুলির তালিকা।

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

PUT https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID/values/Sheet1!B1?valueInputOption=VALUE_INPUT_OPTION

{
  "range": "Sheet1!B1",
  "majorDimension": "COLUMNS",
  "values": [
    [null,"$1","$2", ""],
    [],
    [null,"4/1/2016", "4/15/2016", ""]
  ]
}

এখানে values ক্ষেত্রটি পরিসরের প্রতিটি কলামে করা পরিবর্তনগুলি তালিকাভুক্ত করে। প্রথম অ্যারে নির্দেশ করে যে B1 অপরিবর্তিত রাখা হবে ( null অ্যারে উপাদানের কারণে), যখন B4 সাফ করা হবে (খালি স্ট্রিং)। B2 এবং B3 তাদের মান আপডেট করা হয়েছে। তৃতীয় অ্যারেটি কলাম D-এ একই ক্রিয়াকলাপ সম্পাদন করে, যখন দ্বিতীয় খালি অ্যারে নির্দেশ করে যে কলাম C অপরিবর্তিত থাকতে হবে।

প্রতিক্রিয়াটিতে একটি UpdateValuesResponse অবজেক্ট থাকে যেমন এটি:

{
  "spreadsheetId": SPREADSHEET_ID,
  "updatedRange": "Sheet1!B1:D5",
  "updatedRows": 3,
  "updatedColumns": 2,
  "updatedCells": 6,
}

ফলস্বরূপ শীট নিম্নলিখিত মত দেখায়:

	ক	খ	গ	ডি
1	আইটেম	খরচ	মজুদকৃত	জাহাজের তারিখ
2	চাকা	$1.00	4	4/1/2016
3	দরজা	$2	2	4/15/2016
4	ইঞ্জিন		1
5	মোট	$3.00	7	4/15/2016

মনে রাখবেন যে "মোট" সারি, এই অনুরোধ দ্বারা সরাসরি পরিবর্তিত না হলেও, পরিবর্তিত হয় কারণ এর কোষগুলিতে সূত্র রয়েছে যা পরিবর্তিত কোষের উপর নির্ভর করে।

একাধিক রেঞ্জে লিখুন

একটি ফাঁকা শীট দিয়ে শুরু করে, নিম্নলিখিত spreadsheets.values.batchUpdate কোড নমুনাটি দেখায় কিভাবে শীট1!A1:A4 এবং পত্রক1!B1:D2 রেঞ্জে মানগুলি লিখতে হয়৷ লক্ষ্য পরিসরে বিদ্যমান মানগুলি ওভাররাইট করা হয়েছে৷ রিকোয়েস্ট বডিতে একটি ValueInputOption অবজেক্ট থাকে যা দেখায় কিভাবে ইনপুট ডেটা এবং ValueRange অবজেক্টের একটি বিন্যাস লিখিত প্রতিটি ব্যাপ্তির সাথে সম্পর্কিত। majorDimension ক্ষেত্র নির্ধারণ করে যে অন্তর্ভুক্ত অ্যারেগুলিকে কলাম বা সারির অ্যারে হিসাবে ব্যাখ্যা করা হয়।

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

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

{
  "valueInputOption": "VALUE_INPUT_OPTION",
  "data": [
    {
      "range": "Sheet1!A1:A4",
      "majorDimension": "COLUMNS",
      "values": [
        ["Item", "Wheel", "Door", "Engine"]
      ]
    },
    {
      "range": "Sheet1!B1:D2",
      "majorDimension": "ROWS",
      "values": [
        ["Cost", "Stocked", "Ship Date"],
        ["$20.50", "4", "3/1/2016"]
      ]
    }
  ]
}

প্রতিক্রিয়াটি এমন একটি অবজেক্ট নিয়ে গঠিত যা আপডেট করা সেল পরিসংখ্যান এবং UpdateValuesResponse অবজেক্টের একটি অ্যারের তালিকা করে, প্রতিটি আপডেট করা পরিসরের জন্য একটি। উদাহরণ স্বরূপ:

{
  "spreadsheetId": SPREADSHEET_ID,
  "totalUpdatedRows": 4,
  "totalUpdatedColumns": 4,
  "totalUpdatedCells": 10,
  "totalUpdatedSheets": 1,
  "responses": [
    {
      "spreadsheetId": SPREADSHEET_ID,
      "updatedRange": "Sheet1!A1:A4",
      "updatedRows": 4,
      "updatedColumns": 1,
      "updatedCells": 4,
    },
    {
      "spreadsheetId": SPREADSHEET_ID,
      "updatedRange": "Sheet1!B1:D2",
      "updatedRows": 2,
      "updatedColumns": 3,
      "updatedCells": 6,
    }
  ],
}

ফলস্বরূপ শীট নিম্নলিখিত মত দেখায়:

	ক	খ	গ	ডি
1	আইটেম	খরচ	মজুদকৃত	জাহাজের তারিখ
2	চাকা	$20.50	4	3/1/2016
3	দরজা
4	ইঞ্জিন
5

পার্সিং ছাড়াই মান লিখুন

একটি ফাঁকা শীট দিয়ে শুরু করে, নিম্নলিখিত spreadsheets.values.update কোড নমুনাটি দেখায় কিভাবে শীট1!A1:E1 রেঞ্জে মানগুলি লিখতে হয়, তবে লিখিত স্ট্রিংগুলিকে সূত্র, বুলিয়ান, হিসাবে পার্স করা থেকে রোধ করতে RAW ValueInputOption ক্যোয়ারী প্যারামিটার ব্যবহার করে। বা সংখ্যা। এগুলি স্ট্রিং হিসাবে উপস্থিত হয় এবং টেক্সট সারিবদ্ধকরণটি শীটে ন্যায়সঙ্গত হয়৷

রিকোয়েস্ট বডি হল একটি ValueRange অবজেক্ট যা লেখার জন্য পরিসীমা মান বর্ণনা করে। majorDimension ক্ষেত্রটি নির্দেশ করে যে অ্যারেগুলি সারি দ্বারা সংগঠিত মানগুলির তালিকা। লক্ষ্য পরিসরে বিদ্যমান মানগুলি ওভাররাইট করা হয়েছে৷

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

PUT https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID/values/Sheet1!A1:E1?valueInputOption=RAW

{
  "range": "Sheet1!A1:E1",
  "majorDimension": "ROWS",
  "values": [
    ["Data", 123.45, true, "=MAX(D2:D4)", "10"]
  ],
}

প্রতিক্রিয়াটিতে একটি UpdateValuesResponse অবজেক্ট থাকে যেমন এটি:

{
  "spreadsheetId": SPREADSHEET_ID,
  "updatedRange": "Sheet1!A1:E1",
  "updatedRows": 1,
  "updatedColumns": 5,
  "updatedCells": 5,
}

ফলস্বরূপ শীট নিম্নলিখিত মত দেখায়:

	ক	খ	গ	ডি	ই
1	ডেটা	123.45	সত্য	=MAX(D2:D4)	10
2

মনে রাখবেন যে "TRUE" কেন্দ্রীভূত এবং একটি বুলিয়ান মান, যেখানে "123.45" সঠিক কারণ এটি একটি সংখ্যা, এবং "10" ন্যায়সঙ্গত বামে কারণ এটি একটি স্ট্রিং। সূত্রটি পার্স করা হয় না এবং এটি একটি স্ট্রিং হিসাবেও উপস্থিত হয়৷

মান যোগ করুন

নীচের টেবিলের মত একটি শীট দিয়ে শুরু করুন:

	ক	খ	গ	ডি
1	আইটেম	খরচ	মজুদকৃত	জাহাজের তারিখ
2	চাকা	$20.50	4	3/1/2016
3

নিম্নোক্ত spreadsheets.values.append কোড নমুনা দেখায় কিভাবে সারি 3 থেকে শুরু করে দুটি নতুন সারি মান যুক্ত করতে হয়। ValueInputOption ক্যোয়ারী প্যারামিটার প্রয়োজন এবং লিখিত মানগুলি পার্স করা হয়েছে কিনা তা নির্ধারণ করে (উদাহরণস্বরূপ, একটি স্ট্রিং রূপান্তরিত হবে কি না তারিখ)।

রিকোয়েস্ট বডি হল একটি ValueRange অবজেক্ট যা লেখার জন্য পরিসীমা মান বর্ণনা করে। majorDimension ক্ষেত্রটি নির্দেশ করে যে অ্যারেগুলি সারি দ্বারা সংগঠিত মানগুলির তালিকা।

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

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID/values/Sheet1!A1:E1:append?valueInputOption=VALUE_INPUT_OPTION

{
  "range": "Sheet1!A1:E1",
  "majorDimension": "ROWS",
  "values": [
    ["Door", "$15", "2", "3/15/2016"],
    ["Engine", "$100", "1", "3/20/2016"],
  ],
}

প্রতিক্রিয়াটি একটি AppendValuesResponse অবজেক্ট নিয়ে গঠিত যেমন এটি:

{
  "spreadsheetId": SPREADSHEET_ID,
  "tableRange": "Sheet1!A1:D2",
  "updates": {
    "spreadsheetId": SPREADSHEET_ID,
    "updatedRange": "Sheet1!A3:D4",
    "updatedRows": 2,
    "updatedColumns": 4,
    "updatedCells": 8,
  }
}

ফলস্বরূপ শীট নিম্নলিখিত মত দেখায়:

	ক	খ	গ	ডি
1	আইটেম	খরচ	মজুদকৃত	জাহাজের তারিখ
2	চাকা	$20.50	4	3/1/2016
3	দরজা	$15	2	3/15/2016
4	ইঞ্জিন	$100	1	3/20/2016
5