Getting started with API Keys API

This page describes how to set up your local environment to experiment with API Keys using the curl command.

Before you begin

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

Install the Google Cloud CLI.

If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity .

To initialize the gcloud CLI, run the following command:

gcloud  
init

Create or select a Google Cloud project .

Roles required to select or create a project

Select a project : Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
Create a project : To create a project, you need the Project Creator role ( roles/resourcemanager.projectCreator ), which contains the resourcemanager.projects.create permission. Learn how to grant roles .

Create a Google Cloud project:
```
gcloud projects create PROJECT_ID 
```
Replace PROJECT_ID with a name for the Google Cloud project you are creating.
Select the Google Cloud project that you created:
```
gcloud config set project PROJECT_ID 
```
Replace PROJECT_ID with your Google Cloud project name.

Verify that billing is enabled for your Google Cloud project .

Enable the API Keys API:

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role ( roles/serviceusage.serviceUsageAdmin ), which contains the serviceusage.services.enable permission. Learn how to grant roles .

gcloud  
services  
 enable 
  
apikeys.googleapis.com

Grant roles to your user account. Run the following command once for each of the following IAM roles: roles/serviceusage.apiKeysAdmin

gcloud  
projects  
add-iam-policy-binding  
 PROJECT_ID 
  
--member = 
 "user: USER_IDENTIFIER 
" 
  
--role = 
 ROLE

Replace the following:

PROJECT_ID : Your project ID.
USER_IDENTIFIER : The identifier for your user account. For example, myemail@example.com .
ROLE : The IAM role that you grant to your user account.

Install the Google Cloud CLI.

If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity .

To initialize the gcloud CLI, run the following command:

gcloud  
init

Create or select a Google Cloud project .

Roles required to select or create a project

Select a project : Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
Create a project : To create a project, you need the Project Creator role ( roles/resourcemanager.projectCreator ), which contains the resourcemanager.projects.create permission. Learn how to grant roles .

Create a Google Cloud project:
```
gcloud projects create PROJECT_ID 
```
Replace PROJECT_ID with a name for the Google Cloud project you are creating.
Select the Google Cloud project that you created:
```
gcloud config set project PROJECT_ID 
```
Replace PROJECT_ID with your Google Cloud project name.

Verify that billing is enabled for your Google Cloud project .

Enable the API Keys API:

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role ( roles/serviceusage.serviceUsageAdmin ), which contains the serviceusage.services.enable permission. Learn how to grant roles .

gcloud  
services  
 enable 
  
apikeys.googleapis.com

Grant roles to your user account. Run the following command once for each of the following IAM roles: roles/serviceusage.apiKeysAdmin

gcloud  
projects  
add-iam-policy-binding  
 PROJECT_ID 
  
--member = 
 "user: USER_IDENTIFIER 
" 
  
--role = 
 ROLE

Replace the following:

PROJECT_ID : Your project ID.
USER_IDENTIFIER : The identifier for your user account. For example, myemail@example.com .
ROLE : The IAM role that you grant to your user account.

Testing the API Keys API

Get the project number for the project in which you enabled API Keys.

Define a convenient shell alias for calling the API:

 alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

Make a request to get a list of API keys in your project:

gcurl https://apikeys.googleapis.com/v2/projects/ YOUR_PROJECT_NUMBER 
/locations/global/keys

On success, you get a response similar to the following:

 { 
  
 "keys" 
 : 
  
 [ 
  
 { 
  
 "name" 
 : 
  
 "projects/12345678/locations/global/keys/2885bf87-5b84-47fa-92af-08c3e9337349" 
 , 
  
 "displayName" 
 : 
  
 "API key 2" 
 , 
  
 "createTime" 
 : 
  
 "2019-05-29T22:07:22.036Z" 
 , 
  
 "uid" 
 : 
  
 "2885bf87-5b84-47fa-92af-08c3e9337349" 
 , 
  
 "updateTime" 
 : 
  
 "2019-05-29T22:07:22.058623Z" 
 , 
  
 "restrictions" 
 : 
  
 { 
  
 "androidKeyRestrictions" 
 : 
  
 {} 
  
 }, 
  
 "etag" 
 : 
  
 "zHib8eXEMCxe4ayQEbIaZg==" 
  
 }, 
  
 { 
  
 "name" 
 : 
  
 "projects/12345678/locations/global/keys/a4db08b7-5729-4ba9-8c08-f2df493465a1" 
 , 
  
 "displayName" 
 : 
  
 "API key 1" 
 , 
  
 "createTime" 
 : 
  
 "2019-05-29T22:06:58.844Z" 
 , 
  
 "uid" 
 : 
  
 "a4db08b7-5729-4ba9-8c08-f2df493465a1" 
 , 
  
 "updateTime" 
 : 
  
 "2019-05-29T22:06:58.855103Z" 
 , 
  
 "restrictions" 
 : 
  
 { 
  
 "androidKeyRestrictions" 
 : 
  
 {} 
  
 }, 
  
 "etag" 
 : 
  
 "0L5KcPMGoNi53K5+FqPxiw==" 
  
 } 
  
 ] 
 }

Getting started with API Keys API Stay organized with collections Save and categorize content based on your preferences.

Before you begin

Testing the API Keys API

What's next

Getting started with API Keys API