Google Sheets-ийг аппдаа хэрхэн холбох вэ

Google Sheets-ийг аппдаа холбохдоо Google Cloud төсөлд Google Sheets API-г идэвхжүүлж, service account үүсгэж, таблицаа service account-ын имэйл хаягтай хуваалцаж, түлхүүрийг нь серверийн талын нууц мэдээлэл болгон хадгална. Дараа нь таны сервер spreadsheets.values.get ашиглан мөр уншиж, spreadsheets.values.append ашиглан мөр нэмдэг. Хэрэв хэрэглэгчид өөрсдийн таблицаа холбох шаардлагатай бол OAuth хэрэглэ, мөн таблиц бүрэн нийтэд нээлттэй бол энгийн API түлхүүр уншихад хангалттай.

Энэ гарын авлага аль аргыг сонгох вэ, хэрэгтэй дуудлагууд, квот ба анхаарах зүйлс, AI аппын бүтээгчид өгөх зааврыг тайлбарлана. Google-ийн мэдээллийг 2026 оны 9-р сарын байдлаар Google-ийн developer баримт бичгээс авсан.

Таблицаа яагаад холбох вэ

Түгээмэл шалтгаанууд:

• Багийн ажлын урсгалыг хадгалах. Ажилтнууд үнийн жагсаалт эсвэл хуваарийг Sheets-д засдаг хэвээр; апп тэрийг харуулдаг.
• Өгөгдлөө хүмүүс аль хэдийн харах газар цуглуулах. Шинэ бүртгэл, захиалга эсвэл маягтын хариултууд мөр болж орно.
• Тайлагнал. Аппын өгөгдлийг таблицаар харах дуртай хүмүүст экспортлох.
• Шатлал. Таблицаас эхлээд, дараа нь бодит өгөгдлийн санд шилж болно. Таблицыг аппд хэрхэн хувиргах вэ-ыг үзээрэй.

Google-д аппаа хэрхэн нэвтрүүлэх сонголт

Google-ийн credentials гарын авлага гурван төрлийг тодорхойлдог:

Ихэнх аппын хувьд service account зөв сонголт: нэг credential, таны эзэмшдэг, зөвхөн таны илт хуваалцсан таблицуудад хандах эрхтэй.

Service account ашиглан алхам алхмаар

1. Google Cloud төслөө үүсгэ эсвэл сонгоод, Google Sheets API-г идэвхжүүл.
2. Service account болон түүний түлхүүрийг үүсгэ. Түлхүүр нь JSON файл; нууц үг шиг хандаарай.
3. Таблицаа service account-ын имэйл хаягтай хуваалцаарай, зөвхөн унших бол Viewer, бичих бол Editor. Google-ийн гарын авлагад үүнийг хуваалцах энгийн цонхоор хийдэг гэж заасан.
4. Түлхүүрээ серверийн нууц мэдээлэл болгон хадгал, жишээ нь GOOGLE_SERVICE_ACCOUNT_JSON, мөн таблицын ID-г (таблицын URL-ын урт мөр) SHEET_ID нэрээр.
5. API-г серверээс дуудах таны хэлний Google-ийн client library-аар.
6. Уншилтыг кэшлэ олон зочин ижил өгөгдөл харж байвал, квотод хүрэхгүйн тулд.

Таны ашиглах дуудлагууд

Google-ийн утга унших, бичих гарын авлагаас:

Мужууд A1 тэмдэглэгээ ашигладаг. Google тэмдэглэснээр таблицын нэргүй муж, жишээ нь A1:B2, эхний хуудсанд хамаарна тул хуудсын табуудыг дахин эрэмбэлэхэд асуудал гарахгүйн тулд таб нэрийг тодорхой бич.

RAW ба USER_ENTERED

Бичилтэд valueInputOption хэрэгтэй:

• RAW нь яг илгээснийг текст болгон хадгална. =1+2 нь =1+2 гэсэн текст болж хадгалагдана.
• USER_ENTERED нь оролтыг Sheets дээр гараар бичсэн мэт боловсруулна: огноо огноо болж, =1+2 нь томьёо болно.

Хэрэв та хэрэглэгчийн аппдаа бичсэн текстийг бичиж байгаа бол RAW ашигла. USER_ENTERED-д хэн нэгэн томьёо илгээвэл хэрэглэгч таблицыг нээхэд тэр ажиллана.

Квот ба алдаанууд

2026 оны 9-р сарын байдлаар Google-ийн Sheets API-ийн хязгаарын хуудсанд дараахыг жагсаасан:

Минут бүрийн квотод багтсан л бол өдрийн хязгаар байхгүй. Хэтрүүлбэл 429: Too many requests буцна, Google-ийн зөвлөмж бол truncated exponential backoff: бүтэлгүйтсэн оролт бүрийн дараа хүлээх хугацааг нэмэгдүүл, санамсаргүй саатал нэмж, дээд хязгаартай. Нэг хүсэлт 180 секундээс удаан үргэлжилбэл цаг хугацаа дуусна.

Бодит хэрэглээнд: хуудас нээгдэх бүрт API-г бүү дуудаа. Таблицын өгөгдлийг нэг минут эсвэл түүнээс дээш хугацаагаар кэшлэ, уншилтаа batchGet-ээр багцлаж, боломжтой бол бичилтээ багцлаа.

Сонголт ба үр дүнгийн харьцуулалт

Олон хэрэглэгчтэй, мэдрэмтгий өгөгдөлтэй зүйлд өгөгдлийн сан илүү найдвартай үнэний эх сурвалж. Өгөгдлийн сан гэж юу вэ-г үзээрэй.

AI бүтээгчид өгөх зааврууд

Таблиц унших:

Манай Google Sheet-ийн “Menu” табыг цэсний хуудсанд харуул. Серверээс Google Sheets API-г ашигла, service account-ын JSON түлхүүр нь GOOGLE_SERVICE_ACCOUNT_JSON нууцлаг мэдээлэлд, таблицын ID нь SHEET_ID-д байна. Menu!A2:D мужийг (нэр, тайлбар, үнэ, ангилал) унш. Үр дүнг 5 минут кэшлэ. API бүтэлгүйтвэл сүүлд кэшлэгдсэн хувилбарыг харуул. Түлхүүрийг хөтөч рүү хэзээ ч бүү илгээ.

Мөр бичих:

Хэрэглэгч холбоо барих маягтыг илгээхэд үүнийг өгөгдлийн санд хадгалаад, мөн “Leads” табын мөр нэмж (огноо, нэр, имэйл, мессеж) spreadsheets.values.append-ийг valueInputOption RAW-тай ашигла. Google 429 буцаавал экспоненциал backoff-оор дахин оролд; бүтэлгүйтвэл бүртгэлийг өгөгдлийн санд хадгалаад дараа дахин оролд.

Түгээмэл алдаанууд

• Таблицыг service account-ын имэйлд хуваалцаагүй байх. Тэгвэл түлхүүр зөв байсан ч API эрхийн алдаа буцаана.
• Түлхүүр фронтэнд эсвэл репозиторид байх. JSON түлхүүр нь түүнтэй хуваалцсан бүх таблицад хандах эрхтэй. API түлхүүрийг аюулгүй хадгалах нь-ыг үзээрэй.
• Хэрэглэгчийн оруулсан өгөгдөлд USER_ENTERED ашиглах, энэ нь томьёо оруулах (formula injection) боломжийг нээдэг.
• Хуудас нээх бүрт API дуудах, эхний ачааллын үед минут бүрийн квотод хүрэх.
• Баганын байрлалд найдах. Хэн нэгэн багана оруулахад апп буруу өгөгдөл уншина. Толгой мөрийг уншиж нэрээр нь зураглах, эсвэл толгой мөрийг түгжих.
• Таблицыг шаардлагатайгаас илүү өргөн хуваалцах. “Линктэй хүн бүр” гэдэг нь нийтэд нээлттэй болгодог.
• Таблицыг олон хэрэглэгчтэй өгөгдлийн сан болгон ашиглах. Зэрэг бичилт, эрхийн дутагдал нь өгөгдөл алдах эсвэл задруулахад хүргэдэг.

Хяналтын жагсаалт

• Sheets API идэвхжсэн; service account үүсгэсэн
• Таблиц нь service account-ын имэйлтэй хамгийн бага шаардлагатай эрхээр хуваалцсан
• Түлхүүр болон таблицын ID серверийн нууц мэдээлэлд хадгалсан
• Бүх дуудлагууд серверээс хийгдсэн
• Мужуудад табын нэрийг ашигласан
• Хэрэглэгчийн текстэд RAW ашигласан
• Уншилтыг кэшлэсэн; 429-ийг backoff-оор зохицуулсан
• Sheets боломжгүй үед апп нөхцөл байдлыг дутуугүй зохицуулдаг
• Аль тал үнэний эх сурвалж болохыг шийдсэн

Google Sheets Mythex дээр

Mythex дээр Sheets-тэй ажиллах хоёр өөр арга бий. Connectors нь таны Google дансыг Mythex-тэй холбож, агент бүтээх явцдаа ашиглах боломжтой болгодог, жишээ нь таблицаас унших dashboard бүтээх. Docs-ийн мэдээлэлд credential нь Mythex-ийн холболтын үйлчилгээнд үлдэж, таны кодонд хэзээ ч орохгүй гэж заасан (үзэх: Connectors, Google асуух зөвшөөрөл бүрийг баталгаажуул). Харин нийтлэгдсэн апп өөрөө таблицыг уншиж, бичих хэрэгтэй бол энэ гарын авлагын арга найдвартай: service account түлхүүрийг төслийн нууц мэдээлэл болгон хадгалж, серверээсээ Sheets API дуудах, Integrate any API-д заасны дагуу. Таблицаасаа хэтэрч байвал агентаас өгөгдлийг төслийн өгөгдлийн санд шилжүүлж, түүн дээр dashboard бүтээхийг хүс.

Асуултууд