Skip to content
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.

Commit 94dde78

Browse files
yoshi-automationyoshi-automation
committedNov 1, 2022
feat(content): update the api
#### 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)
1 parent 32386b1 commit 94dde78

File tree

5 files changed

+225
-7
lines changed

5 files changed

+225
-7
lines changed
 

‎docs/dyn/content_v2_1.html

+5
Original file line numberDiff line numberDiff line change
@@ -189,6 +189,11 @@ <h2>Instance Methods</h2>
189189
</p>
190190
<p class="firstline">Returns the pubsubnotificationsettings Resource.</p>
191191

192+
<p class="toc_element">
193+
<code><a href="content_v2_1.quotas.html">quotas()</a></code>
194+
</p>
195+
<p class="firstline">Returns the quotas Resource.</p>
196+
192197
<p class="toc_element">
193198
<code><a href="content_v2_1.regionalinventory.html">regionalinventory()</a></code>
194199
</p>

‎docs/dyn/content_v2_1.promotions.html

+2-2
Original file line numberDiff line numberDiff line change
@@ -79,7 +79,7 @@ <h2>Instance Methods</h2>
7979
<p class="firstline">Close httplib2 connections.</p>
8080
<p class="toc_element">
8181
<code><a href="#create">create(merchantId, body=None, x__xgafv=None)</a></code></p>
82-
<p class="firstline">Inserts a promotion for your Merchant Center account. If the promotion already exists, then it updates the promotion instead.</p>
82+
<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>
8383
<p class="toc_element">
8484
<code><a href="#get">get(merchantId, id, x__xgafv=None)</a></code></p>
8585
<p class="firstline">Retrieves a promotion from your Merchant Center account.</p>
@@ -91,7 +91,7 @@ <h3>Method Details</h3>
9191

9292
<div class="method">
9393
<code class="details" id="create">create(merchantId, body=None, x__xgafv=None)</code>
94-
<pre>Inserts a promotion for your Merchant Center account. If the promotion already exists, then it updates the promotion instead.
94+
<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.
9595

9696
Args:
9797
merchantId: string, Required. The ID of the account that contains the collection. (required)

‎docs/dyn/content_v2_1.quotas.html

+134
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,134 @@
1+
<html><body>
2+
<style>
3+
4+
body, h1, h2, h3, div, span, p, pre, a {
5+
margin: 0;
6+
padding: 0;
7+
border: 0;
8+
font-weight: inherit;
9+
font-style: inherit;
10+
font-size: 100%;
11+
font-family: inherit;
12+
vertical-align: baseline;
13+
}
14+
15+
body {
16+
font-size: 13px;
17+
padding: 1em;
18+
}
19+
20+
h1 {
21+
font-size: 26px;
22+
margin-bottom: 1em;
23+
}
24+
25+
h2 {
26+
font-size: 24px;
27+
margin-bottom: 1em;
28+
}
29+
30+
h3 {
31+
font-size: 20px;
32+
margin-bottom: 1em;
33+
margin-top: 1em;
34+
}
35+
36+
pre, code {
37+
line-height: 1.5;
38+
font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
39+
}
40+
41+
pre {
42+
margin-top: 0.5em;
43+
}
44+
45+
h1, h2, h3, p {
46+
font-family: Arial, sans serif;
47+
}
48+
49+
h1, h2, h3 {
50+
border-bottom: solid #CCC 1px;
51+
}
52+
53+
.toc_element {
54+
margin-top: 0.5em;
55+
}
56+
57+
.firstline {
58+
margin-left: 2 em;
59+
}
60+
61+
.method {
62+
margin-top: 1em;
63+
border: solid 1px #CCC;
64+
padding: 1em;
65+
background: #EEE;
66+
}
67+
68+
.details {
69+
font-weight: bold;
70+
font-size: 14px;
71+
}
72+
73+
</style>
74+
75+
<h1><a href="content_v2_1.html">Content API for Shopping</a> . <a href="content_v2_1.quotas.html">quotas</a></h1>
76+
<h2>Instance Methods</h2>
77+
<p class="toc_element">
78+
<code><a href="#close">close()</a></code></p>
79+
<p class="firstline">Close httplib2 connections.</p>
80+
<p class="toc_element">
81+
<code><a href="#list">list(merchantId, pageSize=None, pageToken=None, x__xgafv=None)</a></code></p>
82+
<p class="firstline">Lists the quota limit and quota usage per method for your Merchant Center account.</p>
83+
<p class="toc_element">
84+
<code><a href="#list_next">list_next()</a></code></p>
85+
<p class="firstline">Retrieves the next page of results.</p>
86+
<h3>Method Details</h3>
87+
<div class="method">
88+
<code class="details" id="close">close()</code>
89+
<pre>Close httplib2 connections.</pre>
90+
</div>
91+
92+
<div class="method">
93+
<code class="details" id="list">list(merchantId, pageSize=None, pageToken=None, x__xgafv=None)</code>
94+
<pre>Lists the quota limit and quota usage per method for your Merchant Center account.
95+
96+
Args:
97+
merchantId: string, Required. The ID of the account that has quota. This account must be an admin. (required)
98+
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.
99+
pageToken: string, Token (if provided) to retrieve the subsequent page. All other parameters must match the original call that provided the page token.
100+
x__xgafv: string, V1 error format.
101+
Allowed values
102+
1 - v1 error format
103+
2 - v2 error format
104+
105+
Returns:
106+
An object of the form:
107+
108+
{ # Response message for the ListMethodQuotas method.
109+
&quot;methodQuotas&quot;: [ # The current quota usage and limits per each method.
110+
{ # The quota information per method in the Content API.
111+
&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.
112+
&quot;quotaLimit&quot;: &quot;A String&quot;, # The current quota limit, for example the maximum number of calls for the method.
113+
&quot;quotaUsage&quot;: &quot;A String&quot;, # The current quota usage, for example the number of calls for the method.
114+
},
115+
],
116+
&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.
117+
}</pre>
118+
</div>
119+
120+
<div class="method">
121+
<code class="details" id="list_next">list_next()</code>
122+
<pre>Retrieves the next page of results.
123+
124+
Args:
125+
previous_request: The request for the previous page. (required)
126+
previous_response: The response from the request for the previous page. (required)
127+
128+
Returns:
129+
A request object that you can call &#x27;execute()&#x27; on to request the next
130+
page. Returns None if there are no more items in the collection.
131+
</pre>
132+
</div>
133+
134+
</body></html>

‎docs/dyn/content_v2_1.reports.html

+1-1
Original file line numberDiff line numberDiff line change
@@ -141,7 +141,7 @@ <h3>Method Details</h3>
141141
&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.**
142142
&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.**
143143
},
144-
&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.
144+
&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.
145145
&quot;aggregatedDestinationStatus&quot;: &quot;A String&quot;, # Aggregated destination status.
146146
&quot;availability&quot;: &quot;A String&quot;, # Availability of the product.
147147
&quot;brand&quot;: &quot;A String&quot;, # Brand of the product.

‎googleapiclient/discovery_cache/documents/content.v2.1.json

+83-4
Original file line numberDiff line numberDiff line change
@@ -4455,7 +4455,7 @@
44554455
"promotions": {
44564456
"methods": {
44574457
"create": {
4458-
"description": "Inserts a promotion for your Merchant Center account. If the promotion already exists, then it updates the promotion instead.",
4458+
"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.",
44594459
"flatPath": "{merchantId}/promotions",
44604460
"httpMethod": "POST",
44614461
"id": "content.promotions.create",
@@ -4573,6 +4573,46 @@
45734573
}
45744574
}
45754575
},
4576+
"quotas": {
4577+
"methods": {
4578+
"list": {
4579+
"description": "Lists the quota limit and quota usage per method for your Merchant Center account.",
4580+
"flatPath": "{merchantId}/quotas",
4581+
"httpMethod": "GET",
4582+
"id": "content.quotas.list",
4583+
"parameterOrder": [
4584+
"merchantId"
4585+
],
4586+
"parameters": {
4587+
"merchantId": {
4588+
"description": "Required. The ID of the account that has quota. This account must be an admin.",
4589+
"format": "int64",
4590+
"location": "path",
4591+
"required": true,
4592+
"type": "string"
4593+
},
4594+
"pageSize": {
4595+
"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.",
4596+
"format": "int32",
4597+
"location": "query",
4598+
"type": "integer"
4599+
},
4600+
"pageToken": {
4601+
"description": "Token (if provided) to retrieve the subsequent page. All other parameters must match the original call that provided the page token.",
4602+
"location": "query",
4603+
"type": "string"
4604+
}
4605+
},
4606+
"path": "{merchantId}/quotas",
4607+
"response": {
4608+
"$ref": "ListMethodQuotasResponse"
4609+
},
4610+
"scopes": [
4611+
"https://www.googleapis.com/auth/content"
4612+
]
4613+
}
4614+
}
4615+
},
45764616
"regionalinventory": {
45774617
"methods": {
45784618
"custombatch": {
@@ -5908,7 +5948,7 @@
59085948
}
59095949
}
59105950
},
5911-
"revision": "20221013",
5951+
"revision": "20221024",
59125952
"rootUrl": "https://shoppingcontent.googleapis.com/",
59135953
"schemas": {
59145954
"Account": {
@@ -9126,6 +9166,24 @@
91269166
},
91279167
"type": "object"
91289168
},
9169+
"ListMethodQuotasResponse": {
9170+
"description": "Response message for the ListMethodQuotas method.",
9171+
"id": "ListMethodQuotasResponse",
9172+
"properties": {
9173+
"methodQuotas": {
9174+
"description": "The current quota usage and limits per each method.",
9175+
"items": {
9176+
"$ref": "MethodQuota"
9177+
},
9178+
"type": "array"
9179+
},
9180+
"nextPageToken": {
9181+
"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.",
9182+
"type": "string"
9183+
}
9184+
},
9185+
"type": "object"
9186+
},
91299187
"ListRegionsResponse": {
91309188
"description": "Response message for the `ListRegions` method.",
91319189
"id": "ListRegionsResponse",
@@ -9487,6 +9545,27 @@
94879545
},
94889546
"type": "object"
94899547
},
9548+
"MethodQuota": {
9549+
"description": "The quota information per method in the Content API.",
9550+
"id": "MethodQuota",
9551+
"properties": {
9552+
"method": {
9553+
"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.",
9554+
"type": "string"
9555+
},
9556+
"quotaLimit": {
9557+
"description": "The current quota limit, for example the maximum number of calls for the method.",
9558+
"format": "int64",
9559+
"type": "string"
9560+
},
9561+
"quotaUsage": {
9562+
"description": "The current quota usage, for example the number of calls for the method.",
9563+
"format": "int64",
9564+
"type": "string"
9565+
}
9566+
},
9567+
"type": "object"
9568+
},
94909569
"Metrics": {
94919570
"description": "Performance metrics. Values are only set for metrics requested explicitly in the request's search query.",
94929571
"id": "Metrics",
@@ -13298,7 +13377,7 @@
1329813377
"type": "object"
1329913378
},
1330013379
"ProductView": {
13301-
"description": "Product fields. Values are only set for fields requested explicitly in the request's search query.",
13380+
"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.",
1330213381
"id": "ProductView",
1330313382
"properties": {
1330413383
"aggregatedDestinationStatus": {
@@ -14281,7 +14360,7 @@
1428114360
},
1428214361
"productView": {
1428314362
"$ref": "ProductView",
14284-
"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."
14363+
"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."
1428514364
},
1428614365
"segments": {
1428714366
"$ref": "Segments",

0 commit comments

Comments
 (0)
Please sign in to comment.