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

Каждый проект 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 в стандартном проекте.
  • Несколько проектов скриптов и других приложений могут использовать один и тот же стандартный проект. Если вы планируете опубликовать проект скрипта в Marketplace в качестве дополнения , он должен иметь свой собственный стандартный проект. Опубликованные приложения не могут использовать общие облачные проекты с другими приложениями.
  • Если вы хотите выполнять функции в проекте скрипта из другого приложения, используя метод scripts.run API Apps Script , проект скрипта и вызывающее приложение должны использовать один и тот же стандартный проект.
  • Когда Apps Script запрашивает у пользователя авторизацию скрипта, использующего стандартный проект, для идентификации скрипта используется имя облачного проекта (а не имя проекта скрипта). Поэтому обязательно укажите подходящее имя облачного проекта.

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

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

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

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

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

Чтобы предоставить приложению Apps Script доступ к другому API Google, активируйте API в соответствующем проекте Cloud:

  1. Откройте проект «Облако» .
  2. Нажмите > API и сервисы .
  3. Нажмите «Включить API и сервисы» .
  4. В поле поиска введите API, который хотите активировать, и нажмите Enter .
  5. Выберите 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. Следуйте инструкциям на экране, чтобы добавить новых участников и их роли. Добавляйте отдельные адреса электронной почты, группы Google или домены.
  6. Нажмите « Сохранить ».

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

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

Если вы хотите опубликовать свой скриптовый проект на Marketplace в качестве дополнения , он должен иметь собственный стандартный проект — опубликованные приложения не могут использовать общие облачные проекты.

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

Переключитесь на другой стандартный облачный проект для вашего скрипта. Если ваш скрипт требует ручной настройки облачного проекта, переключитесь с проекта по умолчанию на стандартный проект. Для получения дополнительной информации см. раздел «Стандартные облачные проекты» .

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

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

  • Если вы активировали расширенные сервисы для своего скрипта, вам необходимо включить соответствующие 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» нажмите «Изменить проект» .
  7. Введите новый номер проекта и нажмите «Установить проект» .

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

Общие диски доступны только клиентам Google Workspace Business и Google Workspace Enterprise .

Общие диски (ранее известные как «Диски для команд») предоставляют общее пространство, где группы пользователей 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 из консоли Google Cloud:

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

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

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

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