আপনার অ্যাপে Google Sheets কীভাবে যুক্ত করবেন

আপনার অ্যাপে Google Sheets যুক্ত করতে একটি Google Cloud প্রজেক্টে Google Sheets API চালু করুন, একটি service account তৈরি করুন, স্প্রেডশিটটি service account-এর ইমেইল ঠিকানার সাথে শেয়ার করুন, এবং তার key-কে একটি সার্ভার-সাইড সিক্রেট হিসেবে সংরক্ষণ করুন। তারপর আপনার সার্ভার spreadsheets.values.get দিয়ে সারি পড়ে এবং spreadsheets.values.append দিয়ে সারি যোগ করে। ব্যবহারকারীদের যদি নিজেদের শিট যুক্ত করতে হয়, তাহলে OAuth ব্যবহার করুন, আর শিট সম্পূর্ণ পাবলিক হলে পড়ার জন্য একটি সাধারণ API key-ই যথেষ্ট।

এই গাইড কোন পদ্ধতি উপযুক্ত, আপনার দরকারি কলগুলো, কোটা ও সতর্কতা, এবং একটি AI অ্যাপ বিল্ডারের জন্য প্রম্পট কভার করে। Google-এর বিবরণ সেপ্টেম্বর ২০২৬ পর্যন্ত Google-এর developer ডকুমেন্টেশন থেকে নেওয়া।

শিট যুক্ত করার কারণ কী

সাধারণ কারণগুলো:

• দলের কাজের ধারা ধরে রাখা। কর্মীরা Sheets-এ দাম তালিকা বা সূচি সম্পাদনা করতে থাকেন; অ্যাপ সেটি দেখায়।
• মানুষ যেখানে দেখে সেখানে ডেটা সংগ্রহ। নতুন sign-up, অর্ডার বা ফর্মের উত্তর সারি হিসেবে জমা হয়।
• রিপোর্টিং। যারা স্প্রেডশিটে কাজ করেন, তাদের জন্য অ্যাপের ডেটা রপ্তানি।
• একটি ধাপ। শিট দিয়ে শুরু করে পরে একটি আসল database-এ যাওয়া। দেখুন স্প্রেডশিটকে কীভাবে অ্যাপে রূপান্তর করবেন।

আপনার অ্যাপ কীভাবে Google-এ সাইন ইন করবে তা বাছুন

Google-এর credentials গাইড তিন ধরনের কথা বলে:

বেশিরভাগ অ্যাপের জন্য service account-ই সঠিক পছন্দ: একটি credential সেট, যা আপনার মালিকানায়, এবং শুধু সেইসব শিটে অ্যাক্সেস যা আপনি স্পষ্টভাবে শেয়ার করেছেন।

service account দিয়ে ধাপে ধাপে

1. একটি Google Cloud প্রজেক্ট তৈরি বা বেছে নিন এবং Google Sheets API চালু করুন।
2. একটি service account ও তার একটি key তৈরি করুন। key হলো একটি JSON ফাইল; এটিকে পাসওয়ার্ডের মতো ব্যবহার করুন।
3. স্প্রেডশিটটি service account-এর ইমেইল ঠিকানার সাথে শেয়ার করুন, শুধু-পড়ার জন্য Viewer বা লেখার জন্য Editor হিসেবে। Google-এর গাইড বলে এটি স্বাভাবিক শেয়ারিং পর্দা দিয়েই হয়।
4. key-টি আপনার সার্ভারে একটি সিক্রেট হিসেবে সংরক্ষণ করুন, যেমন GOOGLE_SERVICE_ACCOUNT_JSON, এবং স্প্রেডশিটের ID (শিটের URL-এর লম্বা স্ট্রিংটি) SHEET_ID হিসেবে।
5. সার্ভার থেকে API কল করুন, আপনার ভাষার জন্য Google-এর client library দিয়ে।
6. পড়া ক্যাশে রাখুন যদি অনেক দর্শক একই ডেটা দেখে, যাতে কোটায় না পৌঁছান।

যে কলগুলো আপনি ব্যবহার করবেন

Google-এর values পড়া ও লেখার গাইড থেকে:

রেঞ্জ A1 নোটেশন-এ লেখা হয়। Google উল্লেখ করে, শিটের নাম ছাড়া রেঞ্জ, যেমন A1:B2, প্রথম শিটে প্রয়োগ হয়; তাই কেউ ট্যাবের ক্রম বদলালে বিস্ময় এড়াতে ট্যাবের নাম স্পষ্টভাবে লিখুন।

RAW বনাম USER_ENTERED

লেখার জন্য একটি valueInputOption লাগে:

• RAW আপনি যা পাঠান ঠিক তাই টেক্সট হিসেবে সংরক্ষণ করে। =1+2 টেক্সট =1+2 হিসেবেই থাকে।
• USER_ENTERED ইনপুটকে এমনভাবে ধরে যেন শিটে টাইপ করা হয়েছে: তারিখ তারিখ হয়, এবং =1+2 একটি ফর্মুলা হয়ে যায়।

আপনার অ্যাপে ব্যবহারকারীর টাইপ করা টেক্সট লিখলে RAW ব্যবহার করুন। USER_ENTERED হলে কেউ এমন একটি ফর্মুলা জমা দিতে পারে যা সহকর্মী শিট খুললে চলে যায়।

কোটা ও ত্রুটি

সেপ্টেম্বর ২০২৬ পর্যন্ত Google-এর Sheets API সীমার পাতা তালিকা করে:

প্রতি মিনিটের কোটার মধ্যে থাকলে কোনো দৈনিক সীমা নেই। সীমা পেরোলে আসে 429: Too many requests, এবং Google truncated exponential backoff-এর পরামর্শ দেয়: প্রতিটি ব্যর্থ চেষ্টার পর আরও বেশি অপেক্ষা করুন, একটি এলোমেলো বিলম্বসহ, একটি সর্বোচ্চ সীমা পর্যন্ত। একটি একক অনুরোধ ১৮০ সেকেন্ডের বেশি সময় নিলে সেটি টাইমআউট হয়।

বাস্তবে: প্রতিটি পেজ ভিউতে API কল করবেন না। শিটের ডেটা এক মিনিট বা তার বেশি ক্যাশে রাখুন, batchGet দিয়ে পড়া একত্র করুন, এবং যেখানে সম্ভব লেখা ব্যাচ করুন।

বিকল্প ও আপস

অনেক ব্যবহারকারী বা সংবেদনশীল ডেটার যেকোনো কিছুর জন্য database-ই আরও ভালো সত্যের উৎস। দেখুন database কী।

আপনার AI বিল্ডারকে দেওয়ার প্রম্পট

একটি শিট পড়া:

আমাদের Google Sheet-এর “Menu” ট্যাবটি মেনু পাতায় দেখান। সার্ভার থেকে Google Sheets API ব্যবহার করুন, একটি service account দিয়ে যার JSON key সিক্রেট GOOGLE_SERVICE_ACCOUNT_JSON-এ আছে, এবং স্প্রেডশিটের ID SHEET_ID-এ। রেঞ্জ Menu!A2:D পড়ুন (নাম, বিবরণ, দাম, ক্যাটাগরি)। ফলাফল ৫ মিনিট ক্যাশে রাখুন। API ব্যর্থ হলে শেষ ক্যাশ করা সংস্করণ দেখান। key কখনও ব্রাউজারে পাঠাবেন না।

সারি লেখা:

কেউ যোগাযোগ ফর্ম জমা দিলে সেটি আমাদের database-এ সংরক্ষণ করুন, এবং “Leads” ট্যাবে একটি সারি যোগ করুন (তারিখ, নাম, ইমেইল, বার্তা) spreadsheets.values.append ব্যবহার করে valueInputOption RAW দিয়ে। Google 429 দিলে exponential backoff দিয়ে আবার চেষ্টা করুন; তবু ব্যর্থ হলে লিডটি database-এ রাখুন এবং পরে আবার চেষ্টা করুন।

সাধারণ ভুল

• শিট service account ইমেইলের সাথে শেয়ার করতে ভুলে যাওয়া। তখন key ঠিক থাকলেও API অনুমতির ত্রুটি দেয়।
• key ফ্রন্টএন্ড বা রিপোজিটরিতে রাখা। JSON key শেয়ার করা প্রতিটি শিটে অ্যাক্সেস দেয়। দেখুন API key কীভাবে নিরাপদ রাখবেন।
• ব্যবহারকারীর ইনপুটে USER_ENTERED ব্যবহার করা, যা ফর্মুলা ইনজেকশনের সুযোগ দেয়।
• প্রতিটি রিকোয়েস্টে API কল করা এবং প্রথম traffic-এর ঢেউয়ে প্রতি-মিনিটের কোটায় পৌঁছে যাওয়া।
• কলামের অবস্থানের ওপর নির্ভর করা। কেউ একটি কলাম ঢোকালে অ্যাপ ভুল ডেটা পড়ে। হেডার সারি পড়ুন এবং নাম অনুযায়ী মিলান, অথবা হেডার লক করুন।
• প্রয়োজনের চেয়ে বেশি শিট শেয়ার করা। “লিংক থাকলে যে কেউ” মানে এটি পাবলিক।
• একটি শিটকে বহু-ব্যবহারকারীর database হিসেবে ব্যবহার করা। একসাথে লেখা ও অনুমতির অভাবে ডেটা হারায় বা ফাঁস হয়।

চেকলিস্ট

• Sheets API চালু; service account তৈরি
• শিট service account ইমেইলের সাথে প্রয়োজনীয় সর্বনিম্ন ভূমিকায় শেয়ার করা
• key ও শিটের ID সার্ভার-সাইড সিক্রেট হিসেবে সংরক্ষিত
• সব কল সার্ভার থেকে করা
• রেঞ্জে ট্যাবের নাম ব্যবহার করা
• ব্যবহারকারীর দেওয়া টেক্সটে RAW ব্যবহার করা
• পড়া ক্যাশে করা; 429 backoff দিয়ে সামলানো
• Sheets অনুপলব্ধ থাকলে অ্যাপ সুন্দরভাবে কাজ চালিয়ে যায়
• কোন পক্ষ সত্যের উৎস হবে তা ঠিক করা

Mythex-এ Google Sheets

Mythex-এ Sheets নিয়ে কাজের দুটি আলাদা উপায় আছে। Connectors আপনার Google অ্যাকাউন্টকে Mythex-এর সাথে যুক্ত করে, যাতে আপনি বানানোর সময় এজেন্ট সেটি ব্যবহার করতে পারে, যেমন একটি শিট পড়ে তা থেকে ড্যাশবোর্ড বানানো। ডকস বলে, credential Mythex-এর connection সেবার কাছেই থাকে এবং কখনও আপনার কোডে যায় না (Connectors); Google যে অনুমতি চায় প্রতিটি অনুমোদন করুন। প্রকাশিত অ্যাপ নিজে থেকে শিট পড়বে বা লিখবে এমন হলে নির্ভরযোগ্য পথ এই গাইডের পদ্ধতিটি: একটি service account key, যা প্রজেক্ট সিক্রেট হিসেবে সংরক্ষিত, এবং আপনার সার্ভার থেকে Sheets API কল, যেমন যেকোনো API যুক্ত করা-এ। শিটের সীমা ছাড়িয়ে গেলে এজেন্টকে ডেটা প্রজেক্টের database-এ সরাতে বলুন, এবং তার ওপর একটি ড্যাশবোর্ড বানান।

প্রশ্নোত্তর