OLD | NEW |
1 { | 1 { |
2 "basePath": "", | 2 "basePath": "", |
3 "baseUrl": "https://kgsearch.googleapis.com/", | 3 "baseUrl": "https://kgsearch.googleapis.com/", |
4 "batchPath": "batch", | 4 "batchPath": "batch", |
5 "description": "Searches the Google Knowledge Graph for entities.", | 5 "description": "Searches the Google Knowledge Graph for entities.", |
6 "discoveryVersion": "v1", | 6 "discoveryVersion": "v1", |
7 "documentationLink": "https://developers.google.com/knowledge-graph/", | 7 "documentationLink": "https://developers.google.com/knowledge-graph/", |
8 "icons": { | 8 "icons": { |
9 "x16": "http://www.google.com/images/icons/product/search-16.gif", | 9 "x16": "http://www.google.com/images/icons/product/search-16.gif", |
10 "x32": "http://www.google.com/images/icons/product/search-32.gif" | 10 "x32": "http://www.google.com/images/icons/product/search-32.gif" |
11 }, | 11 }, |
12 "id": "kgsearch:v1", | 12 "id": "kgsearch:v1", |
13 "kind": "discovery#restDescription", | 13 "kind": "discovery#restDescription", |
14 "name": "kgsearch", | 14 "name": "kgsearch", |
15 "ownerDomain": "google.com", | 15 "ownerDomain": "google.com", |
16 "ownerName": "Google", | 16 "ownerName": "Google", |
17 "parameters": { | 17 "parameters": { |
18 "access_token": { | |
19 "description": "OAuth access token.", | |
20 "location": "query", | |
21 "type": "string" | |
22 }, | |
23 "key": { | |
24 "description": "API key. Your API key identifies your project and pr
ovides you with API access, quota, and reports. Required unless you provide an O
Auth 2.0 token.", | |
25 "location": "query", | |
26 "type": "string" | |
27 }, | |
28 "quotaUser": { | |
29 "description": "Available to use for quota purposes for server-side
applications. Can be any arbitrary string assigned to a user, but should not exc
eed 40 characters.", | |
30 "location": "query", | |
31 "type": "string" | |
32 }, | |
33 "pp": { | |
34 "default": "true", | |
35 "description": "Pretty-print response.", | |
36 "location": "query", | |
37 "type": "boolean" | |
38 }, | |
39 "oauth_token": { | |
40 "description": "OAuth 2.0 token for the current user.", | |
41 "location": "query", | |
42 "type": "string" | |
43 }, | |
44 "bearer_token": { | |
45 "description": "OAuth bearer token.", | |
46 "location": "query", | |
47 "type": "string" | |
48 }, | |
49 "upload_protocol": { | 18 "upload_protocol": { |
50 "description": "Upload protocol for media (e.g. \"raw\", \"multipart
\").", | 19 "description": "Upload protocol for media (e.g. \"raw\", \"multipart
\").", |
51 "location": "query", | 20 "location": "query", |
52 "type": "string" | 21 "type": "string" |
53 }, | 22 }, |
54 "prettyPrint": { | 23 "prettyPrint": { |
55 "default": "true", | 24 "default": "true", |
56 "description": "Returns response with indentations and line breaks."
, | 25 "description": "Returns response with indentations and line breaks."
, |
57 "location": "query", | 26 "location": "query", |
58 "type": "boolean" | 27 "type": "boolean" |
(...skipping 34 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
93 "media", | 62 "media", |
94 "proto" | 63 "proto" |
95 ], | 64 ], |
96 "enumDescriptions": [ | 65 "enumDescriptions": [ |
97 "Responses with Content-Type of application/json", | 66 "Responses with Content-Type of application/json", |
98 "Media download with context-dependent Content-Type", | 67 "Media download with context-dependent Content-Type", |
99 "Responses with Content-Type of application/x-protobuf" | 68 "Responses with Content-Type of application/x-protobuf" |
100 ], | 69 ], |
101 "location": "query", | 70 "location": "query", |
102 "type": "string" | 71 "type": "string" |
| 72 }, |
| 73 "access_token": { |
| 74 "description": "OAuth access token.", |
| 75 "location": "query", |
| 76 "type": "string" |
| 77 }, |
| 78 "key": { |
| 79 "description": "API key. Your API key identifies your project and pr
ovides you with API access, quota, and reports. Required unless you provide an O
Auth 2.0 token.", |
| 80 "location": "query", |
| 81 "type": "string" |
| 82 }, |
| 83 "quotaUser": { |
| 84 "description": "Available to use for quota purposes for server-side
applications. Can be any arbitrary string assigned to a user, but should not exc
eed 40 characters.", |
| 85 "location": "query", |
| 86 "type": "string" |
| 87 }, |
| 88 "pp": { |
| 89 "default": "true", |
| 90 "description": "Pretty-print response.", |
| 91 "location": "query", |
| 92 "type": "boolean" |
| 93 }, |
| 94 "bearer_token": { |
| 95 "description": "OAuth bearer token.", |
| 96 "location": "query", |
| 97 "type": "string" |
| 98 }, |
| 99 "oauth_token": { |
| 100 "description": "OAuth 2.0 token for the current user.", |
| 101 "location": "query", |
| 102 "type": "string" |
103 } | 103 } |
104 }, | 104 }, |
105 "protocol": "rest", | 105 "protocol": "rest", |
106 "resources": { | 106 "resources": { |
107 "entities": { | 107 "entities": { |
108 "methods": { | 108 "methods": { |
109 "search": { | 109 "search": { |
110 "description": "Searches Knowledge Graph for entities that m
atch the constraints.\nA list of matched entities will be returned in response,
which will be in\nJSON-LD format and compatible with http://schema.org", | 110 "description": "Searches Knowledge Graph for entities that m
atch the constraints.\nA list of matched entities will be returned in response,
which will be in\nJSON-LD format and compatible with http://schema.org", |
111 "httpMethod": "GET", | 111 "httpMethod": "GET", |
112 "id": "kgsearch.entities.search", | 112 "id": "kgsearch.entities.search", |
113 "parameterOrder": [], | 113 "parameterOrder": [], |
114 "parameters": { | 114 "parameters": { |
115 "types": { | |
116 "description": "Restricts returned entities with the
se types, e.g. Person\n(as defined in http://schema.org/Person). If multiple typ
es are specified,\nreturned entities will contain one or more of these types.", | |
117 "location": "query", | |
118 "repeated": true, | |
119 "type": "string" | |
120 }, | |
121 "indent": { | |
122 "description": "Enables indenting of json results.", | |
123 "location": "query", | |
124 "type": "boolean" | |
125 }, | |
126 "languages": { | |
127 "description": "The list of language codes (defined
in ISO 693) to run the query with,\ne.g. 'en'.", | |
128 "location": "query", | |
129 "repeated": true, | |
130 "type": "string" | |
131 }, | |
132 "ids": { | 115 "ids": { |
133 "description": "The list of entity id to be used for
search instead of query string.\nTo specify multiple ids in the HTTP request, r
epeat the parameter in the\nURL as in ...?ids=A&ids=B", | 116 "description": "The list of entity id to be used for
search instead of query string.\nTo specify multiple ids in the HTTP request, r
epeat the parameter in the\nURL as in ...?ids=A&ids=B", |
134 "location": "query", | 117 "location": "query", |
135 "repeated": true, | 118 "repeated": true, |
136 "type": "string" | 119 "type": "string" |
137 }, | 120 }, |
138 "limit": { | 121 "limit": { |
139 "description": "Limits the number of entities to be
returned.", | 122 "description": "Limits the number of entities to be
returned.", |
140 "format": "int32", | 123 "format": "int32", |
141 "location": "query", | 124 "location": "query", |
142 "type": "integer" | 125 "type": "integer" |
143 }, | 126 }, |
144 "prefix": { | 127 "prefix": { |
145 "description": "Enables prefix match against names a
nd aliases of entities", | 128 "description": "Enables prefix match against names a
nd aliases of entities", |
146 "location": "query", | 129 "location": "query", |
147 "type": "boolean" | 130 "type": "boolean" |
148 }, | 131 }, |
149 "query": { | 132 "query": { |
150 "description": "The literal query string for search.
", | 133 "description": "The literal query string for search.
", |
151 "location": "query", | 134 "location": "query", |
152 "type": "string" | 135 "type": "string" |
| 136 }, |
| 137 "types": { |
| 138 "description": "Restricts returned entities with the
se types, e.g. Person\n(as defined in http://schema.org/Person). If multiple typ
es are specified,\nreturned entities will contain one or more of these types.", |
| 139 "location": "query", |
| 140 "repeated": true, |
| 141 "type": "string" |
| 142 }, |
| 143 "indent": { |
| 144 "description": "Enables indenting of json results.", |
| 145 "location": "query", |
| 146 "type": "boolean" |
| 147 }, |
| 148 "languages": { |
| 149 "description": "The list of language codes (defined
in ISO 693) to run the query with,\ne.g. 'en'.", |
| 150 "location": "query", |
| 151 "repeated": true, |
| 152 "type": "string" |
153 } | 153 } |
154 }, | 154 }, |
155 "path": "v1/entities:search", | 155 "path": "v1/entities:search", |
156 "response": { | 156 "response": { |
157 "$ref": "SearchResponse" | 157 "$ref": "SearchResponse" |
158 } | 158 } |
159 } | 159 } |
160 } | 160 } |
161 } | 161 } |
162 }, | 162 }, |
163 "revision": "20170109", | 163 "revision": "20170109", |
164 "rootUrl": "https://kgsearch.googleapis.com/", | 164 "rootUrl": "https://kgsearch.googleapis.com/", |
165 "schemas": { | 165 "schemas": { |
166 "SearchResponse": { | 166 "SearchResponse": { |
167 "description": "Response message includes the context and a list of
matching results\nwhich contain the detail of associated entities.", | 167 "description": "Response message includes the context and a list of
matching results\nwhich contain the detail of associated entities.", |
168 "id": "SearchResponse", | 168 "id": "SearchResponse", |
169 "properties": { | 169 "properties": { |
170 "@type": { | |
171 "description": "The schema type of top-level JSON-LD object,
e.g. ItemList.", | |
172 "type": "any" | |
173 }, | |
174 "@context": { | |
175 "description": "The local context applicable for the respons
e. See more details at\nhttp://www.w3.org/TR/json-ld/#context-definitions.", | |
176 "type": "any" | |
177 }, | |
178 "itemListElement": { | 170 "itemListElement": { |
179 "description": "The item list of search results.", | 171 "description": "The item list of search results.", |
180 "items": { | 172 "items": { |
181 "type": "any" | 173 "type": "any" |
182 }, | 174 }, |
183 "type": "array" | 175 "type": "array" |
| 176 }, |
| 177 "@context": { |
| 178 "description": "The local context applicable for the respons
e. See more details at\nhttp://www.w3.org/TR/json-ld/#context-definitions.", |
| 179 "type": "any" |
| 180 }, |
| 181 "@type": { |
| 182 "description": "The schema type of top-level JSON-LD object,
e.g. ItemList.", |
| 183 "type": "any" |
184 } | 184 } |
185 }, | 185 }, |
186 "type": "object" | 186 "type": "object" |
187 } | 187 } |
188 }, | 188 }, |
189 "servicePath": "", | 189 "servicePath": "", |
190 "title": "Knowledge Graph Search API", | 190 "title": "Knowledge Graph Search API", |
191 "version": "v1" | 191 "version": "v1" |
192 } | 192 } |
OLD | NEW |