Projekty Google Cloud

Każdy projekt Google Apps Script używa Google Cloud do zarządzania uwierzytelnianiem, 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 utworzonego przez Ciebie. Projekty domyślne są zwykle odpowiednie do codziennych skryptów, ale w przypadku złożonych aplikacji o jakości komercyjnej lub aplikacji, które chcesz opublikować, należy użyć 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 wybrać projekt w chmurze, którego będzie używać skrypt, na wczesnym etapie tworzenia. Późniejsze przełączenie może spowodować komplikacje, np. konieczność ponownego autoryzowania przez użytkowników.

Domyślne projekty Cloud

Gdy tworzysz projekt Apps Script, tworzy on 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 projektu domyślnego. Apps Script obsługuje niezbędne interakcje z Google Cloud. Jeśli na przykład aktywujesz zaawansowaną usługę 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ć projektu standardowego.

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 projektu domyślnego. Konto usługi Google to appsdev-apps-dev-script-auth@system.gserviceaccount.com.

Wyświetlanie i aktualizowanie domyślnych projektów Cloud

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 r., 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. Przeczytaj artykuł Wyświetlanie i edytowanie domyślnych projektów Cloud.

Użytkownicy, którzy nie są administratorami, nie mogą ręcznie usuwać projektów domyślnych. Jeśli jednak usuniesz projekt skryptu lub przejdziesz na projekt standardowy, Apps Script usunie projekt domyślny dołączony do skryptu wraz z jego ustawieniami i informacjami.

Standardowe projekty Cloud

Domyślne projekty Cloud są najlepszym rozwiązaniem 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 projektu standardowego, jego właściwości i typowe zadania. Te zadania wykonuj tylko w projektach standardowych.

Kiedy Apps Script wymaga standardowych projektów Cloud

W tych sytuacjach musisz użyć projektu standardowego:

Właściwości standardowego projektu w chmurze

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

  • Dostęp do wszystkich ustawień Google Cloud 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 przełączysz go na inny projekt standardowy, pierwotny projekt standardowy pozostanie i będzie można go ponownie użyć.
  • Gdy aktywujesz zaawansowaną usługę w projekcie skryptu, musisz ręcznie aktywować 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 zamierzasz opublikować projekt skryptu w Marketplace jako dodatek, musi on mieć własny projekt standardowy. Opublikowane aplikacje nie mogą współdzielić projektów Cloud z innymi aplikacjami.
  • Jeśli chcesz wykonywać funkcje w projekcie skryptu z innej aplikacji za pomocą metody interfejsu Apps Script APIscripts.run, projekt skryptu i aplikacja wywołująca muszą współdzielić ten sam projekt standardowy.
  • Gdy Apps Script prosi użytkownika o autoryzację skryptu, który używa projektu standardowego, do identyfikacji skryptu używana jest nazwa projektu w chmurze (a nie nazwa projektu skryptu). Z tego powodu pamiętaj, aby ustawić odpowiednią nazwę projektu w chmurze.

Uzyskiwanie dostępu do standardowego projektu w chmurze

Aby uzyskać dostęp do projektu standardowego 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ź projekt standardowy bezpośrednio w konsoli Google Cloud na stronie Zarządzanie zasobami.

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 interfejs API, który chcesz aktywować, 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 interfejsów Google API lub Google Cloud. Zanim zaakceptujesz Warunki korzystania z usługi, dokładnie je przeczytaj.

W zależności od aplikacji może być konieczne skonfigurowanie interfejsu API przez wybranie go w 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 zobacz 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 Google Cloud i raportów o błędach w konsoli Google Cloud

Jeśli używasz logowania Google Cloud lub raportowania błędów w projekcie skryptu, 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 projekt skryptu nie zarejestrował 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 korzystania z usługi.

Domyślne projekty Cloud automatycznie tworzą ekran akceptacji na podstawie szczegółów projektu Apps Script. Nie możesz dostosować tych ustawień. Standardowe projekty Cloud umożliwiają dostosowanie tych informacji. 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 używanych przez skrypt. W przypadku niektórych aplikacji utwórz dodatkowe dane logowania OAuth (identyfikatory klienta i tajne klucze klienta). Rób to tylko w projektach 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 kliknij Pobierz JSON. Użyj tego pliku do skonfigurowania OAuth.

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

Dodaj do projektu standardowego 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 projektu standardowego dodatkowych właścicieli lub inne role (wymaga uprawnień do edycji):

  1. Określ swoich współpracowników. Zalecamy używanie Grupy dyskusyjnej 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 ekranu 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

Ten sam standardowy projekt w chmurze może być współdzielony przez wiele projektów Apps Script. Aby to zrobić, utwórz projekt standardowy, a następnie przełącz każdy projekt skryptu na jego używanie. 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 projekt standardowy – opublikowane aplikacje nie mogą współdzielić projektów Cloud.

Używanie innego standardowego projektu w chmurze

Przełącz projekt skryptu na używanie innego standardowego projektu 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 artykule standard Standardowe projekty Cloud.

Skutki przejścia na inny standardowy projekt w chmurze

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

  • Jeśli w skrypcie aktywowano zaawansowane usługi, 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 w chmurze, przeczytaj artykuł Włączanie interfejsów Google Workspace API.
  • Jeśli skrypt używa wbudowanej usługi Dysku Google, musisz włączyć interfejs Drive API w projektach standardowych Cloud.

    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ą również 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 Twoi użytkownicy muszą ponownie zainstalować aplikację. Więcej informacji o tworzeniu nowych informacji o aplikacji znajdziesz w artykule Publikowanie aplikacji.
  • Nie możesz przełączyć skryptu z powrotem na projekt domyślny. Apps Script usuwa projekty domyślne po ustawieniu skryptu na używanie projektu standardowego.

Przechodzenie 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 znaleźć go 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 konsolę Google Cloud na stronie Zarządzanie zasobami i znajdź projekt, którego chcesz użyć. Musisz mieć w projekcie przypisaną rolę 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ł automatycznie utworzony przez Apps Script.
  3. Określ Numer projektu projektu w chmurze.
  4. Otwórz skrypt, którego projekt w chmurze chcesz zastąpić.
  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 Cloud 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 przestrzenie współdzielone, w których grupy użytkowników Dysku mogą współpracować nad projektami Apps Script i dokumentami 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żej opisujemy, jak projekty Cloud współpracują z dyskami współdzielonymi:

  • Jeśli projekt skryptu używa projektu standardowego, nie ma dodatkowych ograniczeń, gdy projekt skryptu znajduje się na dysku współdzielonym.
  • Jeśli projekt skryptu używa projektu domyślnego 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 używa projektu domyślnego utworzonego przed 8 kwietnia 2019 r., obowiązują te ograniczenia, gdy projekt skryptu znajduje się na dysku współdzielonym:
    1. Nie możesz uzyskać dostępu do projektu domyślnego za pomocą interfejsu Apps Script ani konsoli Google Cloud. To ograniczenie uniemożliwia wykonywanie działań, które wymagają bezpośredniego dostępu do projektu.
    2. Nie możesz aktywować zaawansowanych usług. Aby aktywować zaawansowane usługi, przejdź 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ś(-aś) 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 w chmurze skryptu. Twoi 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 Cloud

Jeśli masz uprawnienie resourcemanager.projects.list do folderu projektu Apps Script w swojej organizacji, możesz wyświetlić 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 Filtr > Identyfikator nadrzędny 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.