স্মার্ট চিপস

এই নির্দেশিকায় বর্ণনা করা হয়েছে কীভাবে এবং কেন আপনার স্প্রেডশিটে স্মার্ট চিপ যোগ ও পরিচালনা করতে গুগল শিটস এপিআই ব্যবহার করবেন।

স্মার্ট চিপ বলতে কী বোঝায়?

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

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

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

অনুরোধে অবশ্যই 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 : ব্যক্তিটির ইমেইল ঠিকানা।

একটি রিচ লিঙ্ক চিপ তৈরি করতে এটি ব্যবহার করুন। যদিও এপিআইটি বিভিন্ন গুগল পরিষেবার (যেমন ইউটিউব বা ক্যালেন্ডার) লিঙ্ক পড়তে পারে, কেবল গুগল ড্রাইভ ফাইলের লিঙ্কগুলোই চিপ হিসেবে লেখা যায়।

  • uri : (আবশ্যক) রিসোর্সটির ইউআরআই। লেখার জন্য, এটি অবশ্যই একটি গুগল ড্রাইভ ফাইল লিঙ্ক হতে হবে। ইউআরআই ২০০০ বাইটের বেশি হতে পারবে না।

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

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

রেসপন্সের chipRuns অ্যারেটিতে সেলের টেক্সটের সমস্ত উপবিভাগের জন্য অবজেক্ট থাকবে।

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

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

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

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

অন্যান্য শীটস ফিচারের সাথে স্মার্ট চিপ ব্যবহার করুন

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

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