• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
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="manufacturers_v1.html">Manufacturer Center API</a> . <a href="manufacturers_v1.accounts.html">accounts</a> . <a href="manufacturers_v1.accounts.products.html">products</a></h1>
76<h2>Instance Methods</h2>
77<p class="toc_element">
78  <code><a href="#delete">delete(parent, name, x__xgafv=None)</a></code></p>
79<p class="firstline">Deletes the product from a Manufacturer Center account.</p>
80<p class="toc_element">
81  <code><a href="#get">get(parent, name, include=None, x__xgafv=None)</a></code></p>
82<p class="firstline">Gets the product from a Manufacturer Center account, including product</p>
83<p class="toc_element">
84  <code><a href="#list">list(parent, pageToken=None, x__xgafv=None, include=None, pageSize=None)</a></code></p>
85<p class="firstline">Lists all the products in a Manufacturer Center account.</p>
86<p class="toc_element">
87  <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
88<p class="firstline">Retrieves the next page of results.</p>
89<p class="toc_element">
90  <code><a href="#update">update(parent, name, body, x__xgafv=None)</a></code></p>
91<p class="firstline">Inserts or updates the attributes of the product in a Manufacturer Center</p>
92<h3>Method Details</h3>
93<div class="method">
94    <code class="details" id="delete">delete(parent, name, x__xgafv=None)</code>
95  <pre>Deletes the product from a Manufacturer Center account.
96
97Args:
98  parent: string, Parent ID in the format `accounts/{account_id}`.
99
100`account_id` - The ID of the Manufacturer Center account. (required)
101  name: string, Name in the format `{target_country}:{content_language}:{product_id}`.
102
103`target_country`   - The target country of the product as a CLDR territory
104                     code (for example, US).
105
106`content_language` - The content language of the product as a two-letter
107                     ISO 639-1 language code (for example, en).
108
109`product_id`     -   The ID of the product. For more information, see
110                     https://support.google.com/manufacturers/answer/6124116#id. (required)
111  x__xgafv: string, V1 error format.
112    Allowed values
113      1 - v1 error format
114      2 - v2 error format
115
116Returns:
117  An object of the form:
118
119    { # A generic empty message that you can re-use to avoid defining duplicated
120      # empty messages in your APIs. A typical example is to use it as the request
121      # or the response type of an API method. For instance:
122      #
123      #     service Foo {
124      #       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
125      #     }
126      #
127      # The JSON representation for `Empty` is empty JSON object `{}`.
128  }</pre>
129</div>
130
131<div class="method">
132    <code class="details" id="get">get(parent, name, include=None, x__xgafv=None)</code>
133  <pre>Gets the product from a Manufacturer Center account, including product
134issues.
135
136A recently updated product takes around 15 minutes to process. Changes are
137only visible after it has been processed. While some issues may be
138available once the product has been processed, other issues may take days
139to appear.
140
141Args:
142  parent: string, Parent ID in the format `accounts/{account_id}`.
143
144`account_id` - The ID of the Manufacturer Center account. (required)
145  name: string, Name in the format `{target_country}:{content_language}:{product_id}`.
146
147`target_country`   - The target country of the product as a CLDR territory
148                     code (for example, US).
149
150`content_language` - The content language of the product as a two-letter
151                     ISO 639-1 language code (for example, en).
152
153`product_id`     -   The ID of the product. For more information, see
154                     https://support.google.com/manufacturers/answer/6124116#id. (required)
155  include: string, The information to be included in the response. Only sections listed here
156will be returned. (repeated)
157  x__xgafv: string, V1 error format.
158    Allowed values
159      1 - v1 error format
160      2 - v2 error format
161
162Returns:
163  An object of the form:
164
165    { # Product data.
166    "parent": "A String", # Parent ID in the format `accounts/{account_id}`.
167        #
168        # `account_id` - The ID of the Manufacturer Center account.
169    "targetCountry": "A String", # The target country of the product as a CLDR territory code (for example,
170        # US).
171    "destinationStatuses": [ # The status of the destinations.
172      { # The destination status.
173        "status": "A String", # The status of the destination.
174        "destination": "A String", # The name of the destination.
175      },
176    ],
177    "contentLanguage": "A String", # The content language of the product as a two-letter ISO 639-1 language code
178        # (for example, en).
179    "attributes": { # Attributes of the product. For more information, see # Attributes of the product uploaded to the Manufacturer Center. Manually
180        # edited attributes are taken into account.
181        # https://support.google.com/manufacturers/answer/6124116.
182      "productLine": "A String", # The name of the group of products related to the product. For more
183          # information, see
184          # https://support.google.com/manufacturers/answer/6124116#productline.
185      "suggestedRetailPrice": { # A price. # The suggested retail price (MSRP) of the product. For more information,
186          # see https://support.google.com/manufacturers/answer/6124116#price.
187        "currency": "A String", # The currency in which the price is denoted.
188        "amount": "A String", # The numeric value of the price.
189      },
190      "color": "A String", # The color of the product. For more information, see
191          # https://support.google.com/manufacturers/answer/6124116#color.
192      "releaseDate": "A String", # The release date of the product. For more information, see
193          # https://support.google.com/manufacturers/answer/6124116#release.
194      "itemGroupId": "A String", # The item group id of the product. For more information, see
195          # https://support.google.com/manufacturers/answer/6124116#itemgroupid.
196      "gtin": [ # The Global Trade Item Number (GTIN) of the product. For more information,
197          # see https://support.google.com/manufacturers/answer/6124116#gtin.
198        "A String",
199      ],
200      "excludedDestination": [ # A list of excluded destinations.
201        "A String",
202      ],
203      "flavor": "A String", # The flavor of the product. For more information, see
204          # https://support.google.com/manufacturers/answer/6124116#flavor.
205      "targetClientId": "A String", # The target client id. Should only be used in the accounts of the data
206          # partners.
207      "scent": "A String", # The scent of the product. For more information, see
208          #  https://support.google.com/manufacturers/answer/6124116#scent.
209      "size": "A String", # The size of the product. For more information, see
210          # https://support.google.com/manufacturers/answer/6124116#size.
211      "capacity": { # The capacity of a product. For more information, see # The capacity of the product. For more information, see
212          # https://support.google.com/manufacturers/answer/6124116#capacity.
213          # https://support.google.com/manufacturers/answer/6124116#capacity.
214        "unit": "A String", # The unit of the capacity, i.e., MB, GB, or TB.
215        "value": "A String", # The numeric value of the capacity.
216      },
217      "title": "A String", # The title of the product. For more information, see
218          # https://support.google.com/manufacturers/answer/6124116#title.
219      "pattern": "A String", # The pattern of the product. For more information, see
220          # https://support.google.com/manufacturers/answer/6124116#pattern.
221      "disclosureDate": "A String", # The disclosure date of the product. For more information, see
222          # https://support.google.com/manufacturers/answer/6124116#disclosure.
223      "theme": "A String", # The theme of the product. For more information, see
224          # https://support.google.com/manufacturers/answer/6124116#theme.
225      "productDetail": [ # The details of the product. For more information, see
226          # https://support.google.com/manufacturers/answer/6124116#productdetail.
227        { # A product detail of the product. For more information, see
228            # https://support.google.com/manufacturers/answer/6124116#productdetail.
229          "attributeName": "A String", # The name of the attribute.
230          "attributeValue": "A String", # The value of the attribute.
231          "sectionName": "A String", # A short section name that can be reused between multiple product details.
232        },
233      ],
234      "includedDestination": [ # A list of included destinations.
235        "A String",
236      ],
237      "description": "A String", # The description of the product. For more information, see
238          # https://support.google.com/manufacturers/answer/6124116#description.
239      "format": "A String", # The format of the product. For more information, see
240          # https://support.google.com/manufacturers/answer/6124116#format.
241      "mpn": "A String", # The Manufacturer Part Number (MPN) of the product. For more information,
242          # see https://support.google.com/manufacturers/answer/6124116#mpn.
243      "brand": "A String", # The brand name of the product. For more information, see
244          # https://support.google.com/manufacturers/answer/6124116#brand.
245      "material": "A String", # The material of the product. For more information, see
246          # https://support.google.com/manufacturers/answer/6124116#material.
247      "productName": "A String", # The canonical name of the product. For more information, see
248          # https://support.google.com/manufacturers/answer/6124116#productname.
249      "featureDescription": [ # The rich format description of the product. For more information, see
250          # https://support.google.com/manufacturers/answer/6124116#featuredesc.
251        { # A feature description of the product. For more information, see
252            # https://support.google.com/manufacturers/answer/6124116#featuredesc.
253          "headline": "A String", # A short description of the feature.
254          "text": "A String", # A detailed description of the feature.
255          "image": { # An image. # An optional image describing the feature.
256            "status": "A String", # The status of the image.
257                # @OutputOnly
258            "imageUrl": "A String", # The URL of the image. For crawled images, this is the provided URL. For
259                # uploaded images, this is a serving URL from Google if the image has been
260                # processed successfully.
261            "type": "A String", # The type of the image, i.e., crawled or uploaded.
262                # @OutputOnly
263          },
264        },
265      ],
266      "sizeSystem": "A String", # The size system of the product. For more information, see
267          # https://support.google.com/manufacturers/answer/6124116#sizesystem.
268      "sizeType": "A String", # The size type of the product. For more information, see
269          # https://support.google.com/manufacturers/answer/6124116#sizetype.
270      "additionalImageLink": [ # The additional images of the product. For more information, see
271          # https://support.google.com/manufacturers/answer/6124116#addlimage.
272        { # An image.
273          "status": "A String", # The status of the image.
274              # @OutputOnly
275          "imageUrl": "A String", # The URL of the image. For crawled images, this is the provided URL. For
276              # uploaded images, this is a serving URL from Google if the image has been
277              # processed successfully.
278          "type": "A String", # The type of the image, i.e., crawled or uploaded.
279              # @OutputOnly
280        },
281      ],
282      "count": { # The number of products in a single package. For more information, see # The count of the product. For more information, see
283          # https://support.google.com/manufacturers/answer/6124116#count.
284          # https://support.google.com/manufacturers/answer/6124116#count.
285        "unit": "A String", # The unit in which these products are counted.
286        "value": "A String", # The numeric value of the number of products in a package.
287      },
288      "gender": "A String", # The target gender of the product. For more information, see
289          # https://support.google.com/manufacturers/answer/6124116#gender.
290      "productPageUrl": "A String", # The URL of the detail page of the product. For more information, see
291          # https://support.google.com/manufacturers/answer/6124116#productpage.
292      "imageLink": { # An image. # The image of the product. For more information, see
293          # https://support.google.com/manufacturers/answer/6124116#image.
294        "status": "A String", # The status of the image.
295            # @OutputOnly
296        "imageUrl": "A String", # The URL of the image. For crawled images, this is the provided URL. For
297            # uploaded images, this is a serving URL from Google if the image has been
298            # processed successfully.
299        "type": "A String", # The type of the image, i.e., crawled or uploaded.
300            # @OutputOnly
301      },
302      "productType": [ # The type or category of the product. For more information, see
303          # https://support.google.com/manufacturers/answer/6124116#producttype.
304        "A String",
305      ],
306      "videoLink": [ # The videos of the product. For more information, see
307          # https://support.google.com/manufacturers/answer/6124116#video.
308        "A String",
309      ],
310      "ageGroup": "A String", # The target age group of the product. For more information, see
311          # https://support.google.com/manufacturers/answer/6124116#agegroup.
312    },
313    "productId": "A String", # The ID of the product. For more information, see
314        # https://support.google.com/manufacturers/answer/6124116#id.
315    "issues": [ # A server-generated list of issues associated with the product.
316      { # Product issue.
317        "severity": "A String", # The severity of the issue.
318        "title": "A String", # Short title describing the nature of the issue.
319        "attribute": "A String", # If present, the attribute that triggered the issue. For more information
320            # about attributes, see
321            # https://support.google.com/manufacturers/answer/6124116.
322        "destination": "A String", # The destination this issue applies to.
323        "resolution": "A String", # What needs to happen to resolve the issue.
324        "timestamp": "A String", # The timestamp when this issue appeared.
325        "type": "A String", # The server-generated type of the issue, for example,
326            # “INCORRECT_TEXT_FORMATTING”, “IMAGE_NOT_SERVEABLE”, etc.
327        "description": "A String", # Longer description of the issue focused on how to resolve it.
328      },
329    ],
330    "name": "A String", # Name in the format `{target_country}:{content_language}:{product_id}`.
331        #
332        # `target_country`   - The target country of the product as a CLDR territory
333        #                      code (for example, US).
334        #
335        # `content_language` - The content language of the product as a two-letter
336        #                      ISO 639-1 language code (for example, en).
337        #
338        # `product_id`     -   The ID of the product. For more information, see
339        #                      https://support.google.com/manufacturers/answer/6124116#id.
340  }</pre>
341</div>
342
343<div class="method">
344    <code class="details" id="list">list(parent, pageToken=None, x__xgafv=None, include=None, pageSize=None)</code>
345  <pre>Lists all the products in a Manufacturer Center account.
346
347Args:
348  parent: string, Parent ID in the format `accounts/{account_id}`.
349
350`account_id` - The ID of the Manufacturer Center account. (required)
351  pageToken: string, The token returned by the previous request.
352  x__xgafv: string, V1 error format.
353    Allowed values
354      1 - v1 error format
355      2 - v2 error format
356  include: string, The information to be included in the response. Only sections listed here
357will be returned. (repeated)
358  pageSize: integer, Maximum number of product statuses to return in the response, used for
359paging.
360
361Returns:
362  An object of the form:
363
364    {
365    "nextPageToken": "A String", # The token for the retrieval of the next page of product statuses.
366    "products": [ # List of the products.
367      { # Product data.
368        "parent": "A String", # Parent ID in the format `accounts/{account_id}`.
369            #
370            # `account_id` - The ID of the Manufacturer Center account.
371        "targetCountry": "A String", # The target country of the product as a CLDR territory code (for example,
372            # US).
373        "destinationStatuses": [ # The status of the destinations.
374          { # The destination status.
375            "status": "A String", # The status of the destination.
376            "destination": "A String", # The name of the destination.
377          },
378        ],
379        "contentLanguage": "A String", # The content language of the product as a two-letter ISO 639-1 language code
380            # (for example, en).
381        "attributes": { # Attributes of the product. For more information, see # Attributes of the product uploaded to the Manufacturer Center. Manually
382            # edited attributes are taken into account.
383            # https://support.google.com/manufacturers/answer/6124116.
384          "productLine": "A String", # The name of the group of products related to the product. For more
385              # information, see
386              # https://support.google.com/manufacturers/answer/6124116#productline.
387          "suggestedRetailPrice": { # A price. # The suggested retail price (MSRP) of the product. For more information,
388              # see https://support.google.com/manufacturers/answer/6124116#price.
389            "currency": "A String", # The currency in which the price is denoted.
390            "amount": "A String", # The numeric value of the price.
391          },
392          "color": "A String", # The color of the product. For more information, see
393              # https://support.google.com/manufacturers/answer/6124116#color.
394          "releaseDate": "A String", # The release date of the product. For more information, see
395              # https://support.google.com/manufacturers/answer/6124116#release.
396          "itemGroupId": "A String", # The item group id of the product. For more information, see
397              # https://support.google.com/manufacturers/answer/6124116#itemgroupid.
398          "gtin": [ # The Global Trade Item Number (GTIN) of the product. For more information,
399              # see https://support.google.com/manufacturers/answer/6124116#gtin.
400            "A String",
401          ],
402          "excludedDestination": [ # A list of excluded destinations.
403            "A String",
404          ],
405          "flavor": "A String", # The flavor of the product. For more information, see
406              # https://support.google.com/manufacturers/answer/6124116#flavor.
407          "targetClientId": "A String", # The target client id. Should only be used in the accounts of the data
408              # partners.
409          "scent": "A String", # The scent of the product. For more information, see
410              #  https://support.google.com/manufacturers/answer/6124116#scent.
411          "size": "A String", # The size of the product. For more information, see
412              # https://support.google.com/manufacturers/answer/6124116#size.
413          "capacity": { # The capacity of a product. For more information, see # The capacity of the product. For more information, see
414              # https://support.google.com/manufacturers/answer/6124116#capacity.
415              # https://support.google.com/manufacturers/answer/6124116#capacity.
416            "unit": "A String", # The unit of the capacity, i.e., MB, GB, or TB.
417            "value": "A String", # The numeric value of the capacity.
418          },
419          "title": "A String", # The title of the product. For more information, see
420              # https://support.google.com/manufacturers/answer/6124116#title.
421          "pattern": "A String", # The pattern of the product. For more information, see
422              # https://support.google.com/manufacturers/answer/6124116#pattern.
423          "disclosureDate": "A String", # The disclosure date of the product. For more information, see
424              # https://support.google.com/manufacturers/answer/6124116#disclosure.
425          "theme": "A String", # The theme of the product. For more information, see
426              # https://support.google.com/manufacturers/answer/6124116#theme.
427          "productDetail": [ # The details of the product. For more information, see
428              # https://support.google.com/manufacturers/answer/6124116#productdetail.
429            { # A product detail of the product. For more information, see
430                # https://support.google.com/manufacturers/answer/6124116#productdetail.
431              "attributeName": "A String", # The name of the attribute.
432              "attributeValue": "A String", # The value of the attribute.
433              "sectionName": "A String", # A short section name that can be reused between multiple product details.
434            },
435          ],
436          "includedDestination": [ # A list of included destinations.
437            "A String",
438          ],
439          "description": "A String", # The description of the product. For more information, see
440              # https://support.google.com/manufacturers/answer/6124116#description.
441          "format": "A String", # The format of the product. For more information, see
442              # https://support.google.com/manufacturers/answer/6124116#format.
443          "mpn": "A String", # The Manufacturer Part Number (MPN) of the product. For more information,
444              # see https://support.google.com/manufacturers/answer/6124116#mpn.
445          "brand": "A String", # The brand name of the product. For more information, see
446              # https://support.google.com/manufacturers/answer/6124116#brand.
447          "material": "A String", # The material of the product. For more information, see
448              # https://support.google.com/manufacturers/answer/6124116#material.
449          "productName": "A String", # The canonical name of the product. For more information, see
450              # https://support.google.com/manufacturers/answer/6124116#productname.
451          "featureDescription": [ # The rich format description of the product. For more information, see
452              # https://support.google.com/manufacturers/answer/6124116#featuredesc.
453            { # A feature description of the product. For more information, see
454                # https://support.google.com/manufacturers/answer/6124116#featuredesc.
455              "headline": "A String", # A short description of the feature.
456              "text": "A String", # A detailed description of the feature.
457              "image": { # An image. # An optional image describing the feature.
458                "status": "A String", # The status of the image.
459                    # @OutputOnly
460                "imageUrl": "A String", # The URL of the image. For crawled images, this is the provided URL. For
461                    # uploaded images, this is a serving URL from Google if the image has been
462                    # processed successfully.
463                "type": "A String", # The type of the image, i.e., crawled or uploaded.
464                    # @OutputOnly
465              },
466            },
467          ],
468          "sizeSystem": "A String", # The size system of the product. For more information, see
469              # https://support.google.com/manufacturers/answer/6124116#sizesystem.
470          "sizeType": "A String", # The size type of the product. For more information, see
471              # https://support.google.com/manufacturers/answer/6124116#sizetype.
472          "additionalImageLink": [ # The additional images of the product. For more information, see
473              # https://support.google.com/manufacturers/answer/6124116#addlimage.
474            { # An image.
475              "status": "A String", # The status of the image.
476                  # @OutputOnly
477              "imageUrl": "A String", # The URL of the image. For crawled images, this is the provided URL. For
478                  # uploaded images, this is a serving URL from Google if the image has been
479                  # processed successfully.
480              "type": "A String", # The type of the image, i.e., crawled or uploaded.
481                  # @OutputOnly
482            },
483          ],
484          "count": { # The number of products in a single package. For more information, see # The count of the product. For more information, see
485              # https://support.google.com/manufacturers/answer/6124116#count.
486              # https://support.google.com/manufacturers/answer/6124116#count.
487            "unit": "A String", # The unit in which these products are counted.
488            "value": "A String", # The numeric value of the number of products in a package.
489          },
490          "gender": "A String", # The target gender of the product. For more information, see
491              # https://support.google.com/manufacturers/answer/6124116#gender.
492          "productPageUrl": "A String", # The URL of the detail page of the product. For more information, see
493              # https://support.google.com/manufacturers/answer/6124116#productpage.
494          "imageLink": { # An image. # The image of the product. For more information, see
495              # https://support.google.com/manufacturers/answer/6124116#image.
496            "status": "A String", # The status of the image.
497                # @OutputOnly
498            "imageUrl": "A String", # The URL of the image. For crawled images, this is the provided URL. For
499                # uploaded images, this is a serving URL from Google if the image has been
500                # processed successfully.
501            "type": "A String", # The type of the image, i.e., crawled or uploaded.
502                # @OutputOnly
503          },
504          "productType": [ # The type or category of the product. For more information, see
505              # https://support.google.com/manufacturers/answer/6124116#producttype.
506            "A String",
507          ],
508          "videoLink": [ # The videos of the product. For more information, see
509              # https://support.google.com/manufacturers/answer/6124116#video.
510            "A String",
511          ],
512          "ageGroup": "A String", # The target age group of the product. For more information, see
513              # https://support.google.com/manufacturers/answer/6124116#agegroup.
514        },
515        "productId": "A String", # The ID of the product. For more information, see
516            # https://support.google.com/manufacturers/answer/6124116#id.
517        "issues": [ # A server-generated list of issues associated with the product.
518          { # Product issue.
519            "severity": "A String", # The severity of the issue.
520            "title": "A String", # Short title describing the nature of the issue.
521            "attribute": "A String", # If present, the attribute that triggered the issue. For more information
522                # about attributes, see
523                # https://support.google.com/manufacturers/answer/6124116.
524            "destination": "A String", # The destination this issue applies to.
525            "resolution": "A String", # What needs to happen to resolve the issue.
526            "timestamp": "A String", # The timestamp when this issue appeared.
527            "type": "A String", # The server-generated type of the issue, for example,
528                # “INCORRECT_TEXT_FORMATTING”, “IMAGE_NOT_SERVEABLE”, etc.
529            "description": "A String", # Longer description of the issue focused on how to resolve it.
530          },
531        ],
532        "name": "A String", # Name in the format `{target_country}:{content_language}:{product_id}`.
533            #
534            # `target_country`   - The target country of the product as a CLDR territory
535            #                      code (for example, US).
536            #
537            # `content_language` - The content language of the product as a two-letter
538            #                      ISO 639-1 language code (for example, en).
539            #
540            # `product_id`     -   The ID of the product. For more information, see
541            #                      https://support.google.com/manufacturers/answer/6124116#id.
542      },
543    ],
544  }</pre>
545</div>
546
547<div class="method">
548    <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
549  <pre>Retrieves the next page of results.
550
551Args:
552  previous_request: The request for the previous page. (required)
553  previous_response: The response from the request for the previous page. (required)
554
555Returns:
556  A request object that you can call 'execute()' on to request the next
557  page. Returns None if there are no more items in the collection.
558    </pre>
559</div>
560
561<div class="method">
562    <code class="details" id="update">update(parent, name, body, x__xgafv=None)</code>
563  <pre>Inserts or updates the attributes of the product in a Manufacturer Center
564account.
565
566Creates a product with the provided attributes. If the product already
567exists, then all attributes are replaced with the new ones. The checks at
568upload time are minimal. All required attributes need to be present for a
569product to be valid. Issues may show up later after the API has accepted a
570new upload for a product and it is possible to overwrite an existing valid
571product with an invalid product. To detect this, you should retrieve the
572product and check it for issues once the new version is available.
573
574Uploaded attributes first need to be processed before they can be
575retrieved. Until then, new products will be unavailable, and retrieval
576of previously uploaded products will return the original state of the
577product.
578
579Args:
580  parent: string, Parent ID in the format `accounts/{account_id}`.
581
582`account_id` - The ID of the Manufacturer Center account. (required)
583  name: string, Name in the format `{target_country}:{content_language}:{product_id}`.
584
585`target_country`   - The target country of the product as a CLDR territory
586                     code (for example, US).
587
588`content_language` - The content language of the product as a two-letter
589                     ISO 639-1 language code (for example, en).
590
591`product_id`     -   The ID of the product. For more information, see
592                     https://support.google.com/manufacturers/answer/6124116#id. (required)
593  body: object, The request body. (required)
594    The object takes the form of:
595
596{ # Attributes of the product. For more information, see
597    # https://support.google.com/manufacturers/answer/6124116.
598  "productLine": "A String", # The name of the group of products related to the product. For more
599      # information, see
600      # https://support.google.com/manufacturers/answer/6124116#productline.
601  "suggestedRetailPrice": { # A price. # The suggested retail price (MSRP) of the product. For more information,
602      # see https://support.google.com/manufacturers/answer/6124116#price.
603    "currency": "A String", # The currency in which the price is denoted.
604    "amount": "A String", # The numeric value of the price.
605  },
606  "color": "A String", # The color of the product. For more information, see
607      # https://support.google.com/manufacturers/answer/6124116#color.
608  "releaseDate": "A String", # The release date of the product. For more information, see
609      # https://support.google.com/manufacturers/answer/6124116#release.
610  "itemGroupId": "A String", # The item group id of the product. For more information, see
611      # https://support.google.com/manufacturers/answer/6124116#itemgroupid.
612  "gtin": [ # The Global Trade Item Number (GTIN) of the product. For more information,
613      # see https://support.google.com/manufacturers/answer/6124116#gtin.
614    "A String",
615  ],
616  "excludedDestination": [ # A list of excluded destinations.
617    "A String",
618  ],
619  "flavor": "A String", # The flavor of the product. For more information, see
620      # https://support.google.com/manufacturers/answer/6124116#flavor.
621  "targetClientId": "A String", # The target client id. Should only be used in the accounts of the data
622      # partners.
623  "scent": "A String", # The scent of the product. For more information, see
624      #  https://support.google.com/manufacturers/answer/6124116#scent.
625  "size": "A String", # The size of the product. For more information, see
626      # https://support.google.com/manufacturers/answer/6124116#size.
627  "capacity": { # The capacity of a product. For more information, see # The capacity of the product. For more information, see
628      # https://support.google.com/manufacturers/answer/6124116#capacity.
629      # https://support.google.com/manufacturers/answer/6124116#capacity.
630    "unit": "A String", # The unit of the capacity, i.e., MB, GB, or TB.
631    "value": "A String", # The numeric value of the capacity.
632  },
633  "title": "A String", # The title of the product. For more information, see
634      # https://support.google.com/manufacturers/answer/6124116#title.
635  "pattern": "A String", # The pattern of the product. For more information, see
636      # https://support.google.com/manufacturers/answer/6124116#pattern.
637  "disclosureDate": "A String", # The disclosure date of the product. For more information, see
638      # https://support.google.com/manufacturers/answer/6124116#disclosure.
639  "theme": "A String", # The theme of the product. For more information, see
640      # https://support.google.com/manufacturers/answer/6124116#theme.
641  "productDetail": [ # The details of the product. For more information, see
642      # https://support.google.com/manufacturers/answer/6124116#productdetail.
643    { # A product detail of the product. For more information, see
644        # https://support.google.com/manufacturers/answer/6124116#productdetail.
645      "attributeName": "A String", # The name of the attribute.
646      "attributeValue": "A String", # The value of the attribute.
647      "sectionName": "A String", # A short section name that can be reused between multiple product details.
648    },
649  ],
650  "includedDestination": [ # A list of included destinations.
651    "A String",
652  ],
653  "description": "A String", # The description of the product. For more information, see
654      # https://support.google.com/manufacturers/answer/6124116#description.
655  "format": "A String", # The format of the product. For more information, see
656      # https://support.google.com/manufacturers/answer/6124116#format.
657  "mpn": "A String", # The Manufacturer Part Number (MPN) of the product. For more information,
658      # see https://support.google.com/manufacturers/answer/6124116#mpn.
659  "brand": "A String", # The brand name of the product. For more information, see
660      # https://support.google.com/manufacturers/answer/6124116#brand.
661  "material": "A String", # The material of the product. For more information, see
662      # https://support.google.com/manufacturers/answer/6124116#material.
663  "productName": "A String", # The canonical name of the product. For more information, see
664      # https://support.google.com/manufacturers/answer/6124116#productname.
665  "featureDescription": [ # The rich format description of the product. For more information, see
666      # https://support.google.com/manufacturers/answer/6124116#featuredesc.
667    { # A feature description of the product. For more information, see
668        # https://support.google.com/manufacturers/answer/6124116#featuredesc.
669      "headline": "A String", # A short description of the feature.
670      "text": "A String", # A detailed description of the feature.
671      "image": { # An image. # An optional image describing the feature.
672        "status": "A String", # The status of the image.
673            # @OutputOnly
674        "imageUrl": "A String", # The URL of the image. For crawled images, this is the provided URL. For
675            # uploaded images, this is a serving URL from Google if the image has been
676            # processed successfully.
677        "type": "A String", # The type of the image, i.e., crawled or uploaded.
678            # @OutputOnly
679      },
680    },
681  ],
682  "sizeSystem": "A String", # The size system of the product. For more information, see
683      # https://support.google.com/manufacturers/answer/6124116#sizesystem.
684  "sizeType": "A String", # The size type of the product. For more information, see
685      # https://support.google.com/manufacturers/answer/6124116#sizetype.
686  "additionalImageLink": [ # The additional images of the product. For more information, see
687      # https://support.google.com/manufacturers/answer/6124116#addlimage.
688    { # An image.
689      "status": "A String", # The status of the image.
690          # @OutputOnly
691      "imageUrl": "A String", # The URL of the image. For crawled images, this is the provided URL. For
692          # uploaded images, this is a serving URL from Google if the image has been
693          # processed successfully.
694      "type": "A String", # The type of the image, i.e., crawled or uploaded.
695          # @OutputOnly
696    },
697  ],
698  "count": { # The number of products in a single package. For more information, see # The count of the product. For more information, see
699      # https://support.google.com/manufacturers/answer/6124116#count.
700      # https://support.google.com/manufacturers/answer/6124116#count.
701    "unit": "A String", # The unit in which these products are counted.
702    "value": "A String", # The numeric value of the number of products in a package.
703  },
704  "gender": "A String", # The target gender of the product. For more information, see
705      # https://support.google.com/manufacturers/answer/6124116#gender.
706  "productPageUrl": "A String", # The URL of the detail page of the product. For more information, see
707      # https://support.google.com/manufacturers/answer/6124116#productpage.
708  "imageLink": { # An image. # The image of the product. For more information, see
709      # https://support.google.com/manufacturers/answer/6124116#image.
710    "status": "A String", # The status of the image.
711        # @OutputOnly
712    "imageUrl": "A String", # The URL of the image. For crawled images, this is the provided URL. For
713        # uploaded images, this is a serving URL from Google if the image has been
714        # processed successfully.
715    "type": "A String", # The type of the image, i.e., crawled or uploaded.
716        # @OutputOnly
717  },
718  "productType": [ # The type or category of the product. For more information, see
719      # https://support.google.com/manufacturers/answer/6124116#producttype.
720    "A String",
721  ],
722  "videoLink": [ # The videos of the product. For more information, see
723      # https://support.google.com/manufacturers/answer/6124116#video.
724    "A String",
725  ],
726  "ageGroup": "A String", # The target age group of the product. For more information, see
727      # https://support.google.com/manufacturers/answer/6124116#agegroup.
728}
729
730  x__xgafv: string, V1 error format.
731    Allowed values
732      1 - v1 error format
733      2 - v2 error format
734
735Returns:
736  An object of the form:
737
738    { # A generic empty message that you can re-use to avoid defining duplicated
739      # empty messages in your APIs. A typical example is to use it as the request
740      # or the response type of an API method. For instance:
741      #
742      #     service Foo {
743      #       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
744      #     }
745      #
746      # The JSON representation for `Empty` is empty JSON object `{}`.
747  }</pre>
748</div>
749
750</body></html>