1<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_1.html">Content API for Shopping</a> . <a href="content_v2_1.accounts.html">accounts</a></h1> 76<h2>Instance Methods</h2> 77<p class="toc_element"> 78 <code><a href="#authinfo">authinfo()</a></code></p> 79<p class="firstline">Returns information about the authenticated user.</p> 80<p class="toc_element"> 81 <code><a href="#claimwebsite">claimwebsite(merchantId, accountId, overwrite=None)</a></code></p> 82<p class="firstline">Claims the website of a Merchant Center sub-account.</p> 83<p class="toc_element"> 84 <code><a href="#custombatch">custombatch(body)</a></code></p> 85<p class="firstline">Retrieves, inserts, updates, and deletes multiple Merchant Center (sub-)accounts in a single request.</p> 86<p class="toc_element"> 87 <code><a href="#delete">delete(merchantId, accountId, force=None)</a></code></p> 88<p class="firstline">Deletes a Merchant Center sub-account.</p> 89<p class="toc_element"> 90 <code><a href="#get">get(merchantId, accountId)</a></code></p> 91<p class="firstline">Retrieves a Merchant Center account.</p> 92<p class="toc_element"> 93 <code><a href="#insert">insert(merchantId, body)</a></code></p> 94<p class="firstline">Creates a Merchant Center sub-account.</p> 95<p class="toc_element"> 96 <code><a href="#link">link(merchantId, accountId, body)</a></code></p> 97<p class="firstline">Performs an action on a link between two Merchant Center accounts, namely accountId and linkedAccountId.</p> 98<p class="toc_element"> 99 <code><a href="#list">list(merchantId, pageToken=None, maxResults=None)</a></code></p> 100<p class="firstline">Lists the sub-accounts in your Merchant Center account.</p> 101<p class="toc_element"> 102 <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p> 103<p class="firstline">Retrieves the next page of results.</p> 104<p class="toc_element"> 105 <code><a href="#update">update(merchantId, accountId, body)</a></code></p> 106<p class="firstline">Updates a Merchant Center account.</p> 107<h3>Method Details</h3> 108<div class="method"> 109 <code class="details" id="authinfo">authinfo()</code> 110 <pre>Returns information about the authenticated user. 111 112Args: 113 114Returns: 115 An object of the form: 116 117 { 118 "kind": "content#accountsAuthInfoResponse", # Identifies what kind of resource this is. Value: the fixed string "content#accountsAuthInfoResponse". 119 "accountIdentifiers": [ # The account identifiers corresponding to the authenticated user. 120 # - For an individual account: only the merchant ID is defined 121 # - For an aggregator: only the aggregator ID is defined 122 # - For a subaccount of an MCA: both the merchant ID and the aggregator ID are defined. 123 { 124 "aggregatorId": "A String", # The aggregator ID, set for aggregators and subaccounts (in that case, it represents the aggregator of the subaccount). 125 "merchantId": "A String", # The merchant account ID, set for individual accounts and subaccounts. 126 }, 127 ], 128 }</pre> 129</div> 130 131<div class="method"> 132 <code class="details" id="claimwebsite">claimwebsite(merchantId, accountId, overwrite=None)</code> 133 <pre>Claims the website of a Merchant Center sub-account. 134 135Args: 136 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) 137 accountId: string, The ID of the account whose website is claimed. (required) 138 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. 139 140Returns: 141 An object of the form: 142 143 { 144 "kind": "content#accountsClaimWebsiteResponse", # Identifies what kind of resource this is. Value: the fixed string "content#accountsClaimWebsiteResponse". 145 }</pre> 146</div> 147 148<div class="method"> 149 <code class="details" id="custombatch">custombatch(body)</code> 150 <pre>Retrieves, inserts, updates, and deletes multiple Merchant Center (sub-)accounts in a single request. 151 152Args: 153 body: object, The request body. (required) 154 The object takes the form of: 155 156{ 157 "entries": [ # The request entries to be processed in the batch. 158 { # A batch entry encoding a single non-batch accounts request. 159 "linkRequest": { # Details about the link request. 160 "action": "A String", # Action to perform for this link. The "request" action is only available to select merchants. 161 "linkType": "A String", # Type of the link between the two accounts. 162 "linkedAccountId": "A String", # The ID of the linked account. 163 }, 164 "account": { # Account data. After the creation of a new account it may take a few minutes before it is fully operational. The methods delete, insert, patch, and update require the admin role. # The account to create or update. Only defined if the method is insert or update. 165 "kind": "content#account", # Identifies what kind of resource this is. Value: the fixed string "content#account". 166 "name": "A String", # Display name for the account. 167 "youtubeChannelLinks": [ # 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. 168 { 169 "status": "A String", # 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's pending approval. Upon insertion, it represents the intended status of the link. Re-uploading a link with status active when it's still pending or with status pending when it'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. 170 "channelId": "A String", # Channel ID. 171 }, 172 ], 173 "adultContent": True or False, # Indicates whether the merchant sells adult content. 174 "websiteUrl": "A String", # The merchant's website. 175 "adsLinks": [ # List of linked Ads 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 Ads interface or through the AdWords API. To delete an active link, or to cancel a link request, remove it from the list. 176 { 177 "adsId": "A String", # Customer ID of the Ads account. 178 "status": "A String", # Status of the link between this Merchant Center account and the Ads account. Upon retrieval, it represents the actual status of the link and can be either active if it was approved in Google Ads or pending if it's pending approval. Upon insertion, it represents the intended status of the link. Re-uploading a link with status active when it's still pending or with status pending when it'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. 179 }, 180 ], 181 "businessInformation": { # The business information of the account. 182 "phoneNumber": "A String", # The phone number of the business. 183 "customerService": { # The customer service information of the business. 184 "url": "A String", # Customer service URL. 185 "phoneNumber": "A String", # Customer service phone number. 186 "email": "A String", # Customer service email. 187 }, 188 "address": { # The address of the business. 189 "postalCode": "A String", # Postal code or ZIP (e.g. "94043"). 190 "country": "A String", # CLDR country code (e.g. "US"). 191 "region": "A String", # Top-level administrative subdivision of the country. For example, a state like California ("CA") or a province like Quebec ("QC"). 192 "streetAddress": "A String", # Street-level part of the address. 193 "locality": "A String", # City, town or commune. May also include dependent localities or sublocalities (e.g. neighborhoods or suburbs). 194 }, 195 }, 196 "googleMyBusinessLink": { # The GMB account which is linked or in the process of being linked with the Merchant Center account. 197 "status": "A String", # Status of the link between this Merchant Center account and the GMB account. 198 "gmbEmail": "A String", # 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. 199 }, 200 "sellerId": "A String", # Client-specific, locally-unique, internal ID for the child account. 201 "id": "A String", # Merchant Center account ID. 202 "users": [ # Users with access to the account. Every account (except for subaccounts) must have at least one admin user. 203 { 204 "admin": True or False, # Whether user is an admin. 205 "orderManager": True or False, # Whether user is an order manager. 206 "paymentsAnalyst": True or False, # Whether user can access payment statements. 207 "emailAddress": "A String", # User's email address. 208 "paymentsManager": True or False, # Whether user can manage payment settings. 209 }, 210 ], 211 }, 212 "force": True or False, # Whether the account should be deleted if the account has offers. Only applicable if the method is delete. 213 "method": "A String", # The method of the batch entry. 214 "batchId": 42, # An entry ID, unique within the batch request. 215 "merchantId": "A String", # The ID of the managing account. 216 "overwrite": 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. 217 "accountId": "A String", # The ID of the targeted account. Only defined if the method is not insert. 218 }, 219 ], 220 } 221 222 223Returns: 224 An object of the form: 225 226 { 227 "kind": "content#accountsCustomBatchResponse", # Identifies what kind of resource this is. Value: the fixed string "content#accountsCustomBatchResponse". 228 "entries": [ # The result of the execution of the batch requests. 229 { # A batch entry encoding a single non-batch accounts response. 230 "batchId": 42, # The ID of the request entry this entry responds to. 231 "account": { # Account data. After the creation of a new account it may take a few minutes before it is fully operational. The methods delete, insert, patch, and update require the admin role. # The retrieved, created, or updated account. Not defined if the method was delete, claimwebsite or link. 232 "kind": "content#account", # Identifies what kind of resource this is. Value: the fixed string "content#account". 233 "name": "A String", # Display name for the account. 234 "youtubeChannelLinks": [ # 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. 235 { 236 "status": "A String", # 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's pending approval. Upon insertion, it represents the intended status of the link. Re-uploading a link with status active when it's still pending or with status pending when it'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. 237 "channelId": "A String", # Channel ID. 238 }, 239 ], 240 "adultContent": True or False, # Indicates whether the merchant sells adult content. 241 "websiteUrl": "A String", # The merchant's website. 242 "adsLinks": [ # List of linked Ads 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 Ads interface or through the AdWords API. To delete an active link, or to cancel a link request, remove it from the list. 243 { 244 "adsId": "A String", # Customer ID of the Ads account. 245 "status": "A String", # Status of the link between this Merchant Center account and the Ads account. Upon retrieval, it represents the actual status of the link and can be either active if it was approved in Google Ads or pending if it's pending approval. Upon insertion, it represents the intended status of the link. Re-uploading a link with status active when it's still pending or with status pending when it'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. 246 }, 247 ], 248 "businessInformation": { # The business information of the account. 249 "phoneNumber": "A String", # The phone number of the business. 250 "customerService": { # The customer service information of the business. 251 "url": "A String", # Customer service URL. 252 "phoneNumber": "A String", # Customer service phone number. 253 "email": "A String", # Customer service email. 254 }, 255 "address": { # The address of the business. 256 "postalCode": "A String", # Postal code or ZIP (e.g. "94043"). 257 "country": "A String", # CLDR country code (e.g. "US"). 258 "region": "A String", # Top-level administrative subdivision of the country. For example, a state like California ("CA") or a province like Quebec ("QC"). 259 "streetAddress": "A String", # Street-level part of the address. 260 "locality": "A String", # City, town or commune. May also include dependent localities or sublocalities (e.g. neighborhoods or suburbs). 261 }, 262 }, 263 "googleMyBusinessLink": { # The GMB account which is linked or in the process of being linked with the Merchant Center account. 264 "status": "A String", # Status of the link between this Merchant Center account and the GMB account. 265 "gmbEmail": "A String", # 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. 266 }, 267 "sellerId": "A String", # Client-specific, locally-unique, internal ID for the child account. 268 "id": "A String", # Merchant Center account ID. 269 "users": [ # Users with access to the account. Every account (except for subaccounts) must have at least one admin user. 270 { 271 "admin": True or False, # Whether user is an admin. 272 "orderManager": True or False, # Whether user is an order manager. 273 "paymentsAnalyst": True or False, # Whether user can access payment statements. 274 "emailAddress": "A String", # User's email address. 275 "paymentsManager": True or False, # Whether user can manage payment settings. 276 }, 277 ], 278 }, 279 "errors": { # A list of errors returned by a failed batch entry. # A list of errors defined if and only if the request failed. 280 "message": "A String", # The message of the first error in errors. 281 "code": 42, # The HTTP status of the first error in errors. 282 "errors": [ # A list of errors. 283 { # An error returned by the API. 284 "reason": "A String", # The error code. 285 "domain": "A String", # The domain of the error. 286 "message": "A String", # A description of the error. 287 }, 288 ], 289 }, 290 "kind": "content#accountsCustomBatchResponseEntry", # Identifies what kind of resource this is. Value: the fixed string "content#accountsCustomBatchResponseEntry". 291 }, 292 ], 293 }</pre> 294</div> 295 296<div class="method"> 297 <code class="details" id="delete">delete(merchantId, accountId, force=None)</code> 298 <pre>Deletes a Merchant Center sub-account. 299 300Args: 301 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) 302 accountId: string, The ID of the account. (required) 303 force: boolean, Flag to delete sub-accounts with products. The default value is false. 304</pre> 305</div> 306 307<div class="method"> 308 <code class="details" id="get">get(merchantId, accountId)</code> 309 <pre>Retrieves a Merchant Center account. 310 311Args: 312 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) 313 accountId: string, The ID of the account. (required) 314 315Returns: 316 An object of the form: 317 318 { # Account data. After the creation of a new account it may take a few minutes before it is fully operational. The methods delete, insert, patch, and update require the admin role. 319 "kind": "content#account", # Identifies what kind of resource this is. Value: the fixed string "content#account". 320 "name": "A String", # Display name for the account. 321 "youtubeChannelLinks": [ # 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. 322 { 323 "status": "A String", # 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's pending approval. Upon insertion, it represents the intended status of the link. Re-uploading a link with status active when it's still pending or with status pending when it'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. 324 "channelId": "A String", # Channel ID. 325 }, 326 ], 327 "adultContent": True or False, # Indicates whether the merchant sells adult content. 328 "websiteUrl": "A String", # The merchant's website. 329 "adsLinks": [ # List of linked Ads 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 Ads interface or through the AdWords API. To delete an active link, or to cancel a link request, remove it from the list. 330 { 331 "adsId": "A String", # Customer ID of the Ads account. 332 "status": "A String", # Status of the link between this Merchant Center account and the Ads account. Upon retrieval, it represents the actual status of the link and can be either active if it was approved in Google Ads or pending if it's pending approval. Upon insertion, it represents the intended status of the link. Re-uploading a link with status active when it's still pending or with status pending when it'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. 333 }, 334 ], 335 "businessInformation": { # The business information of the account. 336 "phoneNumber": "A String", # The phone number of the business. 337 "customerService": { # The customer service information of the business. 338 "url": "A String", # Customer service URL. 339 "phoneNumber": "A String", # Customer service phone number. 340 "email": "A String", # Customer service email. 341 }, 342 "address": { # The address of the business. 343 "postalCode": "A String", # Postal code or ZIP (e.g. "94043"). 344 "country": "A String", # CLDR country code (e.g. "US"). 345 "region": "A String", # Top-level administrative subdivision of the country. For example, a state like California ("CA") or a province like Quebec ("QC"). 346 "streetAddress": "A String", # Street-level part of the address. 347 "locality": "A String", # City, town or commune. May also include dependent localities or sublocalities (e.g. neighborhoods or suburbs). 348 }, 349 }, 350 "googleMyBusinessLink": { # The GMB account which is linked or in the process of being linked with the Merchant Center account. 351 "status": "A String", # Status of the link between this Merchant Center account and the GMB account. 352 "gmbEmail": "A String", # 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. 353 }, 354 "sellerId": "A String", # Client-specific, locally-unique, internal ID for the child account. 355 "id": "A String", # Merchant Center account ID. 356 "users": [ # Users with access to the account. Every account (except for subaccounts) must have at least one admin user. 357 { 358 "admin": True or False, # Whether user is an admin. 359 "orderManager": True or False, # Whether user is an order manager. 360 "paymentsAnalyst": True or False, # Whether user can access payment statements. 361 "emailAddress": "A String", # User's email address. 362 "paymentsManager": True or False, # Whether user can manage payment settings. 363 }, 364 ], 365 }</pre> 366</div> 367 368<div class="method"> 369 <code class="details" id="insert">insert(merchantId, body)</code> 370 <pre>Creates a Merchant Center sub-account. 371 372Args: 373 merchantId: string, The ID of the managing account. This must be a multi-client account. (required) 374 body: object, The request body. (required) 375 The object takes the form of: 376 377{ # Account data. After the creation of a new account it may take a few minutes before it is fully operational. The methods delete, insert, patch, and update require the admin role. 378 "kind": "content#account", # Identifies what kind of resource this is. Value: the fixed string "content#account". 379 "name": "A String", # Display name for the account. 380 "youtubeChannelLinks": [ # 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. 381 { 382 "status": "A String", # 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's pending approval. Upon insertion, it represents the intended status of the link. Re-uploading a link with status active when it's still pending or with status pending when it'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. 383 "channelId": "A String", # Channel ID. 384 }, 385 ], 386 "adultContent": True or False, # Indicates whether the merchant sells adult content. 387 "websiteUrl": "A String", # The merchant's website. 388 "adsLinks": [ # List of linked Ads 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 Ads interface or through the AdWords API. To delete an active link, or to cancel a link request, remove it from the list. 389 { 390 "adsId": "A String", # Customer ID of the Ads account. 391 "status": "A String", # Status of the link between this Merchant Center account and the Ads account. Upon retrieval, it represents the actual status of the link and can be either active if it was approved in Google Ads or pending if it's pending approval. Upon insertion, it represents the intended status of the link. Re-uploading a link with status active when it's still pending or with status pending when it'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. 392 }, 393 ], 394 "businessInformation": { # The business information of the account. 395 "phoneNumber": "A String", # The phone number of the business. 396 "customerService": { # The customer service information of the business. 397 "url": "A String", # Customer service URL. 398 "phoneNumber": "A String", # Customer service phone number. 399 "email": "A String", # Customer service email. 400 }, 401 "address": { # The address of the business. 402 "postalCode": "A String", # Postal code or ZIP (e.g. "94043"). 403 "country": "A String", # CLDR country code (e.g. "US"). 404 "region": "A String", # Top-level administrative subdivision of the country. For example, a state like California ("CA") or a province like Quebec ("QC"). 405 "streetAddress": "A String", # Street-level part of the address. 406 "locality": "A String", # City, town or commune. May also include dependent localities or sublocalities (e.g. neighborhoods or suburbs). 407 }, 408 }, 409 "googleMyBusinessLink": { # The GMB account which is linked or in the process of being linked with the Merchant Center account. 410 "status": "A String", # Status of the link between this Merchant Center account and the GMB account. 411 "gmbEmail": "A String", # 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. 412 }, 413 "sellerId": "A String", # Client-specific, locally-unique, internal ID for the child account. 414 "id": "A String", # Merchant Center account ID. 415 "users": [ # Users with access to the account. Every account (except for subaccounts) must have at least one admin user. 416 { 417 "admin": True or False, # Whether user is an admin. 418 "orderManager": True or False, # Whether user is an order manager. 419 "paymentsAnalyst": True or False, # Whether user can access payment statements. 420 "emailAddress": "A String", # User's email address. 421 "paymentsManager": True or False, # Whether user can manage payment settings. 422 }, 423 ], 424 } 425 426 427Returns: 428 An object of the form: 429 430 { # Account data. After the creation of a new account it may take a few minutes before it is fully operational. The methods delete, insert, patch, and update require the admin role. 431 "kind": "content#account", # Identifies what kind of resource this is. Value: the fixed string "content#account". 432 "name": "A String", # Display name for the account. 433 "youtubeChannelLinks": [ # 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. 434 { 435 "status": "A String", # 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's pending approval. Upon insertion, it represents the intended status of the link. Re-uploading a link with status active when it's still pending or with status pending when it'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. 436 "channelId": "A String", # Channel ID. 437 }, 438 ], 439 "adultContent": True or False, # Indicates whether the merchant sells adult content. 440 "websiteUrl": "A String", # The merchant's website. 441 "adsLinks": [ # List of linked Ads 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 Ads interface or through the AdWords API. To delete an active link, or to cancel a link request, remove it from the list. 442 { 443 "adsId": "A String", # Customer ID of the Ads account. 444 "status": "A String", # Status of the link between this Merchant Center account and the Ads account. Upon retrieval, it represents the actual status of the link and can be either active if it was approved in Google Ads or pending if it's pending approval. Upon insertion, it represents the intended status of the link. Re-uploading a link with status active when it's still pending or with status pending when it'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. 445 }, 446 ], 447 "businessInformation": { # The business information of the account. 448 "phoneNumber": "A String", # The phone number of the business. 449 "customerService": { # The customer service information of the business. 450 "url": "A String", # Customer service URL. 451 "phoneNumber": "A String", # Customer service phone number. 452 "email": "A String", # Customer service email. 453 }, 454 "address": { # The address of the business. 455 "postalCode": "A String", # Postal code or ZIP (e.g. "94043"). 456 "country": "A String", # CLDR country code (e.g. "US"). 457 "region": "A String", # Top-level administrative subdivision of the country. For example, a state like California ("CA") or a province like Quebec ("QC"). 458 "streetAddress": "A String", # Street-level part of the address. 459 "locality": "A String", # City, town or commune. May also include dependent localities or sublocalities (e.g. neighborhoods or suburbs). 460 }, 461 }, 462 "googleMyBusinessLink": { # The GMB account which is linked or in the process of being linked with the Merchant Center account. 463 "status": "A String", # Status of the link between this Merchant Center account and the GMB account. 464 "gmbEmail": "A String", # 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. 465 }, 466 "sellerId": "A String", # Client-specific, locally-unique, internal ID for the child account. 467 "id": "A String", # Merchant Center account ID. 468 "users": [ # Users with access to the account. Every account (except for subaccounts) must have at least one admin user. 469 { 470 "admin": True or False, # Whether user is an admin. 471 "orderManager": True or False, # Whether user is an order manager. 472 "paymentsAnalyst": True or False, # Whether user can access payment statements. 473 "emailAddress": "A String", # User's email address. 474 "paymentsManager": True or False, # Whether user can manage payment settings. 475 }, 476 ], 477 }</pre> 478</div> 479 480<div class="method"> 481 <code class="details" id="link">link(merchantId, accountId, body)</code> 482 <pre>Performs an action on a link between two Merchant Center accounts, namely accountId and linkedAccountId. 483 484Args: 485 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) 486 accountId: string, The ID of the account that should be linked. (required) 487 body: object, The request body. (required) 488 The object takes the form of: 489 490{ 491 "action": "A String", # Action to perform for this link. The "request" action is only available to select merchants. 492 "linkType": "A String", # Type of the link between the two accounts. 493 "linkedAccountId": "A String", # The ID of the linked account. 494 } 495 496 497Returns: 498 An object of the form: 499 500 { 501 "kind": "content#accountsLinkResponse", # Identifies what kind of resource this is. Value: the fixed string "content#accountsLinkResponse". 502 }</pre> 503</div> 504 505<div class="method"> 506 <code class="details" id="list">list(merchantId, pageToken=None, maxResults=None)</code> 507 <pre>Lists the sub-accounts in your Merchant Center account. 508 509Args: 510 merchantId: string, The ID of the managing account. This must be a multi-client account. (required) 511 pageToken: string, The token returned by the previous request. 512 maxResults: integer, The maximum number of accounts to return in the response, used for paging. 513 514Returns: 515 An object of the form: 516 517 { 518 "nextPageToken": "A String", # The token for the retrieval of the next page of accounts. 519 "kind": "content#accountsListResponse", # Identifies what kind of resource this is. Value: the fixed string "content#accountsListResponse". 520 "resources": [ 521 { # Account data. After the creation of a new account it may take a few minutes before it is fully operational. The methods delete, insert, patch, and update require the admin role. 522 "kind": "content#account", # Identifies what kind of resource this is. Value: the fixed string "content#account". 523 "name": "A String", # Display name for the account. 524 "youtubeChannelLinks": [ # 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. 525 { 526 "status": "A String", # 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's pending approval. Upon insertion, it represents the intended status of the link. Re-uploading a link with status active when it's still pending or with status pending when it'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. 527 "channelId": "A String", # Channel ID. 528 }, 529 ], 530 "adultContent": True or False, # Indicates whether the merchant sells adult content. 531 "websiteUrl": "A String", # The merchant's website. 532 "adsLinks": [ # List of linked Ads 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 Ads interface or through the AdWords API. To delete an active link, or to cancel a link request, remove it from the list. 533 { 534 "adsId": "A String", # Customer ID of the Ads account. 535 "status": "A String", # Status of the link between this Merchant Center account and the Ads account. Upon retrieval, it represents the actual status of the link and can be either active if it was approved in Google Ads or pending if it's pending approval. Upon insertion, it represents the intended status of the link. Re-uploading a link with status active when it's still pending or with status pending when it'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. 536 }, 537 ], 538 "businessInformation": { # The business information of the account. 539 "phoneNumber": "A String", # The phone number of the business. 540 "customerService": { # The customer service information of the business. 541 "url": "A String", # Customer service URL. 542 "phoneNumber": "A String", # Customer service phone number. 543 "email": "A String", # Customer service email. 544 }, 545 "address": { # The address of the business. 546 "postalCode": "A String", # Postal code or ZIP (e.g. "94043"). 547 "country": "A String", # CLDR country code (e.g. "US"). 548 "region": "A String", # Top-level administrative subdivision of the country. For example, a state like California ("CA") or a province like Quebec ("QC"). 549 "streetAddress": "A String", # Street-level part of the address. 550 "locality": "A String", # City, town or commune. May also include dependent localities or sublocalities (e.g. neighborhoods or suburbs). 551 }, 552 }, 553 "googleMyBusinessLink": { # The GMB account which is linked or in the process of being linked with the Merchant Center account. 554 "status": "A String", # Status of the link between this Merchant Center account and the GMB account. 555 "gmbEmail": "A String", # 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. 556 }, 557 "sellerId": "A String", # Client-specific, locally-unique, internal ID for the child account. 558 "id": "A String", # Merchant Center account ID. 559 "users": [ # Users with access to the account. Every account (except for subaccounts) must have at least one admin user. 560 { 561 "admin": True or False, # Whether user is an admin. 562 "orderManager": True or False, # Whether user is an order manager. 563 "paymentsAnalyst": True or False, # Whether user can access payment statements. 564 "emailAddress": "A String", # User's email address. 565 "paymentsManager": True or False, # Whether user can manage payment settings. 566 }, 567 ], 568 }, 569 ], 570 }</pre> 571</div> 572 573<div class="method"> 574 <code class="details" id="list_next">list_next(previous_request, previous_response)</code> 575 <pre>Retrieves the next page of results. 576 577Args: 578 previous_request: The request for the previous page. (required) 579 previous_response: The response from the request for the previous page. (required) 580 581Returns: 582 A request object that you can call 'execute()' on to request the next 583 page. Returns None if there are no more items in the collection. 584 </pre> 585</div> 586 587<div class="method"> 588 <code class="details" id="update">update(merchantId, accountId, body)</code> 589 <pre>Updates a Merchant Center account. 590 591Args: 592 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) 593 accountId: string, The ID of the account. (required) 594 body: object, The request body. (required) 595 The object takes the form of: 596 597{ # Account data. After the creation of a new account it may take a few minutes before it is fully operational. The methods delete, insert, patch, and update require the admin role. 598 "kind": "content#account", # Identifies what kind of resource this is. Value: the fixed string "content#account". 599 "name": "A String", # Display name for the account. 600 "youtubeChannelLinks": [ # 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. 601 { 602 "status": "A String", # 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's pending approval. Upon insertion, it represents the intended status of the link. Re-uploading a link with status active when it's still pending or with status pending when it'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. 603 "channelId": "A String", # Channel ID. 604 }, 605 ], 606 "adultContent": True or False, # Indicates whether the merchant sells adult content. 607 "websiteUrl": "A String", # The merchant's website. 608 "adsLinks": [ # List of linked Ads 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 Ads interface or through the AdWords API. To delete an active link, or to cancel a link request, remove it from the list. 609 { 610 "adsId": "A String", # Customer ID of the Ads account. 611 "status": "A String", # Status of the link between this Merchant Center account and the Ads account. Upon retrieval, it represents the actual status of the link and can be either active if it was approved in Google Ads or pending if it's pending approval. Upon insertion, it represents the intended status of the link. Re-uploading a link with status active when it's still pending or with status pending when it'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. 612 }, 613 ], 614 "businessInformation": { # The business information of the account. 615 "phoneNumber": "A String", # The phone number of the business. 616 "customerService": { # The customer service information of the business. 617 "url": "A String", # Customer service URL. 618 "phoneNumber": "A String", # Customer service phone number. 619 "email": "A String", # Customer service email. 620 }, 621 "address": { # The address of the business. 622 "postalCode": "A String", # Postal code or ZIP (e.g. "94043"). 623 "country": "A String", # CLDR country code (e.g. "US"). 624 "region": "A String", # Top-level administrative subdivision of the country. For example, a state like California ("CA") or a province like Quebec ("QC"). 625 "streetAddress": "A String", # Street-level part of the address. 626 "locality": "A String", # City, town or commune. May also include dependent localities or sublocalities (e.g. neighborhoods or suburbs). 627 }, 628 }, 629 "googleMyBusinessLink": { # The GMB account which is linked or in the process of being linked with the Merchant Center account. 630 "status": "A String", # Status of the link between this Merchant Center account and the GMB account. 631 "gmbEmail": "A String", # 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. 632 }, 633 "sellerId": "A String", # Client-specific, locally-unique, internal ID for the child account. 634 "id": "A String", # Merchant Center account ID. 635 "users": [ # Users with access to the account. Every account (except for subaccounts) must have at least one admin user. 636 { 637 "admin": True or False, # Whether user is an admin. 638 "orderManager": True or False, # Whether user is an order manager. 639 "paymentsAnalyst": True or False, # Whether user can access payment statements. 640 "emailAddress": "A String", # User's email address. 641 "paymentsManager": True or False, # Whether user can manage payment settings. 642 }, 643 ], 644 } 645 646 647Returns: 648 An object of the form: 649 650 { # Account data. After the creation of a new account it may take a few minutes before it is fully operational. The methods delete, insert, patch, and update require the admin role. 651 "kind": "content#account", # Identifies what kind of resource this is. Value: the fixed string "content#account". 652 "name": "A String", # Display name for the account. 653 "youtubeChannelLinks": [ # 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. 654 { 655 "status": "A String", # 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's pending approval. Upon insertion, it represents the intended status of the link. Re-uploading a link with status active when it's still pending or with status pending when it'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. 656 "channelId": "A String", # Channel ID. 657 }, 658 ], 659 "adultContent": True or False, # Indicates whether the merchant sells adult content. 660 "websiteUrl": "A String", # The merchant's website. 661 "adsLinks": [ # List of linked Ads 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 Ads interface or through the AdWords API. To delete an active link, or to cancel a link request, remove it from the list. 662 { 663 "adsId": "A String", # Customer ID of the Ads account. 664 "status": "A String", # Status of the link between this Merchant Center account and the Ads account. Upon retrieval, it represents the actual status of the link and can be either active if it was approved in Google Ads or pending if it's pending approval. Upon insertion, it represents the intended status of the link. Re-uploading a link with status active when it's still pending or with status pending when it'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. 665 }, 666 ], 667 "businessInformation": { # The business information of the account. 668 "phoneNumber": "A String", # The phone number of the business. 669 "customerService": { # The customer service information of the business. 670 "url": "A String", # Customer service URL. 671 "phoneNumber": "A String", # Customer service phone number. 672 "email": "A String", # Customer service email. 673 }, 674 "address": { # The address of the business. 675 "postalCode": "A String", # Postal code or ZIP (e.g. "94043"). 676 "country": "A String", # CLDR country code (e.g. "US"). 677 "region": "A String", # Top-level administrative subdivision of the country. For example, a state like California ("CA") or a province like Quebec ("QC"). 678 "streetAddress": "A String", # Street-level part of the address. 679 "locality": "A String", # City, town or commune. May also include dependent localities or sublocalities (e.g. neighborhoods or suburbs). 680 }, 681 }, 682 "googleMyBusinessLink": { # The GMB account which is linked or in the process of being linked with the Merchant Center account. 683 "status": "A String", # Status of the link between this Merchant Center account and the GMB account. 684 "gmbEmail": "A String", # 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. 685 }, 686 "sellerId": "A String", # Client-specific, locally-unique, internal ID for the child account. 687 "id": "A String", # Merchant Center account ID. 688 "users": [ # Users with access to the account. Every account (except for subaccounts) must have at least one admin user. 689 { 690 "admin": True or False, # Whether user is an admin. 691 "orderManager": True or False, # Whether user is an order manager. 692 "paymentsAnalyst": True or False, # Whether user can access payment statements. 693 "emailAddress": "A String", # User's email address. 694 "paymentsManager": True or False, # Whether user can manage payment settings. 695 }, 696 ], 697 }</pre> 698</div> 699 700</body></html>