Projekty Google Cloud

Każdy projekt Apps Script korzysta z Google Cloud do zarządzania autoryzacją, usługami zaawansowanymi i innymi informacjami. Aby skonfigurować te ustawienia i zarządzać nimi, z każdym projektem Apps Script jest powiązany projekt Google Cloud. Twój projekt skryptu może korzystać z utworzonego automatycznie projektu przez Apps Script lub projektu standardowego utworzonego przez Ciebie. Ogólnie rzecz biorąc, projekty domyślne sprawdzają się w przypadku prostych i codziennych skryptów, ale do wszystkich zastosowań złożonych, komercyjnych lub przeznaczonych do publikacji należy używać projektów standardowych.

W każdej chwili możesz zmienić projekt domyślny na projekt standardowy, ale nie możesz przełączyć się z powrotem na projekt domyślny. Najlepiej wybrać projekt Google Cloud, z którego korzysta skrypt. Przełączenie się później może spowodować komplikacje, takie jak wymaganie ponownej autoryzacji użytkowników.

Domyślne projekty Google Cloud

Gdy tworzysz projekt Apps Script, tworzy on domyślny projekt Google Cloud, który działa w tle.

  • W przypadku większości skryptów nigdy nie musisz widzieć 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, podczas zapisywania projektu skryptu zostanie ona aktywowana w domyślnym projekcie Google Cloud.
  • W przypadku niektórych skryptów musisz korzystać z konsoli Google Cloud. W takich przypadkach skrypt musi korzystać ze standardowego projektu Google Cloud. Aby na przykład wyświetlać logi Google Cloud w konsoli Google Cloud, Twój skrypt musi używać standardowego projektu.

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

Większość użytkowników nie może bezpośrednio znajdować, wyświetlać ani edytować projektów domyślnych w Google Cloud Console. Administratorzy i użytkownicy domeny z uprawnieniami resourcemanager.projects.list do nadrzędnego folderu Google Cloud mogą wyświetlać i konfigurować projekty domyślne.

  • W przypadku klientów korzystających z Google Workspace projekty domyślne znajdują się w folderze Organization root > system-gsuite> w hierarchii zasobów Cloud. Nie usuwaj tych folderów. Jeśli to zrobisz, skrypty nie będą mogły tworzyć projektów domyślnych i nie będą działać prawidłowo.
  • W przypadku klientów innych niż Google Workspace projekty domyślne nie będą widoczne w hierarchii zasobów.

Usuwanie domyślnych projektów Google Cloud

Jeśli jesteś administratorem, możesz usunąć domyślne projekty Google Cloud, tak jak w przypadku standardowych projektów Google Cloud. Zobacz Usuwanie projektów Google Apps Script.

Jeśli nie jesteś administratorem, nie możesz usuwać projektów domyślnych. Skrypt Apps Script usuwa jednak projekty domyślne w tych przypadkach:

  • Gdy usuniesz projekt skryptu lub przejdziesz na projekt standardowy, Apps Script usunie projekt domyślny dołączony do skryptu oraz wszystkie jego ustawienia i informacje.
  • Jeśli skrypt nie będzie działać przez co najmniej 180 dni, Apps Script usunie powiązany projekt domyślny. Jeśli skrypt zostanie uruchomiony po usunięciu domyślnego projektu Apps Script, Apps Script utworzy go dla skryptu.

Standardowe projekty Google Cloud

Domyślne projekty Google Cloud to najlepszy wybór dla większości projektów skryptów, chyba że musisz skonfigurować je ręcznie. W takiej sytuacji musisz zmienić projekt skryptu na standardowy.

Poniższe sekcje opisują, kiedy Apps Script wymaga projektu standardowego, ich właściwości i typowych czynności, które trzeba w nich wykonać. Poniższe zadania możesz wykonać tylko w standardowych projektach.

Gdy Apps Script wymaga standardowych projektów Google Cloud

Musisz użyć projektu standardowego w tych sytuacjach:

Standardowe właściwości projektu Google Cloud

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

  • Wszystkie ustawienia Google Cloud dla tego projektu są dostępne bezpośrednio w Google Cloud Console. Dzięki temu możesz aktywować interfejsy API, dostosować dane logowania i skonfigurować inne szczegóły.
  • Gdy usuniesz projekt skryptu lub przejdziesz na inny projekt standardowy, pierwotny projekt standardowy pozostanie i będzie można go użyć ponownie.
  • Gdy w projekcie skryptu aktywujesz usługę zaawansowaną, musisz ręcznie aktywować odpowiedni interfejs API w projekcie standardowym.
  • Wiele projektów skryptu i inne aplikacje mogą korzystać z tego samego projektu standardowego. 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 Google Cloud innym aplikacjom.
  • Jeśli chcesz wykonać funkcje w projekcie skryptu z innej aplikacji, korzystając z metody interfejsu Apps Script API i scripts.run, projekt skryptu i aplikacja do wywoływania muszą mieć ten sam standardowy projekt.
  • Gdy Apps Script prosi użytkownika o autoryzację skryptu korzystającego ze standardowego projektu, do identyfikacji skryptu służy nazwa projektu Google Cloud (a nie nazwa projektu skryptu). Z tego powodu pamiętaj, aby ustawić odpowiednią nazwę projektu Google Cloud.

Dostęp do standardowego projektu Google Cloud

Aby uzyskać dostęp do standardowego projektu powiązanego z projektem skryptu, wykonaj te czynności:

Nowy edytor

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

Starszy edytor

  1. Otwórz skrypt w edytorze Apps Script.
  2. Wybierz Resources > Cloud Platform project (Zasoby i projekt Cloud Platform).
  3. W wyświetlonym oknie kliknij górny link, który odwołuje się do nazwy projektu GCP.

Projekt standardowy możesz też znaleźć bezpośrednio na stronie zarządzania zasobami Google Cloud Console.

Aktywowanie interfejsu API w standardowym projekcie Google Cloud

Często aplikacja Apps Script potrzebuje dostępu do innego interfejsu API Google. Aby to zrobić, musisz aktywować ten interfejs w odpowiednim projekcie Google Cloud. Aktywuj interfejs API, wykonując te czynności:

  1. Otwórz projekt Google 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 ten interfejs w wynikach wyszukiwania, a następnie kliknij Włącz, aby aktywować ten interfejs w tym projekcie Google Cloud.

Może pojawić się prośba o zaakceptowanie warunków korzystania z usług 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 konieczne może być też skonfigurowanie interfejsu API, wybierając go w panelu interfejsów API i usług.

Określanie identyfikatora i liczby standardowego projektu Google Cloud

Wszystkie projekty Google Cloud mają nazwę, identyfikator i numer projektu. Czasami możesz potrzebować tych identyfikatorów, aby skonfigurować usługi lub wykonać inne zadania.

Aby określić standardowy identyfikator i numer projektu, wykonaj te czynności:

  1. Otwórz projekt Google 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 zawiera znaki alfanumeryczne. Możesz zmienić nazwę projektu, która będzie się wyświetlać użytkownikom podczas uwierzytelniania.

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

Jeśli w projekcie skryptu używasz logowania w chmurze lub raportowania błędów, możesz wyświetlić te logi i raporty w Google Cloud Console, wykonując te czynności:

  1. Otwórz projekt Google 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 poprosimy Cię o skonfigurowanie raportowania błędów, oznacza to, że Twój projekt skryptu nie zarejestrował jeszcze żadnych wyjątków.

Jeśli używasz usług, które wymagają protokołu OAuth, Google prosi użytkowników o ich autoryzację. Ustawienia ekranu zgody OAuth pozwalają wybrać niektóre informacje udostępniane Google przez użytkowników, takie jak nazwa aplikacji i URL warunków korzystania z usługi.

Domyślne projekty Google Cloud automatycznie tworzą ekran zgody na podstawie szczegółów projektu Apps Script. Nie możesz dostosować tych ustawień. W standardowych projektach Google Cloud możesz dostosować te informacje. Ekran zgody możesz skonfigurować, wykonując te czynności:

  1. Otwórz projekt Google Cloud
  2. Kliknij Menu > Interfejsy API i usługi > Dane logowania.
  3. Kliknij Skonfiguruj ekran zgody.
  4. Wypełnij każdą sekcję procesu uzyskiwania zgody.
  5. Aby rejestrować zmiany na każdym etapie przepływu pracy, kliknij Zapisz i kontynuuj.

Tworzenie danych logowania OAuth

Apps Script zwykle konfiguruje protokół OAuth dla usług, z których korzysta skrypt. W przypadku niektórych aplikacji trzeba utworzyć dodatkowe dane logowania OAuth (identyfikatory klienta i tajne klucze klienta). Możesz to zrobić tylko w standardowych projektach.

Aby utworzyć identyfikator klienta i tajny klucz klienta do projektu skryptu, wykonaj te czynności:

  1. Otwórz projekt Google 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 powstały formularz. Gdy skończysz, kliknij Utwórz.
  5. W wyświetlonym oknie kliknij Pobierz JSON. Za pomocą tego pliku możesz skonfigurować OAuth.

Dodawanie kolejnych właścicieli do standardowego projektu Google Cloud

Do projektu standardowego możesz dodać innych właścicieli lub inne role. Dzięki temu, że ktoś pracuje nad projektem, ktoś w Twoim zespole zawsze ma dostęp do ustawień Google Cloud skryptu.

Aby dodać dodatkowych właścicieli lub inne role do standardowego projektu, wykonaj te czynności. Aby wprowadzić te zmiany, musisz mieć uprawnienia do edycji projektu:

  1. Określ, kim powinni być Twoi współpracownicy. Zalecamy utworzenie lub użycie istniejącej grupy dyskusyjnej 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 Google 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 Google Cloud co najmniej jednego nowego użytkownika oraz ich role. Pojedynczych członków możesz dodawać pojedynczo jako adresy e-mail, Grupy dyskusyjne Google lub domeny.
  6. Kliknij Zapisz.

Łączenie wielu skryptów w jeden projekt Google Cloud

Ten sam standardowy projekt Google Cloud może mieć wiele projektów Apps Script. Aby to zrobić, utwórz projekt standardowy i włącz każdy z nich. W projektach domyślnych nie można tego zrobić.

Przełącz się na inny standardowy projekt Google Cloud

Możesz przełączyć projekt skryptu w taki, aby używał innego standardowego projektu Google Cloud. Jeśli skrypt wymaga ręcznej konfiguracji projektu Google Cloud, musisz przełączyć się na projekt standardowy. Aby dowiedzieć się, kiedy warto korzystać z projektu standardowego, zobacz projekty standardowe Google Cloud.

Aby przełączyć dotychczasowy skrypt Google Cloud na inny projekt Google Cloud, wykonaj te czynności:

Nowy edytor

  1. Jeśli nie masz odpowiedniego projektu Google Cloud, utwórz go, postępując zgodnie z instrukcjami tworzenia projektu. Ustaw łatwą do zapamiętania nazwę projektu, aby móc ją znaleźć na stronie Zarządzanie zasobami w Google Cloud Console. Apps Script używa tej nazwy przy wysyłaniu próśb o autoryzację użytkowników.
  2. Jeśli chcesz użyć istniejącego projektu, otwórz stronę Zarządzanie zasobami Google Cloud Console i znajdź istniejący projekt. Musisz mieć uprawnienia w projekcie: resourcemanager.projects.update. Nie możesz użyć projektu utworzonego automatycznie przez Apps Script.
  3. Określ numer projektu Google Cloud.
  4. Otwórz skrypt, którego projekt Google Cloud chcesz zastąpić.
  5. Po lewej stronie kliknij Ustawienia projektu .
  6. W sekcji Projekt Google Cloud Platform (GCP) kliknij Zmień projekt.
  7. Wpisz numer nowego projektu i kliknij Ustaw projekt.

Starszy edytor

  1. Jeśli nie masz odpowiedniego projektu GCP, utwórz nowy projekt, postępując zgodnie z instrukcjami tworzenia projektu. W innym przypadku otwórz stronę zarządzania zasobami Google Cloud Console i znajdź istniejący projekt GCP, którego chcesz użyć. Musisz mieć uprawnienia do edycji projektu GCP oraz uprawnienia do wyświetlania jego ustawień w Google Cloud Console. Nowy projekt nie może być utworzony automatycznie przez Apps Script.
  2. Ustaw łatwą do zapamiętania nazwę projektu GCP, by móc ją łatwiej znaleźć na stronie zarządzania zasobami w Google Cloud Console. Nazwa ta służy też do identyfikowania skryptu, gdy Apps Script poprosi użytkowników o jego autoryzację.
  3. Określ numer projektu GCP.
  4. W edytorze Apps Script otwórz skrypt, którego projekt GCP chcesz zastąpić.
  5. Kliknij Zasoby i projekt Cloud Platform.
  6. W sekcji Zmień projekt wklej skopiowany numer projektu w polu tekstowym, a potem kliknij Ustaw projekt.
  7. Ekran z ostrzeżeniem wyjaśnia skutki zmiany projektu Cloud Platform. Uważnie przeczytaj komunikat i kliknij Potwierdź.

Projekty Google Cloud i dyski współdzielone

Dyski współdzielone (wcześniej „Dyski zespołu”) 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 zespołowych skryptów, dodatków i aplikacji internetowych, ale nakładają pewne ograniczenia na to, co można zrobić przy użyciu domyślnych projektów Google Cloud.

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

  • Jeśli Twój projekt skryptu korzysta ze standardowego projektu, nie ma żadnych dodatkowych ograniczeń, gdy projekt jest na dysku współdzielonym.
  • Jeśli Twój projekt skryptu korzysta z projektu domyślnego, który został utworzony 8 kwietnia 2019 r. lub później, nie ma dodatkowych ograniczeń, gdy projekt skryptu znajduje się na dysku współdzielonym.
  • Jeśli Twój projekt skryptu korzysta z projektu domyślnego utworzonego przed 8 kwietnia 2019 roku, obowiązują te ograniczenia, gdy projekt na dysku współdzielonym:
    1. Nie można uzyskać dostępu do projektu domyślnego, używając interfejsu Apps Script lub konsoli Google Cloud. Takie ograniczenie uniemożliwia Ci wykonywanie 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 przenosisz istniejący projekt Apps Script na dysk współdzielony, Google ogranicza dostęp do domyślnego projektu Google Cloud. Nadal możesz uzyskać dostęp do projektu domyślnego, jeśli przed przeniesieniem był dostępny dostęp. 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 skryptu w projekcie Google Cloud. Twoi współpracownicy na dysku współdzielonym mogą nie mieć takiej możliwości.
    4. Skrypt zachowuje nazwę projektu Google Cloud przed przeniesieniem go 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 projekt standardowy.

Uzyskaj listę projektów Google Apps Script

Jeśli masz uprawnienie resourcemanager.projects.list dla folderu projektu Apps Script Twojej organizacji, możesz wyświetlić w tym folderze wszystkie standardowe i domyślne projekty Google Cloud Apps Script.

  1. Otwórz stronę Zarządzanie zasobami w Google Cloud Console.
  2. Skopiuj identyfikator obok folderu Apps Script.
  3. Kliknij Filtruj > Identyfikator nadrzędny i wklej identyfikator folderu Apps Script.

Usuwanie projektów Google Apps Script

Aby usunąć projekt Google Apps Script, wykonaj czynności opisane w sekcji Pobieranie listy projektów Google Apps Script, wybierz projekt do usunięcia i kliknij Usuń.

Aby usunąć projekt Apps Script za pomocą narzędzia 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 Google Cloud znajdziesz w artykule Wyłączanie (usuwanie) projektów.