Jinsi ya Kuunganisha Google Sheets kwenye Programu Yako

Ili kuunganisha Google Sheets kwenye programu yako, washa Google Sheets API kwenye mradi wa Google Cloud, tengeneza akaunti ya huduma, shiriki spreadsheet kwa barua pepe ya akaunti ya huduma, kisha hifadhi ufunguo wake kama siri ya upande wa seva. Seva yako kisha inasoma safu kwa spreadsheets.values.get na kuongeza safu kwa spreadsheets.values.append. Ikiwa watumiaji wanahitaji kuunganisha sheet zao wenyewe, tumia OAuth badala yake, na ikiwa sheet ni ya umma kabisa, API key rahisi inatosha kwa kusoma.

Mwongozo huu unashughulikia njia gani inafaa, miito unayohitaji, mipaka na mitego, pamoja na maagizo kwa kijenzi cha programu cha AI. Maelezo ya Google yanatoka kwenye nyaraka za wasanidi wa Google kufikia Septemba 2026.

Kwa nini kuunganisha sheet hata kidogo

Sababu za kawaida:

• Kuendeleza mtiririko wa timu. Wafanyakazi wanaendelea kuhariri orodha ya bei au ratiba kwenye Sheets; programu inaionyesha.
• Kukusanya data mahali watu tayari wanapoangalia. Wateja wapya, oda au majibu ya fomu yanaingia kama safu.
• Kuripoti. Safirisha data ya programu kwenda sheet kwa watu wanaoishi kwenye spreadsheets.
• Hatua ya kuanzia. Anza na sheet, kisha uhamie hifadhidata halisi. Angalia jinsi ya kugeuza spreadsheet kuwa programu.

Chagua jinsi programu yako inavyoingia kwa Google

Mwongozo wa vitambulisho wa Google unaeleza aina tatu:

Kwa programu nyingi, akaunti ya huduma ndiyo chaguo sahihi: seti moja ya vitambulisho, inayomilikiwa na wewe, yenye ufikiaji tu kwa sheets unazoshiriki nazo waziwazi.

Hatua kwa hatua kwa akaunti ya huduma

1. Tengeneza au chagua mradi wa Google Cloud na uwashe Google Sheets API.
2. Tengeneza akaunti ya huduma na ufunguo wake. Ufunguo ni faili ya JSON; uitendee kama nenosiri.
3. Shiriki spreadsheet kwa barua pepe ya akaunti ya huduma, kama Viewer kwa kusoma pekee au Editor kwa kuandika. Mwongozo wa Google unasema hili linafanywa kupitia skrini ya kawaida ya kushiriki.
4. Hifadhi ufunguo kama siri kwenye seva yako, kwa mfano GOOGLE_SERVICE_ACCOUNT_JSON, pamoja na kitambulisho cha spreadsheet (mfuatano mrefu kwenye URL ya sheet) kama SHEET_ID.
5. Ita API kutoka kwenye seva kwa kutumia maktaba ya mteja ya Google kwa lugha yako.
6. Hifadhi visomo kwenye kache ikiwa wageni wengi wanaona data ileile, ili usifikie kikomo.

Miito utakayotumia

Kutoka mwongozo wa Google wa kusoma na kuandika thamani:

Safu zinatumia nukuu ya A1. Google inabainisha kwamba safu isiyo na jina la sheet, kama A1:B2, inatumika kwa sheet ya kwanza, kwa hiyo taja jina la kichupo waziwazi ili kuepuka mshangao mtu anapopanga upya vichupo.

RAW dhidi ya USER_ENTERED

Maandishi yanahitaji valueInputOption:

• RAW inahifadhi kile unachotuma hasa, kama maandishi. =1+2 inahifadhiwa kama maandishi =1+2.
• USER_ENTERED inachukulia ingizo kana kwamba limeandikwa kwenye Sheets: tarehe zinakuwa tarehe na =1+2 inakuwa fomula.

Ukiandika maandishi ambayo watumiaji waliandika kwenye programu yako, tumia RAW. Kwa USER_ENTERED, mtu anaweza kuwasilisha fomula itakayoendeshwa mwenzake anapofungua sheet.

Mipaka na hitilafu

Kufikia Septemba 2026, ukurasa wa mipaka wa Google Sheets API unaorodhesha:

Hakuna kikomo cha kila siku mradi unabaki ndani ya mipaka ya kila dakika. Kuzidi hayo kunarudisha 429: Too many requests, na Google inapendekeza backoff ya kielelezo yenye kukatwa: subiri muda mrefu zaidi baada ya kila jaribio lililoshindwa, kwa kuchelewa kwa nasibu, hadi kiwango cha juu. Ombi moja linalochukua zaidi ya sekunde 180 linakwisha muda.

Kivitendo: usiite API kila mara ukurasa unapotazamwa. Hifadhi data ya sheet kwenye kache kwa dakika moja au zaidi, unganisha visomo kwa batchGet, na unganisha maandishi pale inapowezekana.

Chaguo na mabadilishano

Kwa chochote chenye watumiaji wengi au data nyeti, hifadhidata ndiyo chanzo bora cha ukweli. Angalia hifadhidata ni nini.

Maagizo ya kumpa kijenzi chako cha AI

Kusoma sheet:

Onyesha kichupo cha "Menu" cha Google Sheet yetu kwenye ukurasa wa menyu. Tumia Google Sheets API kutoka kwenye seva kwa akaunti ya huduma ambayo ufunguo wake wa JSON uko kwenye siri GOOGLE_SERVICE_ACCOUNT_JSON, na kitambulisho cha spreadsheet kiko kwenye SHEET_ID. Soma safu Menu!A2:D (jina, maelezo, bei, kategoria). Hifadhi matokeo kwenye kache kwa dakika 5. API ikishindwa, onyesha toleo la mwisho lililohifadhiwa. Usitume ufunguo kwenye kivinjari kamwe.

Kuandika safu:

Mtu anapowasilisha fomu ya mawasiliano, ihifadhi kwenye hifadhidata yetu na pia uongeze safu kwenye kichupo cha "Leads" (tarehe, jina, barua pepe, ujumbe) kwa kutumia spreadsheets.values.append yenye valueInputOption RAW. Google ikirudisha 429, jaribu tena kwa backoff ya kielelezo; likiendelea kushindwa, weka lead kwenye hifadhidata na ujaribu tena baadaye.

Makosa ya kawaida

• Kusahau kushiriki sheet na barua pepe ya akaunti ya huduma. API kisha inarudisha hitilafu ya ruhusa hata ufunguo ukiwa sahihi.
• Ufunguo kwenye frontend au kwenye hazina ya msimbo. Ufunguo wa JSON unatoa ufikiaji kwa kila sheet iliyoshirikiwa nao. Angalia jinsi ya kulinda API keys.
• Kutumia USER_ENTERED kwa ingizo la mtumiaji, jambo linaloruhusu fomula kuingizwa.
• Kuita API kwenye kila ombi na kufikia kikomo cha kila dakika kwenye kilele cha kwanza cha trafiki.
• Kutegemea nafasi za safuwima. Mtu anaingiza safuwima na programu inasoma data isiyo sahihi. Soma safu ya kichwa na uweke ramani kwa jina, au funga kichwa.
• Kushiriki sheet kwa upana zaidi kuliko inavyohitajika. "Anyone with the link" inaifanya kuwa ya umma.
• Kutumia sheet kama hifadhidata ya watumiaji wengi. Maandishi ya wakati mmoja na ruhusa zinazokosekana zinasababisha data kupotea au kuvuja.

Orodha ya ukaguzi

• Sheets API imewashwa; akaunti ya huduma imetengenezwa
• Sheet imeshirikiwa na barua pepe ya akaunti ya huduma kwa jukumu la chini kabisa linalohitajika
• Ufunguo na kitambulisho cha sheet vimehifadhiwa kama siri za upande wa seva
• Miito yote inatoka kwenye seva
• Majina ya vichupo yanatumika kwenye safu
• RAW inatumika kwa maandishi yanayotolewa na mtumiaji
• Visomo vimehifadhiwa kwenye kache; 429 inashughulikiwa kwa backoff
• Programu inaendelea kufanya kazi kwa namna ya kupungua Sheets ikikosekana
• Imeamuliwa upande upi ni chanzo cha ukweli

Google Sheets kwenye Mythex

Mythex ina njia mbili tofauti za kufanya kazi na Sheets. Viunganishi vinaunganisha akaunti yako ya Google na Mythex ili wakala aitumie wakati unajenga, kwa mfano kusoma sheet kujenga dashibodi kutoka kwake; nyaraka zinasema kitambulisho kinabaki kwenye huduma ya muunganisho ya Mythex na hakiingii kwenye msimbo wako kamwe (angalia Viunganishi, na idhinisha kila ruhusa ambayo Google inaomba). Kwa programu iliyochapishwa kusoma au kuandika sheet yenyewe, njia ya kuaminika ndiyo iliyo kwenye mwongozo huu: ufunguo wa akaunti ya huduma uliohifadhiwa kama siri ya mradi na miito ya Sheets API kutoka kwenye seva yako, kama inavyoonyeshwa kwenye Unganisha API yoyote. Ukizidi sheet, mwombe wakala ahamishe data kwenye hifadhidata ya mradi na ajenge dashibodi juu yake.

Maswali