Class: Google::Apis::KgsearchV1::KgsearchService

Inherits:
Core::BaseService show all
Defined in:
generated/google/apis/kgsearch_v1/service.rb

Overview

Knowledge Graph Search API

Searches the Google Knowledge Graph for entities.

Examples:

require 'google/apis/kgsearch_v1'

Kgsearch = Google::Apis::KgsearchV1 # Alias the module
service = Kgsearch::KgsearchService.new

See Also:

Instance Attribute Summary collapse

Attributes inherited from Core::BaseService

#authorization, #base_path, #batch_path, #client, #client_options, #request_options, #root_url, #upload_path

Instance Method Summary collapse

Methods inherited from Core::BaseService

#batch, #batch_upload, #fetch_all, #http

Methods included from Core::Logging

#logger

Constructor Details

#initializeKgsearchService

Returns a new instance of KgsearchService



45
46
47
48
# File 'generated/google/apis/kgsearch_v1/service.rb', line 45

def initialize
  super('https://kgsearch.googleapis.com/', '')
  @batch_path = 'batch'
end

Instance Attribute Details

#keyString

Returns 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.

Returns:

  • (String)

    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.



38
39
40
# File 'generated/google/apis/kgsearch_v1/service.rb', line 38

def key
  @key
end

#quota_userString

Returns 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.

Returns:

  • (String)

    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.



43
44
45
# File 'generated/google/apis/kgsearch_v1/service.rb', line 43

def quota_user
  @quota_user
end

Instance Method Details

#search_entities(types: nil, indent: nil, languages: nil, ids: nil, limit: nil, prefix: nil, query: nil, fields: nil, quota_user: nil, options: nil) {|result, err| ... } ⇒ Google::Apis::KgsearchV1::SearchResponse

Searches Knowledge Graph for entities that match the constraints. A list of matched entities will be returned in response, which will be in JSON-LD format and compatible with http://schema.org

Parameters:

  • types (Array<String>, String)

    Restricts returned entities with these types, e.g. Person (as defined in http://schema.org/Person). If multiple types are specified, returned entities will contain one or more of these types.

  • indent (Boolean)

    Enables indenting of json results.

  • languages (Array<String>, String)

    The list of language codes (defined in ISO 693) to run the query with, e.g. 'en'.

  • ids (Array<String>, String)

    The list of entity id to be used for search instead of query string. To specify multiple ids in the HTTP request, repeat the parameter in the URL as in ...?ids=A&ids=B

  • limit (Fixnum)

    Limits the number of entities to be returned.

  • prefix (Boolean)

    Enables prefix match against names and aliases of entities

  • query (String)

    The literal query string for search.

  • fields (String)

    Selector specifying which fields to include in a partial response.

  • quota_user (String)

    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.

  • options (Google::Apis::RequestOptions)

    Request-specific options

Yields:

  • (result, err)

    Result & error if block supplied

Yield Parameters:

Returns:

Raises:



89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
# File 'generated/google/apis/kgsearch_v1/service.rb', line 89

def search_entities(types: nil, indent: nil, languages: nil, ids: nil, limit: nil, prefix: nil, query: nil, fields: nil, quota_user: nil, options: nil, &block)
  command =  make_simple_command(:get, 'v1/entities:search', options)
  command.response_representation = Google::Apis::KgsearchV1::SearchResponse::Representation
  command.response_class = Google::Apis::KgsearchV1::SearchResponse
  command.query['types'] = types unless types.nil?
  command.query['indent'] = indent unless indent.nil?
  command.query['languages'] = languages unless languages.nil?
  command.query['ids'] = ids unless ids.nil?
  command.query['limit'] = limit unless limit.nil?
  command.query['prefix'] = prefix unless prefix.nil?
  command.query['query'] = query unless query.nil?
  command.query['fields'] = fields unless fields.nil?
  command.query['quotaUser'] = quota_user unless quota_user.nil?
  execute_or_queue_command(command, &block)
end