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 informacjami. Aby skonfigurować te ustawienia i zarządzać nimi, z każdym projektem Apps Script jest powiązany projekt Google Cloud. Twój projekt skryptu może korzystać z utworzonego automatycznie projektu przez Apps Script lub projektu standardowego utworzonego przez Ciebie. Ogólnie rzecz biorąc, projekty domyślne sprawdzają się w przypadku prostych lub codziennych skryptów, ale do wszystkich złożonych aplikacji, jakości komercyjnych lub projektów, które zamierzasz opublikować, należy użyć projektu standardowego.

W każdej chwili możesz zmienić projekt domyślny na projekt standardowy, ale nie możesz przełączyć się z powrotem na projekt domyślny. Najlepiej wybrać projekt Cloud, którego skrypt używa na wczesnym etapie tworzenia. Przełączenie się później może spowodować komplikacje, takie jak wymaganie ponownej autoryzacji użytkowników.

Domyślne projekty Cloud

Gdy tworzysz projekt Apps Script, tworzy 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, po zapisaniu projektu skryptu Apps Script aktywuje usługę zaawansowaną w domyślnym projekcie Cloud.
  • W przypadku niektórych skryptów musisz korzystać z konsoli Google Cloud. W takich przypadkach 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 – konto usługi Google, które jest właścicielem 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 znajdować, wyświetlać ani edytować projektów domyślnych w Google Cloud Console. Jeśli jesteś administratorem, przeczytaj artykuł Wyświetlanie domyślnych projektów Cloud.

Jeśli Twój projekt skryptu został utworzony przed 8 kwietnia 2019 roku, możesz użyć projektu domyślnego, do którego możesz uzyskać dostęp w konsoli Google Cloud. Aby uzyskać dostęp do projektu domyślnego, przejdź do ustawień skryptu i kliknij numer projektu.

Usuwanie domyślnych projektów Cloud

Jeśli jesteś administratorem, możesz usunąć domyślne projekty Cloud w taki sam sposób jak standardowe projekty Cloud. Zobacz Usuwanie projektów Cloud Apps Script.

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

  • Gdy usuniesz projekt skryptu lub przejdziesz na projekt standardowy, Apps Script usunie projekt domyślny dołączony do skryptu oraz wszystkie jego ustawienia i informacje.
  • Jeśli skrypt nie będzie działać przez co najmniej 180 dni, Apps Script usunie 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 to najlepsza opcja w przypadku większości projektów skryptów, chyba że musisz skonfigurować je ręcznie. W takiej sytuacji musisz zmienić projekt skryptu na standardowy.

Poniższe sekcje opisują, kiedy Apps Script wymaga projektu standardowego, ich właściwości i typowych czynności, które trzeba w nich wykonać. Poniższe zadania możesz wykonać tylko w standardowych projektach.

Gdy Apps Script wymaga standardowych projektów Cloud

Musisz użyć projektu standardowego w tych sytuacjach:

Standardowe właściwości projektu Cloud

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

  • Wszystkie ustawienia Google Cloud dla tego projektu są dostępne bezpośrednio w Google Cloud Console. Dzięki temu możesz aktywować interfejsy API, dostosować dane logowania i skonfigurować inne szczegóły.
  • Gdy usuniesz projekt skryptu lub przejdziesz na inny projekt standardowy, pierwotny projekt standardowy pozostanie i będzie można go użyć ponownie.
  • Gdy w projekcie skryptu aktywujesz usługę zaawansowaną, musisz ręcznie aktywować odpowiedni interfejs API w projekcie standardowym.
  • Wiele projektów skryptu i inne aplikacje mogą korzystać z tego samego projektu standardowego. 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 wykonać funkcje w projekcie skryptu z innej aplikacji, korzystając z metody interfejsu Apps Script API i scripts.run, projekt skryptu i aplikacja do wywoływania muszą mieć ten sam standardowy projekt.
  • Gdy Apps Script prosi użytkownika o autoryzację skryptu korzystającego ze standardowego projektu, do identyfikacji skryptu służy nazwa projektu Cloud (a nie nazwa projektu skryptu). Z tego powodu pamiętaj, aby ustawić odpowiednią nazwę projektu Cloud.

Dostęp do standardowego projektu Cloud

Aby uzyskać dostęp do standardowego projektu 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ądzania zasobami 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. Aktywuj interfejs API, wykonując 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 ten interfejs w wynikach wyszukiwania, a następnie wybierz Włącz, aby aktywować interfejs API w tym projekcie Cloud.

Może pojawić się prośba o zaakceptowanie warunków korzystania z usług interfejsów API Google lub Google Cloud. Przed zaakceptowaniem Warunków korzystania z usługi dokładnie się z nimi zapoznaj.

W zależności od aplikacji konieczne może być też skonfigurowanie interfejsu API, wybierając go w panelu interfejsów API i usług.

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ć standardowy identyfikator i numer projektu, wykonaj te czynności:

  1. Otwórz projekt Cloud.
  2. W prawym górnym rogu kliknij Więcej > Ustawienia projektu.
  3. W wyświetlonym panelu Ustawienia zobaczysz nazwę projektu, Identyfikator projektu i Numer projektu. Numer projektu składa się tylko z cyfr, a Identyfikator projektu zawiera znaki alfanumeryczne. Możesz zmienić nazwę projektu, która będzie się wyświetlać użytkownikom podczas uwierzytelniania.

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

Jeśli używasz logowania w Google Cloud lub raportowania błędów dla projektu skryptu, możesz wyświetlić te logi i raporty w Google Cloud Console, 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 poprosimy Cię o skonfigurowanie raportowania błędów, oznacza to, że Twój projekt skryptu nie zarejestrował jeszcze żadnych wyjątków.

Jeśli używasz usług, które wymagają protokołu OAuth, Google prosi użytkowników o ich autoryzację. Ustawienia ekranu zgody OAuth pozwalają wybrać niektóre informacje udostępniane Google przez użytkowników, takie jak nazwa aplikacji i 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 dostosować tych ustawień. W standardowych projektach Cloud można dostosować te informacje. Ekran zgody 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ę procesu uzyskiwania zgody.
  5. Aby rejestrować zmiany na każdym etapie przepływu pracy, kliknij Zapisz i kontynuuj.

Tworzenie danych logowania OAuth

Apps Script zwykle konfiguruje protokół OAuth dla usług, z których korzysta skrypt. W przypadku niektórych aplikacji trzeba utworzyć dodatkowe dane logowania OAuth (identyfikatory klienta i tajne klucze klienta). Możesz to zrobić tylko w standardowych projektach.

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 powstały formularz. Gdy skończysz, kliknij Utwórz.
  5. W wyświetlonym oknie kliknij Pobierz JSON. Za pomocą tego pliku możesz skonfigurować OAuth.

Dodawanie kolejnych właścicieli do standardowego projektu Cloud

Do projektu standardowego możesz dodać innych właścicieli lub inne role. Dzięki temu, że ktoś pracuje nad projektem, ktoś w Twoim zespole zawsze ma dostęp do ustawień 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 w tej domenie.
  2. Otwórz projekt Cloud
  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 jednego nowego użytkownika i jego role. Pojedynczych członków możesz dodawać pojedynczo jako adresy e-mail, Grupy dyskusyjne Google lub domeny.
  6. Kliknij Zapisz.

Łączenie wielu skryptów w jeden projekt Cloud

Ten sam standardowy projekt Cloud może mieć kilka projektów Apps Script. Aby to zrobić, utwórz projekt standardowy i włącz każdy z nich. W projektach domyślnych nie można tego zrobić.

Użyj innego standardowego projektu Cloud

Możesz przełączyć projekt skryptu w taki, 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. Więcej informacji o tym, kiedy należy używać projektu standardowego, znajdziesz w artykule standardowe projekty Cloud.

Skutki przejścia na inny standardowy projekt Cloud

Zmiana skryptu z domyślnego lub innego projektu standardowego powoduje takie efekty:

  • Jeśli dla Twojego skryptu zostały aktywowane usługi zaawansowane, musisz włączyć odpowiednie interfejsy API w nowym projekcie Cloud. Stracisz 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 autoryzować tę funkcję. W większości przypadków wszyscy użytkownicy, którzy wcześniej autoryzowali aplikacje powiązane z nowym projektem, muszą też ponownie autoryzować swoje konta.
  • Jeśli skrypt jest powiązany z informacjami o aplikacji w Google Workspace Marketplace, informacje o aplikacjach, użytkownicy i opinie nie zostaną przeniesione do nowego projektu. W nowym projekcie musisz utworzyć informacje o aplikacji, a użytkownicy muszą ponownie ją zainstalować. Więcej informacji o tworzeniu nowej informacji o aplikacji znajdziesz w artykule Publikowanie aplikacji.
  • Nie możesz przełączyć skryptu z powrotem na projekt domyślny. Skrypt Apps Script usuwa projekty domyślne po ustawieniu w projekcie skryptu standardowego.

Przełącz na inny standardowy projekt Cloud

Aby przełączyć dotychczasowy projekt Cloud na inny, 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 łatwo ją było znaleźć na stronie zarządzania zasobami w Google Cloud Console. 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ę Google Cloud Console Zarządzaj zasobami i znajdź istniejący projekt do użycia. Musisz mieć w projekcie role takie jak Przeglądarka projektu i Edytor konfiguracji OAuth lub role z odpowiednimi uprawnieniami. Nie możesz użyć projektu utworzonego automatycznie przez Apps Script.
  3. Ustal 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 Cloud i Dyski współdzielone

Dyski współdzielone (wcześniej „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 podczas tworzenia zespołowych skryptów, dodatków i aplikacji internetowych, ale nakładają pewne ograniczenia na to, co można zrobić przy użyciu domyślnych projektów Cloud.

Poniższa lista ograniczeń opisuje sposób, w jaki projekty Cloud współdziałają z dyskami współdzielonymi:

  • Jeśli Twój projekt skryptu korzysta ze standardowego projektu, nie ma żadnych dodatkowych ograniczeń, gdy projekt jest na dysku współdzielonym.
  • Jeśli Twój projekt skryptu korzysta z projektu domyślnego, który został utworzony 8 kwietnia 2019 r. lub później, nie ma dodatkowych ograniczeń, gdy projekt skryptu znajduje się na dysku współdzielonym.
  • Jeśli Twój projekt skryptu korzysta z projektu domyślnego utworzonego przed 8 kwietnia 2019 roku, obowiązują te ograniczenia, gdy projekt na dysku współdzielonym:
    1. Nie można uzyskać dostępu do projektu domyślnego, używając interfejsu Apps Script lub konsoli Google Cloud. Takie ograniczenie uniemożliwia Ci 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. Nadal możesz uzyskać dostęp do projektu domyślnego, jeśli przed przeniesieniem był dostępny dostęp. 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 skryptu w projekcie Cloud. Twoi współpracownicy na dysku współdzielonym mogą nie mieć takiej możliwości.
    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.

Pobranie listy projektów Apps Script Cloud

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

  1. Otwórz stronę Zarządzanie zasobami w Google Cloud Console.
  2. Skopiuj identyfikator obok folderu Apps Script.
  3. Kliknij Filtruj > 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 Pobierz listę projektów Apps Script Cloud, wybierz projekt do usunięcia i kliknij Usuń.

Aby usunąć projekt Apps Script za pomocą narzędzia 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.