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

Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

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

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

Стандартные проекты Google Cloud

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

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

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

Большинство пользователей не могут напрямую находить, просматривать или редактировать проекты по умолчанию в консоли Google Cloud. Администраторы и пользователи домена, у которых есть разрешение resourcemanager.projects.list для родительской папки Google Cloud, могут просматривать и настраивать проекты по умолчанию.

  • Для клиентов Google Workspace проекты по умолчанию находятся в Organization root > system-gsuite > apps-script в иерархии облачных ресурсов. Не удаляйте эти папки. В противном случае сценарии не смогут создавать проекты по умолчанию и не будут выполняться должным образом.
  • Для клиентов, не являющихся пользователями Google Workspace, проекты по умолчанию не имеют родительских элементов в иерархии ресурсов.

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

Если вы являетесь администратором, вы можете удалить проекты Google Cloud по умолчанию, как и стандартные проекты Google Cloud. См. раздел Удаление проектов Google Cloud скрипта приложений .

Если вы не являетесь администратором, вы не можете удалять проекты по умолчанию. Однако Apps Script удаляет проекты по умолчанию в следующих случаях:

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

Стандартные проекты Google Cloud

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

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

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

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

Стандартные свойства проекта Google Cloud

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

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

Доступ к стандартному проекту Google Cloud

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

Новый редактор

  1. Откройте проект скрипта приложений.
  2. Слева нажмите проекта .
  3. В разделе Проект Google Cloud Platform (GCP) нажмите на номер проекта.

Устаревший редактор

  1. Откройте скрипт в редакторе скриптов приложений.
  2. Выберите Ресурсы > Проект облачной платформы .
  3. В открывшемся диалоговом окне щелкните верхнюю ссылку, указывающую на имя проекта GCP.

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

Активировать API в стандартном проекте Google Cloud

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

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

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

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

Определите идентификатор и номер стандартного проекта Google Cloud

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Группируйте несколько скриптов с одним проектом Google Cloud

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

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

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

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

Новый редактор

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

Устаревший редактор

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

Проекты Google Cloud и общие диски

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

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

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

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

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

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

  1. Откройте страницу управления ресурсами в консоли Google Cloud .
  2. Рядом с папкой Apps Script скопируйте идентификатор.
  3. Щелкните Фильтр > Родительский идентификатор и вставьте идентификатор папки Apps Script.

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

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

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

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

Дополнительные сведения об удалении проектов Google Cloud см. в разделе Завершение работы (удаление) проектов .