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