Ustawianie arkuszy dla funkcjonalności tworzenia propozycji planu - iiuni/projektzapisy GitHub Wiki

Aby używać funkcjonalności tworzenia propozycji planu trzeba zalogować się na stronę Google dla developerów, aby móc skonfigurować i używać API służącego do łączenia się z dyskiem Google oraz pracy na arkuszach Google będących na dysku.

Ważne: Upewnij się że na stronie Google dla developerów jesteś zarejestrowany kontem Google pod które masz podpięty dysk, którego system zapisów będzie używać.

Co zrobić krok po kroku:

  1. Należy wejść na https://console.developers.google.com/apis i zalogować się.
  2. W górnym lewym rogu strony obok ikonki Google Cloud jest rozwijane menu, które należy kliknąć. Pojawią się dostępne projekty dla danego konta. Teraz jeśli nie masz projektu dla systemu zapisów to stwórz nowy.
  3. Rób to co każą instrukcje.
  4. Teraz znowu klikając w te rozwijane menu otwórz projekt który właśnie stworzyłeś.
  5. W menu nawigacyjnym (lewy górny róg) wybierz Interfejsy API i usługi -> Włączone interfejsy API i usługi
  6. Na tej stronie kliknij WŁĄCZ INTERFEJSY API I USŁUGI.
  7. Wyszukaj na stronie Google Sheets API i przejdź do strony API.
  8. Kliknij niebieski guzik z napisem WŁĄCZ.
  9. W menu nawigacyjnym wybierz Interfejsy API i usługi -> Dane logowania
  10. Na stronie na którą zostałeś przekierowany kliknij guzik z napisem UTWÓRZ DANE LOGOWANIA i wybierz z listy konto usługi.
  11. Tutaj jest prosty formularz który należy wypełnić. Jako rolę na etapie drugim formularza wybierz Projekt-> Właściciel. Na etapie 3 zostaw wszystko puste, ale kliknij guzik Gotowe.
  12. Na liście Konta usługi widoczny będzie konto które właśnie zostało utworzone - kliknij w nie i przejdź do zakładki klucze.
  13. Wybierz Dodaj klucz -> Utwórz nowy klucz -> JSON
  14. Na twój komputer pobrał się plik formatu json. Teraz wszystkie elementy z tego pliku trzeba wpisać do .env. Są tam już gotowe pola które tylko trzeba uzupełnić danymi. Nazwy są takie same lub analogiczne w .env i w tym pliku json.
  15. Teraz należy wejść na dysk Google(dysk podpięty do konta, na którym działo się wszystko wyżej opisane) i stworzyć 2 arkusze: Wyniki głosowania oraz Przydział zajęć.

Ostatnią rzeczą do zrobienia jest wejście do każdego arkusza i zrobić w nim następujące rzeczy:

a) kliknij w prawym górnym rogu guzik z napisem udostępnij i do pola osoby przekopiuj maila z pliku json, który wcześniej pobrałeś. Upewnij się, że dajesz uprawnienia do edycji i kliknij gotowe.

b) W url strony jest zawarte id pliku, musisz je przekopiować i wkleić do .env. W .env są dwa pola do uzupełnienia:

VOTING_RESULTS_SPREADSHEET_ID=id arkusza Wyniki głosowania

CLASS_ASSIGNMENT_SPREADSHEET_ID=id arkusza Przydział zajęć

Jak uzyskać id? Z url strony arkusza, np:

url: https://docs.google.com/spreadsheets/d/1jy195Cvfly7SJ1BI_-eBDjB4tx706ra35GCdFqmGDVM/edit#gid=0

id: 1jy195Cvfly7SJ1BI_-eBDjB4tx706ra35GCdFqmGDVM

Czyli id arkusza to napis pomiędzy /d/ a /edit(lub bez /edit na końcu).

To wszystko, teraz aplikacja łączy się z dyskiem i plikami, które można czytać i edytować.