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