Inserts or updates the attributes of the product in a Manufacturer Center account. Creates a product with the provided attributes. If the product already exists, then all attributes are replaced with the new ones. The checks at upload time are minimal. All required attributes need to be present for a product to be valid. Issues may show up later after the API has accepted a new upload for a product and it is possible to overwrite an existing valid product with an invalid product. To detect this, you should retrieve the product and check it for issues once the new version is available. Uploaded attributes first need to be processed before they can be retrieved. Until then, new products will be unavailable, and retrieval of previously uploaded products will return the original state of the product.

Scopes

You will need authorization for the https://www.googleapis.com/auth/manufacturercenter scope to make a valid call.

If unset, the scope for this method defaults to https://www.googleapis.com/auth/manufacturercenter. You can set the scope for this method like this: manufacturers1 --scope <scope> accounts products-update ...

Required Scalar Arguments

• <parent> (string)
  • Parent ID in the format accounts/{account_id}. account_id - The ID of the Manufacturer Center account.
• <name> (string)
  • Name in the format {target_country}:{content_language}:{product_id}. target_country - The target country of the product as a CLDR territory code (for example, US). content_language - The content language of the product as a two-letter ISO 639-1 language code (for example, en). product_id - The ID of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#id.

Required Request Value

The request value is a data-structure with various fields. Each field may be a simple scalar or another data-structure. In the latter case it is advised to set the field-cursor to the data-structure's field to specify values more concisely.

For example, a structure like this:

Attributes:
  age-group: string
  brand: string
  capacity:
    unit: string
    value: string
  color: string
  count:
    unit: string
    value: string
  description: string
  disclosure-date: string
  excluded-destination: [string]
  flavor: string
  format: string
  gender: string
  grocery:
    active-ingredients: string
    alcohol-by-volume: number
    allergens: string
    derived-nutrition-claim: [string]
    directions: string
    indications: string
    ingredients: string
    nutrition-claim: [string]
    storage-instructions: string
  gtin: [string]
  image-link:
    image-url: string
    status: string
    type: string
  included-destination: [string]
  item-group-id: string
  material: string
  mpn: string
  nutrition:
    added-sugars:
      amount: number
      unit: string
    added-sugars-daily-percentage: number
    calcium:
      amount: number
      unit: string
    calcium-daily-percentage: number
    cholesterol:
      amount: number
      unit: string
    cholesterol-daily-percentage: number
    dietary-fiber:
      amount: number
      unit: string
    dietary-fiber-daily-percentage: number
    energy:
      amount: number
      unit: string
    energy-from-fat:
      amount: number
      unit: string
    folate-daily-percentage: number
    folate-folic-acid:
      amount: number
      unit: string
    folate-mcg-dfe: number
    iron:
      amount: number
      unit: string
    iron-daily-percentage: number
    monounsaturated-fat:
      amount: number
      unit: string
    nutrition-fact-measure: string
    polyols:
      amount: number
      unit: string
    polyunsaturated-fat:
      amount: number
      unit: string
    potassium:
      amount: number
      unit: string
    potassium-daily-percentage: number
    prepared-size-description: string
    protein:
      amount: number
      unit: string
    protein-daily-percentage: number
    saturated-fat:
      amount: number
      unit: string
    saturated-fat-daily-percentage: number
    serving-size-description: string
    serving-size-measure:
      amount: number
      unit: string
    servings-per-container: string
    sodium:
      amount: number
      unit: string
    sodium-daily-percentage: number
    starch:
      amount: number
      unit: string
    total-carbohydrate:
      amount: number
      unit: string
    total-carbohydrate-daily-percentage: number
    total-fat:
      amount: number
      unit: string
    total-fat-daily-percentage: number
    total-sugars:
      amount: number
      unit: string
    total-sugars-daily-percentage: number
    trans-fat:
      amount: number
      unit: string
    trans-fat-daily-percentage: number
    vitamin-d:
      amount: number
      unit: string
    vitamin-d-daily-percentage: number
  pattern: string
  product-highlight: [string]
  product-line: string
  product-name: string
  product-page-url: string
  product-type: [string]
  release-date: string
  rich-product-content: [string]
  scent: string
  size: string
  size-system: string
  size-type: [string]
  suggested-retail-price:
    amount: string
    currency: string
  target-client-id: string
  theme: string
  title: string
  video-link: [string]
  virtual-model-link: string

can be set completely with the following arguments which are assumed to be executed in the given order. Note how the cursor position is adjusted to the respective structures, allowing simple field names to be used most of the time.

• -r . age-group=sed
  • The target age group of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#agegroup.
• brand=amet.
  • The brand name of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#brand.
• capacity unit=takimata
  • The unit of the capacity, i.e., MB, GB, or TB.

• value=amet.

  • The numeric value of the capacity.

• .. color=duo

  • The color of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#color.
• count unit=ipsum
  • The unit in which these products are counted.

• value=gubergren

  • The numeric value of the number of products in a package.

• .. description=lorem

  • The description of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#description.
• disclosure-date=gubergren
  • The disclosure date of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#disclosure.
• excluded-destination=eos
  • A list of excluded destinations such as "ClientExport", "ClientShoppingCatalog" or "PartnerShoppingCatalog". For more information, see https://support.google.com/manufacturers/answer/7443550
  • Each invocation of this argument appends the given value to the array.
• flavor=dolor
  • The flavor of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#flavor.
• format=ea
  • The format of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#format.
• gender=ipsum
  • The target gender of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#gender.
• grocery active-ingredients=invidunt
  • Active ingredients.
• alcohol-by-volume=0.42548765853373427
  • Alcohol by volume.
• allergens=duo
  • Allergens.
• derived-nutrition-claim=ipsum
  • Derived nutrition claim.
  • Each invocation of this argument appends the given value to the array.
• directions=sed
  • Directions.
• indications=ut
  • Indications.
• ingredients=gubergren
  • Ingredients.
• nutrition-claim=rebum.
  • Nutrition claim.
  • Each invocation of this argument appends the given value to the array.

• storage-instructions=est

  • Storage instructions.

• .. gtin=ipsum

  • The Global Trade Item Number (GTIN) of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#gtin.
  • Each invocation of this argument appends the given value to the array.
• image-link image-url=ipsum
  • The URL of the image. For crawled images, this is the provided URL. For uploaded images, this is a serving URL from Google if the image has been processed successfully.
• status=est
  • The status of the image. @OutputOnly

• type=gubergren

  • The type of the image, i.e., crawled or uploaded. @OutputOnly

• .. included-destination=ea

  • A list of included destinations such as "ClientExport", "ClientShoppingCatalog" or "PartnerShoppingCatalog". For more information, see https://support.google.com/manufacturers/answer/7443550
  • Each invocation of this argument appends the given value to the array.
• item-group-id=dolor
  • The item group id of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#itemgroupid.
• material=lorem
  • The material of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#material.
• mpn=eos
  • The Manufacturer Part Number (MPN) of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#mpn.
• nutrition.added-sugars amount=0.11853734747270994
  • amount.

• unit=duo

  • unit.

• .. added-sugars-daily-percentage=0.9575633866430626

  • Added sugars daily percentage.
• calcium amount=0.7957202632117738
  • amount.

• unit=no

  • unit.

• .. calcium-daily-percentage=0.6792626134346527

  • Calcium daily percentage.
• cholesterol amount=0.9217746474973857
  • amount.

• unit=et

  • unit.

• .. cholesterol-daily-percentage=0.45715758654038996

  • Cholesterol daily percentage.
• dietary-fiber amount=0.2648561880289837
  • amount.

• unit=vero

  • unit.

• .. dietary-fiber-daily-percentage=0.5477575441248734

  • Dietary fiber daily percentage.
• energy amount=0.6383502522516505
  • amount.

• unit=et

  • unit.

• ..energy-from-fat amount=0.9697780726648698

  • amount.

• unit=amet.

  • unit.

• .. folate-daily-percentage=0.04388040358005296

  • Folate daily percentage.
• folate-folic-acid amount=0.40747000249106957
  • amount.

• unit=et

  • unit.

• .. folate-mcg-dfe=0.901889097837698

  • Folate mcg DFE.
• iron amount=0.05383208152352925
  • amount.

• unit=dolor

  • unit.

• .. iron-daily-percentage=0.6349978834153693

  • Iron daily percentage.
• monounsaturated-fat amount=0.1970220513983837
  • amount.

• unit=stet

  • unit.

• .. nutrition-fact-measure=vero

  • Nutrition fact measure.
• polyols amount=0.4523282032393763
  • amount.

• unit=diam

  • unit.

• ..polyunsaturated-fat amount=0.31428290912855783

  • amount.

• unit=accusam

  • unit.

• ..potassium amount=0.333591971041029

  • amount.

• unit=voluptua.

  • unit.

• .. potassium-daily-percentage=0.7904276045322813

  • Potassium daily percentage.
• prepared-size-description=erat
  • Prepared size description.
• protein amount=0.04583256524798884
  • amount.

• unit=sed

  • unit.

• .. protein-daily-percentage=0.726541471822237

  • Protein daily percentage.
• saturated-fat amount=0.3072987560065821
  • amount.

• unit=et

  • unit.

• .. saturated-fat-daily-percentage=0.611403219211556

  • Saturated fat daily percentage.
• serving-size-description=voluptua.
  • Food Serving Size. Serving size description.
• serving-size-measure amount=0.5290758052968516
  • amount.

• unit=dolore

  • unit.

• .. servings-per-container=voluptua.

  • Servings per container.
• sodium amount=0.7753213022845796
  • amount.

• unit=sadipscing

  • unit.

• .. sodium-daily-percentage=0.7463638372321394

  • Sodium daily percentage.
• starch amount=0.7036393712200139
  • amount.

• unit=at

  • unit.

• ..total-carbohydrate amount=0.4551855025693473

  • amount.

• unit=sit

  • unit.

• .. total-carbohydrate-daily-percentage=0.8049890363387713

  • Total carbohydrate daily percentage.
• total-fat amount=0.4875873367661776
  • amount.

• unit=ipsum

  • unit.

• .. total-fat-daily-percentage=0.6542024592226057

  • Total fat daily percentage.
• total-sugars amount=0.9329847794220517
  • amount.

• unit=est

  • unit.

• .. total-sugars-daily-percentage=0.5583798423289809

  • Total sugars daily percentage.
• trans-fat amount=0.5689755800713993
  • amount.

• unit=dolores

  • unit.

• .. trans-fat-daily-percentage=0.261779375871928

  • Trans fat daily percentage.
• vitamin-d amount=0.7087562540955133
  • amount.

• unit=elitr

  • unit.

• .. vitamin-d-daily-percentage=0.9036304069319014

  • Vitamin D daily percentage.

• .. pattern=no

  • The pattern of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#pattern.
• product-highlight=nonumy
  • The product highlights. For more information, see https://support.google.com/manufacturers/answer/10066942
  • Each invocation of this argument appends the given value to the array.
• product-line=at
  • The name of the group of products related to the product. For more information, see https://support.google.com/manufacturers/answer/6124116#productline.
• product-name=sadipscing
  • The canonical name of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#productname.
• product-page-url=aliquyam
  • The URL of the detail page of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#productpage.
• product-type=dolores
  • The type or category of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#producttype.
  • Each invocation of this argument appends the given value to the array.
• release-date=sadipscing
  • The release date of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#release.
• rich-product-content=erat
  • Rich product content. For more information, see https://support.google.com/manufacturers/answer/9389865
  • Each invocation of this argument appends the given value to the array.
• scent=aliquyam
  • The scent of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#scent.
• size=amet
  • The size of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#size.
• size-system=est
  • The size system of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#sizesystem.
• size-type=et
  • The size type of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#sizetype.
  • Each invocation of this argument appends the given value to the array.
• suggested-retail-price amount=sea
  • The numeric value of the price.

• currency=consetetur

  • The currency in which the price is denoted.

• .. target-client-id=consetetur

  • The target client id. Should only be used in the accounts of the data partners. For more information, see https://support.google.com/manufacturers/answer/10857344
• theme=stet
  • The theme of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#theme.
• title=est
  • The title of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#title.
• video-link=aliquyam
  • The videos of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#video.
  • Each invocation of this argument appends the given value to the array.
• virtual-model-link=elitr
  • Virtual Model (3d) asset link.

About Cursors

The cursor position is key to comfortably set complex nested structures. The following rules apply:

• The cursor position is always set relative to the current one, unless the field name starts with the . character. Fields can be nested such as in -r f.s.o .
• The cursor position is set relative to the top-level structure if it starts with ., e.g. -r .s.s
• You can also set nested fields without setting the cursor explicitly. For example, to set a value relative to the current cursor position, you would specify -r struct.sub_struct=bar.
• You can move the cursor one level up by using ... Each additional . moves it up one additional level. E.g. ... would go three levels up.

Optional Output Flags

The method's return value a JSON encoded structure, which will be written to standard output by default.

• -o out
  • out specifies the destination to which to write the server's result to. It will be a JSON-encoded structure. The destination may be - to indicate standard output, or a filepath that is to contain the received bytes. If unset, it defaults to standard output.

Optional General Properties

The following properties can configure any call, and are not specific to this method.

• -p $-xgafv=string

  • V1 error format.

• -p access-token=string

  • OAuth access token.

• -p alt=string

  • Data format for response.

• -p callback=string

  • JSONP

• -p fields=string

  • Selector specifying which fields to include in a partial response.

• -p key=string

  • API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.

• -p oauth-token=string

  • OAuth 2.0 token for the current user.

• -p pretty-print=boolean

  • Returns response with indentations and line breaks.

• -p quota-user=string

  • Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.

• -p upload-type=string

  • Legacy upload protocol for media (e.g. "media", "multipart").

• -p upload-protocol=string

  • Upload protocol for media (e.g. "raw", "multipart").