মৌলিক পড়া

Google Sheets API আপনাকে কক্ষ, ব্যাপ্তি, রেঞ্জের সেট এবং সম্পূর্ণ শীট থেকে মান পড়তে দেয়। এই পৃষ্ঠার উদাহরণ spreadsheets.values সম্পদের সাথে কিছু সাধারণ পঠিত ক্রিয়াকলাপকে চিত্রিত করে। এছাড়াও আপনি spreadsheets.get পদ্ধতি ব্যবহার করে ঘরের মান পড়তে পারেন, তবে সাধারণত spreadsheets.values.get বা spreadsheets.values.batchGet সহজ।

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

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

উৎস তথ্য

এই উদাহরণগুলির জন্য, অনুমান করুন যে স্প্রেডশীটটি পড়া হচ্ছে তার প্রথম শীটে ("শীট1") নিম্নলিখিত উত্স ডেটা রয়েছে৷ প্রথম সারির স্ট্রিংগুলি পৃথক কলামগুলির জন্য লেবেল। আপনার স্প্রেডশীটে অন্যান্য শীট থেকে কীভাবে পড়তে হয় তার উদাহরণ দেখতে, A1 স্বরলিপি দেখুন।

ডি
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

একটি একক পরিসীমা পড়ুন

নিচের spreadsheets.values.get কোড নমুনাটি দেখায় কিভাবে শীট1!A1:D5 রেঞ্জ থেকে মানগুলি পড়তে হয় এবং প্রতিক্রিয়াতে সেগুলি ফেরত দেয়। খালি ট্রেলিং সারি এবং কলাম বাদ দেওয়া হয়েছে৷

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

GET https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID/values/Sheet1!A1:D5

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

{
  "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", "30/20/2016"],
    ["Totals", "$135.5", "7", "3/20/2016"]
  ],
}

কলাম দ্বারা গোষ্ঠীবদ্ধ একটি একক পরিসর পড়ুন

নিচের spreadsheets.values.get কোডের নমুনা দেখায় কিভাবে শীট1!A1:D3 রেঞ্জ থেকে মানগুলি পড়তে হয় এবং প্রতিক্রিয়াতে সেগুলি ফেরত দেয়, কিন্তু কলাম দ্বারা গোষ্ঠীবদ্ধ৷ খালি ট্রেলিং সারি এবং কলাম বাদ দেওয়া হয়েছে৷

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

GET https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID/values/Sheet1!A1:D3?majorDimension=COLUMNS

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

{
  "range": "Sheet1!A1:D3",
  "majorDimension": "COLUMNS",
  "values": [
    ["Item", "Wheel", "Door"],
    ["Cost", "$20.50", "$15"],
    ["Stocked", "4", "2"],
    ["Ship Date", "3/1/2016", "3/15/2016"]
  ],
}

রেন্ডারিং বিকল্প সহ একটি একক পরিসর পড়ুন

নিম্নলিখিত spreadsheets.values.get কোড নমুনাটি দেখায় যে কীভাবে শীট1!A1:D5 রেঞ্জ থেকে মানগুলি পড়তে হয় এবং সেগুলি প্রতিক্রিয়াতে ফেরত দেয়, তবে কীভাবে সেই তথ্য ফেরত দেওয়া হয় তা পরিচালনা করতে রেন্ডারিং বিকল্পগুলি ব্যবহার করে৷ FORMULA এর ValueRenderOption সেটিং নির্দেশ করে যে গণনা করা মানের পরিবর্তে সূত্রগুলি ফেরত দিতে হবে, এবং SERIAL_NUMBER এর DateTimeRenderOption সেটিং নির্দেশ করে যে তারিখগুলি সংখ্যা হিসাবে ফেরত দিতে হবে৷ অন্যান্য সেটিংসও সম্ভব। খালি ট্রেলিং সারি এবং কলাম বাদ দেওয়া হয়েছে৷

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

GET https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID/values/Sheet1!A1:D5?
            valueRenderOption=FORMULA&dateTimeRenderOption=SERIAL_NUMBER

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

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

একাধিক রেঞ্জ পড়ুন

নিচের spreadsheets.values.batchGet কোড নমুনা দেখায় কিভাবে রেঞ্জ Sheet1!B:B এবং Sheet1!D:D থেকে মান পড়তে হয় এবং প্রতিক্রিয়াতে সেগুলি ফেরত দেয়। UNFORMATTED_VALUE এর ValueRenderOption সেটিং নির্দেশ করে যে মানগুলি গণনা করা হয়েছে, কিন্তু প্রতিক্রিয়াতে ফর্ম্যাট করা হয়নি৷ খালি ট্রেলিং সারি এবং কলাম বাদ দেওয়া হয়েছে৷

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

GET https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID/values:batchGet?
            ranges=Sheet1!B:B&ranges=Sheet1!D:D&valueRenderOption=UNFORMATTED_VALUE&majorDimension=COLUMNS

এই পদ্ধতি কলের প্রতিক্রিয়াতে স্প্রেডশীট আইডি সহ একটি অবজেক্ট এবং প্রতিটি অনুরোধ করা পরিসরের সাথে সম্পর্কিত ValueRange অবজেক্টের একটি বিন্যাস থাকে, তাদের অনুরোধ করা ক্রমে তালিকাভুক্ত করা হয়। majorDimension ক্ষেত্র নির্দেশ করে যে অ্যারেগুলি কলাম দ্বারা সংগঠিত মানগুলির তালিকা। যেমন:

{
  "spreadsheetId": SPREADSHEET_ID,
  "valueRanges": [
    {
      "range": "Sheet1!B1:B1000",
      "majorDimension": "COLUMNS",
      "values": [
        ["Cost",20.5,15,100,135.5]
      ]
    },
    {
      "range": "Sheet1!D1:D1000",
      "majorDimension": "COLUMNS",
      "values": [
        ["Ship Date",42430,42444,42449,42449]
      ]s
    }
  ]
}

একাধিক পত্রক জুড়ে একাধিক রেঞ্জ পড়ুন

নিম্নলিখিত spreadsheets.values.batchGet কোড নমুনা দেখায় কিভাবে শীট শীট 1!A1:D5, পণ্য!D1:D100, এবং বিক্রয়!E4:F6 এর রেঞ্জ থেকে মান পড়তে হয় এবং প্রতিক্রিয়াতে সেগুলি ফেরত দেয়৷ UNFORMATTED_VALUE এর ValueRenderOption সেটিং নির্দেশ করে যে মানগুলি গণনা করা হয়েছে, কিন্তু প্রতিক্রিয়াতে ফর্ম্যাট করা হয়নি৷ খালি ট্রেলিং সারি এবং কলাম বাদ দেওয়া হয়েছে৷

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

GET https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID/values:batchGet?
            ranges=Sheet1!A1:D5&ranges=Products!D1:D100&ranges=Sales!E4:F6&valueRenderOption=UNFORMATTED_VALUE&majorDimension=COLUMNS

এই পদ্ধতি কলের প্রতিক্রিয়াতে স্প্রেডশীট আইডি সহ একটি অবজেক্ট এবং প্রতিটি অনুরোধ করা পরিসরের সাথে সম্পর্কিত ValueRange অবজেক্টের একটি বিন্যাস থাকে, তাদের অনুরোধ করা ক্রমে তালিকাভুক্ত করা হয়। majorDimension ক্ষেত্র নির্দেশ করে যে অ্যারেগুলি কলাম দ্বারা সংগঠিত মানগুলির তালিকা। যেমন:

{
  "spreadsheetId": SPREADSHEET_ID,
  "valueRanges": [
    {
      "range": "Sheet1!A1:D5",
      "majorDimension": "COLUMNS",
      "values": [
        [...],
        [...]
      ]
    },
    {
      "range": "Products!D1:D100",
      "majorDimension": "COLUMNS",
      "values": [
        [...]
      ]
    },
    {
      "range": "Sales!E4:F6",
      "majorDimension": "COLUMNS",
      "values": [
        [...],
        [...]
      ]
    }
  ]
}