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

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

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

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

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

  • Для большинства скриптов вам никогда не потребуется просматривать или настраивать этот проект по умолчанию. 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. Чтобы получить доступ к проекту по умолчанию, перейдите в настройки проекта скрипта и нажмите на его номер.

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

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

Если вы не являетесь администратором, вы не можете вручную удалять проекты по умолчанию. Однако, если вы удалите проект скрипта или переключите его на использование стандартного проекта, 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. Откройте проект Cloud .
  2. Нажмите > API и службы .
  3. Нажмите Включить API и службы .
  4. В поле поиска введите API, который вы хотите активировать, и нажмите Enter .
  5. Щелкните API в результатах поиска, а затем нажмите Включить , чтобы активировать API для этого облачного проекта.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Группировка нескольких скриптов в один облачный проект

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

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

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

Эффекты перехода на другой стандартный облачный проект

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

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

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

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

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

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

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

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

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

Общие диски (ранее командные диски) предоставляют общие пространства, где группы пользователей Диска могут совместно работать над проектами Apps Script и документами Диска. Общие диски полезны при командной разработке скриптов, дополнений и веб-приложений, но они накладывают некоторые ограничения на возможности старых стандартных проектов 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. Рядом с папкой 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

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