REST Resource: accounts.languages.productCertifications

  • ProductCertification resource stores product certification data, including brand, MPNs, product codes, and associated certifications.

  • Certifications are linked to products via ProductCertification and contain details like certification name, authority, code, and validity.

  • Issues associated with products are automatically generated and categorized by severity, providing insights into potential problems and resolutions.

  • DestinationStatuses indicate the status of a product's certification for different destinations, such as whether it's active, pending, or disapproved.

  • Manufacturers can manage product certifications using methods like delete, get, list, and patch to control and update their product data.

Resource: ProductCertification

Product certification data.

JSON representation 
{
  "name": string,
  "title": string,
  "brand": string,
  "mpn": [
    string
  ],
  "productCode": [
    string
  ],
  "countryCode": [
    string
  ],
  "productType": [
    string
  ],
  "certification": [
    {
      object (Certification)
    }
  ],
  "issues": [
    {
      object (Issue)
    }
  ],
  "destinationStatuses": [
    {
      object (DestinationStatus)
    }
  ]
}
Fields
name

string

Required. The unique name identifier of a product certification Format: accounts/{account}/languages/{language_code}/productCertifications/{id} Where id is a some unique identifier and language_code is a 2-letter ISO 639-1 code of a Shopping supported language according to https://support.google.com/merchants/answer/160637.
title

string

Required. This is to clearly identify the product you are certifying.
brand

string

Required. This is the product's brand name. The brand is used to help identify your product.
mpn[]

string

Optional. These are the Manufacturer Part Numbers (MPN). MPNs are used to uniquely identify a specific product among all products from the same manufacturer
productCode[]

string

Optional. Another name for GTIN.
countryCode[]

string

Optional. A 2-letter country code (ISO 3166-1 Alpha 2).
productType[]

string

Optional. These are your own product categorization system in your product data.
certification[]

object (Certification)

Required. A list of certifications to link to the described product.
issues[]

object (Issue)

Output only. A server-generated list of issues associated with the product.
destinationStatuses[]

object (DestinationStatus)

Output only. The statuses of the destinations.

Certification

Description of a certification.

JSON representation 
{
  "name": string,
  "authority": string,
  "code": string,
  "value": string,
  "link": string,
  "logo": string,
  "validUntil": string
}
Fields
name

string

Required. Name of the certification.
authority

string

Required. Name of the certification body.
code

string

Optional. A unique code to identify the certification.
value

string

Optional. A custom value of the certification.
validUntil

string

Optional. The expiration date (UTC).

Issue

Product issue.

JSON representation 
{
  "type": string,
  "severity": enum (Severity),
  "attribute": string,
  "title": string,
  "description": string,
  "resolution": enum (IssueResolution),
  "destination": string,
  "timestamp": string,
  "applicableCountries": [
    string
  ]
}
Fields
type

string

The server-generated type of the issue, for example, “INCORRECT_TEXT_FORMATTING”, “IMAGE_NOT_SERVEABLE”, etc.
severity

enum (Severity)

The severity of the issue.
attribute

string

If present, the attribute that triggered the issue. For more information about attributes, see https://support.google.com/manufacturers/answer/6124116.
title

string

Short title describing the nature of the issue.
description

string

Longer description of the issue focused on how to resolve it.
resolution

enum (IssueResolution)

What needs to happen to resolve the issue.
destination

string

The destination this issue applies to.
timestamp

string (Timestamp format)

The timestamp when this issue appeared.

Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".
applicableCountries[]

string

Output only. List of country codes (ISO 3166-1 alpha-2) where issue applies to the manufacturer product.

Severity

Issue severity.

Enums
SEVERITY_UNSPECIFIED Unspecified severity, never used.
ERROR Error severity. The issue prevents the usage of the whole item.
WARNING Warning severity. The issue is either one that prevents the usage of the attribute that triggered it or one that will soon prevent the usage of the whole item.
INFO Info severity. The issue is one that doesn't require immediate attention. It is, for example, used to communicate which attributes are still pending review.

IssueResolution

Resolution of the issue.

Enums
RESOLUTION_UNSPECIFIED Unspecified resolution, never used.
USER_ACTION The user who provided the data must act in order to resolve the issue (for example by correcting some data).
PENDING_PROCESSING The issue will be resolved automatically (for example image crawl or Google review). No action is required now. Resolution might lead to another issue (for example if crawl fails).

DestinationStatus

The destination status.

JSON representation 
{
  "destination": string,
  "status": enum (Status),
  "approvedCountries": [
    string
  ],
  "pendingCountries": [
    string
  ],
  "disapprovedCountries": [
    string
  ]
}
Fields
destination

string

The name of the destination.
status

enum (Status)

The status of the destination.
approvedCountries[]

string

Output only. List of country codes (ISO 3166-1 alpha-2) where the offer is approved.
pendingCountries[]

string

Output only. List of country codes (ISO 3166-1 alpha-2) where the offer is pending approval.
disapprovedCountries[]

string

Output only. List of country codes (ISO 3166-1 alpha-2) where the offer is disapproved.

Status

The status.

Enums
UNKNOWN Unspecified status, never used.
ACTIVE The product is used for this destination.
PENDING The decision is still pending.
DISAPPROVED The product is disapproved. Please look at the issues.

Methods

delete

 Deletes a product certification by its name.

get

 Gets a product certification by its name.

list

 Lists product certifications from a specified certification body.

patch

 Updates (or creates if allow_missing = true) a product certification which links certifications with products.