A Google Cloud project is required to use Google Workspace APIs and build Google Workspace add-ons or apps. A Cloud project forms the basis for creating, enabling, and using all Google Cloud services, including managing APIs, enabling billing, adding and removing collaborators, and managing permissions.
Create a Cloud project
Google Cloud console
- In the Google Cloud console, go to Menu > IAM & Admin > Create a Project .
- In the Project Name
field, enter a descriptive name for your project.
Optional: To edit the Project ID , click Edit . The project ID can't be changed after the project is created, so choose an ID that meets your needs for the lifetime of the project.
- In the Location field, click Browse to display potential locations for your project. Then, click Select .
- Click Create . The Google Cloud console navigates to the Dashboard page and your project is created within a few minutes.
gcloud CLI
In one of the following development environments, access the Google Cloud CLI (`gcloud`):
- Cloud Shell
: To use an online terminal with the gcloud CLI
already set up, activate Cloud Shell.
Activate Cloud Shell - Local Shell
: To use a local development environment, install
and initialize
the gcloud CLI.
To create a Cloud project, use the `gcloud projects create`command:gcloud projects create PROJECT_ID
For further information on Cloud projects, refer to Creating and managing projects in the Google Cloud documentation.
Optional: Enable billing for your Cloud project
Depending on the Google Workspace APIs and features that you want to use, you might also need to enable billing for your Cloud project:
Google Cloud console
- In the Google Cloud console, go to Billing . Click Menu > Billing > My Projects .
- In Select an organization , choose the organization associated with your Google Cloud project.
- In the project row, open the Actions menu ( ), click Change billing , and choose the Cloud Billing account.
- Click Set account .
gcloud CLI
- To list available billing accounts, run:
gcloud billing accounts list
- Link a billing account with a Google Cloud project:
gcloud billing projects link PROJECT_ID --billing-account= BILLING_ACCOUNT_ID
Replace the following:
-
PROJECT_ID
is the Project ID for the Cloud project for which you want to enable billing. -
BILLING_ACCOUNT_ID
is the billing account ID to link with the Google Cloud project.
-
For further information about billing, see Enable, disable, or change billing for a project in the Google Cloud Billing documentation.
Next step
Enable Google Workspace APIs in your Cloud project.