როგორ დავაკავშიროთ Google Sheets თქვენს აპთან
Google Sheets-ის აპთან დასაკავშირებლად ჩართეთ Google Sheets API Google Cloud-ის პროექტში, შექმენით სერვისის ანგარიში, გააზიარეთ სპრედშიტი სერვისის ანგარიშის ელფოსტაზე და მისი გასაღები შეინახეთ როგორც სერვერის მხარის საიდუმლო. შემდეგ თქვენი სერვერი ჩანაწერებს spreadsheets.values.get-ით კითხულობს და spreadsheets.values.append-ით ამატებს. თუ მომხმარებლებს საკუთარი სპრედშიტების დაკავშირება სჭირდებათ, გამოიყენეთ OAuth, ხოლო თუ სპრედშიტი სრულად საჯაროა, წაკითხვისთვის მარტივი API გასაღებიც საკმარისია.
ეს გზამკვლევი აღწერს, რომელი მეთოდი რა შემთხვევაშია შესაფერისი, საჭირო გამოძახებებს, ლიმიტებსა და მახასიათებლებს, და მოთხოვნებს AI აპის შემქმნელისთვის. Google-ის დეტალები აღებულია Google-ის დეველოპერის დოკუმენტაციიდან 2026 წლის სექტემბრის მდგომარეობით.
რატომ დავაკავშიროთ სპრედშიტი
ხშირი მიზეზები:
- გუნდის სამუშაო პროცესის შენარჩუნება. თანამშრომლები Sheets-ში აგრძელებენ ფასების სიის ან გრაფიკის რედაქტირებას, აპი კი მას აჩვენებს.
- მონაცემების შეგროვება იქ, სადაც ხალხი უკვე იყურება. ახალი რეგისტრაციები, შეკვეთები ან ფორმის პასუხები ჩანაწერებად ჩნდება.
- ანგარიშგება. აპის მონაცემების ექსპორტი სპრედშიტში მათთვის, ვინც სპრედშიტებში მუშაობს.
- გადასვლის საფეხური. დაიწყეთ სპრედშიტიდან, შემდეგ გადადით სრულფასოვან მონაცემთა ბაზაზე. იხილეთ როგორ გადავაქციოთ სპრედშიტი აპად.
აირჩიეთ, როგორ შედის თქვენი აპი Google-ში
Google-ის ავტორიზაციის გზამკვლევი სამ ტიპს აღწერს:
| ავტორიზაცია | რას შეუძლია | საუკეთესოა |
|---|---|---|
| API გასაღები | მხოლოდ საჯაროდ ხელმისაწვდომი მონაცემები, მაგალითად ფაილები, გაზიარებული „ბმულის მქონე ყველასთვის“ | საჯარო სპრედშიტის წაკითხვა |
| სერვისის ანგარიში | თქვენი აპის მფლობელობაში მყოფი მონაცემები, ან კონკრეტული ფაილები, რომლებიც სერვისის ანგარიშის ელფოსტაზეა გაზიარებული | თქვენი აპი კითხულობს და წერს თქვენს სპრედშიტებს |
| OAuth კლიენტის ID | მომხმარებლის საკუთარი ფაილები, თანხმობის შემდეგ | თითოეული მომხმარებლის საშუალება დააკავშიროს თავისი სპრედშიტები |
უმეტესი აპისთვის სწორი არჩევანია სერვისის ანგარიში: ერთი ავტორიზაციის მონაცემები, რომელიც თქვენია, წვდომა კი მხოლოდ იმ სპრედშიტებზე გაქვთ, რომლებიც მას მკაფიოდ გაუზიარეთ.
ნაბიჯ-ნაბიჯ სერვისის ანგარიშით
- შექმენით ან აირჩიეთ Google Cloud-ის პროექტი და ჩართეთ Google Sheets API.
- შექმენით სერვისის ანგარიში და მისი გასაღები. გასაღები JSON ფაილია; მოეპყარით მას როგორც პაროლს.
- გააზიარეთ სპრედშიტი სერვისის ანგარიშის ელფოსტაზე: Viewer, თუ მხოლოდ კითხვა გჭირდებათ, ან Editor, თუ წერაც. Google-ის გზამკვლევის მიხედვით ეს ჩვეულებრივი გაზიარების ეკრანით კეთდება.
- შეინახეთ გასაღები როგორც საიდუმლო სერვერზე, მაგალითად
GOOGLE_SERVICE_ACCOUNT_JSON, და სპრედშიტის ID (გრძელი სტრიქონი სპრედშიტის URL-ში) როგორცSHEET_ID. - გამოიძახეთ API სერვერიდან Google-ის კლიენტური ბიბლიოთეკით თქვენი ენისთვის.
- ქეშირება წაკითხვებისთვის, თუ ბევრი ვიზიტორი ერთსა და იმავე მონაცემს ხედავს, რომ ლიმიტს არ მიადგეთ.
გამოძახებები, რომლებიც გამოგადგებათ
Google-ის გზამკვლევიდან მნიშვნელობების წაკითხვისა და ჩაწერისთვის:
| მეთოდი | რას აკეთებს |
|---|---|
spreadsheets.values.get | კითხულობს ერთ დიაპაზონს, მაგალითად Leads!A1:E |
spreadsheets.values.batchGet | კითხულობს რამდენიმე დიაპაზონს ერთი მოთხოვნით |
spreadsheets.values.update | წერს კონკრეტულ დიაპაზონში |
spreadsheets.values.append | ამატებს სტრიქონებს ცხრილის არსებული მონაცემების შემდეგ |
დიაპაზონები 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-ის ლიმიტების გვერდი ასეთ რიცხვებს აჩვენებს:
| ლიმიტი | წაკითხვის მოთხოვნები | ჩაწერის მოთხოვნები |
|---|---|---|
| წუთში, პროექტზე | 300 | 300 |
| წუთში, მომხმარებელზე, პროექტზე | 60 | 60 |
დღიური ლიმიტი არ არსებობს, სანამ წუთობრივ ლიმიტებში რჩებით. ლიმიტის გადაჭარბება აბრუნებს 429: Too many requests-ს, და Google ურჩევს შემცირებულ ექსპონენციურ დაყოვნებას: ყოველი წარუმატებელი მცდელობის შემდეგ უფრო დიდხანს დაელოდეთ, შემთხვევითი დაყოვნებით, მაქსიმუმამდე. ერთი მოთხოვნა, რომელიც 180 წამზე მეტ ხანს გრძელდება, დროის ლიმიტს ეხება.
პრაქტიკაში: ნუ გამოიძახებთ API-ს ყოველ გვერდის ნახვაზე. ქეშში შეინახეთ სპრედშიტის მონაცემები ერთი წუთი ან მეტი, წაკითხვები batchGet-ით დააჯგუფეთ და სადაც შესაძლებელია, ჩაწერებიც.
ვარიანტები და კომპრომისები
| მიდგომა | დადებითი | უარყოფითი |
|---|---|---|
| სპრედშიტი როგორც ცოცხალი მონაცემთა წყარო | ხალხი ნაცნობ ინსტრუმენტში არედაქტირებს; ადმინისტრაციული ეკრანები არ გჭირდებათ | ლიმიტები, არ არის სტრიქონებზე უფლებები, ადვილად ირღვევა სვეტის სახელის შეცვლით |
| სპრედშიტის სინქრონიზაცია მონაცემთა ბაზაში | სწრაფი, საიმედო წაკითხვა; აპი მუშაობს, თუ Sheets გაითიშა | გჭირდებათ სინქრონიზაციის სამუშაო და წესი, რომელი მხარე იმარჯვებს |
| ჯერ მონაცემთა ბაზა, ექსპორტი სპრედშიტში | აპი ფლობს მონაცემებს; სპრედშიტი ანგარიშია | სპრედშიტში რედაქტირება უკან არ ბრუნდება |
| შუალედური ავტომატიზაციის ინსტრუმენტი | კოდის გარეშე მარტივი პროცესებისთვის | კიდევ ერთი გამოწერა; გამართვა უფრო ძნელია |
მრავალი მომხმარებლის ან მგრძნობიარე მონაცემების შემთხვევაში მონაცემთა ბაზა უკეთესი წყაროა. იხილეთ რა არის მონაცემთა ბაზა.
მოთხოვნები თქვენი AI აპის შემქმნელისთვის
სპრედშიტის წაკითხვა:
აჩვენე ჩვენი Google Sheet-ის „Menu“ ჩანართი მენიუს გვერდზე. გამოიყენე Google Sheets API სერვერიდან სერვისის ანგარიშით, რომლის JSON გასაღებიც არის საიდუმლოში GOOGLE_SERVICE_ACCOUNT_JSON, ხოლო სპრედშიტის ID — SHEET_ID-ში. წაიკითხე დიაპაზონი Menu!A2:D (სახელი, აღწერა, ფასი, კატეგორია). შედეგი ქეშში შეინახე 5 წუთით. თუ API ვერ მუშაობს, აჩვენე ბოლო ქეშირებული ვერსია. გასაღები ბრაუზერში არასდროს გაგზავნო.
სტრიქონების ჩაწერა:
როცა ვინმე საკონტაქტო ფორმას გააგზავნის, შეინახე იგი ჩვენს მონაცემთა ბაზაში და ასევე დაამატე სტრიქონი „Leads“ ჩანართში (თარიღი, სახელი, ელფოსტა, შეტყობინება) spreadsheets.values.append-ით, valueInputOption RAW-ით. თუ Google 429-ს დააბრუნებს, ცადე ექსპონენციური დაყოვნებით; თუ მაინც ვერ მუშაობს, ლიდი მონაცემთა ბაზაში დარჩეს და მოგვიანებით ხელახლა ცადე.
ხშირი შეცდომები
- სპრედშიტის გაუზიარებლობა სერვისის ანგარიშის ელფოსტაზე. მაშინ API წვდომის შეცდომას აბრუნებს, მაშინაც კი თუ გასაღები სწორია.
- გასაღები ფრონტენდში ან რეპოზიტორიაში. JSON გასაღები წვდომას აძლევს ყველა სპრედშიტზე, რომელიც მას აქვს გაზიარებული. იხილეთ როგორ შევინახოთ API გასაღებები უსაფრთხოდ.
- USER_ENTERED მომხმარებლის შეყვანისთვის, რაც ფორმულის ინექციას უშვებს.
- API-ის გამოძახება ყოველ მოთხოვნაზე და წუთობრივ ლიმიტზე პირველ ტრაფიკის მწვერვალზე დაჯახება.
- სვეტების პოზიციაზე დამოკიდებულება. ვინმე სვეტს ჩასვამს, და აპი არასწორ მონაცემს წაიკითხავს. წაიკითხეთ სათაურის სტრიქონი და ასახეთ სახელით, ან დაიცავით სათაური.
- სპრედშიტის საჭიროზე ფართოდ გაზიარება. „ბმულის მქონე ყველას“ არჩევანი მას საჯაროდ ხდის.
- სპრედშიტის გამოყენება როგორც მრავალმომხმარებლიანი მონაცემთა ბაზის. ერთდროული ჩაწერები და უფლებების არქონა მონაცემების დაკარგვასა და გაჟონვას იწვევს.
ჩამონათვალი
- Sheets API ჩართულია; სერვისის ანგარიში შექმნილია
- სპრედშიტი გაზიარებულია სერვისის ანგარიშის ელფოსტაზე ყველაზე დაბალი საჭირო როლით
- გასაღები და სპრედშიტის ID შენახულია როგორც სერვერის საიდუმლოები
- ყველა გამოძახება სერვერიდან ხდება
- დიაპაზონებში გამოყენებულია ჩანართების სახელები
- მომხმარებლის მიერ შეყვანილი ტექსტისთვის გამოიყენება RAW
- წაკითხვები ქეშირებულია; 429 დამუშავებულია დაყოვნებით
- აპი სწორად მუშაობს, თუ Sheets მიუწვდომელია
- გადაწყვეტილია, რომელი მხარეა მონაცემების წყარო
Google Sheets Mythex-ში
Mythex-ში სპრედშიტებთან მუშაობის ორი განსხვავებული გზა არსებობს. კონექტორები აკავშირებს თქვენს Google ანგარიშს Mythex-თან, რომ აგენტმა მას აშენების დროს გამოიყენოს, მაგალითად სპრედშიტის წასაკითხად და მისგან დაშბორდის ასაგებად; დოკუმენტაციის თანახმად, ავტორიზაცია Mythex-ის კავშირების სერვისში რჩება და კოდში არ ხვდება (იხილეთ კონექტორები, და დაამტკიცეთ Google-ის მიერ მოთხოვნილი ყველა უფლება). იმისთვის, რომ გამოქვეყნებულმა აპმა დამოუკიდებლად წაიკითხოს ან ჩაწეროს სპრედშიტი, საიმედო გზაა ამ გზამკვლევში აღწერილი: სერვისის ანგარიშის გასაღები როგორც პროექტის საიდუმლო და Sheets API-ს გამოძახებები სერვერიდან, როგორც ნებისმიერი API-ს ინტეგრაციაში. თუ სპრედშიტს უკვე გასცდით, სთხოვეთ აგენტს მონაცემები პროექტის მონაცემთა ბაზაში გადაიტანოს და მის საფუძველზე ააშენოს დაშბორდი.
კითხვები
როგორ წაიკითხავს ჩემი აპი კერძო Google Sheet-ს?
ჩვეულებრივი გზაა Google Cloud-ის სერვისის ანგარიში: ჩართეთ Sheets API, შექმენით სერვისის ანგარიში და მისი გასაღები, შემდეგ სპრედშიტი გაუზიარეთ სერვისის ანგარიშის ელფოსტას როგორც Viewer ან Editor. თქვენი სერვერი გასაღებს, რომელიც საიდუმლოდაა შენახული, იყენებს Sheets API-ს გამოსაძახებლად.
შემიძლია Google API გასაღები გამოვიყენო სპრედშიტთან წვდომისთვის?
მხოლოდ საჯარო მონაცემებისთვის. Google-ის ავტორიზაციის გზამკვლევი ამბობს, რომ API გასაღებები განკუთვნილია საჯაროდ ხელმისაწვდომ მონაცემებზე ანონიმური წვდომისთვის, მაგალითად ფაილებზე, რომლებიც ბმულის მქონე ყველას აქვს გაზიარებული. კერძო სპრედშიტებს სერვისის ანგარიში ან OAuth სჭირდება.
რა ლიმიტები აქვს Google Sheets API-ს?
2026 წლის სექტემბრის მდგომარეობით, Google ითვლის 300 წაკითხვისა და 300 ჩაწერის მოთხოვნას წუთში პროექტზე და 60-60-ს წუთში მომხმარებელზე პროექტზე, დღიური ლიმიტის გარეშე. ლიმიტის გადაჭარბება 429 შეცდომას იწვევს; Google ურჩევს შემცირებულ ექსპონენციურ დაყოვნებას (exponential backoff).
შემიძლია Google Sheets გამოვიყენო აპის მონაცემთა ბაზად?
ეს მუშაობს მცირე, დაბალი ტრაფიკის აპებისთვის, სადაც ხალხი მონაცემებს თავად სპრედშიტშიც არედაქტირებს. ბევრი მომხმარებლისთვის, ხშირი ჩაწერისთვის, ჩანაწერებს შორის კავშირებისთვის ან მომხმარებლების უფლებებისთვის რეალური მონაცემთა ბაზა უფრო საიმედოა, და სპრედშიტშიც მაინც შეგიძლიათ ექსპორტი.