মৌলিক পড়া

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

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

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

উৎস তথ্য

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

একটি একক পরিসর পড়ুন

নিম্নলিখিত spreadsheets.values.get কোড নমুনাটি দেখায় যে Sheet1!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 কোড নমুনাটি দেখায় যে Sheet1!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 কোড নমুনাটি দেখায় যে Sheet1!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 কোড নমুনাটি দেখায় যে কীভাবে Sheet1!A1:D5, Products!D1:D100, এবং Sales!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": [
        [...],
        [...]
      ]
    }
  ]
}