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