Projekty Google Cloud

Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Każdy projekt Apps Script korzysta z Google Cloud do zarządzania autoryzacją, usługami zaawansowanymi i innymi. Aby skonfigurować te ustawienia i nimi zarządzać, z każdym projektem Apps Script jest powiązany projekt Google Cloud. Projekt skryptu może korzystać z projektu domyślnego utworzonego automatycznie przez Apps Script lub projektu standardowego utworzonego przez Ciebie. Ogólnie projekty domyślne sprawdzają się w przypadku prostych lub codziennych skryptów, ale w przypadku aplikacji, które są złożone, komercyjnej jakości lub które zamierzasz opublikować, użyj standardowego projektu.

W każdej chwili możesz zmienić projekt domyślny na standardowy, ale nie możesz wrócić do projektu domyślnego. Najlepiej wybrać projekt Cloud używany przez skrypt na wczesnym etapie. Przełączenie się później może spowodować komplikacje, np. wymaganie ponownej autoryzacji przez użytkowników.

Domyślne projekty Cloud

Gdy utworzysz projekt Apps Script, utworzy on domyślny projekt Cloud, który działa w tle.

  • W przypadku większości skryptów nigdy nie musisz widzieć ani dostosowywać tego domyślnego projektu. Apps Script obsługuje niezbędne interakcje z Google Cloud. Jeśli na przykład aktywujesz usługę zaawansowaną w edytorze Apps Script, usługa ta aktywuje ją w domyślnym projekcie Cloud podczas zapisywania projektu skryptu.
  • W przypadku niektórych skryptów musisz korzystać z konsoli Google Cloud. W takim przypadku skrypt musi zamiast tego użyć standardowego projektu Cloud. Aby na przykład wyświetlać logi Google Cloud w konsoli Google Cloud, Twój skrypt musi używać standardowego projektu.

Domyślnie projekty Cloud mają zasady zarządzania tożsamościami i dostępem z jednym wpisem – kontem usługi Google, które działa jako właściciel projektu domyślnego. Konto usługi Google to appsdev-apps-dev-script-auth@system.gserviceaccount.com.

Wyświetlanie i aktualizowanie domyślnych projektów 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 Cloud.

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

Usuń domyślne projekty 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. Jednak Apps Script usuwa domyślne projekty w tych sytuacjach:

  • Jeśli usuniesz projekt skryptu lub zmienisz go na standardowy, Google Apps Script usunie domyślny projekt załączony do skryptu wraz z wszelkimi jego ustawieniami i informacjami.
  • Jeśli skrypt nie działa przez co najmniej 180 dni, Apps Script usuwa powiązany projekt domyślny. Jeśli skrypt zostanie uruchomiony po usunięciu domyślnego projektu Apps Script, Apps Script utworzy go dla skryptu.

Standardowe projekty Cloud

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

W poniższych sekcjach znajdziesz informacje o tym, kiedy Apps Script wymaga standardowego projektu, jakie są właściwości takich projektów oraz jakie są często wykonywane w nich zadania. Poniższe zadania można wykonać tylko w przypadku standardowych projektów.

Gdy Apps Script wymaga standardowych projektów Cloud

Musisz używać standardowego projektu w tych sytuacjach:

Właściwości standardowego projektu Cloud

Projekty standardowe mają następujące właściwości:

  • Dostęp do wszystkich ustawień Google Cloud w projekcie możesz uzyskać bezpośrednio w konsoli Google Cloud. Dzięki temu możesz aktywować interfejsy API, dostosować dane logowania i skonfigurować inne szczegóły.
  • Gdy usuniesz projekt skryptu lub zmienisz go na inny, standardowy projekt oryginalny pozostanie bez zmian i będzie można go użyć ponownie.
  • Gdy aktywujesz usługę zaawansowaną w projekcie skryptu, musisz ręcznie aktywować odpowiedni interfejs API w projekcie standardowym.
  • Wiele projektów skryptu i inne aplikacje może współdzielić ten sam standardowy projekt. Jeśli chcesz opublikować projekt skryptu w Google Workspace Marketplace jako dodatek, musi on 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 do obsługi połączeń muszą mieć ten sam standardowy projekt.
  • Gdy skrypt Apps Script prosi użytkownika o autoryzację skryptu korzystającego ze standardowego projektu, do rozpoznania skryptu służy nazwa projektu Cloud. Z tego powodu pamiętaj, aby ustawić odpowiednią nazwę projektu Cloud.

Dostęp do standardowego projektu Cloud

Aby uzyskać dostęp do projektu standardowego powiązanego z 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 możesz też znaleźć bezpośrednio na stronie Zarządzanie zasobami w Google Cloud Console.

Aktywowanie interfejsu API w standardowym projekcie Cloud

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

  1. Otwórz projekt 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 z wyników wyszukiwania, a następnie kliknij Włącz, aby aktywować ten interfejs API w tym projekcie Cloud.

Możesz zobaczyć prośbę o zaakceptowanie Warunków usługi dotyczących interfejsów API Google lub Google Cloud. Przed zaakceptowaniem Warunków dokładnie zapoznaj się z ich warunkami.

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

Określanie identyfikatora i liczby standardowego projektu Cloud

Wszystkie projekty Cloud mają nazwę, identyfikator i numer projektu. Czasami możesz potrzebować tych identyfikatorów, aby skonfigurować usługi lub wykonać inne zadania.

Aby określić identyfikator i numer projektu standardowego, wykonaj te czynności:

  1. Otwórz projekt Cloud.
  2. W prawym górnym rogu kliknij Więcej > Ustawienia projektu.
  3. W panelu Ustawienia wyświetl nazwę projektu, identyfikator projektu i numer projektu. Numer projektu składa się tylko z cyfr, a Identyfikator projektu zawiera znaki alfanumeryczne. Możesz edytować nazwę projektu, która jest wyświetlana użytkownikom w przypadku prośby o autoryzację.

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

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

  1. Otwórz projekt 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 Raportowanie błędów. Jeśli pojawi się prośba o skonfigurowanie raportowania błędów, oznacza to, że Twój projekt skryptu nie zarejestrował jeszcze żadnych wyjątków.

Gdy korzystasz z usług wymagających protokołu OAuth, Google prosi użytkowników o ich autoryzację. Ustawienia ekranu zgody OAuth pozwalają skonfigurować niektóre informacje wyświetlane Google, takie jak nazwa aplikacji czy URL Warunków korzystania z usługi.

Domyślne projekty Cloud automatycznie tworzą ekran zgody na podstawie szczegółów projektu Apps Script; nie można ich zmieniać. W standardowych projektach Google Cloud możesz dostosować te informacje. Ekran zgody skryptu możesz skonfigurować, wykonując te czynności:

  1. Otwórz projekt Cloud.
  2. Kliknij Menu > Interfejsy API i usługi > Dane logowania.
  3. Kliknij Skonfiguruj ekran zgody.
  4. Wypełnij każdą sekcję przepływu pracy na ekranie 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 dla usług, z których korzysta Twój skrypt. W przypadku niektórych aplikacji musisz utworzyć dodatkowe dane logowania OAuth (identyfikatory klienta i tajne klucze klienta). Możesz to zrobić tylko w przypadku standardowych projektów.

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

  1. Otwórz projekt 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 wyświetlony formularz. Gdy skończysz, kliknij Utwórz.
  5. W wyświetlonym oknie kliknij Pobierz JSON. Możesz użyć tego pliku do skonfigurowania protokołu OAuth.

Dodawanie kolejnych właścicieli do standardowego projektu Cloud

Do projektu standardowego możesz dodawać kolejnych właścicieli lub inne role. Jeśli pracujesz nad projektem, pomoże to zapewnić, że ktoś z Twojego zespołu będzie zawsze miał dostęp do ustawień projektu Google Cloud skryptu.

Aby dodać dodatkowych właścicieli lub inne role do standardowego projektu, wykonaj te czynności. Aby wprowadzić te zmiany, musisz mieć uprawnienia do edycji projektu:

  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 z tej domeny.
  2. Otwórz projekt Cloud skryptu.
  3. Kliknij Menu > Administracja > Uprawnienia.
  4. U góry kliknij Dodaj.
  5. Postępuj zgodnie z instrukcjami na ekranie, aby dodać co najmniej jednego nowego użytkownika do roli w projekcie Cloud. Możesz dodawać pojedyncze 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 mieć wiele projektów Apps Script. Aby to zrobić, utwórz projekt standardowy, a następnie przełącz go na inny projekt. Nie można tego zrobić w przypadku projektów domyślnych.

Użyj innego standardowego projektu Cloud

Możesz przełączyć projekt skryptu tak, 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 standardowy. Aby dowiedzieć się, kiedy musisz użyć projektu standardowego, zapoznaj się ze standardowymi projektami Cloud.

Skutki przejścia na inny standardowy projekt Cloud

Gdy przełączysz skrypt z projektu domyślnego lub na inny projekt standardowy, będzie to miało następujące skutki:

  • Jeśli w Twoim skrypcie zostały aktywowane usługi zaawansowane, musisz włączyć odpowiadające im 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, zapoznaj się z artykułem Włączanie interfejsów API Google Workspace.
  • Wszyscy użytkownicy, którzy wcześniej autoryzowali skrypt, muszą ponownie wykonać autoryzację. W większości przypadków wszyscy użytkownicy, którzy wcześniej autoryzowali aplikacje powiązane z nowym projektem, też muszą ponownie wykonać autoryzację.
  • Jeśli Twój skrypt jest powiązany z informacjami o aplikacji w Google Workspace Marketplace, informacje o aplikacji, użytkownicy i opinie nie zostaną przeniesione do nowego projektu. Musisz utworzyć stronę z informacjami o aplikacji w ramach nowego projektu, a użytkownicy muszą ponownie zainstalować aplikację. Więcej informacji znajdziesz w sekcji Publikowanie aplikacji.
  • Nie możesz przełączyć skryptu z powrotem na projekt domyślny. Apps Script usuwa projekty domyślne, gdy ustawisz w nim standardowy projekt.

Przełącz się na inny standardowy projekt Cloud

Aby przełączyć istniejący projekt Cloud Script na inny projekt 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ądzania zasobami Google Cloud Console. Apps Script używa tej nazwy, gdy prosisz użytkowników o autoryzację.
  2. Jeśli chcesz użyć istniejącego projektu, otwórz stronę Zarządzanie zasobami w Google Cloud Console i znajdź istniejący projekt do użycia. Musisz mieć w projekcie role: Przeglądarka projektu i Edytujący konfigurację OAuth lub role z odpowiednimi uprawnieniami. Nie możesz użyć projektu utworzonego automatycznie przez Apps Script.
  3. Określ numer projektu 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 wspólne miejsca, 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 razem z zespołem, ale nakładają pewne ograniczenia na możliwości, jakie daje starsze projekty domyślne Cloud.

Poniżej znajdziesz listę ograniczeń dotyczących interakcji projektów Cloud z dyskami współdzielonymi:

  • Jeśli Twój projekt skryptu znajduje się na koncie standardowym, nie ma żadnych dodatkowych ograniczeń, gdy znajduje się on na dysku współdzielonym.
  • Jeśli Twój projekt skryptu używa projektu domyślnego utworzonego 8 kwietnia 2019 r. lub później, nie ma dodatkowych ograniczeń, gdy znajduje się na dysku współdzielonym.
  • Jeśli Twój projekt skryptu używa projektu domyślnego utworzonego przed 8 kwietnia 2019 r., gdy znajduje się on na dysku współdzielonym, obowiązują te ograniczenia:
    1. Nie możesz uzyskać dostępu do projektu domyślnego za pomocą interfejsu Apps Script ani konsoli Google Cloud. To ograniczenie uniemożliwia wykonanie 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. Nadal będziesz mieć dostęp do projektu domyślnego, o ile dostęp został przeniesiony przed przeniesieniem. Jeśli na przykład utworzysz skrypt w folderze Mój dysk, a następnie przeniesiesz go na dysk współdzielony, nadal będziesz mieć dostęp do projektu w Google Cloud. Twoi współpracownicy na dysku współdzielonym mogą tego nie robić.
    4. Skrypt zachowuje nazwę projektu Cloud przed przeniesieniem 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, przejdź na projekt standardowy.

Pobieranie listy projektów Apps Script Cloud

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

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

Usuwanie projektów Apps Script Cloud

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

Aby usunąć projekt Apps Script za pomocą 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 Wyłączanie (usuwanie) projektów.