Google Sheets کو اپنی ایپ سے کیسے جوڑیں

Google Sheets کو اپنی ایپ سے جوڑنے کے لیے، Google Cloud پروجیکٹ میں Google Sheets API فعال کریں، ایک service account بنائیں، اسپریڈ شیٹ کو service account کے ای میل پتے کے ساتھ شیئر کریں، اور اس کی key کو سرور سائیڈ secret کے طور پر محفوظ کریں۔ پھر آپ کا سرور spreadsheets.values.get سے قطاریں پڑھتا ہے اور spreadsheets.values.append سے قطاریں شامل کرتا ہے۔ اگر صارفین کو اپنی ذاتی شیٹس جوڑنی ہیں تو اس کے بجائے OAuth استعمال کریں، اور اگر شیٹ مکمل طور پر عوامی ہے تو پڑھنے کے لیے سادہ API key کافی ہے۔

یہ گائیڈ بتاتی ہے کہ کون سا طریقہ کس کے لیے موزوں ہے، درکار کالز، کوٹے اور مشکلات، اور AI ایپ بلڈر کے لیے پرامپٹس۔ Google کی تفصیلات ستمبر 2026 تک Google کی ڈویلپر دستاویزات سے ہیں۔

شیٹ کو جوڑنا کیوں

عام وجوہات:

• ٹیم کا ورک فلو برقرار رکھیں۔ عملہ قیمتوں کی فہرست یا شیڈول Sheets میں ایڈٹ کرتا رہتا ہے؛ ایپ اسے دکھاتی ہے۔
• جہاں لوگ پہلے ہی دیکھتے ہیں وہاں ڈیٹا جمع کریں۔ نئے سائن اپس، آرڈرز یا فارم جوابات قطاروں کی صورت میں آتے ہیں۔
• رپورٹنگ۔ ایپ کا ڈیٹا ان لوگوں کے لیے شیٹ میں ایکسپورٹ کریں جو اسپریڈ شیٹس میں کام کرتے ہیں۔
• ایک قدم۔ شیٹ سے شروع کریں، پھر ایک مناسب ڈیٹا بیس کی طرف جائیں۔ دیکھیں اسپریڈ شیٹ کو ایپ میں کیسے بدلیں۔

چنیں کہ آپ کی ایپ Google میں کیسے سائن ان کرے

Google کی credentials گائیڈ تین اقسام بیان کرتی ہے:

زیادہ تر ایپس کے لیے service account درست انتخاب ہے: ایک ہی credentials کا سیٹ، جو آپ کا ہے، اور صرف ان شیٹس تک رسائی جو آپ واضح طور پر اس کے ساتھ شیئر کریں۔

Service account کے ساتھ مرحلہ وار

1. Google Cloud پروجیکٹ بنائیں یا چنیں اور Google Sheets API فعال کریں۔
2. Service account اور اس کی key بنائیں۔ key ایک JSON فائل ہے؛ اسے پاس ورڈ کی طرح سمجھیں۔
3. اسپریڈ شیٹ کو service account کے ای میل پتے کے ساتھ شیئر کریں، صرف پڑھنے کے لیے Viewer یا لکھنے کے لیے Editor کے طور پر۔ Google کی گائیڈ کے مطابق یہ عام شیئرنگ اسکرین سے ہوتا ہے۔
4. Key کو اپنے سرور پر secret کے طور پر محفوظ کریں، مثلاً GOOGLE_SERVICE_ACCOUNT_JSON، اور اسپریڈ شیٹ ID (شیٹ کے URL میں لمبی سٹرنگ) کو SHEET_ID کے طور پر۔
5. سرور سے API کو کال کریں اپنی زبان کے لیے Google کی client library کے ذریعے۔
6. ریڈز کیش کریں اگر بہت سے وزیٹرز ایک ہی ڈیٹا دیکھتے ہیں، تاکہ کوٹے تک نہ پہنچیں۔

وہ کالز جو آپ استعمال کریں گے

Google کی ویلیوز پڑھنے اور لکھنے کی گائیڈ سے:

رینجز A1 notation استعمال کرتی ہیں۔ Google نوٹ کرتا ہے کہ شیٹ کے نام کے بغیر رینج، جیسے A1:B2، پہلی شیٹ پر لاگو ہوتی ہے، اس لیے جب کوئی ٹیبز کی ترتیب بدلے تو حیرت سے بچنے کے لیے ٹیب کا نام واضح لکھیں۔

RAW بمقابلہ USER_ENTERED

لکھنے کے لیے valueInputOption درکار ہے:

• RAW بالکل وہی محفوظ کرتا ہے جو آپ بھیجتے ہیں، بطور متن۔ =1+2 بطور متن =1+2 محفوظ ہوتا ہے۔
• USER_ENTERED ان پٹ کو ایسے برتتا ہے جیسے Sheets میں ٹائپ کیا گیا ہو: تاریخیں تاریخیں بن جاتی ہیں اور =1+2 ایک فارمولا بن جاتا ہے۔

اگر آپ وہ متن لکھ رہے ہیں جو صارفین نے آپ کی ایپ میں ٹائپ کیا ہے تو RAW استعمال کریں۔ USER_ENTERED کے ساتھ کوئی فارمولا جمع کروا سکتا ہے جو ساتھی کے شیٹ کھولنے پر چل جائے۔

کوٹے اور خرابیاں

ستمبر 2026 تک، Google کے Sheets API کی حدوں والے صفحے پر یہ درج ہے:

جب تک آپ فی منٹ کوٹے کے اندر رہیں، روزانہ کوئی حد نہیں۔ حد سے تجاوز پر 429: Too many requests آتا ہے، اور Google truncated exponential backoff کی تجویز دیتا ہے: ہر ناکام کوشش کے بعد زیادہ انتظار کریں، ایک تصادفی تاخیر کے ساتھ، زیادہ سے زیادہ حد تک۔ ایک واحد درخواست جو 180 سیکنڈ سے زیادہ لے، وقت ختم ہو جاتی ہے۔

عملی طور پر: ہر صفحہ دیکھنے پر API کو کال نہ کریں۔ شیٹ کا ڈیٹا ایک منٹ یا زیادہ کے لیے کیش کریں، batchGet سے ریڈز کو یکجا کریں، اور جہاں ممکن ہو لکھنے کو بھی یکجا کریں۔

اختیارات اور تجارتی توازن

بہت سے صارفین یا حساس ڈیٹا والی کسی بھی چیز کے لیے، ڈیٹا بیس سچائی کا بہتر ذریعہ ہے۔ دیکھیں ڈیٹا بیس کیا ہے۔

اپنے AI بلڈر کو دینے کے پرامپٹس

شیٹ پڑھنا:

ہماری Google Sheet کا "Menu" ٹیب مینو صفحے پر دکھائیں۔ سرور سے Google Sheets API استعمال کریں، service account کے ساتھ جس کی JSON key secret GOOGLE_SERVICE_ACCOUNT_JSON میں ہے، اور اسپریڈ شیٹ ID SHEET_ID میں ہے۔ رینج Menu!A2:D پڑھیں (نام، تفصیل، قیمت، کیٹیگری)۔ نتیجہ 5 منٹ کے لیے کیش کریں۔ اگر API ناکام ہو تو آخری کیش شدہ ورژن دکھائیں۔ key کبھی براؤزر کو نہ بھیجیں۔

قطاریں لکھنا:

جب کوئی رابطہ فارم جمع کرے تو اسے ہمارے ڈیٹا بیس میں محفوظ کریں اور "Leads" ٹیب میں ایک قطار شامل کریں (تاریخ، نام، ای میل، پیغام)، valueInputOption RAW کے ساتھ spreadsheets.values.append استعمال کرتے ہوئے۔ اگر Google 429 دے تو exponential backoff کے ساتھ دوبارہ کوشش کریں؛ اگر پھر بھی ناکام ہو تو لیڈ ڈیٹا بیس میں رکھیں اور بعد میں دوبارہ کوشش کریں۔

عام غلطیاں

• شیٹ کو service account ای میل کے ساتھ شیئر کرنا بھول جانا۔ اس صورت میں key درست ہونے کے باوجود API اجازت کی خرابی دیتا ہے۔
• key فرنٹ اینڈ یا ریپوزیٹری میں ہونا۔ JSON key اس کے ساتھ شیئر ہر شیٹ تک رسائی دیتی ہے۔ دیکھیں API keys کو محفوظ کیسے رکھیں۔
• صارف کے ان پٹ کے لیے USER_ENTERED استعمال کرنا، جو فارمولا انجیکشن کی اجازت دیتا ہے۔
• ہر درخواست پر API کو کال کرنا اور پہلے ٹریفک اسپائک پر فی منٹ کوٹے تک پہنچ جانا۔
• کالم کی پوزیشنز پر انحصار۔ کوئی کالم ڈالتا ہے اور ایپ غلط ڈیٹا پڑھتی ہے۔ ہیڈر قطار پڑھیں اور نام سے میپ کریں، یا ہیڈر لاک کریں۔
• شیٹ کو ضرورت سے زیادہ وسیع شیئر کرنا۔ "Anyone with the link" اسے عوامی بنا دیتا ہے۔
• شیٹ کو کئی صارفین والے ڈیٹا بیس کے طور پر استعمال کرنا۔ بیک وقت لکھنے اور غائب اجازتوں سے ڈیٹا کھو جاتا ہے یا لیک ہو جاتا ہے۔

چیک لسٹ

• Sheets API فعال؛ service account بنا ہوا
• شیٹ service account ای میل کے ساتھ کم سے کم درکار کردار میں شیئر
• key اور شیٹ ID سرور سائیڈ secrets کے طور پر محفوظ
• تمام کالز سرور سے
• رینجز میں ٹیب کے نام استعمال
• صارف کے فراہم کردہ متن کے لیے RAW استعمال
• ریڈز کیش؛ 429 کو backoff کے ساتھ سنبھالا گیا
• اگر Sheets دستیاب نہ ہو تو ایپ بہتر طور پر کام کرتی ہے
• طے کیا گیا کہ سچائی کا ذریعہ کون سا فریق ہے

Mythex میں Google Sheets

Mythex پر Sheets کے ساتھ کام کرنے کے دو مختلف طریقے ہیں۔ Connectors آپ کے Google اکاؤنٹ کو Mythex سے جوڑتے ہیں تاکہ ایجنٹ آپ کی تعمیر کے دوران اسے استعمال کر سکے، مثلاً ڈیش بورڈ بنانے کے لیے شیٹ پڑھنا؛ ڈاکس کے مطابق credential Mythex کی کنکشن سروس کے پاس رہتی ہے اور کبھی آپ کے کوڈ میں نہیں جاتی (دیکھیں Connectors، اور Google کی مانگی ہر اجازت منظور کریں)۔ شائع شدہ ایپ کا خود شیٹ پڑھنا یا لکھنا قابل اعتماد طریقہ وہی ہے جو اس گائیڈ میں ہے: service account key کو پروجیکٹ secret کے طور پر محفوظ کریں اور سرور سے Sheets API کالز، جیسا کہ Integrate any API میں ہے۔ اگر آپ شیٹ سے آگے بڑھ رہے ہیں تو ایجنٹ سے کہیں کہ ڈیٹا پروجیکٹ کے ڈیٹا بیس میں منتقل کرے اور اس کے اوپر ایک ڈیش بورڈ بنائے۔

سوالات