OLD | NEW |
(Empty) | |
| 1 { |
| 2 "basePath": "/freebase/v1/", |
| 3 "baseUrl": "https://www.googleapis.com/freebase/v1/", |
| 4 "batchPath": "batch", |
| 5 "description": "Find Freebase entities using textual queries and other const
raints.", |
| 6 "discoveryVersion": "v1", |
| 7 "documentationLink": "https://developers.google.com/freebase/", |
| 8 "etag": "\"uUWyYHXmEn-ab7WLvo8qNz2S8ws/kTDiVESNLycoqIbveRofH5KPD08\"", |
| 9 "icons": { |
| 10 "x16": "http://www.google.com/images/icons/product/freebase-16.png", |
| 11 "x32": "http://www.google.com/images/icons/product/freebase-32.png" |
| 12 }, |
| 13 "id": "freebase:v1", |
| 14 "kind": "discovery#restDescription", |
| 15 "methods": { |
| 16 "reconcile": { |
| 17 "description": "Reconcile entities to Freebase open data.", |
| 18 "httpMethod": "GET", |
| 19 "id": "freebase.reconcile", |
| 20 "parameters": { |
| 21 "confidence": { |
| 22 "default": "0.99", |
| 23 "description": "Required confidence for a candidate to match
. Must be between .5 and 1.0", |
| 24 "format": "float", |
| 25 "location": "query", |
| 26 "maximum": "1.0", |
| 27 "minimum": "0.0", |
| 28 "type": "number" |
| 29 }, |
| 30 "kind": { |
| 31 "description": "Classifications of entity e.g. type, categor
y, title.", |
| 32 "location": "query", |
| 33 "repeated": true, |
| 34 "type": "string" |
| 35 }, |
| 36 "lang": { |
| 37 "description": "Languages for names and values. First langua
ge is used for display. Default is 'en'.", |
| 38 "location": "query", |
| 39 "repeated": true, |
| 40 "type": "string" |
| 41 }, |
| 42 "limit": { |
| 43 "default": "3", |
| 44 "description": "Maximum number of candidates to return.", |
| 45 "format": "int32", |
| 46 "location": "query", |
| 47 "maximum": "25", |
| 48 "minimum": "0", |
| 49 "type": "integer" |
| 50 }, |
| 51 "name": { |
| 52 "description": "Name of entity.", |
| 53 "location": "query", |
| 54 "type": "string" |
| 55 }, |
| 56 "prop": { |
| 57 "description": "Property values for entity formatted as\n:", |
| 58 "location": "query", |
| 59 "repeated": true, |
| 60 "type": "string" |
| 61 } |
| 62 }, |
| 63 "path": "reconcile", |
| 64 "response": { |
| 65 "$ref": "ReconcileGet" |
| 66 } |
| 67 }, |
| 68 "search": { |
| 69 "description": "Search Freebase open data.", |
| 70 "httpMethod": "GET", |
| 71 "id": "freebase.search", |
| 72 "parameters": { |
| 73 "as_of_time": { |
| 74 "description": "A mql as_of_time value to use with mql_outpu
t queries.", |
| 75 "location": "query", |
| 76 "type": "string" |
| 77 }, |
| 78 "callback": { |
| 79 "description": "JS method name for JSONP callbacks.", |
| 80 "location": "query", |
| 81 "pattern": "([A-Za-z0-9_$.]|\\[|\\])+", |
| 82 "type": "string" |
| 83 }, |
| 84 "cursor": { |
| 85 "description": "The cursor value to use for the next page of
results.", |
| 86 "format": "int32", |
| 87 "location": "query", |
| 88 "type": "integer" |
| 89 }, |
| 90 "domain": { |
| 91 "description": "Restrict to topics with this Freebase domain
id.", |
| 92 "location": "query", |
| 93 "repeated": true, |
| 94 "type": "string" |
| 95 }, |
| 96 "encode": { |
| 97 "default": "off", |
| 98 "description": "The encoding of the response. You can use th
is parameter to enable html encoding.", |
| 99 "enum": [ |
| 100 "html", |
| 101 "off" |
| 102 ], |
| 103 "enumDescriptions": [ |
| 104 "Encode certain characters in the response (such as tags
and ambersands) using html encoding.", |
| 105 "No encoding of the response. You should not print the r
esults directly on an web page without html-escaping the content first." |
| 106 ], |
| 107 "location": "query", |
| 108 "type": "string" |
| 109 }, |
| 110 "exact": { |
| 111 "description": "Query on exact name and keys only.", |
| 112 "location": "query", |
| 113 "type": "boolean" |
| 114 }, |
| 115 "filter": { |
| 116 "description": "A filter to apply to the query.", |
| 117 "location": "query", |
| 118 "pattern": "^\\(.*\\)$", |
| 119 "repeated": true, |
| 120 "type": "string" |
| 121 }, |
| 122 "format": { |
| 123 "default": "entity", |
| 124 "description": "Structural format of the json response.", |
| 125 "enum": [ |
| 126 "ac", |
| 127 "classic", |
| 128 "entity", |
| 129 "guids", |
| 130 "ids", |
| 131 "mids" |
| 132 ], |
| 133 "enumDescriptions": [ |
| 134 "Compact format useful for autocomplete/suggest UIs.", |
| 135 "[DEPRECATED] Same format as was returned by api.freebas
e.com.", |
| 136 "Basic information about the entities.", |
| 137 "[DEPRECATED] Ordered list of a freebase guids.", |
| 138 "Ordered list of freebase ids.", |
| 139 "Ordered list of freebase mids." |
| 140 ], |
| 141 "location": "query", |
| 142 "type": "string" |
| 143 }, |
| 144 "help": { |
| 145 "description": "The keyword to request help on.", |
| 146 "enum": [ |
| 147 "langs", |
| 148 "mappings", |
| 149 "predicates" |
| 150 ], |
| 151 "enumDescriptions": [ |
| 152 "The language codes served by the service.", |
| 153 "The property/path mappings supported by the filter and
output request parameters.", |
| 154 "The predicates and path-terminating properties supporte
d by the filter and output request parameters." |
| 155 ], |
| 156 "location": "query", |
| 157 "type": "string" |
| 158 }, |
| 159 "indent": { |
| 160 "description": "Whether to indent the json results or not.", |
| 161 "location": "query", |
| 162 "type": "boolean" |
| 163 }, |
| 164 "lang": { |
| 165 "description": "The code of the language to run the query wi
th. Default is 'en'.", |
| 166 "location": "query", |
| 167 "repeated": true, |
| 168 "type": "string" |
| 169 }, |
| 170 "limit": { |
| 171 "default": "20", |
| 172 "description": "Maximum number of results to return.", |
| 173 "format": "int32", |
| 174 "location": "query", |
| 175 "type": "integer" |
| 176 }, |
| 177 "mid": { |
| 178 "description": "A mid to use instead of a query.", |
| 179 "location": "query", |
| 180 "pattern": "^/[mgtx]/[0-2][0-9bcdfghjklmnpqrstvwxyz_]{1,24}$
", |
| 181 "repeated": true, |
| 182 "type": "string" |
| 183 }, |
| 184 "mql_output": { |
| 185 "description": "The MQL query to run againist the results to
extract more data.", |
| 186 "location": "query", |
| 187 "type": "string" |
| 188 }, |
| 189 "output": { |
| 190 "description": "An output expression to request data from ma
tches.", |
| 191 "location": "query", |
| 192 "pattern": "^\\(.*\\)$", |
| 193 "type": "string" |
| 194 }, |
| 195 "prefixed": { |
| 196 "description": "Prefix match against names and aliases.", |
| 197 "location": "query", |
| 198 "type": "boolean" |
| 199 }, |
| 200 "query": { |
| 201 "description": "Query term to search for.", |
| 202 "location": "query", |
| 203 "type": "string" |
| 204 }, |
| 205 "scoring": { |
| 206 "default": "entity", |
| 207 "description": "Relevance scoring algorithm to use.", |
| 208 "enum": [ |
| 209 "entity", |
| 210 "freebase", |
| 211 "schema" |
| 212 ], |
| 213 "enumDescriptions": [ |
| 214 "Use freebase and popularity entity ranking.", |
| 215 "Use freebase entity ranking.", |
| 216 "Use schema ranking for properties and types." |
| 217 ], |
| 218 "location": "query", |
| 219 "type": "string" |
| 220 }, |
| 221 "spell": { |
| 222 "default": "no_spelling", |
| 223 "description": "Request 'did you mean' suggestions", |
| 224 "enum": [ |
| 225 "always", |
| 226 "no_results", |
| 227 "no_spelling" |
| 228 ], |
| 229 "enumDescriptions": [ |
| 230 "Request spelling suggestions for any query at least thr
ee characters long.", |
| 231 "Request spelling suggestions if no results were found."
, |
| 232 "Don't request spelling suggestions." |
| 233 ], |
| 234 "location": "query", |
| 235 "type": "string" |
| 236 }, |
| 237 "stemmed": { |
| 238 "description": "Query on stemmed names and aliases. May not
be used with prefixed.", |
| 239 "location": "query", |
| 240 "type": "boolean" |
| 241 }, |
| 242 "type": { |
| 243 "description": "Restrict to topics with this Freebase type i
d.", |
| 244 "location": "query", |
| 245 "repeated": true, |
| 246 "type": "string" |
| 247 }, |
| 248 "with": { |
| 249 "description": "A rule to match against.", |
| 250 "location": "query", |
| 251 "repeated": true, |
| 252 "type": "string" |
| 253 }, |
| 254 "without": { |
| 255 "description": "A rule to not match against.", |
| 256 "location": "query", |
| 257 "repeated": true, |
| 258 "type": "string" |
| 259 } |
| 260 }, |
| 261 "path": "search", |
| 262 "supportsMediaDownload": true |
| 263 } |
| 264 }, |
| 265 "name": "freebase", |
| 266 "ownerDomain": "google.com", |
| 267 "ownerName": "Google", |
| 268 "parameters": { |
| 269 "alt": { |
| 270 "default": "json", |
| 271 "description": "Data format for the response.", |
| 272 "enum": [ |
| 273 "json" |
| 274 ], |
| 275 "enumDescriptions": [ |
| 276 "Responses with Content-Type of application/json" |
| 277 ], |
| 278 "location": "query", |
| 279 "type": "string" |
| 280 }, |
| 281 "fields": { |
| 282 "description": "Selector specifying which fields to include in a par
tial response.", |
| 283 "location": "query", |
| 284 "type": "string" |
| 285 }, |
| 286 "key": { |
| 287 "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.", |
| 288 "location": "query", |
| 289 "type": "string" |
| 290 }, |
| 291 "oauth_token": { |
| 292 "description": "OAuth 2.0 token for the current user.", |
| 293 "location": "query", |
| 294 "type": "string" |
| 295 }, |
| 296 "prettyPrint": { |
| 297 "default": "true", |
| 298 "description": "Returns response with indentations and line breaks."
, |
| 299 "location": "query", |
| 300 "type": "boolean" |
| 301 }, |
| 302 "quotaUser": { |
| 303 "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. Overrides userIp if both are provided.", |
| 304 "location": "query", |
| 305 "type": "string" |
| 306 }, |
| 307 "userIp": { |
| 308 "description": "IP address of the site where the request originates.
Use this if you want to enforce per-user limits.", |
| 309 "location": "query", |
| 310 "type": "string" |
| 311 } |
| 312 }, |
| 313 "protocol": "rest", |
| 314 "revision": "20140418", |
| 315 "rootUrl": "https://www.googleapis.com/", |
| 316 "schemas": { |
| 317 "ReconcileCandidate": { |
| 318 "id": "ReconcileCandidate", |
| 319 "properties": { |
| 320 "confidence": { |
| 321 "description": "Percentage likelihood that this candidate is
the unique matching entity. Value will be between 0.0 and 1.0", |
| 322 "format": "float", |
| 323 "type": "number" |
| 324 }, |
| 325 "lang": { |
| 326 "description": "Language code that candidate and notable nam
es are displayed in.", |
| 327 "type": "string" |
| 328 }, |
| 329 "mid": { |
| 330 "description": "Freebase MID of candidate entity.", |
| 331 "type": "string" |
| 332 }, |
| 333 "name": { |
| 334 "description": "Freebase name of matching entity in specifie
d language.", |
| 335 "type": "string" |
| 336 }, |
| 337 "notable": { |
| 338 "description": "Type or profession the candidate is notable
for.", |
| 339 "properties": { |
| 340 "id": { |
| 341 "description": "MID of notable category.", |
| 342 "type": "string" |
| 343 }, |
| 344 "name": { |
| 345 "description": "Name of notable category in specifie
d language.", |
| 346 "type": "string" |
| 347 } |
| 348 }, |
| 349 "type": "object" |
| 350 } |
| 351 }, |
| 352 "type": "object" |
| 353 }, |
| 354 "ReconcileGet": { |
| 355 "id": "ReconcileGet", |
| 356 "properties": { |
| 357 "candidate": { |
| 358 "description": "If filled, then the listed candidates are po
tential matches, and such should be evaluated by a more discerning algorithm or
human. The matches are ordered by confidence.", |
| 359 "items": { |
| 360 "$ref": "ReconcileCandidate" |
| 361 }, |
| 362 "type": "array" |
| 363 }, |
| 364 "costs": { |
| 365 "description": "Server costs for reconciling.", |
| 366 "properties": { |
| 367 "hits": { |
| 368 "description": "Total number of hits found.", |
| 369 "format": "int32", |
| 370 "type": "integer" |
| 371 }, |
| 372 "ms": { |
| 373 "description": "Total milliseconds spent.", |
| 374 "format": "int32", |
| 375 "type": "integer" |
| 376 } |
| 377 }, |
| 378 "type": "object" |
| 379 }, |
| 380 "match": { |
| 381 "$ref": "ReconcileCandidate", |
| 382 "description": "If filled, this entity is guaranteed to matc
h at requested confidence probability (default 99%)." |
| 383 }, |
| 384 "warning": { |
| 385 "description": "If filled, then there were recoverable probl
ems that affected the request. For example, some of the properties were ignored
because they either are not valid Freebase predicates or are not indexed for rec
onciliation. The candidates returned should be considered valid results, with th
e caveat that sections of the request were ignored as specified by the warning t
ext.", |
| 386 "items": { |
| 387 "properties": { |
| 388 "location": { |
| 389 "description": "Location of warning in the reque
st e.g. invalid predicate.", |
| 390 "type": "string" |
| 391 }, |
| 392 "message": { |
| 393 "description": "Warning message to display to th
e user.", |
| 394 "type": "string" |
| 395 }, |
| 396 "reason": { |
| 397 "description": "Code for identifying classes of
warnings.", |
| 398 "type": "string" |
| 399 } |
| 400 }, |
| 401 "type": "object" |
| 402 }, |
| 403 "type": "array" |
| 404 } |
| 405 }, |
| 406 "type": "object" |
| 407 } |
| 408 }, |
| 409 "servicePath": "freebase/v1/", |
| 410 "title": "Freebase Search", |
| 411 "version": "v1" |
| 412 } |
OLD | NEW |