Ինչպես միացնել Google Sheets-ը ձեր հավելվածին

Google Sheets-ը հավելվածին միացնելու համար Google Cloud նախագծում միացրեք Google Sheets API-ն, ստեղծեք service account, կիսվեք աղյուսակով service account-ի էլ․ հասցեի հետ և բանալին պահեք որպես սերվերային գաղտնիք։ Ձեր սերվերը այնուհետև կարդում է տողերը spreadsheets.values.get-ով և ավելացնում spreadsheets.values.append-ով։ Եթե օգտատերերը պետք է միացնեն իրենց աղյուսակները, օգտագործեք OAuth, իսկ եթե աղյուսակը լրիվ հանրային է, կարդալու համար բավարար է պարզ API բանալին։

Այս ուղեցույցը ներառում է, թե որ մեթոդն է հարմար, անհրաժեշտ կանչերը, քվոտաներն ու թակարդները, և AI հավելվածների կառուցիչի հրահանգները։ Google-ի մանրամասները վերցված են Google-ի մշակողների փաստաթղթերից՝ 2026 թվականի սեպտեմբերի դրությամբ։

Ինչու միացնել աղյուսակ

Սովորական պատճառներ.

• Պահել թիմի աշխատանքային ընթացքը։ Աշխատակիցները շարունակում են խմբագրել գնացուցակը կամ ժամանակացույցը Sheets-ում, իսկ հավելվածը այն ցույց է տալիս։
• Հավաքել տվյալները այնտեղ, որտեղ մարդիկ արդեն նայում են։ Նոր գրանցումները, պատվերները կամ ձևի պատասխանները տողեր են դառնում։
• Հաշվետվություն։ Արտահանեք հավելվածի տվյալները աղյուսակում նրանց համար, ովքեր աղյուսակներում են աշխատում։
• Ճանապարհի սկիզբ։ Սկսեք աղյուսակից, հետո անցեք իրական տվյալների բազայի։ Տե՛ս ինչպես աղյուսակը վերածել հավելվածի։

Ընտրեք, թե ինչպես է ձեր հավելվածը մուտք գործում Google

Google-ի credentials ուղեցույցը նկարագրում է երեք տեսակ.

Մեծ մասի հավելվածների համար service account-ն է ճիշտ ընտրությունը. մեկ հավաքածու հավատարմագրերի, որոնք ձերն են, և մուտք միայն այն աղյուսակներին, որոնք հստակ կիսել եք դրա հետ։

Քայլ առ քայլ 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 գրադարանով ձեր լեզվի համար։
6. Քեշավորեք կարդալը, եթե շատ այցելուներ են տեսնում նույն տվյալները, որպեսզի չհասնեք քվոտային։

Կանչերը, որ կօգտագործեք

Google-ի ուղեցույցից՝ արժեքներ կարդալու և գրելու համար.

Միջակայքերը գրվում են A1 նշանակմամբ։ 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-ը խորհուրդ է տալիս կտրված 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, կրկնիր exponential backoff-ով. եթե դարձյալ ձախողվի, պահիր առաջատարը տվյալների բազայում և նորից փորձիր ավելի ուշ։

Սովորական սխալներ

• Մոռանալ կիսվել աղյուսակով service account-ի էլ․ հասցեի հետ. այդ դեպքում API-ն թույլտվության սխալ է վերադարձնում, թեև բանալին ճիշտ է։
• Բանալին frontend-ում կամ repository-ում։ JSON բանալին մուտք է տալիս բոլոր աղյուսակներին, որոնք դրա հետ են կիսված։ Տե՛ս ինչպես պահել API բանալիները անվտանգ։
• USER_ENTERED-ը օգտատիրոջ մուտքի համար, որը թույլ է տալիս բանաձևերի ներարկում։
• Կանչել API-ն յուրաքանչյուր հարցումի ժամանակ և հասնել րոպեական քվոտային առաջին թրաֆիկի գագաթնակետին։
• Կախվել սյունակների դիրքերից։ Ինչ-որ մեկը սյունակ է ավելացնում, և հավելվածը կարդում է սխալ տվյալներ։ Կարդացեք վերնագրի տողը և քարտեզագրեք անունով, կամ կողպեք վերնագիրը։
• Աղյուսակը կիսել ավելի լայն, քան պետք է։ «Anyone with the link»-ը այն դարձնում է հանրային։
• Աղյուսակը որպես բազմաօգտատեր տվյալների բազա օգտագործել։ Միաժամանակյա գրությունները և բացակայող թույլտվությունները կորցնում կամ արտահոսեցնում են տվյալները։

Ստուգաթերթ

• Sheets API-ն միացված է; service account-ը ստեղծված է
• Աղյուսակը կիսված է service account-ի էլ․ հասցեի հետ՝ անհրաժեշտ ամենացածր դերով
• Բանալին և աղյուսակի ID-ն պահված են որպես սերվերային գաղտնիքներ
• Բոլոր կանչերը կատարվում են սերվերից
• Միջակայքերում օգտագործված են թերթերի անուններ
• RAW-ը օգտագործվում է օգտատիրոջ տեքստի համար
• Կարդալը քեշավորված է; 429-ը մշակված է backoff-ով
• Հավելվածը նորմալ աշխատում է, երբ Sheets-ը անհասանելի է
• Որոշված է, թե որ կողմն է ճշմարտության աղբյուրը

Google Sheets Mythex-ում

Mythex-ում Sheets-ի հետ աշխատելու երկու տարբեր եղանակ կա։ Connectors-ը կապում է ձեր Google հաշիվը Mythex-ի հետ, որպեսզի գործակալը կարողանա օգտագործել այն ձեր կառուցման ընթացքում, օրինակ՝ աղյուսակը կարդալ և դրանից դաշբորդ կառուցել. փաստաթղթերի համաձայն, հավատարմագիրը մնում է Mythex-ի կապի ծառայությունում և երբեք չի հայտնվում ձեր կոդում (տե՛ս Connectors, և հաստատեք Google-ի խնդրած յուրաքանչյուր թույլտվություն)։ Հրապարակված հավելվածի համար, որ աղյուսակը կարդա կամ գրի ինքնուրույն, հուսալի ճանապարհը այս ուղեցույցում նկարագրվածն է. service account բանալի, որը պահվում է որպես նախագծի գաղտնիք, և Sheets API կանչեր սերվերից, ինչպես Integrate any API-ում։ Եթե աղյուսակից արդեն դուրս եք գալիս, խնդրեք գործակալին տվյալները տեղափոխել նախագծի տվյալների բազա և կառուցել դաշբորդ դրա վրա։

Հարցեր