This reference describes the methods and resource representation available for the Chrome Web StorePublish API. Each resource type has one or more data representations and oneor more methods.

SeeUsing the Chrome Web Store Publish API for aguide on how to authenticate with and make requests to the API.

Authorization

All endpoints are authenticated usingOAuth 2.0.

Valid scopes:

• https://www.googleapis.com/auth/chromewebstore
• https://www.googleapis.com/auth/chromewebstore.readonly

API endpoints

For Item Resource details, see theresource representation.

All URIs are relative to https://www.googleapis.com.

Get

Gets a Chrome Web Store item. Provideprojection="DRAFT" (case sensitive) as a URL Parameter.

HTTP request

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

Parameters

Authorization

This request requires authorization with the following scope.

https://www.googleapis.com/auth/chromewebstore.readonly

The above URL is used as the scope parameter when generating an access token. For more details on API authorization and authentication, consult theOAuth 2.0 documentation.

Request body

Don't supply a request body with this method.

Response

If successful, this method returns anItems resource in the response body.

Insert

Inserts a newitem.

This method supports an upload URI and accepts uploaded media.

HTTP request

POSThttps://www.googleapis.com/upload/chromewebstore/v1.1/items

Parameters

Authorization

This request requires authorization with the following scope.

https://www.googleapis.com/auth/chromewebstore

The above URL is used as the scope parameter when generating an access token. For more details on API authorization and authentication, consult theOAuth 2.0 documentation.

Request body

Don't supply a request body with this method.

Response

If successful, this method returns anItems resource in the response body.

Publish

Publishes anitem. The item will first be sent for review. If theitem is already under review, calling publish will fail.

You can optionally provide apublishTarget in the URL (case sensitive), forexample:

• ?publishTarget="trustedTesters" to publish to trusted testers.
• ?publishTarget="default"

HTTP request

POSThttps://www.googleapis.com/chromewebstore/v1.1/items/EXTENSION_ID/publish

Parameters

Request body

In the request body, you can optionally supply data with the following structure:

JSON

{"target":string,"deployPercentage":string,"reviewExemption":boolean}

Authorization

This request requires authorization with the following scope.

https://www.googleapis.com/auth/chromewebstore

The above URL is used as the scope parameter when generating an access token. For more details on API authorization and authentication, consult theOAuth 2.0 documentation.

Response

If successful, this method returns a response body with the following structure:

{"kind":"chromewebstore#item","item_id":string,"status":[string],"statusDetail":[string]}

Update

Updates an existingitem. The draft revision of the item will beupdated but it won't be sent for review until you callpublish.

This method supports an upload URI and accepts uploaded media.

HTTP request

This method provides media upload functionality through two separate URIs.

• Upload URI, for media upload requests:

  PUThttps://www.googleapis.com/upload/chromewebstore/v1.1/items/EXTENSION_ID

• Metadata URI, for metadata-only requests:

  PUThttps://www.googleapis.com/chromewebstore/v1.1/items/EXTENSION_ID

Parameters

Request body

In the request body, supply anItems resource as the metadata.

Authorization

This request requires authorization with the following scope.

https://www.googleapis.com/auth/chromewebstore

The above URL is used as the scope parameter when generating an access token. For more details on API authorization and authentication, consult theOAuth 2.0 documentation.

Response

If successful, this method returns anItems resource in the response body.

Item Resource

{"kind":"chromewebstore#item","id":string,"publicKey":string,"uploadState":string,"itemError":[(value)]}