194 lines
6.3 KiB
JSON
194 lines
6.3 KiB
JSON
{
|
|
"version_module": "True",
|
|
"resources": {
|
|
"entities": {
|
|
"methods": {
|
|
"search": {
|
|
"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",
|
|
"response": {
|
|
"$ref": "SearchResponse"
|
|
},
|
|
"parameterOrder": [],
|
|
"httpMethod": "GET",
|
|
"parameters": {
|
|
"languages": {
|
|
"repeated": true,
|
|
"location": "query",
|
|
"description": "The list of language codes (defined in ISO 693) to run the query with,\ne.g. 'en'.",
|
|
"type": "string"
|
|
},
|
|
"ids": {
|
|
"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&ids=B",
|
|
"type": "string",
|
|
"repeated": true,
|
|
"location": "query"
|
|
},
|
|
"limit": {
|
|
"location": "query",
|
|
"format": "int32",
|
|
"description": "Limits the number of entities to be returned.",
|
|
"type": "integer"
|
|
},
|
|
"prefix": {
|
|
"description": "Enables prefix match against names and aliases of entities",
|
|
"type": "boolean",
|
|
"location": "query"
|
|
},
|
|
"query": {
|
|
"type": "string",
|
|
"location": "query",
|
|
"description": "The literal query string for search."
|
|
},
|
|
"types": {
|
|
"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.",
|
|
"type": "string",
|
|
"repeated": true,
|
|
"location": "query"
|
|
},
|
|
"indent": {
|
|
"description": "Enables indenting of json results.",
|
|
"type": "boolean",
|
|
"location": "query"
|
|
}
|
|
},
|
|
"flatPath": "v1/entities:search",
|
|
"id": "kgsearch.entities.search",
|
|
"path": "v1/entities:search"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"parameters": {
|
|
"callback": {
|
|
"location": "query",
|
|
"description": "JSONP",
|
|
"type": "string"
|
|
},
|
|
"$.xgafv": {
|
|
"enum": [
|
|
"1",
|
|
"2"
|
|
],
|
|
"description": "V1 error format.",
|
|
"type": "string",
|
|
"enumDescriptions": [
|
|
"v1 error format",
|
|
"v2 error format"
|
|
],
|
|
"location": "query"
|
|
},
|
|
"alt": {
|
|
"enum": [
|
|
"json",
|
|
"media",
|
|
"proto"
|
|
],
|
|
"type": "string",
|
|
"enumDescriptions": [
|
|
"Responses with Content-Type of application/json",
|
|
"Media download with context-dependent Content-Type",
|
|
"Responses with Content-Type of application/x-protobuf"
|
|
],
|
|
"location": "query",
|
|
"description": "Data format for response.",
|
|
"default": "json"
|
|
},
|
|
"key": {
|
|
"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.",
|
|
"type": "string",
|
|
"location": "query"
|
|
},
|
|
"access_token": {
|
|
"type": "string",
|
|
"location": "query",
|
|
"description": "OAuth access token."
|
|
},
|
|
"quotaUser": {
|
|
"location": "query",
|
|
"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.",
|
|
"type": "string"
|
|
},
|
|
"pp": {
|
|
"location": "query",
|
|
"description": "Pretty-print response.",
|
|
"default": "true",
|
|
"type": "boolean"
|
|
},
|
|
"oauth_token": {
|
|
"location": "query",
|
|
"description": "OAuth 2.0 token for the current user.",
|
|
"type": "string"
|
|
},
|
|
"bearer_token": {
|
|
"location": "query",
|
|
"description": "OAuth bearer token.",
|
|
"type": "string"
|
|
},
|
|
"upload_protocol": {
|
|
"location": "query",
|
|
"description": "Upload protocol for media (e.g. \"raw\", \"multipart\").",
|
|
"type": "string"
|
|
},
|
|
"prettyPrint": {
|
|
"default": "true",
|
|
"type": "boolean",
|
|
"location": "query",
|
|
"description": "Returns response with indentations and line breaks."
|
|
},
|
|
"uploadType": {
|
|
"location": "query",
|
|
"description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").",
|
|
"type": "string"
|
|
},
|
|
"fields": {
|
|
"location": "query",
|
|
"description": "Selector specifying which fields to include in a partial response.",
|
|
"type": "string"
|
|
}
|
|
},
|
|
"schemas": {
|
|
"SearchResponse": {
|
|
"description": "Response message includes the context and a list of matching results\nwhich contain the detail of associated entities.",
|
|
"type": "object",
|
|
"properties": {
|
|
"itemListElement": {
|
|
"description": "The item list of search results.",
|
|
"items": {
|
|
"type": "any"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"@context": {
|
|
"description": "The local context applicable for the response. See more details at\nhttp://www.w3.org/TR/json-ld/#context-definitions.",
|
|
"type": "any"
|
|
},
|
|
"@type": {
|
|
"description": "The schema type of top-level JSON-LD object, e.g. ItemList.",
|
|
"type": "any"
|
|
}
|
|
},
|
|
"id": "SearchResponse"
|
|
}
|
|
},
|
|
"icons": {
|
|
"x16": "http://www.google.com/images/icons/product/search-16.gif",
|
|
"x32": "http://www.google.com/images/icons/product/search-32.gif"
|
|
},
|
|
"protocol": "rest",
|
|
"version": "v1",
|
|
"baseUrl": "https://kgsearch.googleapis.com/",
|
|
"servicePath": "",
|
|
"description": "Searches the Google Knowledge Graph for entities.",
|
|
"kind": "discovery#restDescription",
|
|
"rootUrl": "https://kgsearch.googleapis.com/",
|
|
"basePath": "",
|
|
"ownerDomain": "google.com",
|
|
"name": "kgsearch",
|
|
"batchPath": "batch",
|
|
"documentationLink": "https://developers.google.com/knowledge-graph/",
|
|
"revision": "20170109",
|
|
"id": "kgsearch:v1",
|
|
"title": "Knowledge Graph Search API",
|
|
"discoveryVersion": "v1",
|
|
"ownerName": "Google"
|
|
}
|