Show / Hide Table of Contents

Class ProductInput

This resource represents input data you submit for a product, not the processed product that you see in Merchant Center, in Shopping ads, or across Google surfaces. Product inputs, rules and supplemental data source data are combined to create the processed [Product][google.shopping.merchant.products.v1beta.Product].

Required product input attributes to pass data validation checks are primarily defined in the Products Data Specification.

The following attributes are required: [feedLabel][google.shopping.merchant.products.v1beta.Product.feed_label], [contentLanguage][google.shopping.merchant.products.v1beta.Product.content_language] and [offerId][google.shopping.merchant.products.v1beta.Product.offer_id].

After inserting, updating, or deleting a product input, it may take several minutes before the processed product can be retrieved.

All fields in the product input and its sub-messages match the English name of their corresponding attribute in the vertical spec with some exceptions.

Inheritance
object
ProductInput
Implements
IMessage<ProductInput>
IEquatable<ProductInput>
IDeepCloneable<ProductInput>
IBufferMessage
IMessage
Inherited Members
object.GetHashCode()
object.GetType()
object.ToString()
Namespace: Google.Shopping.Merchant.Products.V1Beta
Assembly: Google.Shopping.Merchant.Products.V1Beta.dll
Syntax
public sealed class ProductInput : IMessage<ProductInput>, IEquatable<ProductInput>, IDeepCloneable<ProductInput>, IBufferMessage, IMessage

Constructors

ProductInput()

Declaration
public ProductInput()

ProductInput(ProductInput)

Declaration
public ProductInput(ProductInput other)
Parameters
Type Name Description
ProductInput other

Properties

Attributes

Optional. A list of product attributes.

Declaration
public Attributes Attributes { get; set; }
Property Value
Type Description
Attributes

Channel

Immutable. The channel of the product.

Declaration
public Channel.Types.ChannelEnum Channel { get; set; }
Property Value
Type Description
Channel.Types.ChannelEnum

ContentLanguage

Required. Immutable. The two-letter ISO 639-1 language code for the product.

Declaration
public string ContentLanguage { get; set; }
Property Value
Type Description
string

CustomAttributes

Optional. A list of custom (merchant-provided) attributes. It can also be used for submitting any attribute of the data specification in its generic form (for example, { "name": "size type", "value": "regular" }). This is useful for submitting attributes not explicitly exposed by the API, such as additional attributes used for Buy on Google. Maximum allowed number of characters for each custom attribute is 10240 (represents sum of characters for name and value). Maximum 2500 custom attributes can be set per product, with total size of 102.4kB. Underscores in custom attribute names are replaced by spaces upon insertion.

Declaration
public RepeatedField<CustomAttribute> CustomAttributes { get; }
Property Value
Type Description
RepeatedField<CustomAttribute>

FeedLabel

Required. Immutable. The feed label for the product.

Declaration
public string FeedLabel { get; set; }
Property Value
Type Description
string

HasVersionNumber

Gets whether the "version_number" field is set

Declaration
public bool HasVersionNumber { get; }
Property Value
Type Description
bool

Name

Identifier. The name of the product input. Format: accounts/{account}/productInputs/{productinput} where the last section productinput consists of 4 parts: channel~content_language~feed_label~offer_id example for product input name is "accounts/123/productInputs/online~en~US~sku123"

Declaration
public string Name { get; set; }
Property Value
Type Description
string

OfferId

Required. Immutable. Your unique identifier for the product. This is the same for the product input and processed product. Leading and trailing whitespaces are stripped and multiple whitespaces are replaced by a single whitespace upon submission. See the products data specification for details.

Declaration
public string OfferId { get; set; }
Property Value
Type Description
string

Product

Output only. The name of the processed product. Format: "{product.name=accounts/{account}/products/{product}}"

Declaration
public string Product { get; set; }
Property Value
Type Description
string

ProductInputName

ProductInputName-typed view over the Name resource name property.

Declaration
public ProductInputName ProductInputName { get; set; }
Property Value
Type Description
ProductInputName

VersionNumber

Optional. Represents the existing version (freshness) of the product, which can be used to preserve the right order when multiple updates are done at the same time.

If set, the insertion is prevented when version number is lower than the current version number of the existing product. Re-insertion (for example, product refresh after 30 days) can be performed with the current version_number.

Only supported for insertions into primary data sources.

If the operation is prevented, the aborted exception will be thrown.

Declaration
public long VersionNumber { get; set; }
Property Value
Type Description
long
In this article
Back to top Generated by DocFX