Manufacturer Center API . accounts . languages . productCertifications

Instance Methods

close()

Close httplib2 connections.

delete(name, x__xgafv=None)

Deletes a product certification by its name. This method can only be called by certification bodies.

get(name, x__xgafv=None)

Gets a product certification by its name. This method can only be called by certification bodies.

list(parent, pageSize=None, pageToken=None, x__xgafv=None)

Lists product certifications from a specified certification body. This method can only be called by certification bodies.

list_next()

Retrieves the next page of results.

patch(name, body=None, updateMask=None, x__xgafv=None)

Updates (or creates if allow_missing = true) a product certification which links certifications with products. This method can only be called by certification bodies.

Method Details

close()
Close httplib2 connections.
delete(name, x__xgafv=None)
Deletes a product certification by its name. This method can only be called by certification bodies.

Args:
  name: string, Required. The name of the product certification to delete. Format: accounts/{account}/languages/{language_code}/productCertifications/{id} (required)
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }
}
get(name, x__xgafv=None)
Gets a product certification by its name. This method can only be called by certification bodies.

Args:
  name: string, Required. The name of the product certification to get. Format: accounts/{account}/languages/{language_code}/productCertifications/{id} (required)
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # Product certification data.
  "brand": "A String", # Required. This is the product's brand name. The brand is used to help identify your product.
  "certification": [ # Required. A list of certifications to link to the described product.
    { # Description of a certification.
      "authority": "A String", # Required. Name of the certification body.
      "code": "A String", # Required. A unique code to identify the certification.
      "link": "A String", # Optional. A URL link to the certification.
      "logo": "A String", # Optional. A URL link to the certification logo.
      "name": "A String", # Required. Name of the certification.
      "validUntil": "A String", # Optional. The expiration date (UTC).
      "value": "A String", # Optional. A custom value of the certification.
    },
  ],
  "countryCode": [ # Optional. A 2-letter country code (ISO 3166-1 Alpha 2).
    "A String",
  ],
  "destinationStatuses": [ # Output only. The statuses of the destinations.
    { # The destination status.
      "destination": "A String", # The name of the destination.
      "status": "A String", # The status of the destination.
    },
  ],
  "issues": [ # Output only. A server-generated list of issues associated with the product.
    { # Product issue.
      "attribute": "A String", # If present, the attribute that triggered the issue. For more information about attributes, see https://support.google.com/manufacturers/answer/6124116.
      "description": "A String", # Longer description of the issue focused on how to resolve it.
      "destination": "A String", # The destination this issue applies to.
      "resolution": "A String", # What needs to happen to resolve the issue.
      "severity": "A String", # The severity of the issue.
      "timestamp": "A String", # The timestamp when this issue appeared.
      "title": "A String", # Short title describing the nature of the issue.
      "type": "A String", # The server-generated type of the issue, for example, “INCORRECT_TEXT_FORMATTING”, “IMAGE_NOT_SERVEABLE”, etc.
    },
  ],
  "mpn": [ # Optional. These are the Manufacturer Part Numbers (MPN). MPNs are used to uniquely identify a specific product among all products from the same manufacturer
    "A String",
  ],
  "name": "A 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.
  "productCode": [ # Optional. Another name for GTIN.
    "A String",
  ],
  "productType": [ # Optional. These are your own product categorization system in your product data.
    "A String",
  ],
  "title": "A String", # Required. This is to clearly identify the product you are certifying.
}
list(parent, pageSize=None, pageToken=None, x__xgafv=None)
Lists product certifications from a specified certification body. This method can only be called by certification bodies.

Args:
  parent: string, Required. The parent, which owns this collection of product certifications. Format: accounts/{account}/languages/{language_code} (required)
  pageSize: integer, Optional. The maximum number of product certifications to return. The service may return fewer than this value. If unspecified, at most 50 product certifications will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.
  pageToken: string, Optional. A page token, received from a previous `ListProductCertifications` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListProductCertifications` must match the call that provided the page token. Required if requesting the second or higher page.
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # Response for ListProductCertifications method.
  "nextPageToken": "A String", # A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.
  "productCertifications": [ # The product certifications from the specified certification body.
    { # Product certification data.
      "brand": "A String", # Required. This is the product's brand name. The brand is used to help identify your product.
      "certification": [ # Required. A list of certifications to link to the described product.
        { # Description of a certification.
          "authority": "A String", # Required. Name of the certification body.
          "code": "A String", # Required. A unique code to identify the certification.
          "link": "A String", # Optional. A URL link to the certification.
          "logo": "A String", # Optional. A URL link to the certification logo.
          "name": "A String", # Required. Name of the certification.
          "validUntil": "A String", # Optional. The expiration date (UTC).
          "value": "A String", # Optional. A custom value of the certification.
        },
      ],
      "countryCode": [ # Optional. A 2-letter country code (ISO 3166-1 Alpha 2).
        "A String",
      ],
      "destinationStatuses": [ # Output only. The statuses of the destinations.
        { # The destination status.
          "destination": "A String", # The name of the destination.
          "status": "A String", # The status of the destination.
        },
      ],
      "issues": [ # Output only. A server-generated list of issues associated with the product.
        { # Product issue.
          "attribute": "A String", # If present, the attribute that triggered the issue. For more information about attributes, see https://support.google.com/manufacturers/answer/6124116.
          "description": "A String", # Longer description of the issue focused on how to resolve it.
          "destination": "A String", # The destination this issue applies to.
          "resolution": "A String", # What needs to happen to resolve the issue.
          "severity": "A String", # The severity of the issue.
          "timestamp": "A String", # The timestamp when this issue appeared.
          "title": "A String", # Short title describing the nature of the issue.
          "type": "A String", # The server-generated type of the issue, for example, “INCORRECT_TEXT_FORMATTING”, “IMAGE_NOT_SERVEABLE”, etc.
        },
      ],
      "mpn": [ # Optional. These are the Manufacturer Part Numbers (MPN). MPNs are used to uniquely identify a specific product among all products from the same manufacturer
        "A String",
      ],
      "name": "A 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.
      "productCode": [ # Optional. Another name for GTIN.
        "A String",
      ],
      "productType": [ # Optional. These are your own product categorization system in your product data.
        "A String",
      ],
      "title": "A String", # Required. This is to clearly identify the product you are certifying.
    },
  ],
}
list_next()
Retrieves the next page of results.

        Args:
          previous_request: The request for the previous page. (required)
          previous_response: The response from the request for the previous page. (required)

        Returns:
          A request object that you can call 'execute()' on to request the next
          page. Returns None if there are no more items in the collection.
        
patch(name, body=None, updateMask=None, x__xgafv=None)
Updates (or creates if allow_missing = true) a product certification which links certifications with products. This method can only be called by certification bodies.

Args:
  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. (required)
  body: object, The request body.
    The object takes the form of:

{ # Product certification data.
  "brand": "A String", # Required. This is the product's brand name. The brand is used to help identify your product.
  "certification": [ # Required. A list of certifications to link to the described product.
    { # Description of a certification.
      "authority": "A String", # Required. Name of the certification body.
      "code": "A String", # Required. A unique code to identify the certification.
      "link": "A String", # Optional. A URL link to the certification.
      "logo": "A String", # Optional. A URL link to the certification logo.
      "name": "A String", # Required. Name of the certification.
      "validUntil": "A String", # Optional. The expiration date (UTC).
      "value": "A String", # Optional. A custom value of the certification.
    },
  ],
  "countryCode": [ # Optional. A 2-letter country code (ISO 3166-1 Alpha 2).
    "A String",
  ],
  "destinationStatuses": [ # Output only. The statuses of the destinations.
    { # The destination status.
      "destination": "A String", # The name of the destination.
      "status": "A String", # The status of the destination.
    },
  ],
  "issues": [ # Output only. A server-generated list of issues associated with the product.
    { # Product issue.
      "attribute": "A String", # If present, the attribute that triggered the issue. For more information about attributes, see https://support.google.com/manufacturers/answer/6124116.
      "description": "A String", # Longer description of the issue focused on how to resolve it.
      "destination": "A String", # The destination this issue applies to.
      "resolution": "A String", # What needs to happen to resolve the issue.
      "severity": "A String", # The severity of the issue.
      "timestamp": "A String", # The timestamp when this issue appeared.
      "title": "A String", # Short title describing the nature of the issue.
      "type": "A String", # The server-generated type of the issue, for example, “INCORRECT_TEXT_FORMATTING”, “IMAGE_NOT_SERVEABLE”, etc.
    },
  ],
  "mpn": [ # Optional. These are the Manufacturer Part Numbers (MPN). MPNs are used to uniquely identify a specific product among all products from the same manufacturer
    "A String",
  ],
  "name": "A 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.
  "productCode": [ # Optional. Another name for GTIN.
    "A String",
  ],
  "productType": [ # Optional. These are your own product categorization system in your product data.
    "A String",
  ],
  "title": "A String", # Required. This is to clearly identify the product you are certifying.
}

  updateMask: string, Optional. The list of fields to update according to aip.dev/134. However, only full update is supported as of right now. Therefore, it can be either ignored or set to "*". Setting any other values will returns UNIMPLEMENTED error.
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # Product certification data.
  "brand": "A String", # Required. This is the product's brand name. The brand is used to help identify your product.
  "certification": [ # Required. A list of certifications to link to the described product.
    { # Description of a certification.
      "authority": "A String", # Required. Name of the certification body.
      "code": "A String", # Required. A unique code to identify the certification.
      "link": "A String", # Optional. A URL link to the certification.
      "logo": "A String", # Optional. A URL link to the certification logo.
      "name": "A String", # Required. Name of the certification.
      "validUntil": "A String", # Optional. The expiration date (UTC).
      "value": "A String", # Optional. A custom value of the certification.
    },
  ],
  "countryCode": [ # Optional. A 2-letter country code (ISO 3166-1 Alpha 2).
    "A String",
  ],
  "destinationStatuses": [ # Output only. The statuses of the destinations.
    { # The destination status.
      "destination": "A String", # The name of the destination.
      "status": "A String", # The status of the destination.
    },
  ],
  "issues": [ # Output only. A server-generated list of issues associated with the product.
    { # Product issue.
      "attribute": "A String", # If present, the attribute that triggered the issue. For more information about attributes, see https://support.google.com/manufacturers/answer/6124116.
      "description": "A String", # Longer description of the issue focused on how to resolve it.
      "destination": "A String", # The destination this issue applies to.
      "resolution": "A String", # What needs to happen to resolve the issue.
      "severity": "A String", # The severity of the issue.
      "timestamp": "A String", # The timestamp when this issue appeared.
      "title": "A String", # Short title describing the nature of the issue.
      "type": "A String", # The server-generated type of the issue, for example, “INCORRECT_TEXT_FORMATTING”, “IMAGE_NOT_SERVEABLE”, etc.
    },
  ],
  "mpn": [ # Optional. These are the Manufacturer Part Numbers (MPN). MPNs are used to uniquely identify a specific product among all products from the same manufacturer
    "A String",
  ],
  "name": "A 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.
  "productCode": [ # Optional. Another name for GTIN.
    "A String",
  ],
  "productType": [ # Optional. These are your own product categorization system in your product data.
    "A String",
  ],
  "title": "A String", # Required. This is to clearly identify the product you are certifying.
}