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 |