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. Ogólnie rzecz biorąc, projekty domyślne są odpowiednie do codziennych skryptów, ale w przypadku aplikacji złożonych, o jakości komercyjnej 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, Apps Script tworzy 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. Aby na przykład wyświetlić logi Google Cloud w konsoli Google Cloud, skrypt musi używać standardowego projektu.

Domyślnie projekty w 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 lokalizować, 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.

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 sekcjach poniżej opisujemy, kiedy Apps Script wymaga standardowego projektu, jego właściwości i typowych zadań, które można w nim wykonywać. W przypadku projektów standardowych możesz wykonywać tylko te czynności:

Kiedy Apps Script wymaga standardowych projektów w chmurze

Projektu standardowego musisz używać w tych sytuacjach:

Standardowe właściwości projektu w chmurze

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, oryginalny 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 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 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 w chmurze

Aplikacja Apps Script często potrzebuje dostępu do innego interfejsu API Google. Aby to zrobić, musisz aktywować interfejs API w odpowiednim projekcie w chmurze. Aby aktywować interfejs API, wykonaj te czynności:

  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, aby aktywować interfejs API w tym projekcie w chmurze.

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 na panelu Interfejsy API i usługi.

Określanie identyfikatora i numeru standardowego projektu w chmurze

Wszystkie projekty Cloud mają nazwę projektu, identyfikator projektu i numer projektu. 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 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ę 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 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 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 w chmurze.
  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 logowania 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 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 w razie potrzeby wypełnij 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 w chmurze

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ż podać domeny na liście współpracowników, 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. Postępuj zgodnie z instrukcjami wyświetlanymi na ekranie, aby dodać do projektu w chmurze co najmniej 1 nowego członka i przypisać mu role. 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 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.

Używanie innego standardowego projektu w chmurze

Możesz przełączyć projekt skryptu, aby korzystał z innego standardowego projektu w chmurze. Jeśli skrypt wymaga ręcznej konfiguracji projektu w chmurze, 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 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 efekty:

  • 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łącz interfejs Drive API w standardowym projekcie w chmurze:

    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 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 sekcji Tworzenie projektu. Ustaw nazwę projektu, którą łatwo zapamiętasz, 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 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 w zespole, ale nakładają pewne ograniczenia na to, co można zrobić ze starszymi domyślnymi projektami Cloud.

Poniższa lista ograniczeń opisuje, jak projekty w Google Cloud współdziałają 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 chmurze skryptu. 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 Cloud w 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 w chmurze, wykonaj czynności opisane w sekcji Wyświetlanie listy projektów Apps Script w chmurze. 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.