GTINs (Global trade item numbers, often called barcodes) are used to match products with external sources. A main use case for this is syndicating product reviews to other platforms or Google PLA.

Each GTIN is specified using two fields. The declared type specifies the GTIN standard and the value fields holds the GTIN string value. A detected_type will be assigned to each GTIN based on the value format.

Field

Type

Description

declared_type
(required)

string

Valid values:

  • EAN
  • UPC
  • ISBN

value
(required)

string

The GTIN value.

detected_type
(read-only)

string

Valid values:

  • EAN
  • UPC
  • ISBN

Automatically detected by the format of the value.

📘

Note:

A product may have more than one GTIN. However, two GTINs with identical declared type and value cannot be added.