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.
 
 
 

183 lines
6.0 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. "callback": {
  53. "description": "JSONP",
  54. "location": "query",
  55. "type": "string"
  56. },
  57. "fields": {
  58. "description": "Selector specifying which fields to include in a partial response.",
  59. "location": "query",
  60. "type": "string"
  61. },
  62. "key": {
  63. "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.",
  64. "location": "query",
  65. "type": "string"
  66. },
  67. "oauth_token": {
  68. "description": "OAuth 2.0 token for the current user.",
  69. "location": "query",
  70. "type": "string"
  71. },
  72. "prettyPrint": {
  73. "default": "true",
  74. "description": "Returns response with indentations and line breaks.",
  75. "location": "query",
  76. "type": "boolean"
  77. },
  78. "quotaUser": {
  79. "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.",
  80. "location": "query",
  81. "type": "string"
  82. },
  83. "uploadType": {
  84. "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").",
  85. "location": "query",
  86. "type": "string"
  87. },
  88. "upload_protocol": {
  89. "description": "Upload protocol for media (e.g. \"raw\", \"multipart\").",
  90. "location": "query",
  91. "type": "string"
  92. }
  93. },
  94. "protocol": "rest",
  95. "resources": {
  96. "entities": {
  97. "methods": {
  98. "search": {
  99. "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",
  100. "flatPath": "v1/entities:search",
  101. "httpMethod": "GET",
  102. "id": "kgsearch.entities.search",
  103. "parameterOrder": [],
  104. "parameters": {
  105. "ids": {
  106. "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",
  107. "location": "query",
  108. "repeated": true,
  109. "type": "string"
  110. },
  111. "indent": {
  112. "description": "Enables indenting of json results.",
  113. "location": "query",
  114. "type": "boolean"
  115. },
  116. "languages": {
  117. "description": "The list of language codes (defined in ISO 693) to run the query with,\ne.g. 'en'.",
  118. "location": "query",
  119. "repeated": true,
  120. "type": "string"
  121. },
  122. "limit": {
  123. "description": "Limits the number of entities to be returned.",
  124. "format": "int32",
  125. "location": "query",
  126. "type": "integer"
  127. },
  128. "prefix": {
  129. "description": "Enables prefix match against names and aliases of entities",
  130. "location": "query",
  131. "type": "boolean"
  132. },
  133. "query": {
  134. "description": "The literal query string for search.",
  135. "location": "query",
  136. "type": "string"
  137. },
  138. "types": {
  139. "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.",
  140. "location": "query",
  141. "repeated": true,
  142. "type": "string"
  143. }
  144. },
  145. "path": "v1/entities:search",
  146. "response": {
  147. "$ref": "SearchResponse"
  148. }
  149. }
  150. }
  151. }
  152. },
  153. "revision": "20180809",
  154. "rootUrl": "https://kgsearch.googleapis.com/",
  155. "schemas": {
  156. "SearchResponse": {
  157. "description": "Response message includes the context and a list of matching results\nwhich contain the detail of associated entities.",
  158. "id": "SearchResponse",
  159. "properties": {
  160. "@context": {
  161. "description": "The local context applicable for the response. See more details at\nhttp://www.w3.org/TR/json-ld/#context-definitions.",
  162. "type": "any"
  163. },
  164. "@type": {
  165. "description": "The schema type of top-level JSON-LD object, e.g. ItemList.",
  166. "type": "any"
  167. },
  168. "itemListElement": {
  169. "description": "The item list of search results.",
  170. "items": {
  171. "type": "any"
  172. },
  173. "type": "array"
  174. }
  175. },
  176. "type": "object"
  177. }
  178. },
  179. "servicePath": "",
  180. "title": "Knowledge Graph Search API",
  181. "version": "v1",
  182. "version_module": true
  183. }