Content API for Shopping . accountsbyexternalsellerid

Instance Methods

close()

Close httplib2 connections.

get(merchantId, externalSellerId, x__xgafv=None)

Gets data of the account with the specified external_seller_id belonging to the MCA with the specified merchant_id.

Method Details

close()
Close httplib2 connections.
get(merchantId, externalSellerId, x__xgafv=None)
Gets data of the account with the specified external_seller_id belonging to the MCA with the specified merchant_id.

Args:
  merchantId: string, Required. The ID of the MCA containing the seller. (required)
  externalSellerId: string, Required. The External Seller ID of the seller account to be retrieved. (required)
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # Account data. After the creation of a new account it may take a few minutes before it's fully operational. The methods delete, insert, and update require the admin role.
  "accountManagement": "A String", # Output only. How the account is managed. Acceptable values are: - "`manual`" - "`automatic`"
  "adsLinks": [ # 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.
    {
      "adsId": "A String", # Customer ID of the Ads account.
      "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. Acceptable values are: - "`active`" - "`pending`"
    },
  ],
  "adultContent": True or False, # Indicates whether the merchant sells adult content.
  "automaticImprovements": { # The automatic improvements of the account can be used to automatically update items, improve images and shipping. # The automatic improvements of the account can be used to automatically update items, improve images and shipping. Each section inside AutomaticImprovements is updated separately.
    "imageImprovements": { # This improvement will attempt to automatically correct submitted images if they don't meet the [image requirements](https://support.google.com/merchants/answer/6324350), for example, removing overlays. If successful, the image will be replaced and approved. This improvement is only applied to images of disapproved offers. For more information see: [Automatic image improvements](https://support.google.com/merchants/answer/9242973) # This improvement will attempt to automatically correct submitted images if they don't meet the [image requirements](https://support.google.com/merchants/answer/6324350), for example, removing overlays. If successful, the image will be replaced and approved. This improvement is only applied to images of disapproved offers. For more information see: [Automatic image improvements](https://support.google.com/merchants/answer/9242973) This field is only updated (cleared) if provided.
      "accountImageImprovementsSettings": { # Settings for the Automatic Image Improvements. # Determines how the images should be automatically updated. If this field is not present, then the settings will be deleted. If there are no settings for subaccount, they are inherited from aggregator.
        "allowAutomaticImageImprovements": True or False, # Enables automatic image improvements.
      },
      "effectiveAllowAutomaticImageImprovements": True or False, # Output only. The effective value of allow_automatic_image_improvements. If account_image_improvements_settings is present, then this value is the same. Otherwise, it represents the inherited value of the parent account. Read-only.
    },
    "itemUpdates": { # Turning on [item updates](https://support.google.com/merchants/answer/3246284) allows Google to automatically update items for you. When item updates are on, Google uses the structured data markup on the website and advanced data extractors to update the price and availability of the items. When the item updates are off, items with mismatched data aren't shown. # Turning on [item updates](https://support.google.com/merchants/answer/3246284) allows Google to automatically update items for you. When item updates are on, Google uses the structured data markup on the website and advanced data extractors to update the price and availability of the items. When the item updates are off, items with mismatched data aren't shown. This field is only updated (cleared) if provided.
      "accountItemUpdatesSettings": { # Settings for the Automatic Item Updates. # Determines which attributes of the items should be automatically updated. If this field is not present, then the settings will be deleted. If there are no settings for subaccount, they are inherited from aggregator.
        "allowAvailabilityUpdates": True or False, # If availability updates are enabled, any previous availability values get overwritten if Google finds an out-of-stock annotation on the offer's page. If additionally `allow_availability_updates` field is set to true, values get overwritten if Google finds an in-stock annotation on the offer’s page.
        "allowConditionUpdates": True or False, # If condition updates are enabled, Google always updates item condition with the condition detected from the details of your product.
        "allowPriceUpdates": True or False, # If price updates are enabled, Google always updates the active price with the crawled information.
        "allowStrictAvailabilityUpdates": True or False, # If allow_availability_updates is enabled, items are automatically updated in all your Shopping target countries. By default, availability updates will only be applied to items that are 'out of stock' on your website but 'in stock' on Shopping. Set this to true to also update items that are 'in stock' on your website, but 'out of stock' on Google Shopping. In order for this field to have an effect, you must also allow availability updates.
      },
      "effectiveAllowAvailabilityUpdates": True or False, # Output only. The effective value of allow_availability_updates. If account_item_updates_settings is present, then this value is the same. Otherwise, it represents the inherited value of the parent account. Read-only.
      "effectiveAllowConditionUpdates": True or False, # Output only. The effective value of allow_condition_updates. If account_item_updates_settings is present, then this value is the same. Otherwise, it represents the inherited value of the parent account. Read-only.
      "effectiveAllowPriceUpdates": True or False, # Output only. The effective value of allow_price_updates. If account_item_updates_settings is present, then this value is the same. Otherwise, it represents the inherited value of the parent account. Read-only.
      "effectiveAllowStrictAvailabilityUpdates": True or False, # Output only. The effective value of allow_strict_availability_updates. If account_item_updates_settings is present, then this value is the same. Otherwise, it represents the inherited value of the parent account. Read-only.
    },
    "shippingImprovements": { # Not available for MCAs [accounts](https://support.google.com/merchants/answer/188487). By turning on [automatic shipping improvements](https://support.google.com/merchants/answer/10027038), you are allowing Google to improve the accuracy of your delivery times shown to shoppers using Google. More accurate delivery times, especially when faster, typically lead to better conversion rates. Google will improve your estimated delivery times based on various factors: * Delivery address of an order * Current handling time and shipping time settings * Estimated weekdays or business days * Parcel tracking data # Not available for MCAs [accounts](https://support.google.com/merchants/answer/188487). By turning on [automatic shipping improvements](https://support.google.com/merchants/answer/10027038), you are allowing Google to improve the accuracy of your delivery times shown to shoppers using Google. More accurate delivery times, especially when faster, typically lead to better conversion rates. Google will improve your estimated delivery times based on various factors: - Delivery address of an order - Current handling time and shipping time settings - Estimated weekdays or business days - Parcel tracking data This field is only updated (cleared) if provided.
      "allowShippingImprovements": True or False, # Enables automatic shipping improvements.
    },
  },
  "automaticLabelIds": [ # Automatically created label IDs that are assigned to the account by CSS Center.
    "A String",
  ],
  "businessInformation": { # The business information of the account.
    "address": { # The address of the business. Use `\n` to add a second address line.
      "country": "A String", # CLDR country code (for example, "US"). All MCA sub-accounts inherit the country of their parent MCA by default, however the country can be updated for individual sub-accounts.
      "locality": "A String", # City, town or commune. May also include dependent localities or sublocalities (for example, neighborhoods or suburbs).
      "postalCode": "A String", # Postal code or ZIP (for example, "94043").
      "region": "A String", # Top-level administrative subdivision of the country. For example, a state like California ("CA") or a province like Quebec ("QC").
      "streetAddress": "A String", # Street-level part of the address. Use `\n` to add a second line.
    },
    "customerService": { # The customer service information of the business.
      "email": "A String", # Customer service email.
      "phoneNumber": "A String", # Customer service phone number.
      "url": "A String", # Customer service URL.
    },
    "koreanBusinessRegistrationNumber": "A String", # The 10-digit [Korean business registration number](https://support.google.com/merchants/answer/9037766) separated with dashes in the format: XXX-XX-XXXXX. This field will only be updated if explicitly set.
    "phoneNumber": "A String", # The phone number of the business. This can only be updated if a verified phone number is not already set. To replace a verified phone number use the `Accounts.requestphoneverification` and `Accounts.verifyphonenumber`.
    "phoneVerificationStatus": "A String", # Verification status of the phone number of the business. This status is read only and can be updated only by successful phone verification. Acceptable values are: - "`verified`" - "`unverified`"
  },
  "cssId": "A String", # ID of CSS the account belongs to.
  "googleMyBusinessLink": { # The Business Profile which is linked or in the process of being linked with the Merchant Center account.
    "gmbAccountId": "A String", # The ID of the Business Profile. If this is provided, then `gmbEmail` is ignored. The value of this field should match the `accountId` used by the Business Profile API.
    "gmbEmail": "A String", # The Business Profile email address of a specific account within a Business Profile. A sample account within a Business Profile could be a business account with set of locations, managed under the Business Profile.
    "status": "A String", # Status of the link between this Merchant Center account and the Business Profile. Acceptable values are: - "`active`" - "`pending`"
  },
  "id": "A String", # Required for update. Merchant Center account ID.
  "kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "`content#account`".
  "labelIds": [ # Manually created label IDs that are assigned to the account by CSS.
    "A String",
  ],
  "name": "A String", # Required. Display name for the account.
  "sellerId": "A String", # Client-specific, locally-unique, internal ID for the child account.
  "users": [ # Users with access to the account. Every account (except for subaccounts) must have at least one admin user.
    {
      "admin": True or False, # Whether user is an admin.
      "emailAddress": "A String", # User's email address.
      "orderManager": True or False, # Whether user is an order manager.
      "paymentsAnalyst": True or False, # Whether user can access payment statements.
      "paymentsManager": True or False, # Whether user can manage payment settings.
      "reportingManager": True or False, # Whether user is a reporting manager.
    },
  ],
  "websiteUrl": "A String", # The merchant's website.
  "youtubeChannelLinks": [ # 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.
    {
      "channelId": "A String", # Channel ID.
      "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.
    },
  ],
}