blob: 3f14ecb8d1b0dba6a69efb9728bc9ab640390894 [file] [log] [blame]
Craig Citro065b5302014-08-14 00:47:23 -07001<html><body>
2<style>
3
4body, 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
15body {
16 font-size: 13px;
17 padding: 1em;
18}
19
20h1 {
21 font-size: 26px;
22 margin-bottom: 1em;
23}
24
25h2 {
26 font-size: 24px;
27 margin-bottom: 1em;
28}
29
30h3 {
31 font-size: 20px;
32 margin-bottom: 1em;
33 margin-top: 1em;
34}
35
36pre, code {
37 line-height: 1.5;
38 font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
39}
40
41pre {
42 margin-top: 0.5em;
43}
44
45h1, h2, h3, p {
46 font-family: Arial, sans serif;
47}
48
49h1, 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.html">Content API for Shopping</a> . <a href="content_v2.accounts.html">accounts</a></h1>
76<h2>Instance Methods</h2>
77<p class="toc_element">
Bu Sun Kim673ec5c2020-11-16 11:05:03 -070078 <code><a href="#authinfo">authinfo(x__xgafv=None)</a></code></p>
Nathaniel Manista5cbe5ba2015-03-10 23:29:22 +000079<p class="firstline">Returns information about the authenticated user.</p>
80<p class="toc_element">
Bu Sun Kim673ec5c2020-11-16 11:05:03 -070081 <code><a href="#claimwebsite">claimwebsite(merchantId, accountId, overwrite=None, x__xgafv=None)</a></code></p>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -070082<p class="firstline">Claims the website of a Merchant Center sub-account.</p>
Sai Cheemalapati4ba8c232017-06-06 18:46:08 -040083<p class="toc_element">
Dmitry Frenkel3e17f892020-10-06 16:46:05 -070084 <code><a href="#close">close()</a></code></p>
85<p class="firstline">Close httplib2 connections.</p>
86<p class="toc_element">
Bu Sun Kim673ec5c2020-11-16 11:05:03 -070087 <code><a href="#custombatch">custombatch(body=None, dryRun=None, x__xgafv=None)</a></code></p>
Craig Citro065b5302014-08-14 00:47:23 -070088<p class="firstline">Retrieves, inserts, updates, and deletes multiple Merchant Center (sub-)accounts in a single request.</p>
89<p class="toc_element">
Yoshi Automation Botc2228be2020-11-24 15:48:03 -080090 <code><a href="#delete">delete(merchantId, accountId, dryRun=None, force=None, x__xgafv=None)</a></code></p>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -070091<p class="firstline">Deletes a Merchant Center sub-account.</p>
Craig Citro065b5302014-08-14 00:47:23 -070092<p class="toc_element">
Bu Sun Kim673ec5c2020-11-16 11:05:03 -070093 <code><a href="#get">get(merchantId, accountId, x__xgafv=None)</a></code></p>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -070094<p class="firstline">Retrieves a Merchant Center account.</p>
Craig Citro065b5302014-08-14 00:47:23 -070095<p class="toc_element">
Bu Sun Kim673ec5c2020-11-16 11:05:03 -070096 <code><a href="#insert">insert(merchantId, body=None, dryRun=None, x__xgafv=None)</a></code></p>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -070097<p class="firstline">Creates a Merchant Center sub-account.</p>
98<p class="toc_element">
Bu Sun Kim673ec5c2020-11-16 11:05:03 -070099 <code><a href="#link">link(merchantId, accountId, body=None, x__xgafv=None)</a></code></p>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700100<p class="firstline">Performs an action on a link between two Merchant Center accounts, namely accountId and linkedAccountId.</p>
Craig Citro065b5302014-08-14 00:47:23 -0700101<p class="toc_element">
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700102 <code><a href="#list">list(merchantId, pageToken=None, maxResults=None, x__xgafv=None)</a></code></p>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700103<p class="firstline">Lists the sub-accounts in your Merchant Center account.</p>
Craig Citro065b5302014-08-14 00:47:23 -0700104<p class="toc_element">
105 <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
106<p class="firstline">Retrieves the next page of results.</p>
107<p class="toc_element">
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700108 <code><a href="#update">update(merchantId, accountId, body=None, dryRun=None, x__xgafv=None)</a></code></p>
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700109<p class="firstline">Updates a Merchant Center account. Any fields that are not provided are deleted from the resource.</p>
Craig Citro065b5302014-08-14 00:47:23 -0700110<h3>Method Details</h3>
111<div class="method">
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700112 <code class="details" id="authinfo">authinfo(x__xgafv=None)</code>
Nathaniel Manista5cbe5ba2015-03-10 23:29:22 +0000113 <pre>Returns information about the authenticated user.
114
115Args:
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700116 x__xgafv: string, V1 error format.
117 Allowed values
118 1 - v1 error format
119 2 - v2 error format
Nathaniel Manista5cbe5ba2015-03-10 23:29:22 +0000120
121Returns:
122 An object of the form:
123
124 {
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700125 &quot;accountIdentifiers&quot;: [ # The account identifiers corresponding to the authenticated user. - For an individual account: only the merchant ID is defined - For an aggregator: only the aggregator ID is defined - For a subaccount of an MCA: both the merchant ID and the aggregator ID are defined.
Nathaniel Manista4f877e52015-06-15 16:44:50 +0000126 {
Bu Sun Kim65020912020-05-20 12:08:20 -0700127 &quot;merchantId&quot;: &quot;A String&quot;, # The merchant account ID, set for individual accounts and subaccounts.
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800128 &quot;aggregatorId&quot;: &quot;A String&quot;, # The aggregator ID, set for aggregators and subaccounts (in that case, it represents the aggregator of the subaccount).
Nathaniel Manista5cbe5ba2015-03-10 23:29:22 +0000129 },
130 ],
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800131 &quot;kind&quot;: &quot;A String&quot;, # Identifies what kind of resource this is. Value: the fixed string &quot;content#accountsAuthInfoResponse&quot;.
Nathaniel Manista5cbe5ba2015-03-10 23:29:22 +0000132 }</pre>
133</div>
134
135<div class="method">
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700136 <code class="details" id="claimwebsite">claimwebsite(merchantId, accountId, overwrite=None, x__xgafv=None)</code>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700137 <pre>Claims the website of a Merchant Center sub-account.
Sai Cheemalapati4ba8c232017-06-06 18:46:08 -0400138
139Args:
Dan O'Mearadd494642020-05-01 07:42:23 -0700140 merchantId: string, 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)
Sai Cheemalapati4ba8c232017-06-06 18:46:08 -0400141 accountId: string, The ID of the account whose website is claimed. (required)
Dan O'Mearadd494642020-05-01 07:42:23 -0700142 overwrite: boolean, Only available to selected merchants. When set to `True`, this flag removes any existing claim on the requested website by another account and replaces it with a claim from this account.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700143 x__xgafv: string, V1 error format.
144 Allowed values
145 1 - v1 error format
146 2 - v2 error format
Sai Cheemalapati4ba8c232017-06-06 18:46:08 -0400147
148Returns:
149 An object of the form:
150
151 {
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700152 &quot;kind&quot;: &quot;A String&quot;, # Identifies what kind of resource this is. Value: the fixed string &quot;content#accountsClaimWebsiteResponse&quot;.
Sai Cheemalapati4ba8c232017-06-06 18:46:08 -0400153 }</pre>
154</div>
155
156<div class="method">
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700157 <code class="details" id="close">close()</code>
158 <pre>Close httplib2 connections.</pre>
159</div>
160
161<div class="method">
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700162 <code class="details" id="custombatch">custombatch(body=None, dryRun=None, x__xgafv=None)</code>
Craig Citro065b5302014-08-14 00:47:23 -0700163 <pre>Retrieves, inserts, updates, and deletes multiple Merchant Center (sub-)accounts in a single request.
164
165Args:
Dan O'Mearadd494642020-05-01 07:42:23 -0700166 body: object, The request body.
Craig Citro065b5302014-08-14 00:47:23 -0700167 The object takes the form of:
168
169{
Bu Sun Kim65020912020-05-20 12:08:20 -0700170 &quot;entries&quot;: [ # The request entries to be processed in the batch.
Craig Citroe633be12015-03-02 13:40:36 -0800171 { # A batch entry encoding a single non-batch accounts request.
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800172 &quot;batchId&quot;: 42, # An entry ID, unique within the batch request.
173 &quot;accountId&quot;: &quot;A String&quot;, # The ID of the targeted account. Only defined if the method is not `insert`.
174 &quot;overwrite&quot;: True or False, # Only applicable if the method is `claimwebsite`. Indicates whether or not to take the claim from another account in case there is a conflict.
175 &quot;method&quot;: &quot;A String&quot;, # The method of the batch entry. Acceptable values are: - &quot;`claimWebsite`&quot; - &quot;`delete`&quot; - &quot;`get`&quot; - &quot;`insert`&quot; - &quot;`link`&quot; - &quot;`update`&quot;
176 &quot;linkRequest&quot;: { # Details about the `link` request.
177 &quot;linkedAccountId&quot;: &quot;A String&quot;, # The ID of the linked account.
178 &quot;action&quot;: &quot;A String&quot;, # Action to perform for this link. The `&quot;request&quot;` action is only available to select merchants. Acceptable values are: - &quot;`approve`&quot; - &quot;`remove`&quot; - &quot;`request`&quot;
179 &quot;linkType&quot;: &quot;A String&quot;, # Type of the link between the two accounts. Acceptable values are: - &quot;`channelPartner`&quot; - &quot;`eCommercePlatform`&quot;
180 },
Dmitry Frenkel3e17f892020-10-06 16:46:05 -0700181 &quot;labelIds&quot;: [ # Label IDs for the &#x27;updatelabels&#x27; request.
182 &quot;A String&quot;,
183 ],
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700184 &quot;account&quot;: { # Account data. After the creation of a new account it may take a few minutes before it is fully operational. The methods delete, insert, and update require the admin role. # The account to create or update. Only defined if the method is `insert` or `update`.
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800185 &quot;name&quot;: &quot;A String&quot;, # Required. Display name for the account.
186 &quot;kind&quot;: &quot;A String&quot;, # Identifies what kind of resource this is. Value: the fixed string &quot;`content#account`&quot;
187 &quot;websiteUrl&quot;: &quot;A String&quot;, # The merchant&#x27;s website.
188 &quot;businessInformation&quot;: { # The business information of the account.
189 &quot;customerService&quot;: { # The customer service information of the business.
190 &quot;phoneNumber&quot;: &quot;A String&quot;, # Customer service phone number.
191 &quot;url&quot;: &quot;A String&quot;, # Customer service URL.
192 &quot;email&quot;: &quot;A String&quot;, # Customer service email.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700193 },
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800194 &quot;address&quot;: { # The address of the business.
195 &quot;postalCode&quot;: &quot;A String&quot;, # Postal code or ZIP (e.g. &quot;94043&quot;).
196 &quot;streetAddress&quot;: &quot;A String&quot;, # Street-level part of the address.
197 &quot;region&quot;: &quot;A String&quot;, # Top-level administrative subdivision of the country. For example, a state like California (&quot;CA&quot;) or a province like Quebec (&quot;QC&quot;).
198 &quot;locality&quot;: &quot;A String&quot;, # City, town or commune. May also include dependent localities or sublocalities (e.g. neighborhoods or suburbs).
199 &quot;country&quot;: &quot;A String&quot;, # CLDR country code (e.g. &quot;US&quot;). This value cannot be set for a sub-account of an MCA. All MCA sub-accounts inherit the country of their parent MCA.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700200 },
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800201 &quot;phoneNumber&quot;: &quot;A String&quot;, # The phone number of the business.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700202 },
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800203 &quot;id&quot;: &quot;A String&quot;, # Required for update. Merchant Center account ID.
204 &quot;googleMyBusinessLink&quot;: { # The GMB account which is linked or in the process of being linked with the Merchant Center account.
205 &quot;status&quot;: &quot;A String&quot;, # Status of the link between this Merchant Center account and the GMB account. Acceptable values are: - &quot;`active`&quot; - &quot;`pending`&quot;
206 &quot;gmbEmail&quot;: &quot;A String&quot;, # The GMB email address of which a specific account within a GMB account. A sample account within a GMB account could be a business account with set of locations, managed under the GMB account.
207 },
208 &quot;youtubeChannelLinks&quot;: [ # List of linked YouTube channels that are active or pending approval. To create a new link request, add a new link with status `active` to the list. It will remain in a `pending` state until approved or rejected in the YT Creator Studio interface. To delete an active link, or to cancel a link request, remove it from the list.
209 {
210 &quot;channelId&quot;: &quot;A String&quot;, # Channel ID.
211 &quot;status&quot;: &quot;A String&quot;, # Status of the link between this Merchant Center account and the YouTube channel. Upon retrieval, it represents the actual status of the link and can be either `active` if it was approved in YT Creator Studio or `pending` if it&#x27;s pending approval. Upon insertion, it represents the *intended* status of the link. Re-uploading a link with status `active` when it&#x27;s still pending or with status `pending` when it&#x27;s already active will have no effect: the status will remain unchanged. Re-uploading a link with deprecated status `inactive` is equivalent to not submitting the link at all and will delete the link if it was active or cancel the link request if it was pending.
212 },
213 ],
214 &quot;reviewsUrl&quot;: &quot;A String&quot;, # [DEPRECATED] This field is never returned and will be ignored if provided.
215 &quot;users&quot;: [ # Users with access to the account. Every account (except for subaccounts) must have at least one admin user.
216 {
217 &quot;paymentsManager&quot;: True or False, # Whether user can manage payment settings.
218 &quot;paymentsAnalyst&quot;: True or False, # Whether user can access payment statements.
219 &quot;admin&quot;: True or False, # Whether user is an admin.
220 &quot;orderManager&quot;: True or False, # Whether user is an order manager.
221 &quot;emailAddress&quot;: &quot;A String&quot;, # User&#x27;s email address.
222 },
223 ],
224 &quot;adwordsLinks&quot;: [ # List of linked AdWords accounts that are active or pending approval. To create a new link request, add a new link with status `active` to the list. It will remain in a `pending` state until approved or rejected either in the AdWords interface or through the AdWords API. To delete an active link, or to cancel a link request, remove it from the list.
225 {
226 &quot;status&quot;: &quot;A String&quot;, # Status of the link between this Merchant Center account and the AdWords account. Upon retrieval, it represents the actual status of the link and can be either `active` if it was approved in Google AdWords or `pending` if it&#x27;s pending approval. Upon insertion, it represents the *intended* status of the link. Re-uploading a link with status `active` when it&#x27;s still pending or with status `pending` when it&#x27;s already active will have no effect: the status will remain unchanged. Re-uploading a link with deprecated status `inactive` is equivalent to not submitting the link at all and will delete the link if it was active or cancel the link request if it was pending. Acceptable values are: - &quot;`active`&quot; - &quot;`pending`&quot;
227 &quot;adwordsId&quot;: &quot;A String&quot;, # Customer ID of the AdWords account.
228 },
229 ],
230 &quot;adultContent&quot;: True or False, # Indicates whether the merchant sells adult content.
231 &quot;sellerId&quot;: &quot;A String&quot;, # Client-specific, locally-unique, internal ID for the child account.
232 },
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700233 &quot;force&quot;: True or False, # Whether the account should be deleted if the account has offers. Only applicable if the method is `delete`.
234 &quot;merchantId&quot;: &quot;A String&quot;, # The ID of the managing account.
Craig Citro065b5302014-08-14 00:47:23 -0700235 },
236 ],
237 }
238
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700239 dryRun: boolean, Flag to simulate a request like in a live environment. If set to true, dry-run mode checks the validity of the request and returns errors (if any).
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700240 x__xgafv: string, V1 error format.
241 Allowed values
242 1 - v1 error format
243 2 - v2 error format
Craig Citro065b5302014-08-14 00:47:23 -0700244
245Returns:
246 An object of the form:
247
248 {
Bu Sun Kim65020912020-05-20 12:08:20 -0700249 &quot;entries&quot;: [ # The result of the execution of the batch requests.
Craig Citroe633be12015-03-02 13:40:36 -0800250 { # A batch entry encoding a single non-batch accounts response.
Bu Sun Kim65020912020-05-20 12:08:20 -0700251 &quot;batchId&quot;: 42, # The ID of the request entry this entry responds to.
252 &quot;errors&quot;: { # A list of errors returned by a failed batch entry. # A list of errors defined if and only if the request failed.
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800253 &quot;code&quot;: 42, # The HTTP status of the first error in `errors`.
Bu Sun Kim65020912020-05-20 12:08:20 -0700254 &quot;errors&quot;: [ # A list of errors.
255 { # An error returned by the API.
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800256 &quot;reason&quot;: &quot;A String&quot;, # The error code.
Bu Sun Kim65020912020-05-20 12:08:20 -0700257 &quot;domain&quot;: &quot;A String&quot;, # The domain of the error.
258 &quot;message&quot;: &quot;A String&quot;, # A description of the error.
Bu Sun Kim65020912020-05-20 12:08:20 -0700259 },
260 ],
261 &quot;message&quot;: &quot;A String&quot;, # The message of the first error in `errors`.
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800262 },
263 &quot;linkStatus&quot;: &quot;A String&quot;, # Deprecated. This field is never set. Acceptable values are: - &quot;`active`&quot; - &quot;`inactive`&quot; - &quot;`pending`&quot;
264 &quot;kind&quot;: &quot;A String&quot;, # Identifies what kind of resource this is. Value: the fixed string &quot;`content#accountsCustomBatchResponseEntry`&quot;
265 &quot;account&quot;: { # Account data. After the creation of a new account it may take a few minutes before it is fully operational. The methods delete, insert, and update require the admin role. # The retrieved, created, or updated account. Not defined if the method was `delete`, `claimwebsite` or `link`.
266 &quot;name&quot;: &quot;A String&quot;, # Required. Display name for the account.
267 &quot;kind&quot;: &quot;A String&quot;, # Identifies what kind of resource this is. Value: the fixed string &quot;`content#account`&quot;
268 &quot;websiteUrl&quot;: &quot;A String&quot;, # The merchant&#x27;s website.
269 &quot;businessInformation&quot;: { # The business information of the account.
270 &quot;customerService&quot;: { # The customer service information of the business.
271 &quot;phoneNumber&quot;: &quot;A String&quot;, # Customer service phone number.
272 &quot;url&quot;: &quot;A String&quot;, # Customer service URL.
273 &quot;email&quot;: &quot;A String&quot;, # Customer service email.
274 },
275 &quot;address&quot;: { # The address of the business.
276 &quot;postalCode&quot;: &quot;A String&quot;, # Postal code or ZIP (e.g. &quot;94043&quot;).
277 &quot;streetAddress&quot;: &quot;A String&quot;, # Street-level part of the address.
278 &quot;region&quot;: &quot;A String&quot;, # Top-level administrative subdivision of the country. For example, a state like California (&quot;CA&quot;) or a province like Quebec (&quot;QC&quot;).
279 &quot;locality&quot;: &quot;A String&quot;, # City, town or commune. May also include dependent localities or sublocalities (e.g. neighborhoods or suburbs).
280 &quot;country&quot;: &quot;A String&quot;, # CLDR country code (e.g. &quot;US&quot;). This value cannot be set for a sub-account of an MCA. All MCA sub-accounts inherit the country of their parent MCA.
281 },
282 &quot;phoneNumber&quot;: &quot;A String&quot;, # The phone number of the business.
283 },
284 &quot;id&quot;: &quot;A String&quot;, # Required for update. Merchant Center account ID.
285 &quot;googleMyBusinessLink&quot;: { # The GMB account which is linked or in the process of being linked with the Merchant Center account.
286 &quot;status&quot;: &quot;A String&quot;, # Status of the link between this Merchant Center account and the GMB account. Acceptable values are: - &quot;`active`&quot; - &quot;`pending`&quot;
287 &quot;gmbEmail&quot;: &quot;A String&quot;, # The GMB email address of which a specific account within a GMB account. A sample account within a GMB account could be a business account with set of locations, managed under the GMB account.
288 },
289 &quot;youtubeChannelLinks&quot;: [ # List of linked YouTube channels that are active or pending approval. To create a new link request, add a new link with status `active` to the list. It will remain in a `pending` state until approved or rejected in the YT Creator Studio interface. To delete an active link, or to cancel a link request, remove it from the list.
290 {
291 &quot;channelId&quot;: &quot;A String&quot;, # Channel ID.
292 &quot;status&quot;: &quot;A String&quot;, # Status of the link between this Merchant Center account and the YouTube channel. Upon retrieval, it represents the actual status of the link and can be either `active` if it was approved in YT Creator Studio or `pending` if it&#x27;s pending approval. Upon insertion, it represents the *intended* status of the link. Re-uploading a link with status `active` when it&#x27;s still pending or with status `pending` when it&#x27;s already active will have no effect: the status will remain unchanged. Re-uploading a link with deprecated status `inactive` is equivalent to not submitting the link at all and will delete the link if it was active or cancel the link request if it was pending.
293 },
294 ],
295 &quot;reviewsUrl&quot;: &quot;A String&quot;, # [DEPRECATED] This field is never returned and will be ignored if provided.
296 &quot;users&quot;: [ # Users with access to the account. Every account (except for subaccounts) must have at least one admin user.
297 {
298 &quot;paymentsManager&quot;: True or False, # Whether user can manage payment settings.
299 &quot;paymentsAnalyst&quot;: True or False, # Whether user can access payment statements.
300 &quot;admin&quot;: True or False, # Whether user is an admin.
301 &quot;orderManager&quot;: True or False, # Whether user is an order manager.
302 &quot;emailAddress&quot;: &quot;A String&quot;, # User&#x27;s email address.
303 },
304 ],
305 &quot;adwordsLinks&quot;: [ # List of linked AdWords accounts that are active or pending approval. To create a new link request, add a new link with status `active` to the list. It will remain in a `pending` state until approved or rejected either in the AdWords interface or through the AdWords API. To delete an active link, or to cancel a link request, remove it from the list.
306 {
307 &quot;status&quot;: &quot;A String&quot;, # Status of the link between this Merchant Center account and the AdWords account. Upon retrieval, it represents the actual status of the link and can be either `active` if it was approved in Google AdWords or `pending` if it&#x27;s pending approval. Upon insertion, it represents the *intended* status of the link. Re-uploading a link with status `active` when it&#x27;s still pending or with status `pending` when it&#x27;s already active will have no effect: the status will remain unchanged. Re-uploading a link with deprecated status `inactive` is equivalent to not submitting the link at all and will delete the link if it was active or cancel the link request if it was pending. Acceptable values are: - &quot;`active`&quot; - &quot;`pending`&quot;
308 &quot;adwordsId&quot;: &quot;A String&quot;, # Customer ID of the AdWords account.
309 },
310 ],
311 &quot;adultContent&quot;: True or False, # Indicates whether the merchant sells adult content.
312 &quot;sellerId&quot;: &quot;A String&quot;, # Client-specific, locally-unique, internal ID for the child account.
Bu Sun Kim65020912020-05-20 12:08:20 -0700313 },
Craig Citro065b5302014-08-14 00:47:23 -0700314 },
315 ],
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700316 &quot;kind&quot;: &quot;A String&quot;, # Identifies what kind of resource this is. Value: the fixed string &quot;content#accountsCustomBatchResponse&quot;.
Craig Citro065b5302014-08-14 00:47:23 -0700317 }</pre>
318</div>
319
320<div class="method">
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800321 <code class="details" id="delete">delete(merchantId, accountId, dryRun=None, force=None, x__xgafv=None)</code>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700322 <pre>Deletes a Merchant Center sub-account.
Craig Citro065b5302014-08-14 00:47:23 -0700323
324Args:
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700325 merchantId: string, The ID of the managing account. This must be a multi-client account, and accountId must be the ID of a sub-account of this account. (required)
Craig Citro065b5302014-08-14 00:47:23 -0700326 accountId: string, The ID of the account. (required)
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700327 dryRun: boolean, Flag to simulate a request like in a live environment. If set to true, dry-run mode checks the validity of the request and returns errors (if any).
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800328 force: boolean, Flag to delete sub-accounts with products. The default value is false.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700329 x__xgafv: string, V1 error format.
330 Allowed values
331 1 - v1 error format
332 2 - v2 error format
Craig Citro065b5302014-08-14 00:47:23 -0700333</pre>
334</div>
335
336<div class="method">
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700337 <code class="details" id="get">get(merchantId, accountId, x__xgafv=None)</code>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700338 <pre>Retrieves a Merchant Center account.
Craig Citro065b5302014-08-14 00:47:23 -0700339
340Args:
Dan O'Mearadd494642020-05-01 07:42:23 -0700341 merchantId: string, 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)
Craig Citro065b5302014-08-14 00:47:23 -0700342 accountId: string, The ID of the account. (required)
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700343 x__xgafv: string, V1 error format.
344 Allowed values
345 1 - v1 error format
346 2 - v2 error format
Craig Citro065b5302014-08-14 00:47:23 -0700347
348Returns:
349 An object of the form:
350
Dan O'Mearadd494642020-05-01 07:42:23 -0700351 { # Account data. After the creation of a new account it may take a few minutes before it is fully operational. The methods delete, insert, and update require the admin role.
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800352 &quot;name&quot;: &quot;A String&quot;, # Required. Display name for the account.
353 &quot;kind&quot;: &quot;A String&quot;, # Identifies what kind of resource this is. Value: the fixed string &quot;`content#account`&quot;
354 &quot;websiteUrl&quot;: &quot;A String&quot;, # The merchant&#x27;s website.
355 &quot;businessInformation&quot;: { # The business information of the account.
356 &quot;customerService&quot;: { # The customer service information of the business.
357 &quot;phoneNumber&quot;: &quot;A String&quot;, # Customer service phone number.
358 &quot;url&quot;: &quot;A String&quot;, # Customer service URL.
359 &quot;email&quot;: &quot;A String&quot;, # Customer service email.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700360 },
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800361 &quot;address&quot;: { # The address of the business.
362 &quot;postalCode&quot;: &quot;A String&quot;, # Postal code or ZIP (e.g. &quot;94043&quot;).
363 &quot;streetAddress&quot;: &quot;A String&quot;, # Street-level part of the address.
364 &quot;region&quot;: &quot;A String&quot;, # Top-level administrative subdivision of the country. For example, a state like California (&quot;CA&quot;) or a province like Quebec (&quot;QC&quot;).
365 &quot;locality&quot;: &quot;A String&quot;, # City, town or commune. May also include dependent localities or sublocalities (e.g. neighborhoods or suburbs).
366 &quot;country&quot;: &quot;A String&quot;, # CLDR country code (e.g. &quot;US&quot;). This value cannot be set for a sub-account of an MCA. All MCA sub-accounts inherit the country of their parent MCA.
Bu Sun Kim65020912020-05-20 12:08:20 -0700367 },
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800368 &quot;phoneNumber&quot;: &quot;A String&quot;, # The phone number of the business.
369 },
370 &quot;id&quot;: &quot;A String&quot;, # Required for update. Merchant Center account ID.
371 &quot;googleMyBusinessLink&quot;: { # The GMB account which is linked or in the process of being linked with the Merchant Center account.
372 &quot;status&quot;: &quot;A String&quot;, # Status of the link between this Merchant Center account and the GMB account. Acceptable values are: - &quot;`active`&quot; - &quot;`pending`&quot;
373 &quot;gmbEmail&quot;: &quot;A String&quot;, # The GMB email address of which a specific account within a GMB account. A sample account within a GMB account could be a business account with set of locations, managed under the GMB account.
374 },
375 &quot;youtubeChannelLinks&quot;: [ # List of linked YouTube channels that are active or pending approval. To create a new link request, add a new link with status `active` to the list. It will remain in a `pending` state until approved or rejected in the YT Creator Studio interface. To delete an active link, or to cancel a link request, remove it from the list.
376 {
377 &quot;channelId&quot;: &quot;A String&quot;, # Channel ID.
378 &quot;status&quot;: &quot;A String&quot;, # Status of the link between this Merchant Center account and the YouTube channel. Upon retrieval, it represents the actual status of the link and can be either `active` if it was approved in YT Creator Studio or `pending` if it&#x27;s pending approval. Upon insertion, it represents the *intended* status of the link. Re-uploading a link with status `active` when it&#x27;s still pending or with status `pending` when it&#x27;s already active will have no effect: the status will remain unchanged. Re-uploading a link with deprecated status `inactive` is equivalent to not submitting the link at all and will delete the link if it was active or cancel the link request if it was pending.
379 },
380 ],
381 &quot;reviewsUrl&quot;: &quot;A String&quot;, # [DEPRECATED] This field is never returned and will be ignored if provided.
382 &quot;users&quot;: [ # Users with access to the account. Every account (except for subaccounts) must have at least one admin user.
383 {
384 &quot;paymentsManager&quot;: True or False, # Whether user can manage payment settings.
385 &quot;paymentsAnalyst&quot;: True or False, # Whether user can access payment statements.
386 &quot;admin&quot;: True or False, # Whether user is an admin.
387 &quot;orderManager&quot;: True or False, # Whether user is an order manager.
388 &quot;emailAddress&quot;: &quot;A String&quot;, # User&#x27;s email address.
389 },
390 ],
391 &quot;adwordsLinks&quot;: [ # List of linked AdWords accounts that are active or pending approval. To create a new link request, add a new link with status `active` to the list. It will remain in a `pending` state until approved or rejected either in the AdWords interface or through the AdWords API. To delete an active link, or to cancel a link request, remove it from the list.
392 {
393 &quot;status&quot;: &quot;A String&quot;, # Status of the link between this Merchant Center account and the AdWords account. Upon retrieval, it represents the actual status of the link and can be either `active` if it was approved in Google AdWords or `pending` if it&#x27;s pending approval. Upon insertion, it represents the *intended* status of the link. Re-uploading a link with status `active` when it&#x27;s still pending or with status `pending` when it&#x27;s already active will have no effect: the status will remain unchanged. Re-uploading a link with deprecated status `inactive` is equivalent to not submitting the link at all and will delete the link if it was active or cancel the link request if it was pending. Acceptable values are: - &quot;`active`&quot; - &quot;`pending`&quot;
394 &quot;adwordsId&quot;: &quot;A String&quot;, # Customer ID of the AdWords account.
395 },
396 ],
397 &quot;adultContent&quot;: True or False, # Indicates whether the merchant sells adult content.
398 &quot;sellerId&quot;: &quot;A String&quot;, # Client-specific, locally-unique, internal ID for the child account.
399 }</pre>
Craig Citro065b5302014-08-14 00:47:23 -0700400</div>
401
402<div class="method">
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700403 <code class="details" id="insert">insert(merchantId, body=None, dryRun=None, x__xgafv=None)</code>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700404 <pre>Creates a Merchant Center sub-account.
Craig Citro065b5302014-08-14 00:47:23 -0700405
406Args:
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700407 merchantId: string, The ID of the managing account. This must be a multi-client account. (required)
Dan O'Mearadd494642020-05-01 07:42:23 -0700408 body: object, The request body.
Craig Citro065b5302014-08-14 00:47:23 -0700409 The object takes the form of:
410
Dan O'Mearadd494642020-05-01 07:42:23 -0700411{ # Account data. After the creation of a new account it may take a few minutes before it is fully operational. The methods delete, insert, and update require the admin role.
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800412 &quot;name&quot;: &quot;A String&quot;, # Required. Display name for the account.
413 &quot;kind&quot;: &quot;A String&quot;, # Identifies what kind of resource this is. Value: the fixed string &quot;`content#account`&quot;
414 &quot;websiteUrl&quot;: &quot;A String&quot;, # The merchant&#x27;s website.
415 &quot;businessInformation&quot;: { # The business information of the account.
416 &quot;customerService&quot;: { # The customer service information of the business.
417 &quot;phoneNumber&quot;: &quot;A String&quot;, # Customer service phone number.
418 &quot;url&quot;: &quot;A String&quot;, # Customer service URL.
419 &quot;email&quot;: &quot;A String&quot;, # Customer service email.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700420 },
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800421 &quot;address&quot;: { # The address of the business.
422 &quot;postalCode&quot;: &quot;A String&quot;, # Postal code or ZIP (e.g. &quot;94043&quot;).
423 &quot;streetAddress&quot;: &quot;A String&quot;, # Street-level part of the address.
424 &quot;region&quot;: &quot;A String&quot;, # Top-level administrative subdivision of the country. For example, a state like California (&quot;CA&quot;) or a province like Quebec (&quot;QC&quot;).
425 &quot;locality&quot;: &quot;A String&quot;, # City, town or commune. May also include dependent localities or sublocalities (e.g. neighborhoods or suburbs).
426 &quot;country&quot;: &quot;A String&quot;, # CLDR country code (e.g. &quot;US&quot;). This value cannot be set for a sub-account of an MCA. All MCA sub-accounts inherit the country of their parent MCA.
Bu Sun Kim65020912020-05-20 12:08:20 -0700427 },
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800428 &quot;phoneNumber&quot;: &quot;A String&quot;, # The phone number of the business.
429 },
430 &quot;id&quot;: &quot;A String&quot;, # Required for update. Merchant Center account ID.
431 &quot;googleMyBusinessLink&quot;: { # The GMB account which is linked or in the process of being linked with the Merchant Center account.
432 &quot;status&quot;: &quot;A String&quot;, # Status of the link between this Merchant Center account and the GMB account. Acceptable values are: - &quot;`active`&quot; - &quot;`pending`&quot;
433 &quot;gmbEmail&quot;: &quot;A String&quot;, # The GMB email address of which a specific account within a GMB account. A sample account within a GMB account could be a business account with set of locations, managed under the GMB account.
434 },
435 &quot;youtubeChannelLinks&quot;: [ # List of linked YouTube channels that are active or pending approval. To create a new link request, add a new link with status `active` to the list. It will remain in a `pending` state until approved or rejected in the YT Creator Studio interface. To delete an active link, or to cancel a link request, remove it from the list.
436 {
437 &quot;channelId&quot;: &quot;A String&quot;, # Channel ID.
438 &quot;status&quot;: &quot;A String&quot;, # Status of the link between this Merchant Center account and the YouTube channel. Upon retrieval, it represents the actual status of the link and can be either `active` if it was approved in YT Creator Studio or `pending` if it&#x27;s pending approval. Upon insertion, it represents the *intended* status of the link. Re-uploading a link with status `active` when it&#x27;s still pending or with status `pending` when it&#x27;s already active will have no effect: the status will remain unchanged. Re-uploading a link with deprecated status `inactive` is equivalent to not submitting the link at all and will delete the link if it was active or cancel the link request if it was pending.
439 },
440 ],
441 &quot;reviewsUrl&quot;: &quot;A String&quot;, # [DEPRECATED] This field is never returned and will be ignored if provided.
442 &quot;users&quot;: [ # Users with access to the account. Every account (except for subaccounts) must have at least one admin user.
443 {
444 &quot;paymentsManager&quot;: True or False, # Whether user can manage payment settings.
445 &quot;paymentsAnalyst&quot;: True or False, # Whether user can access payment statements.
446 &quot;admin&quot;: True or False, # Whether user is an admin.
447 &quot;orderManager&quot;: True or False, # Whether user is an order manager.
448 &quot;emailAddress&quot;: &quot;A String&quot;, # User&#x27;s email address.
449 },
450 ],
451 &quot;adwordsLinks&quot;: [ # List of linked AdWords accounts that are active or pending approval. To create a new link request, add a new link with status `active` to the list. It will remain in a `pending` state until approved or rejected either in the AdWords interface or through the AdWords API. To delete an active link, or to cancel a link request, remove it from the list.
452 {
453 &quot;status&quot;: &quot;A String&quot;, # Status of the link between this Merchant Center account and the AdWords account. Upon retrieval, it represents the actual status of the link and can be either `active` if it was approved in Google AdWords or `pending` if it&#x27;s pending approval. Upon insertion, it represents the *intended* status of the link. Re-uploading a link with status `active` when it&#x27;s still pending or with status `pending` when it&#x27;s already active will have no effect: the status will remain unchanged. Re-uploading a link with deprecated status `inactive` is equivalent to not submitting the link at all and will delete the link if it was active or cancel the link request if it was pending. Acceptable values are: - &quot;`active`&quot; - &quot;`pending`&quot;
454 &quot;adwordsId&quot;: &quot;A String&quot;, # Customer ID of the AdWords account.
455 },
456 ],
457 &quot;adultContent&quot;: True or False, # Indicates whether the merchant sells adult content.
458 &quot;sellerId&quot;: &quot;A String&quot;, # Client-specific, locally-unique, internal ID for the child account.
459}
Craig Citro065b5302014-08-14 00:47:23 -0700460
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700461 dryRun: boolean, Flag to simulate a request like in a live environment. If set to true, dry-run mode checks the validity of the request and returns errors (if any).
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700462 x__xgafv: string, V1 error format.
463 Allowed values
464 1 - v1 error format
465 2 - v2 error format
Craig Citro065b5302014-08-14 00:47:23 -0700466
467Returns:
468 An object of the form:
469
Dan O'Mearadd494642020-05-01 07:42:23 -0700470 { # Account data. After the creation of a new account it may take a few minutes before it is fully operational. The methods delete, insert, and update require the admin role.
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800471 &quot;name&quot;: &quot;A String&quot;, # Required. Display name for the account.
472 &quot;kind&quot;: &quot;A String&quot;, # Identifies what kind of resource this is. Value: the fixed string &quot;`content#account`&quot;
473 &quot;websiteUrl&quot;: &quot;A String&quot;, # The merchant&#x27;s website.
474 &quot;businessInformation&quot;: { # The business information of the account.
475 &quot;customerService&quot;: { # The customer service information of the business.
476 &quot;phoneNumber&quot;: &quot;A String&quot;, # Customer service phone number.
477 &quot;url&quot;: &quot;A String&quot;, # Customer service URL.
478 &quot;email&quot;: &quot;A String&quot;, # Customer service email.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700479 },
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800480 &quot;address&quot;: { # The address of the business.
481 &quot;postalCode&quot;: &quot;A String&quot;, # Postal code or ZIP (e.g. &quot;94043&quot;).
482 &quot;streetAddress&quot;: &quot;A String&quot;, # Street-level part of the address.
483 &quot;region&quot;: &quot;A String&quot;, # Top-level administrative subdivision of the country. For example, a state like California (&quot;CA&quot;) or a province like Quebec (&quot;QC&quot;).
484 &quot;locality&quot;: &quot;A String&quot;, # City, town or commune. May also include dependent localities or sublocalities (e.g. neighborhoods or suburbs).
485 &quot;country&quot;: &quot;A String&quot;, # CLDR country code (e.g. &quot;US&quot;). This value cannot be set for a sub-account of an MCA. All MCA sub-accounts inherit the country of their parent MCA.
Bu Sun Kim65020912020-05-20 12:08:20 -0700486 },
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800487 &quot;phoneNumber&quot;: &quot;A String&quot;, # The phone number of the business.
488 },
489 &quot;id&quot;: &quot;A String&quot;, # Required for update. Merchant Center account ID.
490 &quot;googleMyBusinessLink&quot;: { # The GMB account which is linked or in the process of being linked with the Merchant Center account.
491 &quot;status&quot;: &quot;A String&quot;, # Status of the link between this Merchant Center account and the GMB account. Acceptable values are: - &quot;`active`&quot; - &quot;`pending`&quot;
492 &quot;gmbEmail&quot;: &quot;A String&quot;, # The GMB email address of which a specific account within a GMB account. A sample account within a GMB account could be a business account with set of locations, managed under the GMB account.
493 },
494 &quot;youtubeChannelLinks&quot;: [ # List of linked YouTube channels that are active or pending approval. To create a new link request, add a new link with status `active` to the list. It will remain in a `pending` state until approved or rejected in the YT Creator Studio interface. To delete an active link, or to cancel a link request, remove it from the list.
495 {
496 &quot;channelId&quot;: &quot;A String&quot;, # Channel ID.
497 &quot;status&quot;: &quot;A String&quot;, # Status of the link between this Merchant Center account and the YouTube channel. Upon retrieval, it represents the actual status of the link and can be either `active` if it was approved in YT Creator Studio or `pending` if it&#x27;s pending approval. Upon insertion, it represents the *intended* status of the link. Re-uploading a link with status `active` when it&#x27;s still pending or with status `pending` when it&#x27;s already active will have no effect: the status will remain unchanged. Re-uploading a link with deprecated status `inactive` is equivalent to not submitting the link at all and will delete the link if it was active or cancel the link request if it was pending.
498 },
499 ],
500 &quot;reviewsUrl&quot;: &quot;A String&quot;, # [DEPRECATED] This field is never returned and will be ignored if provided.
501 &quot;users&quot;: [ # Users with access to the account. Every account (except for subaccounts) must have at least one admin user.
502 {
503 &quot;paymentsManager&quot;: True or False, # Whether user can manage payment settings.
504 &quot;paymentsAnalyst&quot;: True or False, # Whether user can access payment statements.
505 &quot;admin&quot;: True or False, # Whether user is an admin.
506 &quot;orderManager&quot;: True or False, # Whether user is an order manager.
507 &quot;emailAddress&quot;: &quot;A String&quot;, # User&#x27;s email address.
508 },
509 ],
510 &quot;adwordsLinks&quot;: [ # List of linked AdWords accounts that are active or pending approval. To create a new link request, add a new link with status `active` to the list. It will remain in a `pending` state until approved or rejected either in the AdWords interface or through the AdWords API. To delete an active link, or to cancel a link request, remove it from the list.
511 {
512 &quot;status&quot;: &quot;A String&quot;, # Status of the link between this Merchant Center account and the AdWords account. Upon retrieval, it represents the actual status of the link and can be either `active` if it was approved in Google AdWords or `pending` if it&#x27;s pending approval. Upon insertion, it represents the *intended* status of the link. Re-uploading a link with status `active` when it&#x27;s still pending or with status `pending` when it&#x27;s already active will have no effect: the status will remain unchanged. Re-uploading a link with deprecated status `inactive` is equivalent to not submitting the link at all and will delete the link if it was active or cancel the link request if it was pending. Acceptable values are: - &quot;`active`&quot; - &quot;`pending`&quot;
513 &quot;adwordsId&quot;: &quot;A String&quot;, # Customer ID of the AdWords account.
514 },
515 ],
516 &quot;adultContent&quot;: True or False, # Indicates whether the merchant sells adult content.
517 &quot;sellerId&quot;: &quot;A String&quot;, # Client-specific, locally-unique, internal ID for the child account.
518 }</pre>
Craig Citro065b5302014-08-14 00:47:23 -0700519</div>
520
521<div class="method">
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700522 <code class="details" id="link">link(merchantId, accountId, body=None, x__xgafv=None)</code>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700523 <pre>Performs an action on a link between two Merchant Center accounts, namely accountId and linkedAccountId.
Craig Citro065b5302014-08-14 00:47:23 -0700524
525Args:
Dan O'Mearadd494642020-05-01 07:42:23 -0700526 merchantId: string, 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)
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700527 accountId: string, The ID of the account that should be linked. (required)
Dan O'Mearadd494642020-05-01 07:42:23 -0700528 body: object, The request body.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700529 The object takes the form of:
530
531{
Bu Sun Kim65020912020-05-20 12:08:20 -0700532 &quot;linkedAccountId&quot;: &quot;A String&quot;, # The ID of the linked account.
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800533 &quot;action&quot;: &quot;A String&quot;, # Action to perform for this link. The `&quot;request&quot;` action is only available to select merchants. Acceptable values are: - &quot;`approve`&quot; - &quot;`remove`&quot; - &quot;`request`&quot;
534 &quot;linkType&quot;: &quot;A String&quot;, # Type of the link between the two accounts. Acceptable values are: - &quot;`channelPartner`&quot; - &quot;`eCommercePlatform`&quot;
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700535 }
536
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700537 x__xgafv: string, V1 error format.
538 Allowed values
539 1 - v1 error format
540 2 - v2 error format
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700541
542Returns:
543 An object of the form:
544
545 {
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700546 &quot;kind&quot;: &quot;A String&quot;, # Identifies what kind of resource this is. Value: the fixed string &quot;content#accountsLinkResponse&quot;.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700547 }</pre>
548</div>
549
550<div class="method">
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700551 <code class="details" id="list">list(merchantId, pageToken=None, maxResults=None, x__xgafv=None)</code>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700552 <pre>Lists the sub-accounts in your Merchant Center account.
553
554Args:
555 merchantId: string, The ID of the managing account. This must be a multi-client account. (required)
Bu Sun Kim65020912020-05-20 12:08:20 -0700556 pageToken: string, The token returned by the previous request.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700557 maxResults: integer, The maximum number of accounts to return in the response, used for paging.
558 x__xgafv: string, V1 error format.
559 Allowed values
560 1 - v1 error format
561 2 - v2 error format
Craig Citro065b5302014-08-14 00:47:23 -0700562
563Returns:
564 An object of the form:
565
566 {
Bu Sun Kim65020912020-05-20 12:08:20 -0700567 &quot;resources&quot;: [
Dan O'Mearadd494642020-05-01 07:42:23 -0700568 { # Account data. After the creation of a new account it may take a few minutes before it is fully operational. The methods delete, insert, and update require the admin role.
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800569 &quot;name&quot;: &quot;A String&quot;, # Required. Display name for the account.
570 &quot;kind&quot;: &quot;A String&quot;, # Identifies what kind of resource this is. Value: the fixed string &quot;`content#account`&quot;
571 &quot;websiteUrl&quot;: &quot;A String&quot;, # The merchant&#x27;s website.
572 &quot;businessInformation&quot;: { # The business information of the account.
573 &quot;customerService&quot;: { # The customer service information of the business.
574 &quot;phoneNumber&quot;: &quot;A String&quot;, # Customer service phone number.
575 &quot;url&quot;: &quot;A String&quot;, # Customer service URL.
576 &quot;email&quot;: &quot;A String&quot;, # Customer service email.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700577 },
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800578 &quot;address&quot;: { # The address of the business.
579 &quot;postalCode&quot;: &quot;A String&quot;, # Postal code or ZIP (e.g. &quot;94043&quot;).
580 &quot;streetAddress&quot;: &quot;A String&quot;, # Street-level part of the address.
581 &quot;region&quot;: &quot;A String&quot;, # Top-level administrative subdivision of the country. For example, a state like California (&quot;CA&quot;) or a province like Quebec (&quot;QC&quot;).
582 &quot;locality&quot;: &quot;A String&quot;, # City, town or commune. May also include dependent localities or sublocalities (e.g. neighborhoods or suburbs).
583 &quot;country&quot;: &quot;A String&quot;, # CLDR country code (e.g. &quot;US&quot;). This value cannot be set for a sub-account of an MCA. All MCA sub-accounts inherit the country of their parent MCA.
Bu Sun Kim65020912020-05-20 12:08:20 -0700584 },
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800585 &quot;phoneNumber&quot;: &quot;A String&quot;, # The phone number of the business.
Craig Citro065b5302014-08-14 00:47:23 -0700586 },
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800587 &quot;id&quot;: &quot;A String&quot;, # Required for update. Merchant Center account ID.
588 &quot;googleMyBusinessLink&quot;: { # The GMB account which is linked or in the process of being linked with the Merchant Center account.
589 &quot;status&quot;: &quot;A String&quot;, # Status of the link between this Merchant Center account and the GMB account. Acceptable values are: - &quot;`active`&quot; - &quot;`pending`&quot;
590 &quot;gmbEmail&quot;: &quot;A String&quot;, # The GMB email address of which a specific account within a GMB account. A sample account within a GMB account could be a business account with set of locations, managed under the GMB account.
591 },
592 &quot;youtubeChannelLinks&quot;: [ # List of linked YouTube channels that are active or pending approval. To create a new link request, add a new link with status `active` to the list. It will remain in a `pending` state until approved or rejected in the YT Creator Studio interface. To delete an active link, or to cancel a link request, remove it from the list.
593 {
594 &quot;channelId&quot;: &quot;A String&quot;, # Channel ID.
595 &quot;status&quot;: &quot;A String&quot;, # Status of the link between this Merchant Center account and the YouTube channel. Upon retrieval, it represents the actual status of the link and can be either `active` if it was approved in YT Creator Studio or `pending` if it&#x27;s pending approval. Upon insertion, it represents the *intended* status of the link. Re-uploading a link with status `active` when it&#x27;s still pending or with status `pending` when it&#x27;s already active will have no effect: the status will remain unchanged. Re-uploading a link with deprecated status `inactive` is equivalent to not submitting the link at all and will delete the link if it was active or cancel the link request if it was pending.
596 },
597 ],
598 &quot;reviewsUrl&quot;: &quot;A String&quot;, # [DEPRECATED] This field is never returned and will be ignored if provided.
599 &quot;users&quot;: [ # Users with access to the account. Every account (except for subaccounts) must have at least one admin user.
600 {
601 &quot;paymentsManager&quot;: True or False, # Whether user can manage payment settings.
602 &quot;paymentsAnalyst&quot;: True or False, # Whether user can access payment statements.
603 &quot;admin&quot;: True or False, # Whether user is an admin.
604 &quot;orderManager&quot;: True or False, # Whether user is an order manager.
605 &quot;emailAddress&quot;: &quot;A String&quot;, # User&#x27;s email address.
606 },
607 ],
608 &quot;adwordsLinks&quot;: [ # List of linked AdWords accounts that are active or pending approval. To create a new link request, add a new link with status `active` to the list. It will remain in a `pending` state until approved or rejected either in the AdWords interface or through the AdWords API. To delete an active link, or to cancel a link request, remove it from the list.
609 {
610 &quot;status&quot;: &quot;A String&quot;, # Status of the link between this Merchant Center account and the AdWords account. Upon retrieval, it represents the actual status of the link and can be either `active` if it was approved in Google AdWords or `pending` if it&#x27;s pending approval. Upon insertion, it represents the *intended* status of the link. Re-uploading a link with status `active` when it&#x27;s still pending or with status `pending` when it&#x27;s already active will have no effect: the status will remain unchanged. Re-uploading a link with deprecated status `inactive` is equivalent to not submitting the link at all and will delete the link if it was active or cancel the link request if it was pending. Acceptable values are: - &quot;`active`&quot; - &quot;`pending`&quot;
611 &quot;adwordsId&quot;: &quot;A String&quot;, # Customer ID of the AdWords account.
612 },
613 ],
614 &quot;adultContent&quot;: True or False, # Indicates whether the merchant sells adult content.
615 &quot;sellerId&quot;: &quot;A String&quot;, # Client-specific, locally-unique, internal ID for the child account.
616 },
Craig Citro065b5302014-08-14 00:47:23 -0700617 ],
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800618 &quot;nextPageToken&quot;: &quot;A String&quot;, # The token for the retrieval of the next page of accounts.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700619 &quot;kind&quot;: &quot;A String&quot;, # Identifies what kind of resource this is. Value: the fixed string &quot;content#accountsListResponse&quot;.
Craig Citro065b5302014-08-14 00:47:23 -0700620 }</pre>
621</div>
622
623<div class="method">
624 <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
625 <pre>Retrieves the next page of results.
626
627Args:
628 previous_request: The request for the previous page. (required)
629 previous_response: The response from the request for the previous page. (required)
630
631Returns:
Bu Sun Kim65020912020-05-20 12:08:20 -0700632 A request object that you can call &#x27;execute()&#x27; on to request the next
Craig Citro065b5302014-08-14 00:47:23 -0700633 page. Returns None if there are no more items in the collection.
634 </pre>
635</div>
636
637<div class="method">
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700638 <code class="details" id="update">update(merchantId, accountId, body=None, dryRun=None, x__xgafv=None)</code>
Bu Sun Kimd059ad82020-07-22 17:02:09 -0700639 <pre>Updates a Merchant Center account. Any fields that are not provided are deleted from the resource.
Craig Citro065b5302014-08-14 00:47:23 -0700640
641Args:
Dan O'Mearadd494642020-05-01 07:42:23 -0700642 merchantId: string, 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)
Craig Citro065b5302014-08-14 00:47:23 -0700643 accountId: string, The ID of the account. (required)
Dan O'Mearadd494642020-05-01 07:42:23 -0700644 body: object, The request body.
Craig Citro065b5302014-08-14 00:47:23 -0700645 The object takes the form of:
646
Dan O'Mearadd494642020-05-01 07:42:23 -0700647{ # Account data. After the creation of a new account it may take a few minutes before it is fully operational. The methods delete, insert, and update require the admin role.
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800648 &quot;name&quot;: &quot;A String&quot;, # Required. Display name for the account.
649 &quot;kind&quot;: &quot;A String&quot;, # Identifies what kind of resource this is. Value: the fixed string &quot;`content#account`&quot;
650 &quot;websiteUrl&quot;: &quot;A String&quot;, # The merchant&#x27;s website.
651 &quot;businessInformation&quot;: { # The business information of the account.
652 &quot;customerService&quot;: { # The customer service information of the business.
653 &quot;phoneNumber&quot;: &quot;A String&quot;, # Customer service phone number.
654 &quot;url&quot;: &quot;A String&quot;, # Customer service URL.
655 &quot;email&quot;: &quot;A String&quot;, # Customer service email.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700656 },
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800657 &quot;address&quot;: { # The address of the business.
658 &quot;postalCode&quot;: &quot;A String&quot;, # Postal code or ZIP (e.g. &quot;94043&quot;).
659 &quot;streetAddress&quot;: &quot;A String&quot;, # Street-level part of the address.
660 &quot;region&quot;: &quot;A String&quot;, # Top-level administrative subdivision of the country. For example, a state like California (&quot;CA&quot;) or a province like Quebec (&quot;QC&quot;).
661 &quot;locality&quot;: &quot;A String&quot;, # City, town or commune. May also include dependent localities or sublocalities (e.g. neighborhoods or suburbs).
662 &quot;country&quot;: &quot;A String&quot;, # CLDR country code (e.g. &quot;US&quot;). This value cannot be set for a sub-account of an MCA. All MCA sub-accounts inherit the country of their parent MCA.
Bu Sun Kim65020912020-05-20 12:08:20 -0700663 },
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800664 &quot;phoneNumber&quot;: &quot;A String&quot;, # The phone number of the business.
665 },
666 &quot;id&quot;: &quot;A String&quot;, # Required for update. Merchant Center account ID.
667 &quot;googleMyBusinessLink&quot;: { # The GMB account which is linked or in the process of being linked with the Merchant Center account.
668 &quot;status&quot;: &quot;A String&quot;, # Status of the link between this Merchant Center account and the GMB account. Acceptable values are: - &quot;`active`&quot; - &quot;`pending`&quot;
669 &quot;gmbEmail&quot;: &quot;A String&quot;, # The GMB email address of which a specific account within a GMB account. A sample account within a GMB account could be a business account with set of locations, managed under the GMB account.
670 },
671 &quot;youtubeChannelLinks&quot;: [ # List of linked YouTube channels that are active or pending approval. To create a new link request, add a new link with status `active` to the list. It will remain in a `pending` state until approved or rejected in the YT Creator Studio interface. To delete an active link, or to cancel a link request, remove it from the list.
672 {
673 &quot;channelId&quot;: &quot;A String&quot;, # Channel ID.
674 &quot;status&quot;: &quot;A String&quot;, # Status of the link between this Merchant Center account and the YouTube channel. Upon retrieval, it represents the actual status of the link and can be either `active` if it was approved in YT Creator Studio or `pending` if it&#x27;s pending approval. Upon insertion, it represents the *intended* status of the link. Re-uploading a link with status `active` when it&#x27;s still pending or with status `pending` when it&#x27;s already active will have no effect: the status will remain unchanged. Re-uploading a link with deprecated status `inactive` is equivalent to not submitting the link at all and will delete the link if it was active or cancel the link request if it was pending.
675 },
676 ],
677 &quot;reviewsUrl&quot;: &quot;A String&quot;, # [DEPRECATED] This field is never returned and will be ignored if provided.
678 &quot;users&quot;: [ # Users with access to the account. Every account (except for subaccounts) must have at least one admin user.
679 {
680 &quot;paymentsManager&quot;: True or False, # Whether user can manage payment settings.
681 &quot;paymentsAnalyst&quot;: True or False, # Whether user can access payment statements.
682 &quot;admin&quot;: True or False, # Whether user is an admin.
683 &quot;orderManager&quot;: True or False, # Whether user is an order manager.
684 &quot;emailAddress&quot;: &quot;A String&quot;, # User&#x27;s email address.
685 },
686 ],
687 &quot;adwordsLinks&quot;: [ # List of linked AdWords accounts that are active or pending approval. To create a new link request, add a new link with status `active` to the list. It will remain in a `pending` state until approved or rejected either in the AdWords interface or through the AdWords API. To delete an active link, or to cancel a link request, remove it from the list.
688 {
689 &quot;status&quot;: &quot;A String&quot;, # Status of the link between this Merchant Center account and the AdWords account. Upon retrieval, it represents the actual status of the link and can be either `active` if it was approved in Google AdWords or `pending` if it&#x27;s pending approval. Upon insertion, it represents the *intended* status of the link. Re-uploading a link with status `active` when it&#x27;s still pending or with status `pending` when it&#x27;s already active will have no effect: the status will remain unchanged. Re-uploading a link with deprecated status `inactive` is equivalent to not submitting the link at all and will delete the link if it was active or cancel the link request if it was pending. Acceptable values are: - &quot;`active`&quot; - &quot;`pending`&quot;
690 &quot;adwordsId&quot;: &quot;A String&quot;, # Customer ID of the AdWords account.
691 },
692 ],
693 &quot;adultContent&quot;: True or False, # Indicates whether the merchant sells adult content.
694 &quot;sellerId&quot;: &quot;A String&quot;, # Client-specific, locally-unique, internal ID for the child account.
695}
Craig Citro065b5302014-08-14 00:47:23 -0700696
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700697 dryRun: boolean, Flag to simulate a request like in a live environment. If set to true, dry-run mode checks the validity of the request and returns errors (if any).
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700698 x__xgafv: string, V1 error format.
699 Allowed values
700 1 - v1 error format
701 2 - v2 error format
Craig Citro065b5302014-08-14 00:47:23 -0700702
703Returns:
704 An object of the form:
705
Dan O'Mearadd494642020-05-01 07:42:23 -0700706 { # Account data. After the creation of a new account it may take a few minutes before it is fully operational. The methods delete, insert, and update require the admin role.
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800707 &quot;name&quot;: &quot;A String&quot;, # Required. Display name for the account.
708 &quot;kind&quot;: &quot;A String&quot;, # Identifies what kind of resource this is. Value: the fixed string &quot;`content#account`&quot;
709 &quot;websiteUrl&quot;: &quot;A String&quot;, # The merchant&#x27;s website.
710 &quot;businessInformation&quot;: { # The business information of the account.
711 &quot;customerService&quot;: { # The customer service information of the business.
712 &quot;phoneNumber&quot;: &quot;A String&quot;, # Customer service phone number.
713 &quot;url&quot;: &quot;A String&quot;, # Customer service URL.
714 &quot;email&quot;: &quot;A String&quot;, # Customer service email.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700715 },
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800716 &quot;address&quot;: { # The address of the business.
717 &quot;postalCode&quot;: &quot;A String&quot;, # Postal code or ZIP (e.g. &quot;94043&quot;).
718 &quot;streetAddress&quot;: &quot;A String&quot;, # Street-level part of the address.
719 &quot;region&quot;: &quot;A String&quot;, # Top-level administrative subdivision of the country. For example, a state like California (&quot;CA&quot;) or a province like Quebec (&quot;QC&quot;).
720 &quot;locality&quot;: &quot;A String&quot;, # City, town or commune. May also include dependent localities or sublocalities (e.g. neighborhoods or suburbs).
721 &quot;country&quot;: &quot;A String&quot;, # CLDR country code (e.g. &quot;US&quot;). This value cannot be set for a sub-account of an MCA. All MCA sub-accounts inherit the country of their parent MCA.
Bu Sun Kim65020912020-05-20 12:08:20 -0700722 },
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800723 &quot;phoneNumber&quot;: &quot;A String&quot;, # The phone number of the business.
724 },
725 &quot;id&quot;: &quot;A String&quot;, # Required for update. Merchant Center account ID.
726 &quot;googleMyBusinessLink&quot;: { # The GMB account which is linked or in the process of being linked with the Merchant Center account.
727 &quot;status&quot;: &quot;A String&quot;, # Status of the link between this Merchant Center account and the GMB account. Acceptable values are: - &quot;`active`&quot; - &quot;`pending`&quot;
728 &quot;gmbEmail&quot;: &quot;A String&quot;, # The GMB email address of which a specific account within a GMB account. A sample account within a GMB account could be a business account with set of locations, managed under the GMB account.
729 },
730 &quot;youtubeChannelLinks&quot;: [ # List of linked YouTube channels that are active or pending approval. To create a new link request, add a new link with status `active` to the list. It will remain in a `pending` state until approved or rejected in the YT Creator Studio interface. To delete an active link, or to cancel a link request, remove it from the list.
731 {
732 &quot;channelId&quot;: &quot;A String&quot;, # Channel ID.
733 &quot;status&quot;: &quot;A String&quot;, # Status of the link between this Merchant Center account and the YouTube channel. Upon retrieval, it represents the actual status of the link and can be either `active` if it was approved in YT Creator Studio or `pending` if it&#x27;s pending approval. Upon insertion, it represents the *intended* status of the link. Re-uploading a link with status `active` when it&#x27;s still pending or with status `pending` when it&#x27;s already active will have no effect: the status will remain unchanged. Re-uploading a link with deprecated status `inactive` is equivalent to not submitting the link at all and will delete the link if it was active or cancel the link request if it was pending.
734 },
735 ],
736 &quot;reviewsUrl&quot;: &quot;A String&quot;, # [DEPRECATED] This field is never returned and will be ignored if provided.
737 &quot;users&quot;: [ # Users with access to the account. Every account (except for subaccounts) must have at least one admin user.
738 {
739 &quot;paymentsManager&quot;: True or False, # Whether user can manage payment settings.
740 &quot;paymentsAnalyst&quot;: True or False, # Whether user can access payment statements.
741 &quot;admin&quot;: True or False, # Whether user is an admin.
742 &quot;orderManager&quot;: True or False, # Whether user is an order manager.
743 &quot;emailAddress&quot;: &quot;A String&quot;, # User&#x27;s email address.
744 },
745 ],
746 &quot;adwordsLinks&quot;: [ # List of linked AdWords accounts that are active or pending approval. To create a new link request, add a new link with status `active` to the list. It will remain in a `pending` state until approved or rejected either in the AdWords interface or through the AdWords API. To delete an active link, or to cancel a link request, remove it from the list.
747 {
748 &quot;status&quot;: &quot;A String&quot;, # Status of the link between this Merchant Center account and the AdWords account. Upon retrieval, it represents the actual status of the link and can be either `active` if it was approved in Google AdWords or `pending` if it&#x27;s pending approval. Upon insertion, it represents the *intended* status of the link. Re-uploading a link with status `active` when it&#x27;s still pending or with status `pending` when it&#x27;s already active will have no effect: the status will remain unchanged. Re-uploading a link with deprecated status `inactive` is equivalent to not submitting the link at all and will delete the link if it was active or cancel the link request if it was pending. Acceptable values are: - &quot;`active`&quot; - &quot;`pending`&quot;
749 &quot;adwordsId&quot;: &quot;A String&quot;, # Customer ID of the AdWords account.
750 },
751 ],
752 &quot;adultContent&quot;: True or False, # Indicates whether the merchant sells adult content.
753 &quot;sellerId&quot;: &quot;A String&quot;, # Client-specific, locally-unique, internal ID for the child account.
754 }</pre>
Craig Citro065b5302014-08-14 00:47:23 -0700755</div>
756
757</body></html>