Python 3.8 is now generally available.

Setting up your Google Cloud project for App Engine

A Google Cloud project contains your App Engine application as well as other Google Cloud resources.

You can perform all of your administrative tasks from the Cloud SDK and the App Engine Admin API, including the common tasks covered in this topic.

Before you can deploy your apps to the App Engine standard environment, you typically need to create or set up the following:

  1. A Cloud project
  2. An App Engine application
  3. A billing account

Creating a project and application

You can select or create a new Google Cloud project and App Engine application to create and manage a collection of settings, credentials, and your app's metadata. App Engine requires all projects to enable billing, but you will only be charged if a project exceeds its free quota.

Only the Owner role has privileges to create an App Engine application in a Cloud project and that application must exist before any other account can perform tasks on that application. For example, the App Engine application must be created before an account with the App Engine Deployer role can deploy an app using a service account.


After installing Cloud SDK, an account with the Cloud project Owner role can run the following gcloud commands to create a Cloud project and App Engine application:

  1. Run the following command to create a Cloud project:

    gcloud projects create
  2. Run the following command to select a region and create an App Engine application:

    gcloud app create
  3. Enable billing in the Billing page of the Cloud Console, see Enabling billing for details.


To programmatically create a Cloud project and App Engine application, you use both the Resource Manager API and App Engine Admin API:

  1. To create a Cloud project, see Creating a New Project.

  2. To create an App Engine application, see Creating App Engine Applications.

  3. Enable billing in the Billing page of the Cloud Console, see Enabling billing for details.

Enabling billing

To deploy your apps, you must enable billing. Your account will not be charged if you stay within your free quota. If your application needs resources that exceed the free quota, you will be charged for the additional usage.

If you have a billing account when you create a Cloud project, then billing is automatically enabled on that project.

To enable billing on a Cloud project:

  1. In the Cloud Console, go to the Billing page:

    Go to the Billing page

  2. Select or create a Cloud project.

  3. Depending on if a billing account exists or if the selected Cloud project is associated with an account, the Billing page displays one of the following:

    • If billing is already enabled for the selected Cloud project, then the details about the billing account are listed.

    • If no billing account exists, you are prompted to create a billing account and associate it with the selected Cloud project.

    • If a billing account exists, you are prompted to enable billing if the selected Cloud project is not already associated with a billing account. You can also click Cancel and then click Create account to create and associate a new billing account.

After you enable billing, there is no limit to the amount that you might be charged. To gain more control over your application's costs, you can create a budget and set alerts.

Changing or removing a spending limit

Spending limits enable you to specify an approximate maximum amount you could be charged for using App Engine resources in the standard environment per day.

Changing a spending limit

To change an existing spending limit:

  1. In the Cloud Console, go to the Application settings page:

    Go to the Application settings page

  2. Click Edit and specify a new spending limit. When you increase the daily spending limit, the new limit takes effect immediately.

  3. Click Save to set the spending limit for this Cloud project. If you have more than one Cloud project, you must individually set spending limits in each project.

The spending limit only applies to consumption of App Engine resources. It does not apply to other Google Cloud resources and you will be charged for their usage. Also, spending limits might be exceeded slightly while your application is disabled.

Removing a spending limit

Once the spending limit is removed from a project, you can no longer create spending limits in that project.

To remove a spending limit, contact Google Cloud support. A user with the App Engine administrator role can contact support from the Support page in Google Cloud Console:

Go to the Support page

Managing billing

Use the Billing page to manage your billing accounts:

  1. Go to the Billing page in the Cloud Console:

    Go to the Billing page

  2. Select the account that you want to manage and then navigate to the corresponding page to perform the following management tasks:

    • See an overview of your billing account, make payments, and add billing account administrators from the Overview page.
    • Create budgets and alerts on the Budgets & alerts page.
    • View your transaction history and download invoices from the Transactions page.
    • Export your billing data to a BigQuery Dataset from the Billing export page.
    • Configure your payment account and contacts on the Payment settings page.
    • Set the method of payment on the Payment method page.

For more information about billing, see the Pricing page.

Creating budgets and setting alerts

You can create a budget for a Cloud project to avoid surprises on your bill and monitor all of your Google Cloud charges from one place. With a budget, you can create alerts that send emails to your billing administrators when charges exceed a certain amount.

To create a budget and set alerts in a Cloud project:

  1. In the Cloud Console, go to the Billing page:

    Go to the Billing page

  2. Click the billing account for which you want to create a budget.

  3. Click Budgets & alerts and then Create budget to begin creating a budget for your Cloud project.

  4. Define your budget in the Set budget section and then specify the percentages for which you want to receive email alerts in the following Set budget alerts section.

  5. Click Save to set the budget and enable alerts for your Cloud project. If you have multiple Cloud projects, you must individually set budgets and alerts in each project.

Disabling an application

Disable an App Engine application to stop your app from running instances and serving requests. No data loss will occur when you disable your app, nor will any configuration settings change. Simply re-enable your App Engine application to startup instances and continue serving the traffic to your app.

Your app's resources in both the standard and flexible environment are disabled and therefore, won't incur charges. However, billing charges can still occur for the other services in your Cloud project, for example you can still incur storage charges for your stored data.

If your app is actively processing a request, it will continue to complete that task and can take up to an hour before your app is completely disabled.

To disable an App Engine application:

  1. Go to the Application settings page:

    Go to the Application settings page

  2. Click Disable application and then follow the prompts.

When you want your app to continue serving requests, enable the App Engine application by returning to the same Application settings page and then clicking Enable application.

Disabling your application stops all serving requests, but your data and state are retained. You will still be billed for applicable charges already incurred or charges for other services running in your project, such as Cloud SQL. To release all the resources used within the project, shut down your project.

Shutting down a project

You can disable billing and release all the Google Cloud resources that are being used in your Cloud project by shutting down that project.


After installing the Google Cloud SDK, you run the following gcloud command to shut down a Cloud project:

gcloud projects delete


To programmatically shut down your Cloud project, see Shutting Down a Project in the Resource Manager API.


To shut down a Cloud project using the Cloud Console:

  1. Go to the Projects page:

    Go to the Projects page

  2. Select the Cloud project that you want to shut down, then click .

For more information about managing your Cloud projects, see Cloud Resource Manager: creating, shutting down, and restoring projects.