Projekty Google Cloud

Każdy projekt Apps Script korzysta z Google Cloud do zarządzania uwierzytelnianiem, zaawansowanymi usługami i innymi informacjami. Aby móc konfigurować te ustawienia i nimi zarządzać, każdy projekt Apps Script ma powiązany projekt Google Cloud. Twój projekt skryptu może korzystać z domyślnego projektu utworzonego automatycznie przez Apps Script lub z standardowego projektu utworzonego przez Ciebie. Projekty domyślne są na ogół odpowiednie do codziennego użytku lub prostych skryptów, ale w przypadku aplikacji, które są złożone, mają charakter komercyjny lub mają być publikowane, należy użyć projektu standardowego.

W dowolnym momencie możesz przełączyć się z projektu domyślnego na projekt standardowy, ale nie możesz z powrotem przejść na projekt domyślny. Najlepiej wybrać projekt Cloud, którego używa skrypt, na wczesnym etapie rozwoju. Przełączenie na inny typ konta może spowodować komplikacje, np. konieczność ponownego autoryzowania użytkowników.

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 nie musisz wyświetlać ani dostosowywać tego domyślnego projektu. Aplikacja Apps Script obsługuje niezbędne interakcje z Google Cloud. Jeśli na przykład aktywujesz usługę zaawansowaną w edytorze Apps Script, to 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ć dzienniki Google Cloud w konsoli Google Cloud, skrypt musi używać projektu standardowego.

Domyślnie projekty Cloud mają zasadę Identity and Access Management (IAM) z 1 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 w chmurze

Większość użytkowników nie może bezpośrednio znajdować, wyświetlać ani edytować projektów domyślnych w konsoli Google Cloud. Jeśli jesteś administratorem, przeczytaj artykuł Wyświetlanie domyślnych projektów Google 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 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 samo jak standardowe projekty Cloud. Zapoznaj się z artykułem Usuwanie projektów Apps Script z Cloud.

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

  • Jeśli usuniesz projekt skryptu lub przełączysz go na projekt standardowy, Apps Script usunie domyślny projekt dołączony do skryptu wraz ze wszystkimi ustawieniami i zawieranymi przez niego informacjami.
  • Jeśli skrypt nie jest uruchamiany przez co najmniej 180 dni, Apps Script usuwa powiązany z nim projekt domyślny. Jeśli skrypt zostanie uruchomiony po usunięciu przez Apps Script projektu domyślnego, Apps Script utworzy projekt domyślny 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ć projekt ręcznie. W takich sytuacjach musisz przełączyć projekt skryptu na projekt standardowy.

W poniższych sekcjach znajdziesz informacje o tym, kiedy Apps Script wymaga standardowego projektu, a także jakie są jego właściwości i typowe zadania, które są w nim wykonywane. Te czynności możesz wykonywać tylko w przypadku projektów standardowych.

Gdy Apps Script wymaga standardowych projektów Cloud

Standardowego projektu musisz użyć w tych sytuacjach:

Właściwości standardowego projektu Cloud

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

  • Wszystkie ustawienia Google Cloud dotyczące projektu możesz wyświetlić bezpośrednio w konsoli Google Cloud. Dzięki temu możesz aktywować interfejsy API, dostosować dane uwierzytelniające i skonfigurować inne szczegóły.
  • Gdy usuniesz projekt skryptu lub przełączysz go na inny projekt standardowy, pierwotny projekt standardowy pozostanie i można go ponownie użyć.
  • 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ć używany przez wiele projektów skryptów i innych aplikacji. 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 Google Cloud innym aplikacjom.
  • Jeśli chcesz wykonywać funkcje w projekcie skryptu z innej aplikacji za pomocą metody scripts.run interfejsu Apps Script API, projekt skryptu i aplikacja wywołująca muszą należeć do tego samego projektu standardowego.
  • Gdy Apps Script prosi użytkownika o autoryzację skryptu korzystającego ze standardowego projektu, do identyfikacji skryptu zostanie użyta nazwa projektu Cloud (a nie nazwa projektu skryptu). Dlatego 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.

Standardowy projekt możesz też znaleźć bezpośrednio na stronie Zarządzanie zasobami w konsoli Google Cloud.

Aktywowanie interfejsu API w standardowym projekcie Cloud

Aplikacja Apps Script często potrzebuje dostępu do innego interfejsu Google API. 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 w wynikach wyszukiwania, a następnie kliknij Włącz, aby aktywować interfejs API dla tego projektu Cloud.

Może pojawić się prośba o zaakceptowanie Warunków korzystania z usługi interfejsów API Google lub Google Cloud. Przed zaakceptowaniem Warunków korzystania z usługi przeczytaj je uważnie.

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

Określanie identyfikatora i numeru standardowego projektu Cloud

Wszystkie projekty Cloud mają nazwę, identyfikator i numer. Czasami te identyfikatory są potrzebne do konfigurowania usług lub wykonywania innych zadań.

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 wyświetlonym panelu Ustawienia sprawdź Nazwa projektu, Identyfikator projektu i Numer projektu. Numer projektu składa się tylko z cyfr, a identyfikator projektu jest alfanumeryczny. Możesz edytować nazwa projektu, która jest wyświetlana użytkownikom podczas prośby 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 logowania w Google Cloud 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 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 projekt skryptu nie zalogował jeszcze żadnych wyjątków.

Podczas korzystania z usług wymagających OAuth Google prosi użytkowników o autoryzację tych usług. Ustawienia ekranu zgody OAuth umożliwiają określenie niektórych informacji, które Google przedstawia użytkownikom, takich jak nazwa aplikacji i adres URL Warunków korzystania z usługi.

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

  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 ekranu akceptacji.
  5. Aby rejestrować zmiany na każdym etapie przepływu pracy, kliknij Zapisz i kontynuuj.

Tworzenie danych logowania OAuth

Skrypt Google Apps zwykle konfiguruje OAuth dla usług, których używa Twój skrypt. W przypadku niektórych aplikacji musisz utworzyć dodatkowe dane uwierzytelniające OAuth (identyfikatory klienta i tajne klucze klienta). Możesz to zrobić tylko w przypadku projektów standardowych.

Aby utworzyć identyfikator klienta i tajny klucz klienta dla 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 zgłoszenia wybierz typ zgłoszenia i w razie potrzeby wypełnij wyświetlony formularz. Gdy skończysz, kliknij Utwórz.
  5. W wyświetlonym oknie kliknij Pobierz JSON. Za pomocą tego pliku możesz skonfigurować OAuth.

Dodawanie dodatkowych właścicieli do standardowego projektu Cloud

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

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

  1. Określ, kto powinien być Twoim współpracownikiem. Zalecamy utworzenie lub użycie istniejącej grupy 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, w którym znajduje się skrypt.
  3. Kliknij Menu > Administracja > Uprawnienia.
  4. U góry kliknij Dodaj.
  5. Aby dodać co najmniej 1 nowego członka i jego role do projektu Cloud, postępuj zgodnie z instrukcjami wyświetlanymi na ekranie. Jako nowych członków możesz dodawać pojedyncze adresy e-mail, grupy dyskusyjne Google lub domeny.
  6. Kliknij Zapisz.

Grupowanie wielu skryptów w jednym projekcie Cloud

Możesz mieć wiele projektów Apps Script, które korzystają z tego samego standardowego projektu Cloud. Aby to zrobić, utwórz projekt standardowy, a następnie przełącz każdy projekt skryptu, aby go użyć. Nie możesz tego zrobić w przypadku projektów domyślnych.

Użyj innego standardowego projektu Cloud

Możesz zmienić projekt skryptu tak, aby używał innego standardowego projektu Cloud. Jeśli skrypt wymaga ręcznej konfiguracji projektu Cloud, musisz przejść z projektu domyślnego na projekt standardowy. Więcej informacji o tym, kiedy należy używać projektu standardowego, znajdziesz w artykule Standardowe projekty Cloud.

Skutki przełączenia się na inny standardowy projekt Cloud

Jeśli przełączysz skrypt z projektu domyślnego do innego projektu standardowego, nastąpią następujące zmiany:

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

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

    Włączanie interfejsu Drive API

  • Wszyscy użytkownicy, którzy wcześniej autoryzowali skrypt, muszą dokonać ponownej autoryzacji. W większości przypadków wszyscy użytkownicy, którzy wcześniej autoryzowali aplikacje powiązane z nowym projektem, muszą ponownie autoryzować.
  • Jeśli 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ę aplikacji w nowym projekcie, a użytkownicy muszą ponownie zainstalować aplikację. Informacje o tworzeniu nowej strony aplikacji znajdziesz w artykule Publikowanie aplikacji.
  • Nie będzie można przywrócić skryptu z powrotem do projektu domyślnego. Gdy skonfigurujesz skrypt tak, aby używał projektu standardowego, Apps Script usunie projekty domyślne.

Przełączanie się na inny standardowy projekt Cloud

Aby przełączyć istniejący projekt Cloud skryptu 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. Podaj łatwą do zapamiętania nazwę projektu, aby można było go 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ź projekt, którego chcesz użyć. Musisz mieć w projekcie rolę przeglądarki projektu i edytującego konfigurację OAuth lub rolę o równoważnych uprawnieniach. Nie możesz używać projektu utworzonego automatycznie przez Apps Script.
  3. Sprawdź numer projektu swojego projektu Cloud.
  4. Otwórz skrypt, którego projekt w usłudze Cloud chcesz zastąpić.
  5. Po lewej stronie kliknij Ustawienia projektu .
  6. W sekcji Projekt Google Cloud Platform (GCP) kliknij Zmień projekt.
  7. Wpisz nowy numer projektu i kliknij Ustaw projekt.

Projekty w chmurze i dyski współdzielone

Dyski współdzielone (dawniej Dyski zespołowe) to wspólne przestrzenie, 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 skryptów, dodatków i aplikacji internetowych w zespole, ale nakładają pewne ograniczenia na to, co można zrobić ze starszymi domyślnymi projektami Cloud.

Na liście ograniczeń opisano sposób współdziałania projektów Cloud z dyskami współdzielonymi:

  • Jeśli Twój projekt skryptu korzysta ze standardowego projektu, nie ma żadnych dodatkowych ograniczeń, gdy projekt skryptu znajduje się na dysku współdzielonym.
  • Jeśli projekt skryptu korzysta z projektu domyślnego utworzonego 8 kwietnia 2019 r. lub później, nie ma żadnych dodatkowych ograniczeń, jeśli projekt skryptu znajduje się na dysku współdzielonym.
  • Jeśli Twój projekt skryptu korzysta z domyślnego projektu utworzonego przed 8 kwietnia 2019 r., podczas przechowywania tego projektu na dysku współdzielonym obowiązują te ograniczenia:
    1. Do domyślnego projektu nie można uzyskać dostępu przy użyciu interfejsu Apps Script ani konsoli Google Cloud. To ograniczenie uniemożliwia Ci wykonywanie czynności wymagających 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 miałeś do niego dostęp 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 Cloud tego skryptu. Twoi współpracownicy na dysku współdzielonym mogą nie być w stanie tego zrobić.
    4. Skrypt zachowuje nazwę projektu Cloud, jaką miał przed przeniesieniem na dysk współdzielony. Nawet jeśli zmienisz nazwę projektu na dysku współdzielonym, użytkownicy, którzy autoryzują skrypt, nadal widzą 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 uprawnienie resourcemanager.projects.list do folderu projektu Apps Script Twojej organizacji, możesz wyświetlać wszystkie standardowe i domyślne projekty Apps Script Cloud w tym folderze.

  1. Otwórz konsolę Google Cloud na stronie Zarządzanie zasobami.
  2. Obok folderu Apps Script skopiuj identyfikator.
  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 Pobieranie listy projektów Apps Script Cloud, 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.