| 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 }, |
| 18 "key": { | 23 "key": { |
| 19 "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.", | 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.", |
| 20 "location": "query", | 25 "location": "query", |
| 21 "type": "string" | 26 "type": "string" |
| 22 }, | 27 }, |
| 23 "access_token": { | |
| 24 "description": "OAuth access token.", | |
| 25 "location": "query", | |
| 26 "type": "string" | |
| 27 }, | |
| 28 "quotaUser": { | 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.", | 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", | 30 "location": "query", |
| 31 "type": "string" | 31 "type": "string" |
| 32 }, | 32 }, |
| 33 "pp": { | 33 "pp": { |
| 34 "default": "true", | 34 "default": "true", |
| 35 "description": "Pretty-print response.", | 35 "description": "Pretty-print response.", |
| 36 "location": "query", | 36 "location": "query", |
| 37 "type": "boolean" | 37 "type": "boolean" |
| 38 }, | 38 }, |
| 39 "oauth_token": { |
| 40 "description": "OAuth 2.0 token for the current user.", |
| 41 "location": "query", |
| 42 "type": "string" |
| 43 }, |
| 39 "bearer_token": { | 44 "bearer_token": { |
| 40 "description": "OAuth bearer token.", | 45 "description": "OAuth bearer token.", |
| 41 "location": "query", | 46 "location": "query", |
| 42 "type": "string" | 47 "type": "string" |
| 43 }, | 48 }, |
| 44 "oauth_token": { | |
| 45 "description": "OAuth 2.0 token for the current user.", | |
| 46 "location": "query", | |
| 47 "type": "string" | |
| 48 }, | |
| 49 "upload_protocol": { | 49 "upload_protocol": { |
| 50 "description": "Upload protocol for media (e.g. \"raw\", \"multipart
\").", | 50 "description": "Upload protocol for media (e.g. \"raw\", \"multipart
\").", |
| 51 "location": "query", | 51 "location": "query", |
| 52 "type": "string" | 52 "type": "string" |
| 53 }, | 53 }, |
| 54 "prettyPrint": { | 54 "prettyPrint": { |
| 55 "default": "true", | 55 "default": "true", |
| 56 "description": "Returns response with indentations and line breaks."
, | 56 "description": "Returns response with indentations and line breaks."
, |
| 57 "location": "query", | 57 "location": "query", |
| 58 "type": "boolean" | 58 "type": "boolean" |
| 59 }, | 59 }, |
| 60 "fields": { |
| 61 "description": "Selector specifying which fields to include in a par
tial response.", |
| 62 "location": "query", |
| 63 "type": "string" |
| 64 }, |
| 60 "uploadType": { | 65 "uploadType": { |
| 61 "description": "Legacy upload protocol for media (e.g. \"media\", \"
multipart\").", | 66 "description": "Legacy upload protocol for media (e.g. \"media\", \"
multipart\").", |
| 62 "location": "query", | 67 "location": "query", |
| 63 "type": "string" | 68 "type": "string" |
| 64 }, | 69 }, |
| 65 "fields": { | |
| 66 "description": "Selector specifying which fields to include in a par
tial response.", | |
| 67 "location": "query", | |
| 68 "type": "string" | |
| 69 }, | |
| 70 "callback": { | |
| 71 "description": "JSONP", | |
| 72 "location": "query", | |
| 73 "type": "string" | |
| 74 }, | |
| 75 "$.xgafv": { | 70 "$.xgafv": { |
| 76 "description": "V1 error format.", | 71 "description": "V1 error format.", |
| 77 "enum": [ | 72 "enum": [ |
| 78 "1", | 73 "1", |
| 79 "2" | 74 "2" |
| 80 ], | 75 ], |
| 81 "enumDescriptions": [ | 76 "enumDescriptions": [ |
| 82 "v1 error format", | 77 "v1 error format", |
| 83 "v2 error format" | 78 "v2 error format" |
| 84 ], | 79 ], |
| 85 "location": "query", | 80 "location": "query", |
| 86 "type": "string" | 81 "type": "string" |
| 87 }, | 82 }, |
| 83 "callback": { |
| 84 "description": "JSONP", |
| 85 "location": "query", |
| 86 "type": "string" |
| 87 }, |
| 88 "alt": { | 88 "alt": { |
| 89 "default": "json", | 89 "default": "json", |
| 90 "description": "Data format for response.", | 90 "description": "Data format for response.", |
| 91 "enum": [ | 91 "enum": [ |
| 92 "json", | 92 "json", |
| 93 "media", | 93 "media", |
| 94 "proto" | 94 "proto" |
| 95 ], | 95 ], |
| 96 "enumDescriptions": [ | 96 "enumDescriptions": [ |
| 97 "Responses with Content-Type of application/json", | 97 "Responses with Content-Type of application/json", |
| 98 "Media download with context-dependent Content-Type", | 98 "Media download with context-dependent Content-Type", |
| 99 "Responses with Content-Type of application/x-protobuf" | 99 "Responses with Content-Type of application/x-protobuf" |
| 100 ], | 100 ], |
| 101 "location": "query", | 101 "location": "query", |
| 102 "type": "string" | 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 "prefix": { | |
| 116 "description": "Enables prefix match against names a
nd aliases of entities", | |
| 117 "location": "query", | |
| 118 "type": "boolean" | |
| 119 }, | |
| 120 "query": { | |
| 121 "description": "The literal query string for search.
", | |
| 122 "location": "query", | |
| 123 "type": "string" | |
| 124 }, | |
| 125 "types": { | 115 "types": { |
| 126 "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.", | 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.", |
| 127 "location": "query", | 117 "location": "query", |
| 128 "repeated": true, | 118 "repeated": true, |
| 129 "type": "string" | 119 "type": "string" |
| 130 }, | 120 }, |
| 131 "indent": { | 121 "indent": { |
| 132 "description": "Enables indenting of json results.", | 122 "description": "Enables indenting of json results.", |
| 133 "location": "query", | 123 "location": "query", |
| 134 "type": "boolean" | 124 "type": "boolean" |
| 135 }, | 125 }, |
| 136 "languages": { | 126 "languages": { |
| 137 "description": "The list of language codes (defined
in ISO 693) to run the query with,\ne.g. 'en'.", | 127 "description": "The list of language codes (defined
in ISO 693) to run the query with,\ne.g. 'en'.", |
| 138 "location": "query", | 128 "location": "query", |
| 139 "repeated": true, | 129 "repeated": true, |
| 140 "type": "string" | 130 "type": "string" |
| 141 }, | 131 }, |
| 142 "ids": { | 132 "ids": { |
| 143 "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", | 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", |
| 144 "location": "query", | 134 "location": "query", |
| 145 "repeated": true, | 135 "repeated": true, |
| 146 "type": "string" | 136 "type": "string" |
| 147 }, | 137 }, |
| 148 "limit": { | 138 "limit": { |
| 149 "description": "Limits the number of entities to be
returned.", | 139 "description": "Limits the number of entities to be
returned.", |
| 150 "format": "int32", | 140 "format": "int32", |
| 151 "location": "query", | 141 "location": "query", |
| 152 "type": "integer" | 142 "type": "integer" |
| 143 }, |
| 144 "prefix": { |
| 145 "description": "Enables prefix match against names a
nd aliases of entities", |
| 146 "location": "query", |
| 147 "type": "boolean" |
| 148 }, |
| 149 "query": { |
| 150 "description": "The literal query string for search.
", |
| 151 "location": "query", |
| 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 }, |
| 170 "@context": { | 174 "@context": { |
| 171 "description": "The local context applicable for the respons
e. See more details at\nhttp://www.w3.org/TR/json-ld/#context-definitions.", | 175 "description": "The local context applicable for the respons
e. See more details at\nhttp://www.w3.org/TR/json-ld/#context-definitions.", |
| 172 "type": "any" | 176 "type": "any" |
| 173 }, | 177 }, |
| 174 "itemListElement": { | 178 "itemListElement": { |
| 175 "description": "The item list of search results.", | 179 "description": "The item list of search results.", |
| 176 "items": { | 180 "items": { |
| 177 "type": "any" | 181 "type": "any" |
| 178 }, | 182 }, |
| 179 "type": "array" | 183 "type": "array" |
| 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 |