feat(manufacturers): update the API

#### manufacturers:v1 The following keys were added: - resources.accounts.resources.languages.resources.productCertifications.methods.delete.description - resources.accounts.resources.languages.resources.productCertifications.methods.delete.flatPath - resources.accounts.resources.languages.resources.productCertifications.methods.delete.httpMethod - resources.accounts.resources.languages.resources.productCertifications.methods.delete.id - resources.accounts.resources.languages.resources.productCertifications.methods.delete.parameterOrder - resources.accounts.resources.languages.resources.productCertifications.methods.delete.parameters.name.description - resources.accounts.resources.languages.resources.productCertifications.methods.delete.parameters.name.location - resources.accounts.resources.languages.resources.productCertifications.methods.delete.parameters.name.pattern - resources.accounts.resources.languages.resources.productCertifications.methods.delete.parameters.name.required - resources.accounts.resources.languages.resources.productCertifications.methods.delete.parameters.name.type - resources.accounts.resources.languages.resources.productCertifications.methods.delete.path - resources.accounts.resources.languages.resources.productCertifications.methods.delete.response.$ref - resources.accounts.resources.languages.resources.productCertifications.methods.delete.scopes - resources.accounts.resources.languages.resources.productCertifications.methods.get.description - resources.accounts.resources.languages.resources.productCertifications.methods.get.flatPath - resources.accounts.resources.languages.resources.productCertifications.methods.get.httpMethod - resources.accounts.resources.languages.resources.productCertifications.methods.get.id - resources.accounts.resources.languages.resources.productCertifications.methods.get.parameterOrder - resources.accounts.resources.languages.resources.productCertifications.methods.get.parameters.name.description - resources.accounts.resources.languages.resources.productCertifications.methods.get.parameters.name.location - resources.accounts.resources.languages.resources.productCertifications.methods.get.parameters.name.pattern - resources.accounts.resources.languages.resources.productCertifications.methods.get.parameters.name.required - resources.accounts.resources.languages.resources.productCertifications.methods.get.parameters.name.type - resources.accounts.resources.languages.resources.productCertifications.methods.get.path - resources.accounts.resources.languages.resources.productCertifications.methods.get.response.$ref - resources.accounts.resources.languages.resources.productCertifications.methods.get.scopes - resources.accounts.resources.languages.resources.productCertifications.methods.list.description - resources.accounts.resources.languages.resources.productCertifications.methods.list.flatPath - resources.accounts.resources.languages.resources.productCertifications.methods.list.httpMethod - resources.accounts.resources.languages.resources.productCertifications.methods.list.id - resources.accounts.resources.languages.resources.productCertifications.methods.list.parameterOrder - resources.accounts.resources.languages.resources.productCertifications.methods.list.parameters.pageSize.description - resources.accounts.resources.languages.resources.productCertifications.methods.list.parameters.pageSize.format - resources.accounts.resources.languages.resources.productCertifications.methods.list.parameters.pageSize.location - resources.accounts.resources.languages.resources.productCertifications.methods.list.parameters.pageSize.type - resources.accounts.resources.languages.resources.productCertifications.methods.list.parameters.pageToken.description - resources.accounts.resources.languages.resources.productCertifications.methods.list.parameters.pageToken.location - resources.accounts.resources.languages.resources.productCertifications.methods.list.parameters.pageToken.type - resources.accounts.resources.languages.resources.productCertifications.methods.list.parameters.parent.description - resources.accounts.resources.languages.resources.productCertifications.methods.list.parameters.parent.location - resources.accounts.resources.languages.resources.productCertifications.methods.list.parameters.parent.pattern - resources.accounts.resources.languages.resources.productCertifications.methods.list.parameters.parent.required - resources.accounts.resources.languages.resources.productCertifications.methods.list.parameters.parent.type - resources.accounts.resources.languages.resources.productCertifications.methods.list.path - resources.accounts.resources.languages.resources.productCertifications.methods.list.response.$ref - resources.accounts.resources.languages.resources.productCertifications.methods.list.scopes - resources.accounts.resources.languages.resources.productCertifications.methods.patch.description - resources.accounts.resources.languages.resources.productCertifications.methods.patch.flatPath - resources.accounts.resources.languages.resources.productCertifications.methods.patch.httpMethod - resources.accounts.resources.languages.resources.productCertifications.methods.patch.id - resources.accounts.resources.languages.resources.productCertifications.methods.patch.parameterOrder - resources.accounts.resources.languages.resources.productCertifications.methods.patch.parameters.name.description - resources.accounts.resources.languages.resources.productCertifications.methods.patch.parameters.name.location - resources.accounts.resources.languages.resources.productCertifications.methods.patch.parameters.name.pattern - resources.accounts.resources.languages.resources.productCertifications.methods.patch.parameters.name.required - resources.accounts.resources.languages.resources.productCertifications.methods.patch.parameters.name.type - resources.accounts.resources.languages.resources.productCertifications.methods.patch.parameters.updateMask.description - resources.accounts.resources.languages.resources.productCertifications.methods.patch.parameters.updateMask.format - resources.accounts.resources.languages.resources.productCertifications.methods.patch.parameters.updateMask.location - resources.accounts.resources.languages.resources.productCertifications.methods.patch.parameters.updateMask.type - resources.accounts.resources.languages.resources.productCertifications.methods.patch.path - resources.accounts.resources.languages.resources.productCertifications.methods.patch.request.$ref - resources.accounts.resources.languages.resources.productCertifications.methods.patch.response.$ref - resources.accounts.resources.languages.resources.productCertifications.methods.patch.scopes - schemas.Certification.description - schemas.Certification.id - schemas.Certification.properties.authority.description - schemas.Certification.properties.authority.type - schemas.Certification.properties.link.description - schemas.Certification.properties.link.type - schemas.Certification.properties.logo.description - schemas.Certification.properties.logo.type - schemas.Certification.properties.name.description - schemas.Certification.properties.name.type - schemas.Certification.properties.validUntil.description - schemas.Certification.properties.validUntil.type - schemas.Certification.properties.value.description - schemas.Certification.properties.value.type - schemas.Certification.type - schemas.ListProductCertificationsResponse.description - schemas.ListProductCertificationsResponse.id - schemas.ListProductCertificationsResponse.properties.nextPageToken.description - schemas.ListProductCertificationsResponse.properties.nextPageToken.type - schemas.ListProductCertificationsResponse.properties.productCertifications.description - schemas.ListProductCertificationsResponse.properties.productCertifications.items.$ref - schemas.ListProductCertificationsResponse.properties.productCertifications.type - schemas.ListProductCertificationsResponse.type - schemas.ProductCertification.description - schemas.ProductCertification.id - schemas.ProductCertification.properties.brand.description - schemas.ProductCertification.properties.brand.type - schemas.ProductCertification.properties.certification.description - schemas.ProductCertification.properties.certification.items.$ref - schemas.ProductCertification.properties.certification.type - schemas.ProductCertification.properties.countryCode.description - schemas.ProductCertification.properties.countryCode.items.type - schemas.ProductCertification.properties.countryCode.type - schemas.ProductCertification.properties.destinationStatuses.description - schemas.ProductCertification.properties.destinationStatuses.items.$ref - schemas.ProductCertification.properties.destinationStatuses.readOnly - schemas.ProductCertification.properties.destinationStatuses.type - schemas.ProductCertification.properties.issues.description - schemas.ProductCertification.properties.issues.items.$ref - schemas.ProductCertification.properties.issues.readOnly - schemas.ProductCertification.properties.issues.type - schemas.ProductCertification.properties.mpn.description - schemas.ProductCertification.properties.mpn.items.type - schemas.ProductCertification.properties.mpn.type - schemas.ProductCertification.properties.name.description - schemas.ProductCertification.properties.name.type - schemas.ProductCertification.properties.productCode.description - schemas.ProductCertification.properties.productCode.items.type - schemas.ProductCertification.properties.productCode.type - schemas.ProductCertification.properties.productType.description - schemas.ProductCertification.properties.productType.items.type - schemas.ProductCertification.properties.productType.type - schemas.ProductCertification.properties.title.description - schemas.ProductCertification.properties.title.type - schemas.ProductCertification.type
googleapis · Feb 2, 2023 · a927411 · a927411
1 parent 1a462c2
commit a927411
Show file tree

Hide file tree

Showing 2 changed files with 978 additions and 1 deletion.
diff --git a/discovery/manufacturers-v1.json b/discovery/manufacturers-v1.json
@@ -107,6 +107,134 @@
   "resources": {
     "accounts": {
       "resources": {
+        "languages": {
+          "resources": {
+            "productCertifications": {
+              "methods": {
+                "delete": {
+                  "description": "Deletes a product certification by its name. This method can only be called by certification bodies.",
+                  "flatPath": "v1/accounts/{accountsId}/languages/{languagesId}/productCertifications/{productCertificationsId}",
+                  "httpMethod": "DELETE",
+                  "id": "manufacturers.accounts.languages.productCertifications.delete",
+                  "parameterOrder": [
+                    "name"
+                  ],
+                  "parameters": {
+                    "name": {
+                      "description": "Required. The name of the product certification to delete. Format: accounts/{account}/languages/{language_code}/productCertifications/{id}",
+                      "location": "path",
+                      "pattern": "^accounts/[^/]+/languages/[^/]+/productCertifications/[^/]+$",
+                      "required": true,
+                      "type": "string"
+                    }
+                  },
+                  "path": "v1/{+name}",
+                  "response": {
+                    "$ref": "Empty"
+                  },
+                  "scopes": [
+                    "https://www.googleapis.com/auth/manufacturercenter"
+                  ]
+                },
+                "get": {
+                  "description": "Gets a product certification by its name. This method can only be called by certification bodies.",
+                  "flatPath": "v1/accounts/{accountsId}/languages/{languagesId}/productCertifications/{productCertificationsId}",
+                  "httpMethod": "GET",
+                  "id": "manufacturers.accounts.languages.productCertifications.get",
+                  "parameterOrder": [
+                    "name"
+                  ],
+                  "parameters": {
+                    "name": {
+                      "description": "Required. The name of the product certification to get. Format: accounts/{account}/languages/{language_code}/productCertifications/{id}",
+                      "location": "path",
+                      "pattern": "^accounts/[^/]+/languages/[^/]+/productCertifications/[^/]+$",
+                      "required": true,
+                      "type": "string"
+                    }
+                  },
+                  "path": "v1/{+name}",
+                  "response": {
+                    "$ref": "ProductCertification"
+                  },
+                  "scopes": [
+                    "https://www.googleapis.com/auth/manufacturercenter"
+                  ]
+                },
+                "list": {
+                  "description": "Lists product certifications from a specified certification body. This method can only be called by certification bodies.",
+                  "flatPath": "v1/accounts/{accountsId}/languages/{languagesId}/productCertifications",
+                  "httpMethod": "GET",
+                  "id": "manufacturers.accounts.languages.productCertifications.list",
+                  "parameterOrder": [
+                    "parent"
+                  ],
+                  "parameters": {
+                    "pageSize": {
+                      "description": "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.",
+                      "format": "int32",
+                      "location": "query",
+                      "type": "integer"
+                    },
+                    "pageToken": {
+                      "description": "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.",
+                      "location": "query",
+                      "type": "string"
+                    },
+                    "parent": {
+                      "description": "Required. The parent, which owns this collection of product certifications. Format: accounts/{account}/languages/{language_code}",
+                      "location": "path",
+                      "pattern": "^accounts/[^/]+/languages/[^/]+$",
+                      "required": true,
+                      "type": "string"
+                    }
+                  },
+                  "path": "v1/{+parent}/productCertifications",
+                  "response": {
+                    "$ref": "ListProductCertificationsResponse"
+                  },
+                  "scopes": [
+                    "https://www.googleapis.com/auth/manufacturercenter"
+                  ]
+                },
+                "patch": {
+                  "description": "Updates (or creates if allow_missing = true) a product certification which links certifications with products. This method can only be called by certification bodies.",
+                  "flatPath": "v1/accounts/{accountsId}/languages/{languagesId}/productCertifications/{productCertificationsId}",
+                  "httpMethod": "PATCH",
+                  "id": "manufacturers.accounts.languages.productCertifications.patch",
+                  "parameterOrder": [
+                    "name"
+                  ],
+                  "parameters": {
+                    "name": {
+                      "description": "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.",
+                      "location": "path",
+                      "pattern": "^accounts/[^/]+/languages/[^/]+/productCertifications/[^/]+$",
+                      "required": true,
+                      "type": "string"
+                    },
+                    "updateMask": {
+                      "description": "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.",
+                      "format": "google-fieldmask",
+                      "location": "query",
+                      "type": "string"
+                    }
+                  },
+                  "path": "v1/{+name}",
+                  "request": {
+                    "$ref": "ProductCertification"
+                  },
+                  "response": {
+                    "$ref": "ProductCertification"
+                  },
+                  "scopes": [
+                    "https://www.googleapis.com/auth/manufacturercenter"
+                  ]
+                }
+              }
+            }
+          }
+        },
         "products": {
           "methods": {
             "delete": {
@@ -288,7 +416,7 @@
       }
     }
   },
-  "revision": "20220913",
+  "revision": "20230201",
   "rootUrl": "https://manufacturers.googleapis.com/",
   "schemas": {
     "Attributes": {
@@ -503,6 +631,37 @@
       },
       "type": "object"
     },
+    "Certification": {
+      "description": "Description of a certification.",
+      "id": "Certification",
+      "properties": {
+        "authority": {
+          "description": "Required. Name of the certification body.",
+          "type": "string"
+        },
+        "link": {
+          "description": "Optional. A URL link to the certification.",
+          "type": "string"
+        },
+        "logo": {
+          "description": "Optional. A URL link to the certification logo.",
+          "type": "string"
+        },
+        "name": {
+          "description": "Required. Name of the certification.",
+          "type": "string"
+        },
+        "validUntil": {
+          "description": "Optional. The expiration date (UTC).",
+          "type": "string"
+        },
+        "value": {
+          "description": "Required. A custom value of the certification.",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
     "Count": {
       "description": "The number of products in a single package. For more information, see https://support.google.com/manufacturers/answer/6124116#count.",
       "id": "Count",
@@ -757,6 +916,24 @@
       },
       "type": "object"
     },
+    "ListProductCertificationsResponse": {
+      "description": "Response for ListProductCertifications method.",
+      "id": "ListProductCertificationsResponse",
+      "properties": {
+        "nextPageToken": {
+          "description": "A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.",
+          "type": "string"
+        },
+        "productCertifications": {
+          "description": "The product certifications from the specified certification body.",
+          "items": {
+            "$ref": "ProductCertification"
+          },
+          "type": "array"
+        }
+      },
+      "type": "object"
+    },
     "ListProductsResponse": {
       "id": "ListProductsResponse",
       "properties": {
@@ -1031,6 +1208,76 @@
       },
       "type": "object"
     },
+    "ProductCertification": {
+      "description": "The data matches with the vertical specification for product in http://google3/googlebase/verticals/devel/product_certification",
+      "id": "ProductCertification",
+      "properties": {
+        "brand": {
+          "description": "Required. This is the product's brand name. The brand is used to help identify your product.",
+          "type": "string"
+        },
+        "certification": {
+          "description": "Required. A list of certifications to link to the described product.",
+          "items": {
+            "$ref": "Certification"
+          },
+          "type": "array"
+        },
+        "countryCode": {
+          "description": "Optional. A 2-letter country code (ISO 3166-1 Alpha 2).",
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "destinationStatuses": {
+          "description": "Output only. The statuses of the destinations.",
+          "items": {
+            "$ref": "DestinationStatus"
+          },
+          "readOnly": true,
+          "type": "array"
+        },
+        "issues": {
+          "description": "Output only. A server-generated list of issues associated with the product.",
+          "items": {
+            "$ref": "Issue"
+          },
+          "readOnly": true,
+          "type": "array"
+        },
+        "mpn": {
+          "description": "Optional. These are the Manufacturer Part Numbers (MPN). MPNs are used to uniquely identify a specific product among all products from the same manufacturer",
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "name": {
+          "description": "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.",
+          "type": "string"
+        },
+        "productCode": {
+          "description": "Optional. Another name for GTIN.",
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "productType": {
+          "description": "Optional. These are your own product categorization system in your product data.",
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "title": {
+          "description": "Required. This is to clearly identify the product you are certifying.",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
     "ProductDetail": {
       "description": "A product detail of the product. For more information, see https://support.google.com/manufacturers/answer/6124116#productdetail.",
       "id": "ProductDetail",