Облачные проекты Google

Каждый проект Apps Script использует Google Cloud для управления авторизацией, расширенными сервисами и другими деталями. Для настройки и управления этими параметрами каждый проект Apps Script имеет связанный с ним проект Google Cloud . Ваш проект скрипта может использовать проект по умолчанию , который Apps Script создает автоматически, или стандартный проект , который вы создаете самостоятельно. В целом, проекты по умолчанию хороши для обычных скриптов, но для любого сложного приложения, приложения коммерческого качества или приложения, которое вы планируете опубликовать, следует использовать стандартный проект.

Вы можете в любой момент переключиться с проекта по умолчанию на стандартный проект , но вернуться к использованию проекта по умолчанию невозможно. Лучше всего выбрать облачный проект, используемый вашим скриптом, на раннем этапе разработки. Переключение позже может вызвать сложности, например, потребовать повторной авторизации пользователей.

Проекты облака по умолчанию

При создании проекта Apps Script, по умолчанию создается облачный проект, работающий в фоновом режиме.

  • Для большинства скриптов вам никогда не потребуется просматривать или изменять этот проект по умолчанию. Apps Script обрабатывает необходимые взаимодействия с Google Cloud. Например, если вы активируете расширенную службу в редакторе Apps Script, Apps Script активирует эту расширенную службу в проекте Cloud по умолчанию при сохранении проекта скрипта.
  • Для некоторых скриптов необходимо взаимодействовать с консолью Google Cloud. В таких случаях ваш скрипт должен использовать стандартный проект Cloud. Например, для просмотра журналов Google Cloud в консоли Google Cloud ваш скрипт должен использовать стандартный проект.

По умолчанию для облачных проектов существует политика управления идентификацией и доступом (IAM) с одной записью — учетной записью службы Google, которая выступает в качестве владельца проекта по умолчанию. Учетная запись службы Google — appsdev-apps-dev-script-auth@system.gserviceaccount.com .

Просмотр или обновление облачных проектов по умолчанию

Большинство пользователей не могут напрямую находить, просматривать или редактировать проекты по умолчанию в консоли Google Cloud. Если вы являетесь администратором, обратитесь к разделу «Просмотр проектов Google Cloud по умолчанию» .

Если вы создали свой проект скрипта до 8 апреля 2019 года , вы можете использовать проект по умолчанию, доступный в консоли Google Cloud. Чтобы получить доступ к проекту по умолчанию, перейдите в настройки проекта скрипта и щелкните номер проекта.

Удалить проекты Cloud по умолчанию

Если вы являетесь администратором, вы можете удалять стандартные облачные проекты так же, как и обычные облачные проекты. См. раздел «Просмотр или редактирование стандартных облачных проектов» .

Если вы не являетесь администратором, вы не можете вручную удалить проекты по умолчанию. Однако, если вы удалите проект скрипта или переключитесь на использование стандартного проекта, Apps Script удалит проект по умолчанию, прикрепленный к скрипту, вместе со всеми его настройками и информацией.

Стандартные облачные проекты

Для большинства скриптовых проектов оптимальным вариантом являются проекты Cloud по умолчанию, за исключением случаев, когда требуется ручная настройка проекта. В таких ситуациях необходимо переключить скриптовый проект на использование стандартного проекта .

В следующих разделах описывается, когда Apps Script требует наличия стандартного проекта, свойства таких проектов и типичные задачи, выполняемые с их помощью. Следующие задачи можно выполнять только со стандартными проектами.

Когда Apps Script требует стандартных облачных проектов

В следующих ситуациях необходимо использовать стандартный проект:

Стандартные свойства облачного проекта

Стандартные проекты обладают следующими свойствами:

  • Вы можете получить доступ ко всем настройкам Google Cloud для проекта непосредственно из консоли Google Cloud . Это позволяет активировать API, корректировать учетные данные авторизации и настраивать другие параметры.
  • При удалении проекта скрипта или переключении на использование другого стандартного проекта исходный стандартный проект сохраняется и может быть использован повторно.
  • При активации расширенной службы в проекте скрипта необходимо вручную активировать соответствующий API в стандартном проекте.
  • Несколько проектов скриптов и других приложений могут использовать один и тот же стандартный проект. Если вы планируете опубликовать проект скрипта в Google Workspace Marketplace в качестве дополнения , он должен иметь свой собственный стандартный проект. Опубликованные приложения не могут использовать общие облачные проекты с другими приложениями.
  • Если вы хотите выполнять функции в проекте скрипта из другого приложения, используя метод scripts.run API Apps Script , проект скрипта и вызывающее приложение должны использовать один и тот же стандартный проект.
  • Когда Apps Script запрашивает у пользователя авторизацию скрипта, использующего стандартный проект, для идентификации скрипта используется имя облачного проекта (а не имя проекта скрипта). Поэтому обязательно укажите подходящее имя облачного проекта.

Получите доступ к стандартному облачному проекту.

Чтобы получить доступ к стандартному проекту, связанному с вашим проектом скриптов, выполните следующие действия:

  1. Откройте проект Apps Script.
  2. В левой части экрана нажмите проекта» .
  3. В разделе «Проект Google Cloud Platform (GCP)» щелкните номер проекта.

Также стандартный проект можно найти непосредственно на странице «Управление ресурсами» в консоли Google Cloud .

Активация API в стандартном облачном проекте

Часто приложению Apps Script требуется доступ к другому API Google. Для этого необходимо активировать API в соответствующем проекте Cloud. Активировать API можно следующим образом:

  1. Откройте проект «Облако» .
  2. Нажмите > API и сервисы .
  3. Нажмите «Включить API и сервисы» .
  4. В поле поиска введите API, который хотите активировать, и нажмите Enter .
  5. Выберите API из результатов поиска, а затем нажмите «Включить» , чтобы активировать API для этого облачного проекта.

Возможно, вам будет предложено принять Условия использования API Google или Google Cloud . Внимательно ознакомьтесь с Условиями использования, прежде чем принимать их.

В зависимости от приложения, вам также может потребоваться настроить API, выбрав его на панели управления «API и сервисы» .

Определите идентификатор и номер стандартного облачного проекта.

Все облачные проекты имеют название проекта, идентификатор проекта и номер проекта. В некоторых случаях эти идентификаторы необходимы для настройки сервисов или выполнения других задач.

Чтобы определить идентификационный номер и номер вашего стандартного проекта, выполните следующие действия:

  1. Откройте проект «Облако» .
  2. В правом верхнем углу нажмите > «Настройки проекта» .
  3. В появившейся панели настроек вы можете просмотреть название проекта , идентификатор проекта и номер проекта . Номер проекта состоит только из цифр, а идентификатор проекта — из букв и цифр. Вы можете изменить название проекта , которое отображается пользователям во время запросов на авторизацию.

Просматривайте журналы и отчеты об ошибках Google Cloud в консоли Google Cloud.

Если вы используете систему логирования или отчетов об ошибках Google Cloud для своего скриптового проекта, вы можете просмотреть эти журналы и отчеты в консоли Google Cloud , выполнив следующие действия:

  1. Откройте проект «Облако» .
  2. Нажмите « .
  3. В разделе «Операции» щелкните «Ведение журнала» > «Проводник журналов» .
  4. Чтобы просмотреть отчеты об ошибках, в разделе «Операции» нажмите «Отчеты об ошибках» . Если вам будет предложено настроить отчеты об ошибках, это означает, что ваш скриптовый проект еще не регистрировал никаких исключений.

При использовании сервисов, требующих аутентификации OAuth, Google запрашивает у пользователей разрешение на использование этих сервисов. Настройки экрана согласия OAuth позволяют задать некоторую информацию, которую Google предоставляет пользователям, например, название приложения и URL-адрес Условий использования.

В стандартных облачных проектах экран согласия создается автоматически на основе сведений о проекте Apps Script; эти настройки нельзя изменить. В стандартных облачных проектах эта информация настраивается. Вы можете настроить экран согласия вашего скрипта следующим образом:

  1. Откройте проект «Облако» .
  2. Нажмите > API и сервисы > Учетные данные .
  3. Нажмите «Настроить экран согласия» .
  4. Заполните каждый раздел процедуры получения согласия.
  5. Чтобы сохранить изменения на каждом этапе рабочего процесса, нажмите «Сохранить и продолжить» .

Создание учетных данных OAuth

В Apps Script обычно настраивается OAuth для сервисов, используемых вашим скриптом. Для некоторых приложений необходимо создать дополнительные учетные данные OAuth (идентификаторы клиентов и секреты клиентов). Это можно сделать только в стандартных проектах.

Для создания идентификатора клиента и секретного ключа клиента для вашего скриптового проекта выполните следующие действия:

  1. Откройте проект «Облако» .
  2. Нажмите > API и сервисы > Учетные данные .
  3. Нажмите «Создать учетные данные» > «Идентификатор клиента OAuth» .
  4. В разделе «Тип приложения» выберите тип вашего приложения и при необходимости заполните появившуюся форму. После завершения нажмите «Создать» .
  5. В появившемся диалоговом окне нажмите «Скачать JSON» . Этот файл можно использовать для настройки OAuth.

Добавление дополнительных владельцев к стандартному облачному проекту

В стандартный проект можно добавить дополнительных владельцев или другие роли. Если вы работаете над проектом совместно, это поможет гарантировать, что кто-то из вашей команды всегда будет иметь доступ к настройкам Google Cloud проекта скрипта.

Добавить дополнительных владельцев или другие роли в стандартный проект можно следующим образом. Для внесения любых из этих изменений у вас должны быть права на редактирование проекта:

  1. Определите, кто должен быть вашими соавторами. Мы рекомендуем создать или использовать существующую группу Google. Вы также можете указать домены в списке соавторов, чтобы включить всех пользователей из этого домена.
  2. Откройте проект Cloud этого скрипта .
  3. Нажмите > IAM и администратор > IAM .
  4. Вверху нажмите «Добавить» .
  5. Следуйте инструкциям на экране, чтобы добавить одного или нескольких новых участников и их роли в проект Cloud. В качестве новых участников можно добавлять отдельные адреса электронной почты, группы Google или домены.
  6. Нажмите « Сохранить ».

Объедините несколько скриптов в один облачный проект.

Вы можете использовать один и тот же стандартный облачный проект для нескольких проектов Apps Script. Для этого создайте стандартный проект, а затем переключите каждый проект Script на его использование. С проектами по умолчанию это сделать невозможно.

Используйте другой стандартный облачный проект.

Вы можете переключить проект скрипта таким образом, чтобы он использовал другой стандартный проект Cloud. Если ваш скрипт требует ручной настройки проекта Cloud, вам необходимо переключиться с проекта по умолчанию на стандартный проект. Чтобы узнать больше о том, когда следует использовать стандартный проект, обратитесь к разделу «Стандартные проекты Cloud» .

Последствия перехода на другой стандарт облачного проекта

Если вы переключите свой скрипт с проекта по умолчанию на другой стандартный проект, это повлияет на его работу следующим образом:

  • Если вы активировали расширенные сервисы для своего скрипта, вам необходимо включить соответствующие API в новом проекте Cloud. При этом вы потеряете все данные, связанные с расширенными сервисами в предыдущем проекте Cloud. Чтобы узнать, как включить API в вашем проекте Cloud, см. раздел «Включение API Google Workspace» .
  • Если ваш скрипт использует встроенный сервис Google Drive, необходимо включить API Drive в стандартных облачных проектах.

    В стандартном облачном проекте включите API Google Drive:

    Включите API Google Диска

  • Все пользователи, ранее авторизовавшие скрипт, должны пройти повторную авторизацию. В большинстве случаев все пользователи, ранее авторизовавшие приложения, связанные с новым проектом, также должны пройти повторную авторизацию.
  • Если ваш скрипт связан с приложением, размещенным на Google Workspace Marketplace, информация о приложении, пользователи и отзывы не переносятся в новый проект. Вам необходимо создать новое приложение в рамках нового проекта, и ваши пользователи должны будут переустановить ваше приложение. Информацию о создании нового приложения см. в разделе «Публикация приложения» .
  • Вы не можете переключить скрипт обратно на проект по умолчанию. Apps Script удаляет проекты по умолчанию после того, как вы настроите скрипт на использование стандартного проекта.

Переключиться на другой стандартный облачный проект

Чтобы перенести существующий облачный проект скрипта в другой облачный проект, выполните следующие действия:

  1. Если у вас нет подходящего облачного проекта, создайте его, следуя инструкциям по созданию проекта . Задайте запоминающееся имя проекта, чтобы вы могли найти его на странице «Управление ресурсами» в консоли Google Cloud . Apps Script будет использовать это имя при запросе у пользователей авторизации скрипта.
  2. Если вы хотите использовать существующий проект, откройте страницу «Управление ресурсами» в консоли Google Cloud и найдите подходящий проект. Для этого проекта у вас должны быть роли «Просмотрщик проектов» и «Редактор конфигурации OAuth» или роли с эквивалентными разрешениями. Вы не можете использовать проект, автоматически созданный с помощью Apps Script.
  3. Определите номер проекта вашего облачного проекта .
  4. Откройте скрипт, проект Cloud которого вы хотите заменить.
  5. В левой части экрана нажмите проекта» .
  6. В разделе «Проект Google Cloud Platform (GCP)» нажмите «Изменить проект» .
  7. Введите новый номер проекта и нажмите «Установить проект» .

Облачные проекты и общие диски

Общие диски (ранее известные как «Диски для команд») предоставляют общее пространство, где группы пользователей Google Диска могут совместно работать над проектами Apps Script и документами Google Диска. Общие диски полезны при командной разработке скриптов, дополнений и веб-приложений, но они накладывают некоторые ограничения на возможности работы со старыми проектами Cloud по умолчанию.

Приведенный ниже список ограничений описывает, как облачные проекты взаимодействуют с общими дисками:

  • Если ваш скриптовый проект использует стандартный проект, то при размещении скриптового проекта на общем диске дополнительных ограничений нет.
  • Если в вашем проекте скрипта используется проект по умолчанию, созданный 8 апреля 2019 года или позже, то никаких дополнительных ограничений не возникает, если проект скрипта находится на общем диске.
  • Если в вашем проекте скрипта используется проект по умолчанию, созданный до 8 апреля 2019 года, то при размещении проекта скрипта на общем диске действуют следующие ограничения:
    1. Вы не можете получить доступ к проекту по умолчанию через пользовательский интерфейс Apps Script или консоль Google Cloud . Это ограничение не позволяет вам выполнять действия, требующие прямого доступа к проекту .
    2. Вы не можете активировать расширенные сервисы . Для активации расширенных сервисов переключитесь на стандартный проект.
    3. При перемещении существующего проекта Apps Script на общий диск Google ограничивает доступ к проекту Cloud по умолчанию. Вы по-прежнему можете получить доступ к проекту Cloud, если у вас был доступ до перемещения. Например, если вы создали скрипт в папке «Мой диск», а затем переместили его на общий диск, вы все еще можете получить доступ к проекту Cloud этого скрипта. Ваши коллеги на общем диске могут не иметь к нему доступа.
    4. Скрипт сохраняет имя облачного проекта, которое у него было до перемещения на общий диск. Даже если вы измените имя проекта на общем диске, пользователи, авторизовавшие скрипт, по-прежнему будут видеть старое имя в диалоговых окнах авторизации.

Чтобы избежать этих ограничений для старых скриптов, переключитесь на стандартный проект .

Получите список проектов Apps Script Cloud

Если у вас есть разрешение resourcemanager.projects.list для папки проекта Apps Script вашей организации, вы можете просмотреть все стандартные и проекты Apps Script Cloud по умолчанию в этой папке.

  1. Откройте страницу «Управление ресурсами» в консоли Google Cloud .
  2. Скопируйте идентификатор (ID) рядом с папкой Apps Script .
  3. Нажмите «Фильтр» > «Идентификатор родительского элемента» и вставьте идентификатор папки Apps Script.

Удалить проекты Apps Script Cloud

Чтобы удалить проект Apps Script Cloud, выполните действия, описанные в разделе «Получить список проектов Apps Script Cloud» , выберите проект, который хотите удалить, и нажмите «Удалить» .

Для удаления проекта Apps Script с помощью gcloud используйте следующие команды.

gcloud projects list --filter='parent.id=APPS_SCRIPT_FOLDER_ID'
gcloud projects delete PROJECT_ID

Для получения дополнительной информации об удалении облачных проектов см. раздел «Завершение (удаление) проектов» .