TheChrome Web Store Publish API lets you create, update, and publishitems in the Chrome Web Store. This guide will tell you how to:

• Get a refresh token and access token to use in the tool of your choice.
• Make test HTTP requests using theOAuth 2.0 Playground.

Prerequisites

Before using the API, note the following:

• Developers are required to enable2-step verification for their Google Account to publish orupdate an existing extension.
• Before you can publish a new item, you have to fill out theStore listing andPrivacy tabs in theDeveloper Dashboard.

Initial setup

Before you can begin making REST calls against the Chrome Web Store, you will need to enable theChrome Web Store API in a Google Cloud project, configure an OAuth consent screen, and retrieve your API access keys. Thefollowing sections walk through this process.

Enable the Chrome Web Store API

1. Go to theGoogle Cloud Console.
2. Create a new project or select an existing one.

   

3. In thesearch bar type "Chrome Web Store API".
4. Enable theChrome Web Store API.

Configure the OAuth consent screen

1. Go toOAuth consent screen.
2. SelectExternal thenCreate.

   

3. Fill out the requiredApp information fields (listed below) then clickSave and Continue.
   • App name.
   • User support email.
   • Developer contact information.
4. ClickSave and Continue to skip the Scopes screen.
5. Add your email address toTest users, then clickSave and Continue.This lets you immediately use the project without needing to go through anapproval process.

Create an OAuth Client

1. Go toCredentials.
2. ClickCreate Credentials thenOAuth client ID.

   

3. ForApplication type, chooseWeb application.
4. Enter a name.
5. Addhttps://developers.google.com/oauthplayground to the list of Authorized redirect URIs.
6. Click "Create".

You will be given a client ID and a client secret. Keep these safe.

Obtain access and refresh tokens

1. Openhttps://developers.google.com/oauthplayground.

   

2. Click the settings icon in the top right, and choose "Use your own OAuth credentials".

3. Enter your client ID and client secret.

4. Addhttps://www.googleapis.com/auth/chromewebstore to the "Input your own scopes" field.

5. Click "Authorize APIs".

6. Follow the steps to sign in with your Google Account.

7. Click "Exchange authorization code for tokens" to generate a new access token.

Try a request

To try a request, click copying the following to the Request URI field:

https://www.googleapis.com/chromewebstore/v1.1/items/EXTENSION_ID?projection=DRAFT

Then, click "Send the request".

curl"https://oauth2.googleapis.com/token"-d"client_secret=$CLIENT_SECRET&grant_type=refresh_token&refresh_token=$REFRESH_TOKEN&client_id=$CLIENT_ID"

{"access_token":"ya29...","expires_in":3600,"refresh_token":"1/rwn...","scope":"https://www.googleapis.com/auth/chromewebstore","token_type":"Bearer",}

You can useItems:Insert to create a new item.

curl-H"Authorization: Bearer$TOKEN"-H"x-goog-api-version: 2"-XPOST-T$FILE_NAME-vhttps://www.googleapis.com/upload/chromewebstore/v1.1/items

Upload a package to update an existing store item

You can useItems:Update to upload a new package foran existing version. If you have not increased theversion field inyour extension's manifest file, this will fail.

curl-H"Authorization: Bearer$TOKEN"-H"x-goog-api-version: 2"-XPUT-T$FILE_NAME-vhttps://www.googleapis.com/upload/chromewebstore/v1.1/items/EXTENSION_ID

Publish an item to the public

You can useItems:Publish to publish an item toall users. The item will be submitted for review and published when the itempasses.

curl-H"Authorization: Bearer$TOKEN"-H"x-goog-api-version: 2"-H"Content-Length: 0"-XPOST-vhttps://www.googleapis.com/chromewebstore/v1.1/items/EXTENSION_ID/publish

Publish an item to trusted testers

You can also useItems:Publish to publish an itemto a target group, such as trusted testers. The item will be submitted forreview and published when the item passes.

curl-H"Authorization: Bearer$TOKEN"-H"x-goog-api-version: 2"-H"Content-Length: 0"-XPOST-vhttps://www.googleapis.com/chromewebstore/v1.1/items/EXTENSION_ID/publish?publishTarget=trustedTesters

Check the upload status of an item

You can useItem:Get to check the upload status of an item if the most recent upload attempt returnedIN_PROGRESS.

curl-H"Authorization: Bearer$TOKEN"-H"x-goog-api-version: 2"-H"Content-Length: 0"-H"Expect:"-XGET-vhttps://www.googleapis.com/chromewebstore/v1.1/items/EXTENSION_ID?projection=DRAFT