Inserts a new item.

This method supports an upload URI and accepts uploaded media.


HTTP request



Parameter nameValueDescription
Required query parameters
uploadTypestringThe type of upload request to the /upload URI. The only accepted value is media: a simple upload of the media data.
Optional query parameters
publisherEmailstringThe email of the publisher who owns the items. Defaults to the caller's email address.


This request requires authorization with the following scope.

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

Request body

Do not supply a request body with this method.


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

Improve article

We serve cookies on this site to analyze traffic, remember your preferences, and optimize your experience.