blob: 2f9cb34e145f550e74b1b4475019ccd82ebda6c2 [file] [edit]
<html><body>
<style>
body, h1, h2, h3, div, span, p, pre, a {
margin: 0;
padding: 0;
border: 0;
font-weight: inherit;
font-style: inherit;
font-size: 100%;
font-family: inherit;
vertical-align: baseline;
}
body {
font-size: 13px;
padding: 1em;
}
h1 {
font-size: 26px;
margin-bottom: 1em;
}
h2 {
font-size: 24px;
margin-bottom: 1em;
}
h3 {
font-size: 20px;
margin-bottom: 1em;
margin-top: 1em;
}
pre, code {
line-height: 1.5;
font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
}
pre {
margin-top: 0.5em;
}
h1, h2, h3, p {
font-family: Arial, sans serif;
}
h1, h2, h3 {
border-bottom: solid #CCC 1px;
}
.toc_element {
margin-top: 0.5em;
}
.firstline {
margin-left: 2 em;
}
.method {
margin-top: 1em;
border: solid 1px #CCC;
padding: 1em;
background: #EEE;
}
.details {
font-weight: bold;
font-size: 14px;
}
</style>
<h1><a href="chromewebstore_v2.html">Chrome Web Store API</a> . <a href="chromewebstore_v2.publishers.html">publishers</a> . <a href="chromewebstore_v2.publishers.items.html">items</a></h1>
<h2>Instance Methods</h2>
<p class="toc_element">
<code><a href="#cancelSubmission">cancelSubmission(name, body=None, x__xgafv=None)</a></code></p>
<p class="firstline">Cancel the current active submission of an item if present. This can be used to cancel the review of a pending submission.</p>
<p class="toc_element">
<code><a href="#close">close()</a></code></p>
<p class="firstline">Close httplib2 connections.</p>
<p class="toc_element">
<code><a href="#fetchStatus">fetchStatus(name, x__xgafv=None)</a></code></p>
<p class="firstline">Fetch the status of an item.</p>
<p class="toc_element">
<code><a href="#publish">publish(name, body=None, x__xgafv=None)</a></code></p>
<p class="firstline">Submit the item to be published in the store. The item will be submitted for review unless `skip_review` is set to true, or the item is staged from a previous submission with `publish_type` set to `STAGED_PUBLISH`.</p>
<p class="toc_element">
<code><a href="#setPublishedDeployPercentage">setPublishedDeployPercentage(name, body=None, x__xgafv=None)</a></code></p>
<p class="firstline">Set a higher target deploy percentage for the item's published revision. This will be updated without the item being submitted for review. This is only available to items with over 10,000 seven-day active users.</p>
<h3>Method Details</h3>
<div class="method">
<code class="details" id="cancelSubmission">cancelSubmission(name, body=None, x__xgafv=None)</code>
<pre>Cancel the current active submission of an item if present. This can be used to cancel the review of a pending submission.
Args:
name: string, Required. Name of the item to cancel the submission of in the form `publishers/{publisherId}/items/{itemId}` (required)
body: object, The request body.
The object takes the form of:
{ # Request message for CancelSubmission.
}
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # Response message for `CancelSubmission`.
}</pre>
</div>
<div class="method">
<code class="details" id="close">close()</code>
<pre>Close httplib2 connections.</pre>
</div>
<div class="method">
<code class="details" id="fetchStatus">fetchStatus(name, x__xgafv=None)</code>
<pre>Fetch the status of an item.
Args:
name: string, Required. Name of the item to retrieve the status of in the form `publishers/{publisherId}/items/{itemId}` (required)
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # Response message for `FetchItemStatus`.
&quot;itemId&quot;: &quot;A String&quot;, # Output only. The ID of the item.
&quot;lastAsyncUploadState&quot;: &quot;A String&quot;, # Output only. The state of the last async upload for an item. Only set when there has been an async upload for the item in the past 24 hours.
&quot;name&quot;: &quot;A String&quot;, # The name of the requested item.
&quot;publicKey&quot;: &quot;A String&quot;, # The public key of the item, which may be generated by the store.
&quot;publishedItemRevisionStatus&quot;: { # Details on the status of an item revision. # Output only. Status of the current published revision of the item. Will be unset if the item is not published.
&quot;distributionChannels&quot;: [ # Details on the package of the item
{ # Deployment information for a specific release channel
&quot;crxVersion&quot;: &quot;A String&quot;, # The extension version provided in the manifest of the uploaded package.
&quot;deployPercentage&quot;: 42, # The current deploy percentage for the release channel (nonnegative number between 0 and 100).
},
],
&quot;state&quot;: &quot;A String&quot;, # Output only. Current state of the item
},
&quot;submittedItemRevisionStatus&quot;: { # Details on the status of an item revision. # Status of the item revision submitted to be published. Will be unset if the item has not been submitted for publishing since the last successful publish.
&quot;distributionChannels&quot;: [ # Details on the package of the item
{ # Deployment information for a specific release channel
&quot;crxVersion&quot;: &quot;A String&quot;, # The extension version provided in the manifest of the uploaded package.
&quot;deployPercentage&quot;: 42, # The current deploy percentage for the release channel (nonnegative number between 0 and 100).
},
],
&quot;state&quot;: &quot;A String&quot;, # Output only. Current state of the item
},
&quot;takenDown&quot;: True or False, # If true, the item has been taken down for a policy violation. Check the developer dashboard for details.
&quot;warned&quot;: True or False, # If true, the item has been warned for a policy violation and will be taken down if not resolved. Check the developer dashboard for details.
}</pre>
</div>
<div class="method">
<code class="details" id="publish">publish(name, body=None, x__xgafv=None)</code>
<pre>Submit the item to be published in the store. The item will be submitted for review unless `skip_review` is set to true, or the item is staged from a previous submission with `publish_type` set to `STAGED_PUBLISH`.
Args:
name: string, Required. Name of the item in the form `publishers/{publisherId}/items/{itemId}` (required)
body: object, The request body.
The object takes the form of:
{ # Request message for PublishItem.
&quot;blockOnWarnings&quot;: True or False, # Optional. When set to true the request will fail if there are any warnings during validation and the details will be included in the `error.details`. Otherwise warnings are treated as non-blocking and will be ignored for validation but will be included in the response for inspection. Defaults to `false` if unset.
&quot;deployInfos&quot;: [ # Optional. Additional deploy information including the desired initial percentage rollout. Defaults to the current value saved in the developer dashboard if unset.
{ # Deployment information for a specific release channel. Used in requests to update deployment parameters.
&quot;deployPercentage&quot;: 42, # Required. The current deploy percentage for the release channel (nonnegative number between 0 and 100).
},
],
&quot;publishType&quot;: &quot;A String&quot;, # Optional. Use this to control if the item is published immediately on approval or staged for publishing in the future. Defaults to `DEFAULT_PUBLISH` if unset.
&quot;skipReview&quot;: True or False, # Optional. Whether to attempt to skip item review. The API will validate if the item qualifies and return a validation error if the item requires review. Defaults to `false` if unset.
}
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # Response message for `PublishItem`.
&quot;itemId&quot;: &quot;A String&quot;, # Output only. The ID of the item.
&quot;name&quot;: &quot;A String&quot;, # The name of the item that was submitted
&quot;state&quot;: &quot;A String&quot;, # Output only. The current state of the submission.
&quot;warningInfo&quot;: { # Message containing details on warnings encountered during PublishItem. # Output only. Non-blocking warnings encountered during the request.
&quot;warnings&quot;: [ # All warnings encountered during the request.
{ # Represents a single warning encountered during the request.
&quot;description&quot;: &quot;A String&quot;, # A description of the warning. Developers should use this message to understand the warning and take appropriate action to resolve the issue.
&quot;reason&quot;: &quot;A String&quot;, # The reason for the warning. This is a constant value that identifies the proximate cause of the warning.
},
],
},
}</pre>
</div>
<div class="method">
<code class="details" id="setPublishedDeployPercentage">setPublishedDeployPercentage(name, body=None, x__xgafv=None)</code>
<pre>Set a higher target deploy percentage for the item&#x27;s published revision. This will be updated without the item being submitted for review. This is only available to items with over 10,000 seven-day active users.
Args:
name: string, Required. Name of the item to update the published revision of in the form `publishers/{publisherId}/items/{itemId}` (required)
body: object, The request body.
The object takes the form of:
{ # Request message for SetPublishedDeployPercentage.
&quot;deployPercentage&quot;: 42, # Required. Unscaled percentage value for the publised revision (nonnegative number between 0 and 100). It must be larger than the existing target percentage.
}
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # Response message for `SetPublishedDeployPercentage`.
}</pre>
</div>
</body></html>