স্মার্ট চিপস

এই নির্দেশিকাটি বর্ণনা করে যে কীভাবে এবং কেন আপনার স্প্রেডশিটে স্মার্ট চিপ যোগ এবং পরিচালনা করার জন্য Google Sheets API ব্যবহার করবেন।

স্মার্ট চিপ কী?

স্মার্ট চিপসের সাহায্যে, আপনি অন্যান্য Google Workspace অ্যাপ্লিকেশন থেকে সরাসরি Sheets-এ সমৃদ্ধ, ইন্টারেক্টিভ ডেটা আনতে পারেন। স্মার্ট চিপ ব্যবহারকারীদের তথ্য এবং অ্যাকশনে দ্রুত অ্যাক্সেস প্রদান করে, একটি সেল লিঙ্ককে একটি গতিশীল বস্তুতে রূপান্তরিত করে। আরও জানতে, আপনার Google Sheets-এ স্মার্ট চিপ ঢোকান দেখুন।

একটি স্মার্ট চিপ যোগ করুন

চিপগুলিকে চিপ রান হিসেবে উপস্থাপন করা হয়, যা CellData এর অংশ, তাই আপনি বিদ্যমান spreadsheets.batchUpdate পদ্ধতি ব্যবহার করে একটি UpdateCellsRequest বা AppendCellsRequest সরবরাহ করে একটি চিপ সন্নিবেশ করতে পারেন।

অনুরোধে অবশ্যই chipRuns ক্ষেত্রটি অন্তর্ভুক্ত থাকতে হবে। একটি চিপ রান একটি চিপের বৈশিষ্ট্য এবং কোষের পাঠ্যের মধ্যে এটি কোথায় অবস্থিত তা বর্ণনা করে।

chipRuns লেখার সময়, আপনাকে অবশ্যই একটি userEnteredValue প্রদান করতে হবে যাতে আপনি যে প্রতিটি চিপ যোগ করতে চান তার জন্য প্লেসহোল্ডার অক্ষর ( @ ) থাকবে। chipRuns অ্যারের প্রতিটি রান যেকোনো একটি প্লেসহোল্ডারের সাথে মিলবে। লেখার সময় নন-চিপড রান বাদ দেওয়া যেতে পারে।

নিচের উদাহরণটি দেখায় কিভাবে একটি ফাইল চিপ, একটি পিপল চিপ এবং প্লেইন টেক্সট একটি একক কোষ, A1-এ লিখতে হয়। * {JSON}

        {
          "updateCells": {
            "rows": [
              {
                "values": [
                  {
                    "userEnteredValue": {
                      "stringValue": "@ is the owner of @."
                    },
                    "chipRuns": [
                      {
                        "chip": {
                          "personProperties": {
                            "email": "johndoe@gmail.com",
                            "displayFormat": "DEFAULT"
                          }
                        }
                      },
                      {
                        "startIndex": 18,
                        "chip": {
                          "richLinkProperties": {
                            "uri": "https://docs.google.com/document/d/YOUR_DOCUMENT_ID/edit"
                          }
                        }
                      }
                    ]
                  }
                ]
              }
            ],
            "fields": "userEnteredValue,chipRuns",
            "range": {
              "startRowIndex": 0,
              "startColumnIndex": 0
            }
          }
        }

চিপের বৈশিষ্ট্য কনফিগার করুন

একটি চিপ অবজেক্টের নিম্নলিখিত বৈশিষ্ট্যের ধরণগুলির মধ্যে একটি থাকতে পারে:

ব্যক্তিবৈশিষ্ট্য

এটি ব্যবহার করে একটি ব্যক্তি চিপ তৈরি করুন।

  • email : (প্রয়োজনীয়) লিঙ্ক করা ব্যক্তির ইমেল ঠিকানা।
  • displayFormat : (ঐচ্ছিক) ব্যক্তির নামের জন্য পছন্দসই প্রদর্শন বিন্যাস। নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:
    • DEFAULT : স্ট্যান্ডার্ড "প্রথম নাম পদবি" বিন্যাস।
    • LAST_NAME_COMMA_FIRST_NAME : "শেষ নাম, প্রথম নাম" ফর্ম্যাট।
    • EMAIL : ব্যক্তির ইমেইল ঠিকানা।

একটি সমৃদ্ধ লিঙ্ক চিপ তৈরি করতে এটি ব্যবহার করুন। যদিও API বিভিন্ন Google পরিষেবার (যেমন YouTube বা ক্যালেন্ডার) লিঙ্কগুলি পড়তে পারে, শুধুমাত্র Google ড্রাইভ ফাইলের লিঙ্কগুলি চিপ হিসাবে লেখা যেতে পারে।

  • uri : (প্রয়োজনীয়) রিসোর্সের URI। লেখার জন্য, এটি অবশ্যই একটি Google Drive ফাইল লিঙ্ক হতে হবে। URI গুলি ২০০০ বাইটের বেশি হতে পারবে না।

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

একটি স্মার্ট চিপের ডেটা পড়তে, spreadsheets.get পদ্ধতি ব্যবহার করুন এবং fields প্যারামিটারে sheets.data.rowData.values(chipRuns) অন্তর্ভুক্ত করুন।

প্রতিক্রিয়ার chipRuns অ্যারেতে কোষের পাঠ্যের সমস্ত উপ-বিভাগের জন্য অবজেক্ট থাকবে।

  • চিপড রান: এই বিভাগগুলিতে একটি পপুলেটেড chip অবজেক্ট থাকবে যার মধ্যে personProperties অথবা richLinkProperties থাকবে।
  • নন-চিপড রান: প্লেইন টেক্সট সেকশনেও একটি রান অবজেক্ট থাকবে, কিন্তু এর chip ফিল্ড খালি থাকবে।

একটি চিপের ডিসপ্লে টেক্সট পেতে, একটি ক্ষেত্র হিসেবে formattedValue যোগ করুন।

একটি স্মার্ট চিপ আপডেট করুন

একটি স্মার্ট চিপ আপডেট বা প্রতিস্থাপন করতে, আপনাকে কোষের বিষয়বস্তু ওভাররাইট করতে হবে। একটি চিপ যোগ করার জন্য আপনি যেমন UpdateCellsRequest বা AppendCellsRequest ব্যবহার করেন, তেমনি একটি নতুন userEnteredValue এবং chipRun প্রদান করে। এটি কোষের বিদ্যমান চিপটি প্রতিস্থাপন করবে।

অন্যান্য Sheets বৈশিষ্ট্যের সাথে স্মার্ট চিপ ব্যবহার করুন

টেবিল : স্মার্ট চিপগুলি প্রকল্পের মালিকদের (পিপল চিপ), অথবা সম্পর্কিত নথি (ফাইল চিপ) ট্র্যাক করার জন্য টেবিল কলাম টাইপ হিসেবে ব্যবহার করা যেতে পারে।

ফিল্টার : আপনি তাদের মধ্যে থাকা স্মার্ট চিপগুলির টেক্সট মানের উপর ভিত্তি করে রেঞ্জগুলি ফিল্টার করতে পারেন।