মৌলিক পড়া

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

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

এই উদাহরণগুলিতে, প্লেসহোল্ডার 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": [
        [...],
        [...]
      ]
    }
  ]
}