You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 

194 lines
6.3 KiB

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