Skip to content

Commit

Permalink
feat(content): update the api
Browse files Browse the repository at this point in the history
#### content:v2.1

The following keys were added:
- resources.quotas.methods.list (Total Keys: 16)
- schemas.ListMethodQuotasResponse (Total Keys: 5)
- schemas.MethodQuota (Total Keys: 7)
  • Loading branch information
yoshi-automation committed Nov 1, 2022
1 parent 32386b1 commit 94dde78
Show file tree
Hide file tree
Showing 5 changed files with 225 additions and 7 deletions.
5 changes: 5 additions & 0 deletions docs/dyn/content_v2_1.html
Expand Up @@ -189,6 +189,11 @@ <h2>Instance Methods</h2>
</p>
<p class="firstline">Returns the pubsubnotificationsettings Resource.</p>

<p class="toc_element">
<code><a href="content_v2_1.quotas.html">quotas()</a></code>
</p>
<p class="firstline">Returns the quotas Resource.</p>

<p class="toc_element">
<code><a href="content_v2_1.regionalinventory.html">regionalinventory()</a></code>
</p>
Expand Down
4 changes: 2 additions & 2 deletions docs/dyn/content_v2_1.promotions.html
Expand Up @@ -79,7 +79,7 @@ <h2>Instance Methods</h2>
<p class="firstline">Close httplib2 connections.</p>
<p class="toc_element">
<code><a href="#create">create(merchantId, body=None, x__xgafv=None)</a></code></p>
<p class="firstline">Inserts a promotion for your Merchant Center account. If the promotion already exists, then it updates the promotion instead.</p>
<p class="firstline">Inserts a promotion for your Merchant Center account. If the promotion already exists, then it updates the promotion instead. To [end or delete] (https://developers.google.com/shopping-content/guides/promotions#end_a_promotion) a promotion update the time period of the promotion to a time that has already passed.</p>
<p class="toc_element">
<code><a href="#get">get(merchantId, id, x__xgafv=None)</a></code></p>
<p class="firstline">Retrieves a promotion from your Merchant Center account.</p>
Expand All @@ -91,7 +91,7 @@ <h3>Method Details</h3>

<div class="method">
<code class="details" id="create">create(merchantId, body=None, x__xgafv=None)</code>
<pre>Inserts a promotion for your Merchant Center account. If the promotion already exists, then it updates the promotion instead.
<pre>Inserts a promotion for your Merchant Center account. If the promotion already exists, then it updates the promotion instead. To [end or delete] (https://developers.google.com/shopping-content/guides/promotions#end_a_promotion) a promotion update the time period of the promotion to a time that has already passed.

Args:
merchantId: string, Required. The ID of the account that contains the collection. (required)
Expand Down
134 changes: 134 additions & 0 deletions docs/dyn/content_v2_1.quotas.html
@@ -0,0 +1,134 @@
<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="content_v2_1.html">Content API for Shopping</a> . <a href="content_v2_1.quotas.html">quotas</a></h1>
<h2>Instance Methods</h2>
<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="#list">list(merchantId, pageSize=None, pageToken=None, x__xgafv=None)</a></code></p>
<p class="firstline">Lists the quota limit and quota usage per method for your Merchant Center account.</p>
<p class="toc_element">
<code><a href="#list_next">list_next()</a></code></p>
<p class="firstline">Retrieves the next page of results.</p>
<h3>Method Details</h3>
<div class="method">
<code class="details" id="close">close()</code>
<pre>Close httplib2 connections.</pre>
</div>

<div class="method">
<code class="details" id="list">list(merchantId, pageSize=None, pageToken=None, x__xgafv=None)</code>
<pre>Lists the quota limit and quota usage per method for your Merchant Center account.

Args:
merchantId: string, Required. The ID of the account that has quota. This account must be an admin. (required)
pageSize: integer, The maximum number of quotas to return in the response, used for paging. Defaults to 500; values above 1000 will be coerced to 1000.
pageToken: string, Token (if provided) to retrieve the subsequent page. All other parameters must match the original call that provided the page token.
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 the ListMethodQuotas method.
&quot;methodQuotas&quot;: [ # The current quota usage and limits per each method.
{ # The quota information per method in the Content API.
&quot;method&quot;: &quot;A String&quot;, # The method name, for example “products.list”. Method name does not contain version because quota can be shared between different API versions of the same method.
&quot;quotaLimit&quot;: &quot;A String&quot;, # The current quota limit, for example the maximum number of calls for the method.
&quot;quotaUsage&quot;: &quot;A String&quot;, # The current quota usage, for example the number of calls for the method.
},
],
&quot;nextPageToken&quot;: &quot;A String&quot;, # A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.
}</pre>
</div>

<div class="method">
<code class="details" id="list_next">list_next()</code>
<pre>Retrieves the next page of results.

Args:
previous_request: The request for the previous page. (required)
previous_response: The response from the request for the previous page. (required)

Returns:
A request object that you can call &#x27;execute()&#x27; on to request the next
page. Returns None if there are no more items in the collection.
</pre>
</div>

</body></html>
2 changes: 1 addition & 1 deletion docs/dyn/content_v2_1.reports.html
Expand Up @@ -141,7 +141,7 @@ <h3>Method Details</h3>
&quot;unshippedItems&quot;: 3.14, # Number of ordered items not shipped up until the end of the queried day. If a multi-day period is specified in the search query, the returned value is the average number of unshipped items over the days in the queried period. **This metric cannot be segmented by customer_country_code.**
&quot;unshippedOrders&quot;: 3.14, # Number of orders not shipped or partially shipped up until the end of the queried day. If a multi-day period is specified in the search query, the returned value is the average number of unshipped orders over the days in the queried period. **This metric cannot be segmented by product dimensions and customer_country_code.**
},
&quot;productView&quot;: { # Product fields. Values are only set for fields requested explicitly in the request&#x27;s search query. # Product fields requested by the merchant in the query. Field values are only set if the merchant queries `ProductView`. `product_view` field is available only to allowlisted users who can query the `ProductView` table.
&quot;productView&quot;: { # Product fields. Values are only set for fields requested explicitly in the request&#x27;s search query. Available only to selected merchants. Submit the [interest form](https://forms.gle/7Uy8htzAN8oNokz9A) to request access. # Product fields requested by the merchant in the query. Field values are only set if the merchant queries `ProductView`. Available only to selected merchants. Submit the [interest form](https://forms.gle/7Uy8htzAN8oNokz9A) to request access.
&quot;aggregatedDestinationStatus&quot;: &quot;A String&quot;, # Aggregated destination status.
&quot;availability&quot;: &quot;A String&quot;, # Availability of the product.
&quot;brand&quot;: &quot;A String&quot;, # Brand of the product.
Expand Down
87 changes: 83 additions & 4 deletions googleapiclient/discovery_cache/documents/content.v2.1.json
Expand Up @@ -4455,7 +4455,7 @@
"promotions": {
"methods": {
"create": {
"description": "Inserts a promotion for your Merchant Center account. If the promotion already exists, then it updates the promotion instead.",
"description": "Inserts a promotion for your Merchant Center account. If the promotion already exists, then it updates the promotion instead. To [end or delete] (https://developers.google.com/shopping-content/guides/promotions#end_a_promotion) a promotion update the time period of the promotion to a time that has already passed.",
"flatPath": "{merchantId}/promotions",
"httpMethod": "POST",
"id": "content.promotions.create",
Expand Down Expand Up @@ -4573,6 +4573,46 @@
}
}
},
"quotas": {
"methods": {
"list": {
"description": "Lists the quota limit and quota usage per method for your Merchant Center account.",
"flatPath": "{merchantId}/quotas",
"httpMethod": "GET",
"id": "content.quotas.list",
"parameterOrder": [
"merchantId"
],
"parameters": {
"merchantId": {
"description": "Required. The ID of the account that has quota. This account must be an admin.",
"format": "int64",
"location": "path",
"required": true,
"type": "string"
},
"pageSize": {
"description": "The maximum number of quotas to return in the response, used for paging. Defaults to 500; values above 1000 will be coerced to 1000.",
"format": "int32",
"location": "query",
"type": "integer"
},
"pageToken": {
"description": "Token (if provided) to retrieve the subsequent page. All other parameters must match the original call that provided the page token.",
"location": "query",
"type": "string"
}
},
"path": "{merchantId}/quotas",
"response": {
"$ref": "ListMethodQuotasResponse"
},
"scopes": [
"https://www.googleapis.com/auth/content"
]
}
}
},
"regionalinventory": {
"methods": {
"custombatch": {
Expand Down Expand Up @@ -5908,7 +5948,7 @@
}
}
},
"revision": "20221013",
"revision": "20221024",
"rootUrl": "https://shoppingcontent.googleapis.com/",
"schemas": {
"Account": {
Expand Down Expand Up @@ -9126,6 +9166,24 @@
},
"type": "object"
},
"ListMethodQuotasResponse": {
"description": "Response message for the ListMethodQuotas method.",
"id": "ListMethodQuotasResponse",
"properties": {
"methodQuotas": {
"description": "The current quota usage and limits per each method.",
"items": {
"$ref": "MethodQuota"
},
"type": "array"
},
"nextPageToken": {
"description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.",
"type": "string"
}
},
"type": "object"
},
"ListRegionsResponse": {
"description": "Response message for the `ListRegions` method.",
"id": "ListRegionsResponse",
Expand Down Expand Up @@ -9487,6 +9545,27 @@
},
"type": "object"
},
"MethodQuota": {
"description": "The quota information per method in the Content API.",
"id": "MethodQuota",
"properties": {
"method": {
"description": "The method name, for example \u201cproducts.list\u201d. Method name does not contain version because quota can be shared between different API versions of the same method.",
"type": "string"
},
"quotaLimit": {
"description": "The current quota limit, for example the maximum number of calls for the method.",
"format": "int64",
"type": "string"
},
"quotaUsage": {
"description": "The current quota usage, for example the number of calls for the method.",
"format": "int64",
"type": "string"
}
},
"type": "object"
},
"Metrics": {
"description": "Performance metrics. Values are only set for metrics requested explicitly in the request's search query.",
"id": "Metrics",
Expand Down Expand Up @@ -13298,7 +13377,7 @@
"type": "object"
},
"ProductView": {
"description": "Product fields. Values are only set for fields requested explicitly in the request's search query.",
"description": "Product fields. Values are only set for fields requested explicitly in the request's search query. Available only to selected merchants. Submit the [interest form](https://forms.gle/7Uy8htzAN8oNokz9A) to request access.",
"id": "ProductView",
"properties": {
"aggregatedDestinationStatus": {
Expand Down Expand Up @@ -14281,7 +14360,7 @@
},
"productView": {
"$ref": "ProductView",
"description": "Product fields requested by the merchant in the query. Field values are only set if the merchant queries `ProductView`. `product_view` field is available only to allowlisted users who can query the `ProductView` table."
"description": "Product fields requested by the merchant in the query. Field values are only set if the merchant queries `ProductView`. Available only to selected merchants. Submit the [interest form](https://forms.gle/7Uy8htzAN8oNokz9A) to request access."
},
"segments": {
"$ref": "Segments",
Expand Down

0 comments on commit 94dde78

Please sign in to comment.