Skip to content

Commit b123349

Browse files
feat(content): update the api
#### content:v2.1 The following keys were added: - resources.accounts.methods.requestphoneverification (Total Keys: 16) - resources.freelistingsprogram.methods.get (Total Keys: 11) - resources.freelistingsprogram.methods.requestreview (Total Keys: 11) - resources.shoppingadsprogram.methods.get (Total Keys: 11) - resources.shoppingadsprogram.methods.requestreview (Total Keys: 11) - schemas.FreeListingsProgramStatus (Total Keys: 16) - schemas.RequestPhoneVerificationRequest (Total Keys: 5) - schemas.RequestPhoneVerificationResponse (Total Keys: 3) - schemas.RequestReviewFreeListingsRequest (Total Keys: 3) - schemas.RequestReviewShoppingAdsRequest (Total Keys: 3) - schemas.ShoppingAdsProgramStatus (Total Keys: 15)
1 parent ec1425b commit b123349

7 files changed

+884
-24
lines changed

docs/dyn/content_v2_1.accounts.html

+65
Original file line numberDiff line numberDiff line change
@@ -125,12 +125,18 @@ <h2>Instance Methods</h2>
125125
<p class="toc_element">
126126
<code><a href="#listlinks_next">listlinks_next(previous_request, previous_response)</a></code></p>
127127
<p class="firstline">Retrieves the next page of results.</p>
128+
<p class="toc_element">
129+
<code><a href="#requestphoneverification">requestphoneverification(merchantId, accountId, body=None, x__xgafv=None)</a></code></p>
130+
<p class="firstline">Request verification code to start phone verification.</p>
128131
<p class="toc_element">
129132
<code><a href="#update">update(merchantId, accountId, body=None, x__xgafv=None)</a></code></p>
130133
<p class="firstline">Updates a Merchant Center account. Any fields that are not provided are deleted from the resource.</p>
131134
<p class="toc_element">
132135
<code><a href="#updatelabels">updatelabels(merchantId, accountId, body=None, x__xgafv=None)</a></code></p>
133136
<p class="firstline">Updates labels that are assigned to the Merchant Center account by CSS user.</p>
137+
<p class="toc_element">
138+
<code><a href="#verifyphonenumber">verifyphonenumber(merchantId, accountId, body=None, x__xgafv=None)</a></code></p>
139+
<p class="firstline">Validates verification code to verify phone number for the account.</p>
134140
<h3>Method Details</h3>
135141
<div class="method">
136142
<code class="details" id="authinfo">authinfo(x__xgafv=None)</code>
@@ -771,6 +777,36 @@ <h3>Method Details</h3>
771777
</pre>
772778
</div>
773779

780+
<div class="method">
781+
<code class="details" id="requestphoneverification">requestphoneverification(merchantId, accountId, body=None, x__xgafv=None)</code>
782+
<pre>Request verification code to start phone verification.
783+
784+
Args:
785+
merchantId: string, Required. The ID of the managing account. If this parameter is not the same as accountId, then this account must be a multi-client account and accountId must be the ID of a sub-account of this account. (required)
786+
accountId: string, Required. The ID of the account. (required)
787+
body: object, The request body.
788+
The object takes the form of:
789+
790+
{ # Request message for the RequestPhoneVerification method.
791+
&quot;languageCode&quot;: &quot;A String&quot;, # Language code [IETF BCP 47 syntax](https://tools.ietf.org/html/bcp47) (for example, en-US). Language code is used to provide localized `SMS` and `PHONE_CALL`. Default language used is en-US if not provided.
792+
&quot;phoneNumber&quot;: &quot;A String&quot;, # Phone number to be verified.
793+
&quot;phoneRegionCode&quot;: &quot;A String&quot;, # Required. Two letter country code for the phone number, for example `CA` for Canadian numbers. See the [ISO 3166-1 alpha-2](https://wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements) officially assigned codes.
794+
&quot;phoneVerificationMethod&quot;: &quot;A String&quot;, # Verification method to receive verification code.
795+
}
796+
797+
x__xgafv: string, V1 error format.
798+
Allowed values
799+
1 - v1 error format
800+
2 - v2 error format
801+
802+
Returns:
803+
An object of the form:
804+
805+
{ # Response message for the RequestPhoneVerification method.
806+
&quot;verificationId&quot;: &quot;A String&quot;, # The verification ID to use in subsequent calls to `verifyphonenumber`.
807+
}</pre>
808+
</div>
809+
774810
<div class="method">
775811
<code class="details" id="update">update(merchantId, accountId, body=None, x__xgafv=None)</code>
776812
<pre>Updates a Merchant Center account. Any fields that are not provided are deleted from the resource.
@@ -935,4 +971,33 @@ <h3>Method Details</h3>
935971
}</pre>
936972
</div>
937973

974+
<div class="method">
975+
<code class="details" id="verifyphonenumber">verifyphonenumber(merchantId, accountId, body=None, x__xgafv=None)</code>
976+
<pre>Validates verification code to verify phone number for the account.
977+
978+
Args:
979+
merchantId: string, Required. The ID of the managing account. If this parameter is not the same as accountId, then this account must be a multi-client account and accountId must be the ID of a sub-account of this account. (required)
980+
accountId: string, Required. The ID of the account. (required)
981+
body: object, The request body.
982+
The object takes the form of:
983+
984+
{ # Request message for the VerifyPhoneNumber method.
985+
&quot;phoneVerificationMethod&quot;: &quot;A String&quot;, # Verification method used to receive verification code.
986+
&quot;verificationCode&quot;: &quot;A String&quot;, # The verification code that was sent to the phone number for validation.
987+
&quot;verificationId&quot;: &quot;A String&quot;, # The verification ID returned by `requestphoneverification`.
988+
}
989+
990+
x__xgafv: string, V1 error format.
991+
Allowed values
992+
1 - v1 error format
993+
2 - v2 error format
994+
995+
Returns:
996+
An object of the form:
997+
998+
{ # Response message for the VerifyPhoneNumber method.
999+
&quot;verifiedPhoneNumber&quot;: &quot;A String&quot;, # Verified phone number if verification is successful.
1000+
}</pre>
1001+
</div>
1002+
9381003
</body></html>
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,146 @@
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.freelistingsprogram.html">freelistingsprogram</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="#get">get(merchantId, x__xgafv=None)</a></code></p>
82+
<p class="firstline">Retrieves the status and review eligibility for the free listing program.</p>
83+
<p class="toc_element">
84+
<code><a href="#requestreview">requestreview(merchantId, body=None, x__xgafv=None)</a></code></p>
85+
<p class="firstline">Requests a review for Free Listings program in the provided region. Important: This method is only whitelisted for selected merchants.</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="get">get(merchantId, x__xgafv=None)</code>
94+
<pre>Retrieves the status and review eligibility for the free listing program.
95+
96+
Args:
97+
merchantId: string, Required. The ID of the account. (required)
98+
x__xgafv: string, V1 error format.
99+
Allowed values
100+
1 - v1 error format
101+
2 - v2 error format
102+
103+
Returns:
104+
An object of the form:
105+
106+
{ # Response message for GetFreeListingsProgramStatus.
107+
&quot;regionStatuses&quot;: [ # Status of the program in each region. Regions with the same status and review eligibility are grouped together in `regionCodes`.
108+
{ # Status of program and region.
109+
&quot;disapprovalDate&quot;: &quot;A String&quot;, # Date by which `eligibility_status` will go from `WARNING` to `DISAPPROVED`. It will be present when `eligibility_status` is `WARNING`. Date will be provided in ISO 8601 format i.e. YYYY-MM-DD
110+
&quot;eligibilityStatus&quot;: &quot;A String&quot;, # Eligibility status of the standard free listing program.
111+
&quot;enhancedEligibilityStatus&quot;: &quot;A String&quot;, # Eligibility status of the enhanced free listing program.
112+
&quot;ineligibilityReason&quot;: &quot;A String&quot;, # Reason if a program in a given country is not eligible for review. Populated only if `review_eligibility_status` is `INELIGIBLE`.
113+
&quot;regionCodes&quot;: [ # The two-letter [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) codes for all the regions with the same `eligibilityStatus` and `reviewEligibility`.
114+
&quot;A String&quot;,
115+
],
116+
&quot;reviewEligibilityStatus&quot;: &quot;A String&quot;, # If a program in a given country is eligible for review. It will be present only if eligibility status is `DISAPPROVED`.
117+
&quot;reviewIssues&quot;: [ # These issues will be evaluated in review process. Fix all the issues before requesting the review.
118+
&quot;A String&quot;,
119+
],
120+
},
121+
],
122+
&quot;state&quot;: &quot;A String&quot;, # If program is successfully onboarded for at least one region.
123+
}</pre>
124+
</div>
125+
126+
<div class="method">
127+
<code class="details" id="requestreview">requestreview(merchantId, body=None, x__xgafv=None)</code>
128+
<pre>Requests a review for Free Listings program in the provided region. Important: This method is only whitelisted for selected merchants.
129+
130+
Args:
131+
merchantId: string, Required. The ID of the account. (required)
132+
body: object, The request body.
133+
The object takes the form of:
134+
135+
{ # Request message for the RequestReviewFreeListings Program method.
136+
&quot;regionCode&quot;: &quot;A String&quot;, # The code [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) of the country for which review is to be requested.
137+
}
138+
139+
x__xgafv: string, V1 error format.
140+
Allowed values
141+
1 - v1 error format
142+
2 - v2 error format
143+
</pre>
144+
</div>
145+
146+
</body></html>

docs/dyn/content_v2_1.html

+10
Original file line numberDiff line numberDiff line change
@@ -119,6 +119,11 @@ <h2>Instance Methods</h2>
119119
</p>
120120
<p class="firstline">Returns the datafeedstatuses Resource.</p>
121121

122+
<p class="toc_element">
123+
<code><a href="content_v2_1.freelistingsprogram.html">freelistingsprogram()</a></code>
124+
</p>
125+
<p class="firstline">Returns the freelistingsprogram Resource.</p>
126+
122127
<p class="toc_element">
123128
<code><a href="content_v2_1.liasettings.html">liasettings()</a></code>
124129
</p>
@@ -224,6 +229,11 @@ <h2>Instance Methods</h2>
224229
</p>
225230
<p class="firstline">Returns the shippingsettings Resource.</p>
226231

232+
<p class="toc_element">
233+
<code><a href="content_v2_1.shoppingadsprogram.html">shoppingadsprogram()</a></code>
234+
</p>
235+
<p class="firstline">Returns the shoppingadsprogram Resource.</p>
236+
227237
<p class="toc_element">
228238
<code><a href="#close">close()</a></code></p>
229239
<p class="firstline">Close httplib2 connections.</p>

docs/dyn/content_v2_1.reports.html

+11-11
Original file line numberDiff line numberDiff line change
@@ -101,7 +101,7 @@ <h3>Method Details</h3>
101101
{ # Request message for the ReportService.Search method.
102102
&quot;pageSize&quot;: 42, # Number of ReportRows to retrieve in a single page. Defaults to the maximum of 1000. Values above 1000 are coerced to 1000.
103103
&quot;pageToken&quot;: &quot;A String&quot;, # Token of the page to retrieve. If not specified, the first page of results is returned. In order to request the next page of results, the value obtained from `next_page_token` in the previous response should be used.
104-
&quot;query&quot;: &quot;A String&quot;, # Required. Query that defines performance metrics to retrieve and dimensions according to which the metrics are to be segmented.
104+
&quot;query&quot;: &quot;A String&quot;, # Required. Query that defines performance metrics to retrieve and dimensions according to which the metrics are to be segmented. For details on how to construct your query, see the [Query Language guide](https://developers.google.com/shopping-content/guides/reports/query-language/overview).
105105
}
106106

107107
x__xgafv: string, V1 error format.
@@ -140,11 +140,11 @@ <h3>Method Details</h3>
140140
},
141141
&quot;segments&quot;: { # Dimensions according to which metrics are segmented in the response. Values of product dimensions, e.g., offer id, reflect the state of a product at the time of the corresponding event, e.g., impression or order. Segment fields cannot be selected in queries without also selecting at least one metric field. Values are only set for dimensions requested explicitly in the request&#x27;s search query. # Segmentation dimensions requested by the merchant in the query. Dimension values are only set for dimensions requested explicitly in the query.
142142
&quot;brand&quot;: &quot;A String&quot;, # Brand of the product.
143-
&quot;categoryL1&quot;: &quot;A String&quot;, # Product category (1st level) in Google&#x27;s product taxonomy.
144-
&quot;categoryL2&quot;: &quot;A String&quot;, # Product category (2nd level) in Google&#x27;s product taxonomy.
145-
&quot;categoryL3&quot;: &quot;A String&quot;, # Product category (3rd level) in Google&#x27;s product taxonomy.
146-
&quot;categoryL4&quot;: &quot;A String&quot;, # Product category (4th level) in Google&#x27;s product taxonomy.
147-
&quot;categoryL5&quot;: &quot;A String&quot;, # Product category (5th level) in Google&#x27;s product taxonomy.
143+
&quot;categoryL1&quot;: &quot;A String&quot;, # [Product category (1st level)](https://developers.google.com/shopping-content/guides/reports/segmentation#category_and_product_type) in Google&#x27;s product taxonomy.
144+
&quot;categoryL2&quot;: &quot;A String&quot;, # [Product category (2nd level)](https://developers.google.com/shopping-content/guides/reports/segmentation#category_and_product_type) in Google&#x27;s product taxonomy.
145+
&quot;categoryL3&quot;: &quot;A String&quot;, # [Product category (3rd level)](https://developers.google.com/shopping-content/guides/reports/segmentation#category_and_product_type) in Google&#x27;s product taxonomy.
146+
&quot;categoryL4&quot;: &quot;A String&quot;, # [Product category (4th level)](https://developers.google.com/shopping-content/guides/reports/segmentation#category_and_product_type) in Google&#x27;s product taxonomy.
147+
&quot;categoryL5&quot;: &quot;A String&quot;, # [Product category (5th level)](https://developers.google.com/shopping-content/guides/reports/segmentation#category_and_product_type) in Google&#x27;s product taxonomy.
148148
&quot;currencyCode&quot;: &quot;A String&quot;, # Currency in which price metrics are represented, e.g., if you select `ordered_item_sales_micros`, the returned value will be represented by this currency.
149149
&quot;customLabel0&quot;: &quot;A String&quot;, # Custom label 0 for custom grouping of products.
150150
&quot;customLabel1&quot;: &quot;A String&quot;, # Custom label 1 for custom grouping of products.
@@ -157,11 +157,11 @@ <h3>Method Details</h3>
157157
&quot;year&quot;: 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
158158
},
159159
&quot;offerId&quot;: &quot;A String&quot;, # Merchant-provided id of the product.
160-
&quot;productTypeL1&quot;: &quot;A String&quot;, # Product category (1st level) in merchant&#x27;s own product taxonomy.
161-
&quot;productTypeL2&quot;: &quot;A String&quot;, # Product category (2nd level) in merchant&#x27;s own product taxonomy.
162-
&quot;productTypeL3&quot;: &quot;A String&quot;, # Product category (3rd level) in merchant&#x27;s own product taxonomy.
163-
&quot;productTypeL4&quot;: &quot;A String&quot;, # Product category (4th level) in merchant&#x27;s own product taxonomy.
164-
&quot;productTypeL5&quot;: &quot;A String&quot;, # Product category (5th level) in merchant&#x27;s own product taxonomy.
160+
&quot;productTypeL1&quot;: &quot;A String&quot;, # [Product type (1st level)](https://developers.google.com/shopping-content/guides/reports/segmentation#category_and_product_type) in merchant&#x27;s own product taxonomy.
161+
&quot;productTypeL2&quot;: &quot;A String&quot;, # [Product type (2nd level)](https://developers.google.com/shopping-content/guides/reports/segmentation#category_and_product_type) in merchant&#x27;s own product taxonomy.
162+
&quot;productTypeL3&quot;: &quot;A String&quot;, # [Product type (3rd level)](https://developers.google.com/shopping-content/guides/reports/segmentation#category_and_product_type) in merchant&#x27;s own product taxonomy.
163+
&quot;productTypeL4&quot;: &quot;A String&quot;, # [Product type (4th level)](https://developers.google.com/shopping-content/guides/reports/segmentation#category_and_product_type) in merchant&#x27;s own product taxonomy.
164+
&quot;productTypeL5&quot;: &quot;A String&quot;, # [Product type (5th level)](https://developers.google.com/shopping-content/guides/reports/segmentation#category_and_product_type) in merchant&#x27;s own product taxonomy.
165165
&quot;program&quot;: &quot;A String&quot;, # Program to which metrics apply, e.g., Free Product Listing.
166166
&quot;title&quot;: &quot;A String&quot;, # Title of the product.
167167
&quot;week&quot;: { # Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values * A month and day value, with a zero year, such as an anniversary * A year on its own, with zero month and day values * A year and month value, with a zero day, such as a credit card expiration date Related types are google.type.TimeOfDay and `google.protobuf.Timestamp`. # First day of the week (Monday) of the metrics date in the merchant timezone.

0 commit comments

Comments
 (0)