Module: BWAPI::Client::Projects::Queries

Includes:
Backfill, DateRange, Mentions
Included in:
BWAPI::Client::Projects
Defined in:
lib/bwapi/client/projects/queries.rb,
lib/bwapi/client/projects/queries/backfill.rb,
lib/bwapi/client/projects/queries/mentions.rb,
lib/bwapi/client/projects/queries/date_range.rb

Overview

Queries module for projects/queries endpoints

Defined Under Namespace

Modules: Backfill, DateRange, Mentions

Instance Method Summary collapse

Methods included from Mentions

#delete_query_mention, #get_query_mention_content, #update_query_mention

Methods included from DateRange

#create_date_range, #date_range, #date_ranges, #delete_date_range, #update_date_range

Methods included from Backfill

#backfills, #create_backfill, #delete_backfill, #get_backfill

Instance Method Details

#create_query(id, opts = {}) ⇒ Hashie::Mash

Create a new query in project

Parameters:

  • Id of project

  • (defaults to: {})

    options hash of parameters

Options Hash (opts):

  • id (String) —

    Id of the query

  • name (String) —

    Name of the project

  • dailyLimit (Integer) —

    Daily limit of the query

  • twitterLimit (Integer) —

    Twitter limit of the query

  • averageMonthlyMentions (Integer) —

    Average monthly mentions

  • type (String) —

    Query type

  • includedTerms (Array) —

    Included terms of terms query

  • contextTerms (Array) —

    Content terms of the query

  • excludedTerms (Array) —

    Excluded terms of thequery

  • languages (Array) —

    Query languages

  • twitterScreenName (String) —

    Tracked twitter screen name

  • industry (String) —

    Industry of the query

  • creationDate (Date) —

    Date the query was created on

  • lastModificationDate (Date) —

    Modification date of the query

Returns:

  • New query



56
57
58
 
# File 'lib/bwapi/client/projects/queries.rb', line 56

def create_query id, opts={}
  post "projects/#{id}/queries", opts
end

#delete_query(project_id, query_id) ⇒ Hashie::Mash

Delete an existing query project

Parameters:

  • Id of project

  • Id of query

Returns:

  • Deleted query



89
90
91
 
# File 'lib/bwapi/client/projects/queries.rb', line 89

def delete_query project_id, query_id
  delete "projects/#{project_id}/queries/#{query_id}"
end

#get_query(project_id, query_id) ⇒ Hashie::Mash Also known as: query

Get a specific query in project

Parameters:

  • Id of project

  • Id of query

Returns:

  • Specific query



32
33
34
 
# File 'lib/bwapi/client/projects/queries.rb', line 32

def get_query project_id, query_id
  get "projects/#{project_id}/queries/#{query_id}"
end

#queries(id) ⇒ Hashie::Mash

Get all queries in project

Parameters:

  • Id of project

Returns:

  • All queries in project



15
16
17
 
# File 'lib/bwapi/client/projects/queries.rb', line 15

def queries id
  get "projects/#{id}/queries"
end

#queries_summary(id) ⇒ Hashie::Mash

Get summary of all queries in project

Parameters:

  • Id of project

Returns:

  • Summary of all queries in project



23
24
25
 
# File 'lib/bwapi/client/projects/queries.rb', line 23

def queries_summary id
  get "projects/#{id}/queries/summary"
end

#update_query(project_id, query_id, opts = {}) ⇒ Hashie::Mash

Update an existing query in project

Parameters:

  • Id of project

  • Id of query

  • (defaults to: {})

    options hash of parameters

Options Hash (opts):

  • id (Integer) —

    Id of the query

  • name (String) —

    Name of the project

  • dailyLimit (Integer) —

    Daily limit of the query

  • twitterLimit (Integer) —

    Twitter limit of the query

  • averageMonthlyMentions (Integer) —

    Average monthly mentions

  • type (String) —

    Query type

  • includedTerms (Array) —

    Included terms of terms query

  • contextTerms (Array) —

    Content terms of the query

  • excludedTerms (Array) —

    Excluded terms of thequery

  • languages (Array) —

    Query languages

  • twitterScreenName (String) —

    Tracked twitter screen name

  • industry (String) —

    Industry of the query

  • creationDate (Date) —

    Date the query was created on

  • lastModificationDate (Date) —

    Modification date of the query

Returns:

  • Updated query



80
81
82
 
# File 'lib/bwapi/client/projects/queries.rb', line 80

def update_query project_id, query_id, opts={}
  put "projects/#{project_id}/queries/#{query_id}", opts
end