Projekty Google Cloud

Każdy projekt Apps Script korzysta z Google Cloud do zarządzania autoryzacją, usługami zaawansowanymi i innymi informacjami. Aby można było skonfigurować te ustawienia i nimi zarządzać, każdy projekt Apps Script ma powiązany projekt Google Cloud. Projekt skryptu może korzystać z domyślnego projektu tworzonego automatycznie przez Apps Script lub standardowego projektu utworzonego przez Ciebie. Ogólnie projekty domyślne nadają się do tworzenia zwykłych lub prostych skryptów, ale używaj standardowego projektu do każdej aplikacji o złożonej, komercyjnej jakości lub do opublikowania.

W każdej chwili możesz przełączyć się z projektu domyślnego na projekt standardowy, ale nie możesz przełączyć się z powrotem na projekt domyślny. Na początku tworzenia skryptu najlepiej wybrać projekt Cloud, którego używa Twój skrypt. Późniejsze przejście może spowodować komplikacje, na przykład konieczność ponownej autoryzacji.

Domyślne projekty Cloud

Gdy tworzysz projekt Apps Script, Apps Script tworzy domyślny projekt Cloud, który działa w tle.

  • W przypadku większości skryptów ten domyślny projekt nie jest nigdy potrzebny ani widoczny. Apps Script obsługuje niezbędne interakcje z Google Cloud. Jeśli np. aktywujesz usługę zaawansowaną w edytorze Apps Script, po zapisaniu projektu skryptu Apps Script aktywuje tę usługę w domyślnym projekcie Cloud.
  • W przypadku niektórych skryptów musisz korzystać z konsoli Google Cloud. W takich przypadkach skrypt musi używać standardowego projektu Cloud. Aby na przykład wyświetlić logi Google Cloud w konsoli Google Cloud, skrypt musi używać standardowego projektu.

Domyślnie projekty Cloud mają zasadę Identity and Access Management (IAM) z 1 wpisem – kontem usługi Google, który jest właścicielem domyślnego projektu. Konto usługi Google to appsdev-apps-dev-script-auth@system.gserviceaccount.com.

Wyświetl lub zaktualizuj domyślne projekty Cloud

Większość użytkowników nie może bezpośrednio lokalizować, wyświetlać ani edytować domyślnych projektów w konsoli Google Cloud. Jeśli jesteś administratorem, zapoznaj się z artykułem Wyświetlanie domyślnych projektów Google Cloud.

Jeśli projekt skryptu został utworzony przed 8 kwietnia 2019 r., możesz użyć projektu domyślnego, który jest dostępny w konsoli Google Cloud. Aby uzyskać dostęp do projektu domyślnego, otwórz ustawienia projektu skryptu i kliknij numer projektu.

Usuwanie domyślnych projektów Cloud

Jeśli jesteś administratorem, możesz usuwać domyślne projekty Cloud, tak jak w przypadku standardowych projektów Cloud. Zobacz Usuwanie projektów Apps Script Cloud.

Jeśli nie jesteś administratorem, nie możesz usuwać projektów domyślnych. Apps Script usuwa jednak domyślne projekty w tych sytuacjach:

  • Jeśli usuniesz projekt skryptu lub zmienisz go na standardowy projekt, Apps Script usunie domyślny projekt dołączony do skryptu wraz ze wszystkimi ustawieniami i informacjami, które się w nim znajdują.
  • Jeśli skrypt nie działa przez co najmniej 180 dni, Apps Script usuwa powiązany z nim projekt domyślny. Jeśli skrypt zostanie uruchomiony po usunięciu domyślnego projektu przez Apps Script, Apps Script utworzy projekt dla skryptu.

Standardowe projekty Cloud

Domyślne projekty Cloud to najlepsze rozwiązanie w przypadku większości projektów skryptów, chyba że musisz skonfigurować projekt ręcznie. W takiej sytuacji musisz zmienić projekt skryptu na standardowy.

W kolejnych sekcjach opisano, kiedy Apps Script wymaga standardowego projektu, oraz poznasz ich właściwości i typowe zadania, które można w nich wykonać. Poniższe zadania możesz wykonywać tylko w standardowych projektach.

Gdy Apps Script wymaga standardowych projektów Cloud

Projektu standardowego musisz użyć w tych sytuacjach:

Standardowe właściwości projektu Cloud

Projekty standardowe mają te właściwości:

  • Dostęp do wszystkich ustawień Google Cloud projektu możesz uzyskać bezpośrednio w konsoli Google Cloud. Dzięki temu możesz aktywować interfejsy API, dostosować dane logowania do autoryzacji i skonfigurować inne szczegóły.
  • Gdy usuniesz projekt skryptu lub przełączysz go na inny projekt standardowy, pierwotny projekt standardowy pozostanie i będzie można go użyć ponownie.
  • Po aktywowaniu usługi zaawansowanej w projekcie skryptu musisz ręcznie aktywować odpowiedni interfejs API w projekcie standardowym.
  • Ten sam projekt standardowy może być współużytkowany przez wiele projektów skryptu i innych aplikacji. Jeśli chcesz opublikować projekt skryptu jako dodatek w Google Workspace Marketplace, musisz mieć własny projekt standardowy. Opublikowane aplikacje nie mogą udostępniać projektów Cloud innym aplikacjom.
  • Jeśli chcesz uruchamiać funkcje w projekcie skryptu z innej aplikacji za pomocą metody scripts.run interfejsu Apps Script API, projekt skryptu i aplikacja wywołująca muszą mieć ten sam projekt standardowy.
  • Gdy Apps Script prosi użytkownika o autoryzację skryptu, który korzysta ze standardowego projektu, do jego identyfikacji używana jest nazwa projektu Cloud, a nie nazwa projektu skryptu. Z tego powodu ustaw odpowiednią nazwę projektu Cloud.

Dostęp do standardowego projektu Cloud

Aby uzyskać dostęp do standardowego projektu powiązanego z Twoim projektem skryptu, wykonaj te czynności:

  1. Otwórz projekt Apps Script.
  2. Po lewej stronie kliknij Ustawienia projektu .
  3. W sekcji Projekt Google Cloud Platform (GCP) kliknij numer projektu.

Projekt standardowy znajdziesz też bezpośrednio na stronie Zarządzanie zasobami w konsoli Google Cloud.

Aktywowanie interfejsu API w standardowym projekcie Cloud

Często aplikacja Apps Script wymaga dostępu do innego interfejsu API Google. Aby to zrobić, musisz aktywować interfejs API w odpowiednim projekcie Cloud. Aktywuj interfejs API, wykonując te czynności:

  1. Otwórz projekt Google Cloud.
  2. Kliknij Menu > Interfejsy API i usługi.
  3. Kliknij Włącz interfejsy API i usługi.
  4. W polu wyszukiwania wpisz interfejs API, który chcesz aktywować, i naciśnij Enter.
  5. Kliknij interfejs API w wynikach wyszukiwania, a następnie kliknij Włącz, aby aktywować interfejs API w tym projekcie Cloud.

Może pojawić się prośba o zaakceptowanie Warunków korzystania z interfejsów API Google lub Google Cloud. Przeczytaj je uważnie, zanim je zaakceptujesz.

W zależności od aplikacji może być też konieczne skonfigurowanie interfejsu API przez wybranie go w panelu Interfejsy API i usługi.

Określanie identyfikatora i numeru standardowego projektu Cloud

Wszystkie projekty Cloud mają nazwę, identyfikator i numer projektu. Czasami potrzebujesz tych identyfikatorów do konfigurowania usług lub wykonywania innych zadań.

Aby określić identyfikator i numer projektu standardowego:

  1. Otwórz projekt Google Cloud.
  2. W prawym górnym rogu kliknij Więcej > Ustawienia projektu.
  3. Wyświetl nazwę projektu, identyfikator projektu i numer projektu w wynikowym panelu Ustawienia. Numer projektu składa się tylko z cyfr, a identyfikator projektu jest alfanumeryczny. Możesz edytować nazwę projektu, która jest wyświetlana użytkownikom podczas próśb o autoryzację.

Wyświetlanie logów i raportów o błędach Google Cloud w konsoli Google Cloud

Jeśli w projekcie skryptu korzystasz z Google Cloud Logging lub raportowania błędów, możesz wyświetlić te logi i raporty w konsoli Google Cloud, wykonując te czynności:

  1. Otwórz projekt Google Cloud.
  2. Kliknij Menu .
  3. Przewiń w dół do sekcji Operacje i kliknij Logowanie > Eksplorator logów.
  4. Aby wyświetlić raporty o błędach, przewiń w dół do sekcji Operacje i kliknij Error Reporting. Jeśli pojawi się prośba o skonfigurowanie raportowania błędów, oznacza to, że w projekcie skryptu nie zarejestrowano jeszcze żadnych wyjątków.

W przypadku usług, które wymagają protokołu OAuth, Google prosi użytkowników o autoryzację tych usług. Dzięki ustawieniom ekranu zgody OAuth możesz skonfigurować niektóre informacje, które Google przedstawia użytkownikom, np. nazwę aplikacji i adres URL Warunków korzystania z usługi.

Domyślne projekty Cloud automatycznie tworzą ekran zgody na podstawie szczegółów projektu Apps Script. Nie możesz zmienić tych ustawień. W standardowych projektach Cloud możesz dostosować te informacje. Aby skonfigurować ekran zgody w skrypcie, wykonaj te czynności:

  1. Otwórz projekt Google Cloud.
  2. Kliknij Menu > Interfejsy API i usługi > Dane logowania.
  3. Kliknij Konfiguruj ekran zgody.
  4. Wypełnij każdą sekcję przepływu pracy ekranu zgody.
  5. Aby rejestrować zmiany na każdym etapie przepływu pracy, kliknij Zapisz i kontynuuj.

Tworzenie danych logowania OAuth

Apps Script zwykle konfiguruje OAuth na potrzeby usług, których używa Twój skrypt. W przypadku niektórych aplikacji trzeba utworzyć dodatkowe dane logowania OAuth (identyfikatory klientów i tajne klucze klienta). Można to zrobić tylko w przypadku standardowych projektów.

Aby utworzyć identyfikator klienta i tajny klucz klienta dla projektu skryptu, wykonaj te czynności:

  1. Otwórz projekt Google Cloud.
  2. Kliknij Menu > Interfejsy API i usługi > Dane logowania.
  3. Kliknij Utwórz dane logowania > Identyfikator klienta OAuth.
  4. W sekcji Typ aplikacji wybierz typ aplikacji i w razie potrzeby wypełnij formularz. Gdy skończysz, kliknij Utwórz.
  5. W wyświetlonym oknie kliknij Pobierz JSON. Za pomocą tego pliku możesz skonfigurować protokół OAuth.

Dodawanie kolejnych właścicieli do standardowego projektu Cloud

Do standardowego projektu możesz dodać dodatkowych właścicieli lub inne role. Jeśli współpracujesz nad projektem, osoba z Twojego zespołu zawsze będzie miała dostęp do ustawień Google Cloud projektu skryptu.

Aby dodać do standardowego projektu dodatkowych właścicieli lub inne role, wykonaj te czynności. Aby wprowadzić którąkolwiek z tych zmian, musisz mieć w projekcie uprawnienia do edycji:

  1. Określ, kim powinni być Twoi współpracownicy. Zalecamy utworzenie lub użycie istniejącej grupy dyskusyjnej Google. Możesz też określić domeny na liście współpracowników, aby uwzględnić wszystkich użytkowników w tych domenach.
  2. Otwórz projekt Google Cloud skryptu.
  3. Kliknij Menu > Administracja > Uprawnienia.
  4. U góry kliknij Dodaj.
  5. Postępuj zgodnie z instrukcjami wyświetlanymi na ekranie, aby dodać do projektu Cloud co najmniej 1 użytkownika i jego role. Możesz dodawać poszczególne adresy e-mail, grupy dyskusyjne Google lub domeny jako nowych członków.
  6. Kliknij Zapisz.

Grupowanie wielu skryptów w jednym projekcie Cloud

Ten sam standardowy projekt Cloud może zawierać wiele projektów Apps Script. Aby to zrobić, utwórz standardowy projekt, a następnie przełącz poszczególne projekty skryptu, aby z niego korzystać. Nie można tego zrobić w projektach domyślnych.

Użyj innego standardowego projektu Cloud

Możesz zmienić projekt skryptu, aby używał innego standardowego projektu Cloud. Jeśli Twój skrypt wymaga ręcznej konfiguracji projektu Cloud, musisz przełączyć się z projektu domyślnego na projekt standardowy. Aby dowiedzieć się, kiedy warto korzystać ze standardowego projektu, przeczytaj artykuł o standardowych projektach Cloud.

Skutki przejścia na inny standardowy projekt Cloud

Skutki zmiany skryptu z projektu domyślnego lub innego standardowego projektu są następujące:

  • Jeśli w swoim skrypcie aktywowano usługi zaawansowane, musisz włączyć odpowiednie interfejsy API w nowym projekcie Cloud. Utracisz wszystkie dane powiązane z usługami zaawansowanymi w poprzednim projekcie Cloud. Aby dowiedzieć się, jak włączyć interfejsy API w projekcie Cloud, przeczytaj artykuł Włączanie interfejsów Google Workspace APIs.
  • Jeśli skrypt korzysta z wbudowanej usługi Dysk Google, musisz włączyć interfejs Drive API w standardowych projektach Cloud.

    W standardowym projekcie Cloud włącz interfejs Drive API:

    Włączanie interfejsu Drive API

  • Wszyscy użytkownicy, którzy wcześniej autoryzowali skrypt, muszą ponownie autoryzować ten skrypt. W większości przypadków wszyscy użytkownicy, którzy wcześniej autoryzowali aplikacje powiązane z nowym projektem, muszą też ponownie autoryzować aplikacje.
  • Jeśli skrypt jest powiązany z informacjami o aplikacji w Google Workspace Marketplace, informacje o aplikacji, użytkownicy i opinie nie są przenoszone do nowego projektu. Musisz utworzyć listę aplikacji w nowym projekcie, a użytkownicy muszą ponownie zainstalować aplikację. Informacje na temat tworzenia nowych informacji o aplikacji znajdziesz w artykule Publikowanie aplikacji.
  • Nie możesz przełączyć skryptu z powrotem na projekt domyślny. Apps Script usuwa projekty domyślne po ustawieniu w skrypcie korzystania ze standardowego projektu.

Przełącz się na inny standardowy projekt Cloud

Aby przełączyć istniejący projekt Cloud skryptu na inny projekt Google Cloud, wykonaj te czynności:

  1. Jeśli nie masz odpowiedniego projektu Cloud, utwórz go, postępując zgodnie z instrukcjami tworzenia projektu. Ustaw łatwą do zapamiętania nazwę projektu, aby można ją było znaleźć na stronie Zarządzanie zasobami w konsoli Google Cloud. Apps Script używa tej nazwy, gdy prosisz użytkowników o autoryzację skryptu.
  2. Jeśli chcesz użyć istniejącego projektu, otwórz stronę Zarządzanie zasobami w konsoli Google Cloud i znajdź istniejący projekt, którego chcesz użyć. Musisz mieć w projekcie przypisaną rolę przeglądarki projektu i edytującego konfigurację OAuth lub role z równoważnymi uprawnieniami. Nie możesz użyć projektu, który został automatycznie utworzony przez Apps Script.
  3. Określ numer projektu Cloud.
  4. Otwórz skrypt, którego projekt Cloud chcesz zastąpić.
  5. Po lewej stronie kliknij Ustawienia projektu .
  6. W sekcji Projekt Google Cloud Platform (GCP) kliknij Zmień projekt.
  7. Wpisz numer nowego projektu i kliknij Ustaw projekt.

Projekty w chmurze i dyski współdzielone

Dyski współdzielone (dawniej Dyski zespołu) to miejsca współdzielone, w których grupy użytkowników Dysku mogą współpracować nad projektami Apps Script i dokumentami na Dysku. Dyski współdzielone są przydatne przy tworzeniu skryptów, dodatków i aplikacji internetowych w zespole, ale nakładają pewne ograniczenia na możliwości, jakie można wykonywać w przypadku starszych domyślnych projektów Cloud.

Na liście ograniczeń opisano sposób, w jaki projekty Cloud wchodzą w interakcje z dyskami współdzielonymi:

  • Jeśli projekt skryptu znajduje się na dysku współdzielonym, nie obowiązują żadne dodatkowe ograniczenia.
  • Jeśli projekt skryptu korzysta z domyślnego projektu utworzonego 8 kwietnia 2019 r. lub później, nie obowiązują żadne dodatkowe ograniczenia, jeśli ten projekt znajduje się na dysku współdzielonym.
  • Jeśli Twój projekt skryptu korzysta z domyślnego projektu utworzonego przed 8 kwietnia 2019 r., gdy ten projekt znajduje się na dysku współdzielonym, obowiązują te ograniczenia:
    1. Do domyślnego projektu nie można uzyskać dostępu za pomocą interfejsu Apps Script ani konsoli Google Cloud. To ograniczenie uniemożliwia wykonywanie działań, które wymagają bezpośredniego dostępu do projektu.
    2. Nie możesz aktywować usług zaawansowanych. Aby aktywować usługi zaawansowane, przełącz się na projekt standardowy.
    3. Gdy przenosisz istniejący projekt Apps Script na dysk współdzielony, Google ogranicza dostęp do domyślnego projektu Cloud. Jeśli przed przeniesieniem miałeś do niego dostęp, zachowasz dostęp do projektu domyślnego. Jeśli na przykład utworzysz skrypt w folderze Mój dysk, a potem przeniesiesz go na dysk współdzielony, nadal będziesz mieć dostęp do projektu Cloud skryptu. Twoi współpracownicy korzystający z dysku współdzielonego mogą nie mieć uprawnień.
    4. Skrypt zachowuje nazwę projektu Cloud sprzed przeniesienia na dysk współdzielony. Nawet jeśli zmienisz nazwę projektu na dysku współdzielonym, użytkownicy, którzy autoryzują skrypt, nadal będą widzieć starą nazwę w oknach autoryzacji.

Aby uniknąć powyższych ograniczeń w przypadku starszych skryptów, przełącz się na projekt standardowy.

Pobieranie listy projektów Apps Script Cloud

Jeśli masz uprawnienie resourcemanager.projects.list do folderu projektu Apps Script swojej organizacji, możesz wyświetlać wszystkie standardowe i domyślne projekty Apps Script Cloud w tym folderze.

  1. Otwórz stronę Zarządzanie zasobami w konsoli Google Cloud.
  2. Skopiuj identyfikator z folderu Apps Script.
  3. Kliknij Filtruj > Identyfikator nadrzędny i wklej identyfikator folderu Apps Script.

Usuwanie projektów Cloud Apps Script

Aby usunąć projekt Cloud Apps Script, wykonaj czynności opisane w sekcji Uzyskiwanie listy projektów Apps Script Cloud, wybierz projekt do usunięcia i kliknij Usuń.

Aby usunąć projekt Apps Script przy użyciu gcloud, użyj tych poleceń.

gcloud projects list --filter='parent.id=APPS_SCRIPT_FOLDER_ID'
gcloud projects delete PROJECT_ID

Więcej informacji o usuwaniu projektów Cloud znajdziesz w artykule o wyłączaniu (usuwaniu) projektów.