Projekty Google Cloud

Każdy projekt Apps Script używa Google Cloud do zarządzania autoryzacją, usług zaawansowanych i innych. Aby można było konfigurować te ustawienia i nimi zarządzać, każdy projekt Apps Script ma powiązany projekt Google Cloud. Twój projekt skryptu może korzystać z domyślnego projektu utworzonego automatycznie przez Apps Script lub z standardowego projektu utworzonego przez Ciebie. Ogólnie rzecz biorąc, projekty domyślne są odpowiednie do codziennych lub prostych projektów. skryptów, ale dla każdej aplikacji, która mają złożony charakter, charakter komercyjny lub są przeznaczone do publikacji.

W dowolnym momencie możesz przełączyć się z projektu domyślnego na projekt standardowy, ale nie możesz z powrotem przejść na projekt domyślny. Najlepiej, aby wybrać projekt Google Cloud używany na wczesnym etapie projektowania. Przełączenie na inny typ konta może spowodować komplikacje, np. konieczność ponownego autoryzowania użytkowników.

Domyślne projekty Cloud

Gdy tworzysz projekt Apps Script, Apps Script tworzy Projekt w chmurze, który działa w tle.

  • W przypadku większości skryptów nie musisz nigdy widzieć ani zmieniać tego domyślnego projektu. aplikacji; Skrypt obsługuje niezbędne interakcje z Google Cloud. Na przykład, jeśli aktywujesz zaawansowaną usługę w edytorze Apps Script, aktywuje usługę zaawansowaną w domyślnym projekcie Cloud, gdy zapisać projekt skryptu.
  • W przypadku niektórych skryptów musisz użyć konsoli Google Cloud. W tych skrypt musi używać standardowego projektu Cloud. Dla: Aby na przykład wyświetlić logi Google Cloud w konsoli Google Cloud, skrypt musi używać w standardowym projekcie.

Domyślnie projekty Cloud mają usługę Identity and Access Management (uprawnienia) z jednym wpisem, konto usługi Google działające jako właściciel domyślny projekt. Konto usługi Google jest 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 zlokalizować, 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żyć szablonu domyślny projekt, do którego masz dostęp w konsoli Google Cloud. Aby uzyskać dostęp do domyślny projekt, przejdź do ustawień projektu skryptu i kliknij projekt numer.

Usuwanie domyślnych projektów Cloud

Jeśli jesteś administratorem, możesz usuwać domyślne projekty Cloud w taki sam sposób standardowych projektach Cloud. Zobacz Usuwanie projektów Apps Script Cloud.

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

  • Jeśli usuniesz projekt skryptu lub przełączysz go na standardowy projekt, Skrypt usuwa domyślny projekt dołączony do skryptu oraz ustawień ani informacji w nim zawartych.
  • Jeśli skrypt nie jest uruchamiany przez co najmniej 180 dni, Apps Script usuwa powiązany z nim projekt domyślny. Jeśli skrypt zostanie uruchomiony po usunięciu przez Apps Script projektu domyślnego, Apps Script utworzy projekt domyślny dla skryptu.

Standardowe projekty Cloud

Domyślne projekty Cloud to najlepsza opcja w przypadku większości projektów skryptów, chyba że musisz ręcznie skonfigurować projekt. W takiej sytuacji musisz: przełączyć projekt skryptu na projekt standardowy.

W tych sekcjach opisano, kiedy Apps Script wymaga projektu standardowego, właściwości takich projektów oraz typowe zadania wykonywane za ich pomocą. Do wyboru masz tylko i wykonaj podane niżej zadania w standardowych projektach.

Gdy Apps Script wymaga standardowych projektów Cloud

Musisz używać projektu standardowego w tych sytuacjach:

Standardowe właściwości projektu Cloud

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

  • Masz bezpośredni dostęp do wszystkich ustawień Google Cloud w projekcie z konsoli Google Cloud. Pozwoli Ci to aktywować interfejsy API, dostosować autoryzację dane logowania i skonfigurować inne ustawienia.
  • Gdy usuniesz projekt skryptu lub przełączysz się na w innym standardowym projekcie, pierwotny projekt standardowy pozostaje ponownie użyte.
  • Gdy aktywujesz usługę zaawansowaną w projekcie skryptu, musisz ręcznie aktywować odpowiedni interfejs API w projekcie standardowym.
  • Wiele projektów skryptów i inne aplikacje mogą współdzielić to samo w standardowym projekcie. Jeśli zamierzasz opublikować projekt skryptu do Google Workspace Marketplace, jako dodatek, musi mieć własny standardowy projekt. Opublikowane aplikacje nie mogą być udostępniane Projekty w chmurze z innymi aplikacjami.
  • Jeśli chcesz uruchamiać 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 standardu w projektach AI.
  • Gdy Apps Script prosi użytkownika o autoryzację skryptu korzystającego ze standardowego nazwa projektu w Google Cloud służy do identyfikowania skryptu (a nie nazwę projektu skryptu). Z tego powodu pamiętaj, aby ustawić właściwy Nazwa projektu Cloud.

Dostęp do standardowego projektu Cloud

Aby uzyskać dostęp do projektu standardowego 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.

Projekt standardowy możesz też znaleźć bezpośrednio na stronie Zarządzanie zasobami w konsoli Google Cloud.

Aktywowanie interfejsu API w standardowym projekcie Cloud

Często aplikacja Apps Script wymaga dostępu do innego interfejsu API Google. Aby to zrobić: musisz aktywować interfejs API w odpowiednim projekcie Cloud. Aktywuj interfejs API, wykonując 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 interfejs API, który chcesz aktywować, i naciśnij Enter.
  5. Kliknij interfejs API w wynikach wyszukiwania, a następnie kliknij Włącz, aby aktywować. interfejsu API dla tego projektu Cloud.

Może pojawić się prośba o zaakceptowanie Warunków korzystania z usługi dla interfejsów API Google lub Google Cloud Zapoznaj się z Warunkami należy dokładnie zapoznać się z Usługą przed ich zaakceptowaniem.

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

Określanie identyfikatorów & numer standardowego projektu Cloud

Wszystkie projekty Cloud mają nazwę, identyfikator i numer. Czasem konieczne jest posiadanie tych identyfikatorów, konfigurować usługi lub wykonywać inne zadania.

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

  1. Otwórz projekt Cloud.
  2. W prawym górnym rogu kliknij Więcej > Ustawienia projektu.
  3. Wyświetl nazwę projektu, identyfikator projektu i numer projektu. w wyświetlonym panelu Ustawienia. Numer projektu składa się tylko z: cyfr, a identyfikator projektu to znaki alfanumeryczne. Możesz edytować nazwa projektu, która wyświetla się użytkownikom podczas wyświetlania prośby o autoryzację.

Wyświetl logi Google Cloud & raportów o błędach w konsoli Google Cloud.

Jeśli korzystasz z logowania w Google Cloud lub raportowanie błędów projektu skryptu, możesz wyświetlać te logi i raporty Google Cloud Console, 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 Error Reporting. Jeśli pojawi się prośba o skonfiguruj raportowanie błędów, oznacza to, że Twój projekt skryptu nie zarejestrował już wszystkie wyjątki.

Podczas korzystania z usług wymagających OAuth Google prosi użytkowników o autoryzację tych usług. Ustawienia ekranu zgody OAuth pozwalają określić niektóre informacje, które Google przedstawia użytkownikom, nazwę aplikacji i adres URL warunków korzystania z usługi.

Domyślne projekty Cloud tworzą ekran zgody automatycznie szczegóły projektu Apps Script; nie możesz zmienić tych ustawień. W przypadku standardowych projektów Cloud możesz dostosować te informacje. Możesz skonfigurować zgodę skryptu ekranu, wykonując te czynności:

  1. Otwórz projekt Cloud.
  2. Kliknij Menu . > Interfejsy API i Usługi > Dane logowania.
  3. Kliknij Skonfiguruj ekran zgody.
  4. Wypełnij wszystkie sekcje procedury ekranu 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 na potrzeby usług których używa skrypt. W przypadku niektórych aplikacji musisz utworzyć dodatkowe dane uwierzytelniające OAuth (identyfikatory klienta i tajne klucze klienta). Możesz to zrobić tylko za pomocą standardowych projektach.

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 w razie potrzeby wypełnij wyświetlony formularz. Gdy skończysz, kliknij Utwórz.
  5. W wyświetlonym oknie kliknij Pobierz plik JSON. Dostępne opcje użyć tego pliku do skonfigurowania OAuth.

Dodawanie kolejnych właścicieli do standardowego projektu Cloud

Do projektu standardowego możesz dodać kolejnych właścicieli lub inne role. Jeśli współpracujesz nad projektem, masz pewność, że ktoś z Twojego zespołu zespół zawsze ma dostęp do ustawień Google Cloud projektu skryptu.

Aby dodać do standardowego projektu dodatkowych właścicieli lub inne role, wykonaj te czynności: następujących po sobie. Musisz mieć uprawnienia do edycji w projekcie, aby móc tworzyć dowolne z następujące zmiany:

  1. Określ, kim powinni być Twoi współpracownicy. Zalecamy lub utwórz istniejącą grupę dyskusyjną Google. Dostępne opcje określ także domeny na liście współpracowników, aby uwzględnić wszystkich użytkowników na tej liście w Twojej domenie.
  2. Otwórz projekt Cloud skryptu.
  3. Kliknij Menu . > Administracja administrator > IAM.
  4. U góry kliknij Dodaj.
  5. Postępuj zgodnie z instrukcjami wyświetlanymi na ekranie, aby dodać co najmniej 1 nowego użytkownika i jego role w projekcie Cloud. 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 Cloud

Możesz mieć wiele projektów Apps Script korzystających z tego samego standardu Projekt w chmurze. Aby to zrobić, utwórz projekt standardowy, a potem przełącz każdy projekt skryptu aby z niej korzystać. Nie można tego zrobić w projektach domyślnych.

Użyj innego standardowego projektu Cloud

Możesz zmienić projekt skryptu tak, aby używał innego standardu Projekt w chmurze. Jeśli Twój skrypt wymaga ręcznej konfiguracji Projekt Cloud, musisz przełączyć się z projektu domyślnego na standardowy w projektach AI. Aby się uczyć aby dowiedzieć się, kiedy trzeba użyć standardowego projektu, zapoznaj się z artykułem standardowych projektów Cloud.

Skutki przejścia na inny standardowy projekt Cloud

Jeśli zmienisz swój skrypt z projektu domyślnego lub innego na inny standard będzie miał następujące skutki:

  • Jeśli w skrypcie zostały aktywowane usługi zaawansowane, musisz włączyć odpowiednich interfejsów API w do nowego projektu Cloud. Utracisz wszystkie dane powiązane z zaawansowanymi w poprzednim projekcie Cloud. Aby dowiedzieć się, jak włączyć interfejsy API w projekcie Cloud, zapoznaj się z sekcją Włączanie interfejsów Google Workspace API.
  • Jeśli skrypt korzysta z wbudowanej usługi Dysku Google, musisz włączyć interfejs Drive API w standardowych projektach Cloud.

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

    Włączanie interfejsu Drive API

  • Wszyscy użytkownicy, którzy wcześniej autoryzowali skrypt, muszą dokonać ponownej autoryzacji. W większości przypadków wszyscy użytkownicy, którzy wcześniej autoryzowali aplikacje powiązane z nowym projektem, muszą ponownie 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. Trzeba utworzyć stronę aplikacji w nowym projekcie oraz użytkownicy muszą ponownie zainstalować aplikację. Informacje o tworzeniu nowych informacje o aplikacji znajdziesz w artykule Publikowanie aplikacji.
  • Nie będzie można przywrócić skryptu z powrotem do projektu domyślnego. Usunięcia Apps Script domyślnych projektów po ustawieniu w skrypcie standardowego projektu.

Przełącz się na inny standardowy projekt Cloud

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

  1. Jeśli nie masz odpowiedniego projektu Cloud, utwórz Wykonaj instrukcje podane w sekcji Tworzenie projektu. za instrukcje. Ustaw łatwą do zapamiętania nazwę projektu, aby: znajdziesz go na stronie Zarządzanie zasobami w konsoli Google Cloud. Apps Script używa tej nazwy, gdy z prośbą o autoryzację skryptu.
  2. Jeśli chcesz użyć istniejącego projektu, otwórz stronę Zarządzanie zasobami w konsoli Google Cloud. i zlokalizuj istniejący projekt, którego chcesz użyć. Musisz mieć Role przeglądarki projektu i edytora konfiguracji protokołu OAuth lub odpowiadające im role dla funkcji w projektach AI. Nie możesz użyć projektu, który został utworzony automatycznie przez Google Apps Skrypt.
  3. Określ numer projektu swojego projektu Cloud.
  4. Otwórz skrypt, którego projekt Cloud chcesz zastąpić.
  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 dyski współdzielone

Dyski współdzielone (dawniej Dyski zespołowe) to wspólne przestrzenie, 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 programowania skryptów, dodatków i aplikacji internetowych, ale nakładają pewne ograniczenia na co można zrobić ze starszymi domyślnymi projektami Cloud.

Lista ograniczeń opisuje sposób interakcji projektów Google Cloud za pomocą dysków współdzielonych:

  • Jeśli Twój projekt skryptu korzysta ze standardowego projektu, nie ma żadnych dodatkowe ograniczenia, jeśli projekt skryptu znajduje się na dysku współdzielonym.
  • Jeśli Twój projekt skryptu używa projektu domyślnego, który został utworzony po 8 kwietnia 2019 r. nie będą obowiązywały żadne dodatkowe ograniczenia, na dysku współdzielonym.
  • Jeśli Twój projekt skryptu korzysta z projektu domyślnego, który został utworzony wcześniej 8 kwietnia 2019 r. podczas wykonywania skryptu będą obowiązywać poniższe ograniczenia znajduje się na dysku współdzielonym:
    1. Nie możesz uzyskać dostępu do projektu domyślnego za pomocą interfejsu użytkownika Apps Script ani konsoli Google Cloud. To ograniczenie uniemożliwia Ci działania, które wymagają bezpośredniego dostępu do projektu.
    2. Nie możesz aktywować usług zaawansowanych. Aby aktywować usługi zaawansowane, przejdź na wersję standardową w projektach AI.
    3. Gdy przenosisz istniejący projekt Apps Script na dysk współdzielony, Google ogranicza dostęp do domyślnego projektu Cloud. Nadal możesz dostęp do domyślnego projektu, jeśli był on możliwy przed przeniesieniem. Dla: przykład, jeśli skrypt został utworzony w folderze Mój dysk, a następnie przeniesiony na dysk współdzielony, nadal możesz uzyskać dostęp do jego Projekt w chmurze. Twoi współpracownicy na dysku współdzielonym mogą nie być w stanie tego zrobić.
    4. Skrypt zachowuje nazwę projektu 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ę podczas autoryzacji .

Aby uniknąć powyższych ograniczeń w przypadku starszych skryptów, przełącz się na projekt standardowy.

Pobieranie listy projektów Apps Script Cloud

Jeśli masz uprawnienia resourcemanager.projects.list do folderu projektu Apps Script w organizacji, możesz wyświetlać w tym folderze wszystkie standardowe i domyślne projekty Apps Script Cloud.

  1. Otwórz konsolę Google Cloud na stronie Zarządzanie zasobami.
  2. Skopiuj identyfikator znajdujący się obok folderu Apps Script.
  3. Kliknij Filtruj > Identyfikator nadrzędny i wklej identyfikator folderu Apps Script.

Usuń projekty Apps Script Cloud

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

Aby usunąć projekt Apps Script za pomocą interfejsu gcloud, wykonaj te czynności 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 sekcji Wyłączanie (usuwanie).