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, Apps Script aktywuje ją w domyślnym projekcie Cloud, gdy zapiszesz projekt skryptu.
  • 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ę zarządzania tożsamościami i dostępem (IAM) z jednym wpisem, czyli kontem usługi Google, które pełni rolę właściciela 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 projekt skryptu został utworzony przed 8 kwietnia 2019 roku, 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 dla skryptu.

Standardowe projekty Cloud

Domyślne projekty Cloud są najlepszą opcją w przypadku większości projektów skryptów, chyba że musisz ręcznie skonfigurować projekt. W takich sytuacjach musisz przełączyć projekt skryptu na projekt standardowy.

W tych sekcjach opisano, kiedy Apps Script wymaga projektu standardowego, właściwości takich projektów oraz typowe zadania wykonywane za ich pomocą. Te czynności możesz wykonywać tylko w przypadku projektów standardowych.

Kiedy Apps Script wymaga standardowych projektów w chmurze

Standardowego projektu musisz użyć w tych sytuacjach:

Standardowe właściwości 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, dostosowywać poświadczenia autoryzacji i konfigurować 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ć.
  • Gdy aktywujesz usługę zaawansowaną 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 inne aplikacje. 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 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, który korzysta ze standardowego projektu, do identyfikacji skryptu używana jest 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 potem kliknij Włącz, aby go aktywować w tym projekcie Cloud.

Może pojawić się prośba o zaakceptowanie Warunków korzystania z 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 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 musisz mieć te identyfikatory, aby skonfigurować usługi lub wykonać inne czynności.

Aby określić identyfikator i numer standardowego projektu:

  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 przypadku projektu skryptu korzystasz z rejestrowania w Google Cloud lub raportowania błędów, możesz wyświetlić te logi i raporty w konsoli Google Cloud. Aby to zrobić:

  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 błędów, 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 automatycznie tworzą ekran zgody na podstawie informacji o projekcie Apps Script. Nie możesz zmieniać 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 zapisać 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 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 aplikacji wybierz typ aplikacji i w razie potrzeby wypełnij odpowiedni formularz. Gdy skończysz, kliknij Utwórz.
  5. W wyświetlonym oknie kliknij Pobierz plik 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 zawsze mieć dostęp do ustawień Google Cloud projektu skryptu.

Aby dodać do projektu standardowego dodatkowych właścicieli lub inne role, 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ć do projektu Cloud co najmniej 1 nowego członka i jego role, 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 przełączyć projekt skryptu, aby korzystał z 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 w usłudze Cloud

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

  • Jeśli w przypadku skryptu masz włączone usługi zaawansowane, musisz włączyć odpowiednie interfejsy API w nowym projekcie w chmurze. 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ą ponownie go autoryzować. 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 ramach nowego projektu, a użytkownicy muszą ponownie zainstalować aplikację. Informacje o tworzeniu nowej strony aplikacji znajdziesz w artykule Publikowanie aplikacji.
  • Nie możesz przełączyć skryptu z powrotem do projektu domyślnego. Gdy skonfigurujesz skrypt do korzystania z 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, prosząc 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 obszary, 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 robić ze starszymi domyślnymi projektami Cloud.

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

  • Jeśli projekt skryptu korzysta z projektu standardowego, 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 lub po 8 kwietnia 2019 r., nie ma żadnych dodatkowych ograniczeń, gdy projekt skryptu znajduje się na dysku współdzielonym.
  • Jeśli projekt skryptu korzysta z projektu domyślnego utworzonego przed 8 kwietnia 2019 r., gdy projekt skryptu znajduje się na dysku współdzielonym, obowiązują te ograniczenia:
    1. Nie możesz uzyskać dostępu do projektu domyślnego za pomocą interfejsu użytkownika Apps Script ani konsoli Google Cloud. To ograniczenie uniemożliwia Ci wykonywanie czynności, 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 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 mieć takiej możliwości.
    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 w Google Cloud

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

  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 Pobierz listę 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.