Projekty Google Cloud

Każdy projekt Google 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. Ogólnie rzecz biorąc, projekty domyślne są odpowiednie do codziennych 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 w chmurze, 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 Google Cloud

Gdy tworzysz projekt Apps Script, tworzony jest domyślny projekt w chmurze, 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 skryptów 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 konsoli Google Cloud. W takich przypadkach skrypt musi używać standardowego projektu w chmurze. 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 znajdować, 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 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.

Osoby niebędące administratorami nie mogą ręcznie usuwać domyślnych projektów. Jeśli jednak usuniesz projekt skryptu lub przejdziesz na projekt standardowy, Apps Script usunie domyślny projekt dołączony do skryptu wraz z jego ustawieniami i informacjami.

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 sekcjach poniżej opisujemy, kiedy Apps Script wymaga standardowego projektu, jego właściwości i typowych zadań. Wykonuj te zadania tylko w przypadku projektów standardowych.

Kiedy Apps Script wymaga standardowych projektów Cloud

Standardowego projektu musisz używać w tych sytuacjach:

Standardowe właściwości projektu w chmurze

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

  • Uzyskaj dostęp do wszystkich ustawień Google Cloud dla projektu bezpośrednio z konsoli Google Cloud. Umożliwia to aktywowanie interfejsów API, dostosowywanie danych logowania i konfigurowanie innych szczegółów.
  • Gdy usuniesz projekt skryptu lub zmienisz go tak, aby używał innego projektu standardowego, 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.
  • Ten sam projekt standardowy może być współdzielony przez wiele projektów skryptów i innych aplikacji. Jeśli chcesz opublikować projekt skryptu w Marketplace jako dodatek, musi on mieć własny projekt standardowy. 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ą korzystać z 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 w chmurze (a nie nazwa projektu skryptu). Dlatego pamiętaj, aby ustawić odpowiednią nazwę projektu w chmurze.

Dostęp do standardowego projektu w chmurze

Aby uzyskać dostęp do standardowego projektu powiązanego z projektem skryptu:

  1. Otwórz projekt Apps Script.
  2. Po lewej stronie kliknij Ustawienia projektu .
  3. W sekcji Projekt Google Cloud kliknij numer projektu.

Znajdź standardowy projekt bezpośrednio na stronie Zarządzanie zasobami w konsoli Google Cloud.

Aktywowanie interfejsu API w standardowym projekcie w chmurze

Aby przyznać aplikacji Apps Script dostęp do innego interfejsu API Google, aktywuj interfejs API w odpowiednim projekcie w chmurze:

  1. Otwórz projekt w chmurze.
  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.

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

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

Określanie identyfikatora i numeru standardowego projektu w chmurze

Wszystkie projekty Cloud mają nazwę, identyfikator i numer. Te identyfikatory mogą być potrzebne do skonfigurowania usług lub wykonania innych zadań.

Aby określić identyfikator i numer projektu standardowego:

  1. Otwórz projekt w chmurze.
  2. W prawym górnym rogu kliknij Więcej  > Ustawienia projektu.
  3. W wyświetlonym panelu Ustawienia sprawdź Nazwę projektu, Identyfikator projektu i Numer projektu. Numer projektu składa się z cyfr, a identyfikator projektu jest alfanumeryczny. Edytuj nazwę projektu, która jest wyświetlana 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 w chmurze.
  2. Kliknij Menu .
  3. W sekcji Operacje kliknij Logowanie > Eksplorator logów.
  4. Aby wyświetlić raporty o błędach, w sekcji Operacje 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 określają informacje, które Google wyświetla użytkownikom, takie 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 standardowych projektach w Google Cloud możesz dostosować te informacje. Aby skonfigurować ekran zgody skryptu:

  1. Otwórz projekt w chmurze.
  2. Kliknij Menu  > Interfejsy API i usługi > Dane logowania.
  3. Kliknij Skonfiguruj ekran zgody.
  4. Wypełnij każdą sekcję procesu ekranu zgody.
  5. Aby zapisać zmiany na każdym etapie, 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 utwórz dodatkowe dane logowania OAuth (identyfikatory klientów i tajne klucze klientów). Rób to tylko w przypadku projektów standardowych.

Aby utworzyć identyfikator klienta i tajny klucz klienta dla projektu skryptu:

  1. Otwórz projekt w chmurze.
  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. Gdy skończysz, kliknij Utwórz.
  5. W oknie dialogowym kliknij Pobierz JSON. Użyj tego pliku do skonfigurowania OAuth.

Dodawanie dodatkowych właścicieli do standardowego projektu w chmurze

Dodaj do standardowego projektu dodatkowych właścicieli lub inne role, aby mieć pewność, że ktoś z Twojego zespołu zawsze będzie mieć dostęp do ustawień Google Cloud projektu skryptu.

Aby dodać do standardowego projektu dodatkowych właścicieli lub inne role (wymaga uprawnień do edycji):

  1. Określ współpracowników. Zalecamy użycie grupy Google. Określ domeny, aby uwzględnić wszystkich użytkowników w tej domenie.
  2. Otwórz projekt w chmurze skryptu.
  3. Kliknij Menu  > Administracja > Uprawnienia.
  4. U góry kliknij Dodaj.
  5. Aby dodać nowych członków i ich role, postępuj zgodnie z instrukcjami wyświetlanymi na ekranie. Dodaj pojedyncze adresy e-mail, grupy dyskusyjne Google lub domeny.
  6. Kliknij Zapisz.

Grupowanie wielu skryptów w jednym projekcie w chmurze

Wiele projektów Apps Script może współdzielić ten sam standardowy projekt w chmurze. 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.

Jeśli chcesz opublikować projekt skryptu w Marketplace jako dodatek, musi on mieć własny standardowy projekt – opublikowane aplikacje nie mogą współdzielić projektów w chmurze.

Używanie innego standardowego projektu w chmurze

Przełączanie projektu skryptu na inny standardowy projekt w chmurze. Jeśli skrypt wymaga ręcznej konfiguracji projektu w chmurze, przełącz się z projektu domyślnego na projekt standardowy. Więcej informacji znajdziesz w sekcji standardowe projekty Cloud.

Skutki przejścia na inny standardowy projekt w chmurze

Jeśli przełączysz skrypt z domyślnego projektu lub na inny standardowy projekt, spowoduje to następujące zmiany:

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

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

    Włączanie interfejsu Drive API

  • Wszyscy użytkownicy, którzy wcześniej autoryzowali skrypt, muszą to zrobić ponownie. 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 chmurze

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

  1. Jeśli nie masz odpowiedniego projektu w chmurze, utwórz go, postępując zgodnie z instrukcjami w artykule 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 utworzonego automatycznie przez Apps Script.
  3. Określ numer projektu projektu w chmurze.
  4. Otwórz skrypt, w którym chcesz zastąpić projekt w chmurze.
  5. Po lewej stronie kliknij Ustawienia projektu .
  6. W sekcji Projekt Google Cloud kliknij Zmień projekt.
  7. Wpisz nowy numer projektu i kliknij Ustaw projekt.

Projekty w chmurze i dyski współdzielone

Dyski współdzielone są dostępne tylko dla klientów Google Workspace Business i Google Workspace Enterprise.

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 w zespole, ale nakładają pewne ograniczenia na to, co można zrobić ze starszymi domyślnymi projektami w Cloud.

Poniżej znajdziesz opis interakcji projektów w Google Cloud 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 w chmurze. Nadal możesz mieć dostęp do projektu domyślnego, jeśli miałeś dostęp 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 w Cloud powiązanego ze skryptem. Współpracownicy na dysku współdzielonym mogą nie mieć takiej możliwości.
    4. Skrypt zachowuje nazwę projektu w chmurze, 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ąć tych ograniczeń w przypadku starszych skryptów, przejdź na projekt standardowy.

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 w Cloud w tym folderze.

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

Usuwanie projektów Apps Script Cloud

Aby usunąć projekty domyślne, musisz być administratorem.

Aby usunąć projekt Apps Script z konsoli Google Cloud:

  1. Otwórz projekt w chmurze.
  2. W prawym górnym rogu kliknij Więcej  > Ustawienia projektu.
  3. Kliknij Wyłącz / usuń.
  4. Aby wyłączyć projekt, postępuj zgodnie z instrukcjami wyświetlanymi na ekranie.

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.