Projekty Google Cloud

Każdy projekt Apps Script używa Google Cloud do zarządzania autoryzacją, zaawansowanymi usługami i innymi informacjami. Aby 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, który Apps Script tworzy automatycznie, lub z standardowego projektu, który tworzysz samodzielnie. Projekty domyślne są zwykle odpowiednie do codziennych lub prostych skryptów, ale w przypadku aplikacji złożonych, komercyjnych lub przeznaczonych do publikacji należy używać projektu standardowego.

W każdej chwili możesz przejść z projektu domyślnego na projekt standardowy, ale nie możesz wrócić do projektu domyślnego. Najlepiej jest wybrać projekt Cloud, z którego korzysta skrypt, na wczesnym etapie tworzenia. Późniejsze przełączenie może spowodować komplikacje, np. konieczność ponownego autoryzowania przez użytkowników.

Domyślne projekty w chmurze

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. 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 w chmurze, gdy zapiszesz projekt skryptu.
  • W przypadku niektórych skryptów musisz korzystać z Google Cloud Console. W takich przypadkach skrypt musi zamiast tego używać standardowego projektu Cloud. Na przykład aby 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óre pełni rolę właściciela domyślnego projektu. 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 znaleźć, wyświetlić 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żywać 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. Więcej informacji znajdziesz w artykule Wyświetlanie i edytowanie domyślnych projektów w chmurze.

Jeśli nie jesteś administratorem, nie możesz ręcznie usuwać domyślnych projektów. Jeśli jednak usuniesz projekt skryptu lub przełączysz go na projekt standardowy, Apps Script usunie domyślny projekt dołączony do skryptu wraz z wszystkimi ustawieniami i informacjami, które zawiera.

Standardowe projekty Cloud

Domyślne projekty w chmurze 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 kolejnych sekcjach opisujemy, kiedy Apps Script wymaga standardowego projektu, jego właściwości i typowe zadania, które można w nim wykonywać. Poniższe zadania możesz wykonywać tylko w przypadku projektów standardowych.

Kiedy Apps Script wymaga standardowych projektów Cloud

Projektu standardowego musisz używać w tych sytuacjach:

Standardowe właściwości projektu w Google Cloud

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

  • Wszystkie ustawienia Google Cloud dla projektu są dostępne bezpośrednio w konsoli Google Cloud. Umożliwia to aktywowanie interfejsów API, dostosowywanie danych logowania autoryzacji i konfigurowanie innych szczegółów.
  • Gdy usuniesz projekt skryptu lub przełączysz go na inny projekt standardowy, pierwotny projekt standardowy pozostanie i będzie można go ponownie użyć.
  • Gdy włączysz usługę zaawansowaną w projekcie skryptu, musisz ręcznie włączyć odpowiedni interfejs API w projekcie standardowym.
  • Wiele projektów skryptów i innych aplikacji może współdzielić ten sam standardowy projekt. Jeśli zamierzasz opublikować projekt skryptu w Google Workspace Marketplace jako dodatek, musi on mieć własny standardowy projekt. Opublikowane aplikacje nie mogą udostępniać projektów 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ą współdzielić ten sam standardowy projekt.
  • 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 w Google 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.

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 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 nazwę interfejsu API, który chcesz włączyć, i naciśnij Enter.
  5. Kliknij interfejs API w wynikach wyszukiwania, a następnie kliknij Włącz, aby aktywować interfejs API w tym projekcie w Google 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 wybranie go w panelu Interfejsy API i usługi.

Określanie identyfikatora i numeru standardowego projektu w Cloud

Wszystkie projekty Cloud mają nazwę, identyfikator i numer. Czasami te identyfikatory są niezbędne do skonfigurowania usług lub wykonania innych zadań.

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 zobaczysz Nazwę projektu, Identyfikator projektu i Numer projektu. Numer projektu składa się tylko z cyfr, a identyfikator projektu jest alfanumeryczny. Możesz edytować nazwę projektu, która wyświetla się użytkownikom w prośbach o autoryzację.

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

Jeśli w projekcie skryptu używasz 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 w projekcie skryptu nie zarejestrowano jeszcze żadnych wyjątków.

Gdy użytkownicy korzystają z usług wymagających OAuth, Google prosi ich o autoryzację tych usług. Ustawienia ekranu zgody OAuth umożliwiają skonfigurowanie niektórych informacji, które Google wyświetla użytkownikom, takich jak nazwa aplikacji i adres URL Warunków usługi.

Domyślne projekty Cloud automatycznie tworzą ekran zgody na podstawie szczegółów projektu Apps Script. Nie możesz dostosować tych ustawień. W projektach Standard Cloud możesz dostosować te informacje. Ekran zgody skryptu możesz skonfigurować w ten sposób:

  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 procesu, kliknij Zapisz i kontynuuj.

Tworzenie danych logowania OAuth

Apps Script zwykle konfiguruje OAuth dla usług, z których korzysta skrypt. W przypadku niektórych aplikacji musisz utworzyć dodatkowe dane uwierzytelniające OAuth (identyfikatory klientów i tajne klucze klientów). 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 wypełnij formularz, jeśli to konieczne. 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 w zespole, dzięki temu zawsze będziesz mieć dostęp do ustawień Google Cloud projektu skryptu.

Do projektu standardowego możesz dodać kolejnych właścicieli lub inne role, wykonując 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 w tej domenie.
  2. Otwórz projekt 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 w Cloud co najmniej 1 nowego członka i przypisać mu rolę. 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 w Google Cloud

Wiele projektów Apps Script może współdzielić ten sam standardowy projekt w Cloud. Aby to zrobić, utwórz standardowy projekt, a następnie przełącz każdy projekt skryptu, aby go używać. Nie możesz tego zrobić w przypadku projektów domyślnych.

Używanie innego standardowego projektu Cloud

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

Skutki przejścia na inny standardowy projekt w Cloud

Jeśli przełączysz skrypt z projektu domyślnego na inny projekt standardowy, nastąpią te zmiany:

  • Jeśli w skrypcie zostały aktywowane 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 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 Google Drive, 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 je 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ć informacje o aplikacji w nowym projekcie, a użytkownicy muszą ponownie zainstalować aplikację. Informacje o tworzeniu nowych informacji o aplikacji znajdziesz w artykule Publikowanie aplikacji.
  • Nie możesz przywrócić skryptu do projektu domyślnego. Apps Script usuwa projekty domyślne po skonfigurowaniu skryptu do korzystania ze standardowego projektu.

Przełączanie się na inny standardowy projekt w Google Cloud

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

  1. Jeśli nie masz odpowiedniego projektu w Cloud, utwórz go, postępując zgodnie z instrukcjami w sekcji Tworzenie projektu. Ustaw nazwę projektu, którą łatwo zapamiętać, aby móc go znaleźć na stronie Zarządzanie zasobami w konsoli Google Cloud. Apps Script używa tej nazwy, gdy prosi użytkowników o autoryzację skryptu.
  2. Jeśli chcesz użyć istniejącego projektu, otwórz stronę konsoli Google Cloud Zarządzaj zasobami i znajdź projekt, którego chcesz użyć. Musisz mieć w projekcie role Przeglądający projekt i Edytujący konfigurację OAuth lub role z równoważnymi uprawnieniami. Nie możesz używać projektu, który został utworzony automatycznie przez Apps Script.
  3. Określ numer projektu w projekcie Cloud.
  4. Otwórz skrypt, w którym chcesz zastąpić projekt w Google Cloud.
  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 (wcześniej dyski zespołowe) 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 skryptów, dodatków i aplikacji internetowych z zespołem, ale nakładają pewne ograniczenia na to, co można zrobić ze starszymi domyślnymi projektami w chmurze.

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

  • Jeśli projekt skryptu korzysta ze standardowego projektu, nie ma dodatkowych ograniczeń, gdy projekt skryptu znajduje się na dysku współdzielonym.
  • Jeśli projekt skryptu korzysta z domyślnego projektu utworzonego 8 kwietnia 2019 r. lub później, nie ma dodatkowych ograniczeń, gdy projekt skryptu znajduje się na dysku współdzielonym.
  • Jeśli projekt skryptu korzysta z domyślnego projektu utworzonego przed 8 kwietnia 2019 roku, 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 Apps Script ani konsoli Google Cloud. To ograniczenie uniemożliwia podejmowanie 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 przeniesiesz istniejący projekt Apps Script na dysk współdzielony, Google ograniczy dostęp do domyślnego projektu Cloud. Nadal możesz mieć dostęp do domyślnego projektu, jeśli był on przyznany przed przeniesieniem. Jeśli na przykład utworzysz skrypt w folderze na Moim dysku, a potem przeniesiesz go na dysk współdzielony, nadal będziesz mieć dostęp do projektu Cloud skryptu. Współpracownicy na dysku współdzielonym mogą nie mieć takiej możliwości.
    4. Skrypt zachowuje nazwę projektu w Cloud, którą miał 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 standardowy projekt.

Wyświetlanie 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ć wszystkie standardowe i domyślne projekty Apps Script Cloud w tym folderze.

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

Usuwanie projektów Apps Script Cloud

Aby usunąć projekt Apps Script Cloud, wykonaj czynności opisane w sekcji Wyświetlanie listy projektów Apps Script Cloud. Wybierz projekt, który chcesz usunąć, 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.