A Google Cloud project is required to use Google Workspace APIs and buildGoogle Workspace add-ons or apps. A Cloud project forms thebasis for creating, enabling, and using all Google Cloud services, includingmanaging APIs, enabling billing, adding and removing collaborators, and managingpermissions.
Create a Cloud project
Google Cloud console
- In the Google Cloud console, go to Menu 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: Replace PROJECT_ID by setting the ID for the project you want to create.gcloud projects create PROJECT_ID
For further information on Cloud projects, refer toCreating and managing projectsin the Google Cloud documentation.
Optional: Enable billing for your Cloud project
Depending on the Google Workspace APIs and features that you want touse, you might also need to enable billing for your Cloud project:
Google Cloud console
- In the Google Cloud console, go to Billing. Click Menu 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 (more_vert), 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, seeEnable, disable, or change billing for a projectin the Google Cloud Billing documentation.
Next step
Enable Google Workspace APIsin your Cloud project.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-09-06 UTC.
[{ "type": "thumb-down", "id": "missingTheInformationINeed", "label":"Missing the information I need" },{ "type": "thumb-down", "id": "tooComplicatedTooManySteps", "label":"Too complicated / too many steps" },{ "type": "thumb-down", "id": "outOfDate", "label":"Out of date" },{ "type": "thumb-down", "id": "samplesCodeIssue", "label":"Samples / code issue" },{ "type": "thumb-down", "id": "otherDown", "label":"Other" }] [{ "type": "thumb-up", "id": "easyToUnderstand", "label":"Easy to understand" },{ "type": "thumb-up", "id": "solvedMyProblem", "label":"Solved my problem" },{ "type": "thumb-up", "id": "otherUp", "label":"Other" }]