on develop help sign in
Adding manufacterers v1 service definition
61417e4Brendan Hay
gen/model/manufacturers/v1/manufacturers-api.jsonnew file+353
@@ -0,0 +1,353 @@
1+{
2+ "id": "manufacturers:v1",
3+ "auth": {
4+ "oauth2": {
5+ "scopes": {
6+ "https://www.googleapis.com/auth/manufacturercenter": {
7+ "description": "Manage your product listings for Google Manufacturer Center"
8+ }
9+ }
10+ }
11+ },
12+ "description": "Public API for managing Manufacturer Center related data.",
13+ "protocol": "rest",
14+ "title": "Manufacturer Center API",
15+ "resources": {
16+ "accounts": {
17+ "resources": {
18+ "products": {
19+ "methods": {
20+ "get": {
21+ "id": "manufacturers.accounts.products.get",
22+ "response": {
23+ "$ref": "Product"
24+ },
25+ "parameterOrder": [
26+ "parent",
27+ "name"
28+ ],
29+ "description": "Gets the product from a Manufacturer Center account, including product\nissues.",
30+ "flatPath": "v1/accounts/{accountsId}/products/{productsId}",
31+ "httpMethod": "GET",
32+ "parameters": {
33+ "parent": {
34+ "description": "Parent ID in the format `accounts/{account_id}`.\n\n`account_id` - The ID of the Manufacturer Center account.",
35+ "required": true,
36+ "pattern": "^accounts/[^/]+$",
37+ "location": "path",
38+ "type": "string"
39+ },
40+ "name": {
41+ "description": "Name in the format `{target_country}:{content_language}:{product_id}`.\n\n`target_country` - The target country of the product as a CLDR territory\n code (for example, US).\n\n`content_language` - The content language of the product as a two-letter\n ISO 639-1 language code (for example, en).\n\n`product_id` - The ID of the product. For more information, see\n https://support.google.com/manufacturers/answer/6124116#id.",
42+ "required": true,
43+ "pattern": "^[^/]+$",
44+ "location": "path",
45+ "type": "string"
46+ }
47+ },
48+ "path": "v1/{+parent}/products/{+name}",
49+ "scopes": [
50+ "https://www.googleapis.com/auth/manufacturercenter"
51+ ]
52+ },
53+ "list": {
54+ "id": "manufacturers.accounts.products.list",
55+ "response": {
56+ "$ref": "ListProductsResponse"
57+ },
58+ "parameterOrder": [
59+ "parent"
60+ ],
61+ "description": "Lists all the products in a Manufacturer Center account.",
62+ "flatPath": "v1/accounts/{accountsId}/products",
63+ "httpMethod": "GET",
64+ "parameters": {
65+ "pageSize": {
66+ "description": "Maximum number of product statuses to return in the response, used for\npaging.",
67+ "location": "query",
68+ "type": "integer",
69+ "format": "int32"
70+ },
71+ "parent": {
72+ "description": "Parent ID in the format `accounts/{account_id}`.\n\n`account_id` - The ID of the Manufacturer Center account.",
73+ "required": true,
74+ "pattern": "^accounts/[^/]+$",
75+ "location": "path",
76+ "type": "string"
77+ },
78+ "pageToken": {
79+ "description": "The token returned by the previous request.",
80+ "location": "query",
81+ "type": "string"
82+ }
83+ },
84+ "path": "v1/{+parent}/products",
85+ "scopes": [
86+ "https://www.googleapis.com/auth/manufacturercenter"
87+ ]
88+ }
89+ }
90+ }
91+ }
92+ }
93+ },
94+ "schemas": {
95+ "ListProductsResponse": {
96+ "type": "object",
97+ "properties": {
98+ "nextPageToken": {
99+ "description": "The token for the retrieval of the next page of product statuses.",
100+ "type": "string"
101+ },
102+ "products": {
103+ "description": "List of the products.",
104+ "type": "array",
105+ "items": {
106+ "$ref": "Product"
107+ }
108+ }
109+ },
110+ "id": "ListProductsResponse"
111+ },
112+ "Issue": {
113+ "description": "Product issue.",
114+ "type": "object",
115+ "properties": {
116+ "severity": {
117+ "description": "The severity of the issue.",
118+ "enum": [
119+ "SEVERITY_UNSPECIFIED",
120+ "ERROR",
121+ "WARNING",
122+ "INFO"
123+ ],
124+ "enumDescriptions": [
125+ "Unspecified severity, never used.",
126+ "Error severity. The issue prevents the usage of the whole item.",
127+ "Warning severity. The issue is either one that prevents the usage of the\nattribute that triggered it or one that will soon prevent the usage of\nthe whole item.",
128+ "Info severity. The issue is one that doesn't require immediate attention.\nIt is, for example, used to communicate which attributes are still\npending review."
129+ ],
130+ "type": "string"
131+ },
132+ "description": {
133+ "description": "Description of the issue.",
134+ "type": "string"
135+ },
136+ "attribute": {
137+ "description": "If present, the attribute that triggered the issue. For more information\nabout attributes, see\nhttps://support.google.com/manufacturers/answer/6124116.",
138+ "type": "string"
139+ },
140+ "type": {
141+ "description": "The server-generated type of the issue, for example,\n“INCORRECT_TEXT_FORMATTING”, “IMAGE_NOT_SERVEABLE”, etc.",
142+ "type": "string"
143+ }
144+ },
145+ "id": "Issue"
146+ },
147+ "Attributes": {
148+ "description": "Attributes of the product. For more information, see\nhttps://support.google.com/manufacturers/answer/6124116.",
149+ "type": "object",
150+ "properties": {
151+ "productPageUrl": {
152+ "description": "The URL of the manufacturer's detail page of the product. For more\ninformation, see\nhttps://support.google.com/manufacturers/answer/6124116#productpage.",
153+ "type": "string"
154+ },
155+ "mpn": {
156+ "description": "The Manufacturer Part Number (MPN) of the product. For more information,\nsee https://support.google.com/manufacturers/answer/6124116#mpn.",
157+ "type": "string"
158+ },
159+ "title": {
160+ "description": "The title of the product. For more information, see\nhttps://support.google.com/manufacturers/answer/6124116#title.",
161+ "type": "string"
162+ },
163+ "productLine": {
164+ "description": "The name of the group of products related to the product. For more\ninformation, see\nhttps://support.google.com/manufacturers/answer/6124116#productline.",
165+ "type": "string"
166+ },
167+ "productName": {
168+ "description": "The canonical name of the product. For more information, see\nhttps://support.google.com/manufacturers/answer/6124116#productname.",
169+ "type": "string"
170+ },
171+ "brand": {
172+ "description": "The brand name of the product. For more information, see\nhttps://support.google.com/manufacturers/answer/6124116#brand.",
173+ "type": "string"
174+ },
175+ "productType": {
176+ "description": "The manufacturer's category of the product. For more information, see\nhttps://support.google.com/manufacturers/answer/6124116#producttype.",
177+ "type": "array",
178+ "items": {
179+ "type": "string"
180+ }
181+ },
182+ "gtin": {
183+ "description": "The Global Trade Item Number (GTIN) of the product. For more information,\nsee https://support.google.com/manufacturers/answer/6124116#gtin.",
184+ "type": "array",
185+ "items": {
186+ "type": "string"
187+ }
188+ }
189+ },
190+ "id": "Attributes"
191+ },
192+ "Product": {
193+ "description": "Product data.",
194+ "type": "object",
195+ "properties": {
196+ "parent": {
197+ "description": "Parent ID in the format `accounts/{account_id}`.\n\n`account_id` - The ID of the Manufacturer Center account.\n@OutputOnly",
198+ "type": "string"
199+ },
200+ "targetCountry": {
201+ "description": "The target country of the product as a CLDR territory code (for example,\nUS).\n@OutputOnly",
202+ "type": "string"
203+ },
204+ "contentLanguage": {
205+ "description": "The content language of the product as a two-letter ISO 639-1 language code\n(for example, en).\n@OutputOnly",
206+ "type": "string"
207+ },
208+ "manuallyDeletedAttributes": {
209+ "description": "Names of the attributes of the product deleted manually via the\nManufacturer Center UI.\n@OutputOnly",
210+ "type": "array",
211+ "items": {
212+ "type": "string"
213+ }
214+ },
215+ "productId": {
216+ "description": "The ID of the product. For more information, see\nhttps://support.google.com/manufacturers/answer/6124116#id.\n@OutputOnly",
217+ "type": "string"
218+ },
219+ "finalAttributes": {
220+ "description": "Final attributes of the product. The final attributes are obtained by\noverriding the uploaded attributes with the manually provided and deleted\nattributes. Google systems only process, evaluate, review, and/or use final\nattributes.\n@OutputOnly",
221+ "$ref": "Attributes"
222+ },
223+ "issues": {
224+ "description": "A server-generated list of issues associated with the product.\n@OutputOnly",
225+ "type": "array",
226+ "items": {
227+ "$ref": "Issue"
228+ }
229+ },
230+ "name": {
231+ "description": "Name in the format `{target_country}:{content_language}:{product_id}`.\n\n`target_country` - The target country of the product as a CLDR territory\n code (for example, US).\n\n`content_language` - The content language of the product as a two-letter\n ISO 639-1 language code (for example, en).\n\n`product_id` - The ID of the product. For more information, see\n https://support.google.com/manufacturers/answer/6124116#id.\n@OutputOnly",
232+ "type": "string"
233+ },
234+ "uploadedAttributes": {
235+ "description": "Attributes of the product uploaded via the Manufacturer Center API or via\nfeeds.",
236+ "$ref": "Attributes"
237+ },
238+ "manuallyProvidedAttributes": {
239+ "description": "Attributes of the product provided manually via the Manufacturer Center UI.\n@OutputOnly",
240+ "$ref": "Attributes"
241+ }
242+ },
243+ "id": "Product"
244+ }
245+ },
246+ "revision": "20161028",
247+ "basePath": "",
248+ "icons": {
249+ "x32": "http://www.google.com/images/icons/product/search-32.gif",
250+ "x16": "http://www.google.com/images/icons/product/search-16.gif"
251+ },
252+ "version_module": "True",
253+ "canonicalName": "Manufacturer Center",
254+ "discoveryVersion": "v1",
255+ "baseUrl": "https://manufacturers.googleapis.com/",
256+ "name": "manufacturers",
257+ "parameters": {
258+ "access_token": {
259+ "description": "OAuth access token.",
260+ "type": "string",
261+ "location": "query"
262+ },
263+ "prettyPrint": {
264+ "description": "Returns response with indentations and line breaks.",
265+ "default": "true",
266+ "type": "boolean",
267+ "location": "query"
268+ },
269+ "key": {
270+ "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.",
271+ "type": "string",
272+ "location": "query"
273+ },
274+ "quotaUser": {
275+ "description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.",
276+ "type": "string",
277+ "location": "query"
278+ },
279+ "pp": {
280+ "description": "Pretty-print response.",
281+ "default": "true",
282+ "type": "boolean",
283+ "location": "query"
284+ },
285+ "fields": {
286+ "description": "Selector specifying which fields to include in a partial response.",
287+ "type": "string",
288+ "location": "query"
289+ },
290+ "alt": {
291+ "description": "Data format for response.",
292+ "location": "query",
293+ "enum": [
294+ "json",
295+ "media",
296+ "proto"
297+ ],
298+ "default": "json",
299+ "enumDescriptions": [
300+ "Responses with Content-Type of application/json",
301+ "Media download with context-dependent Content-Type",
302+ "Responses with Content-Type of application/x-protobuf"
303+ ],
304+ "type": "string"
305+ },
306+ "$.xgafv": {
307+ "description": "V1 error format.",
308+ "enum": [
309+ "1",
310+ "2"
311+ ],
312+ "enumDescriptions": [
313+ "v1 error format",
314+ "v2 error format"
315+ ],
316+ "type": "string",
317+ "location": "query"
318+ },
319+ "callback": {
320+ "description": "JSONP",
321+ "type": "string",
322+ "location": "query"
323+ },
324+ "oauth_token": {
325+ "description": "OAuth 2.0 token for the current user.",
326+ "type": "string",
327+ "location": "query"
328+ },
329+ "uploadType": {
330+ "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").",
331+ "type": "string",
332+ "location": "query"
333+ },
334+ "bearer_token": {
335+ "description": "OAuth bearer token.",
336+ "type": "string",
337+ "location": "query"
338+ },
339+ "upload_protocol": {
340+ "description": "Upload protocol for media (e.g. \"raw\", \"multipart\").",
341+ "type": "string",
342+ "location": "query"
343+ }
344+ },
345+ "documentationLink": "https://developers.google.com/manufacturers/",
346+ "ownerDomain": "google.com",
347+ "batchPath": "batch",
348+ "servicePath": "",
349+ "ownerName": "Google",
350+ "version": "v1",
351+ "rootUrl": "https://manufacturers.googleapis.com/",
352+ "kind": "discovery#restDescription"
353+}