yandex-direct-api 1.0.0 → 1.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: b3179fac1ae6dd3d8e997c28e6f8358b6ffa5089
-  data.tar.gz: 3473b4882754ef0f0f8b3ce350514964599bf038
+  metadata.gz: 2b2481f400a3b99c634d239b68aae9b09e4eda09
+  data.tar.gz: b824938bb314043a51667375415423a4ccfe48bd
 SHA512:
-  metadata.gz: 236a6e20d5f018ed8d650d90892bf335f43ea18111b8bd6361967e737a6b8dc0c458a5dc9a4e467cf26c7f6743921d42ad6b99928b761b395d763e8ddc1fea36
-  data.tar.gz: 559ed3c881110c34bd0e9c207bea562206befaafe161c2b6805fcf3cbfed532481c6b44a5d6e4b7ccc7a7fd0f7d598f27eab572a0ede12328a201561d253d1ae
+  metadata.gz: 37f6f9d26ea3cf521d5ecb22d3a9e47b160d919fe3852d137a4ab4c3dc7201202d7f4c4ef7c51aedf9da69ce8ca83af84afc1ea3fed235960ebe7f966eb4c2e9
+  data.tar.gz: d709c58aaeb932b95967767a3992f033cd7491d7c678a50619f51833da0bec25776be9cbd2dc19f67bd88f9be0e0c144355f158b854d58613f3ad02a6be37391

data/README.md

@@ -0,0 +1,10 @@
+# yandex-direct-api
+Интеграция с API Yandex Direct v.5
+
+gem 'yandex-direct-api'
+
+bundle
+
+rake yandex_direct:install
+
+Внесите изменения в config/yandex_direct_api.yml

data/lib/live/live.rb

@@ -0,0 +1,62 @@
+module YandexDirect::Live
+  def self.configuration
+    YandexDirect.configuration
+  end
+
+  def self.request (method, params = {})
+    body = {
+      locale: configuration['locale'],
+      token: configuration['token'],
+      method: method,
+      param: params
+    }
+
+    url = URI((configuration['sandbox'] ? 'https://api-sandbox.direct.yandex.ru/live/v4/json/' : 'https://api.direct.yandex.ru/live/v4/json/'))
+
+    if configuration['verbose']
+      puts "\t\033[32mYandex.Direct:\033[0m #{method}(#{body[:param]})"
+    end
+
+    http = Net::HTTP.new(url.host, url.port)
+    http.use_ssl = true
+    http.verify_mode = OpenSSL::SSL::VERIFY_NONE
+    response = http.post(url.path, JSON.generate(body))
+
+    raise YandexDirect::RuntimeError.new("#{response.code} - #{response.message}") unless response.code.to_i == 200
+
+    json = YandexDirect.parse_json(response.body)
+    
+    if json.has_key?('error_code') and json.has_key?('error_str')
+      code = json['error_code'].to_i
+      error = json['error_detail'].length > 0 ? json['error_detail'] : json['error_str']
+      raise YandexDirect::RuntimeError.new "#{code} - #{error}"
+    end
+    
+    return json['data']
+  end
+
+  def self.upload_image (url, name)
+    result = YandexDirect::Live.request('AdImage', {'Action': 'Upload', 'AdImageURLData': [{'Login': configuration['login'], 'URL': url, 'Name': name}]})
+    result['ActionsResult'].first['AdImageUploadTaskID']
+  end
+
+  def self.get_image_hash(upload_task_ids)
+    result = YandexDirect::Live.request('AdImage', {'Action': 'CheckUploadStatus', 'SelectionCriteria': {'AdImageUploadTaskIDS': upload_task_ids}})
+    result["AdImageUploads"]
+  end
+
+  def self.get_uploaded_image_hashes(params)
+    upload_task_ids = params.map{|p| p[:image_upload_task_id]}
+    if upload_task_ids.any?
+      image_hashes = YandexDirect::Live.get_image_hash(upload_task_ids)
+      associations = []
+      image_hashes.each do |result|
+        unless result['Status'] == 'Pending'
+          add = params.find{|p| p.image_upload_task_id == result['AdImageUploadTaskID']}
+          associations.push({add_id: add.add_id, ad_image_hash: result['AdImageHash']}) unless result['Status'] == 'Error'
+        end
+      end
+      associations
+    end
+  end
+end

data/lib/services/ad_group.rb

@@ -0,0 +1,80 @@
+class YandexDirect::AdGroup
+  SERVICE = 'adgroups'
+  attr_accessor :name, :campaign_id, :id, :status, :region_ids, :negative_keywords, :tracking_params
+
+  def initialize(params)
+    @name = params[:name]
+    @id = params[:id]
+    @status = params[:status]
+    @campaign_id = params[:campaign_id]
+    @region_ids = params[:region_ids]
+    @negative_keywords = {"Items": params[:negative_keywords]} if params[:negative_keywords].present?
+    @tracking_params = params[:tracking_params]
+  end
+
+  def self.list(params)
+    selection_criteria = {"Types":  ["TEXT_AD_GROUP"]}
+    selection_criteria["CampaignIds"] = params[:campaign_ids] if params[:campaign_ids].present?
+    selection_criteria["Ids"] = params[:ids] if params[:ids].present?
+    ad_groups = YandexDirect.request(SERVICE, 'get', { 
+      "SelectionCriteria": selection_criteria,
+      "FieldNames": ['Id', 'Name', 'CampaignId', 'Status', 'RegionIds', 'TrackingParams', 'NegativeKeywords']
+    })["AdGroups"]
+    (ad_groups || []).map{|c| new({ name: c["Name"], id: c["Id"], status: c["Status"], campaign_id: c["CampaignId"], 
+                                    region_ids: c["RegionIds"], tracking_params: c["TrackingParams"], negative_keywords: c["NegativeKeywords"]})}
+  end
+
+  def self.add(params)
+    if params.kind_of?(Array)
+      batch_add(params)
+    else
+      params.id = YandexDirect.request(SERVICE, 'add', {"AdGroups": [params.parameters]})["AddResults"].first["Id"]
+      params
+    end
+  end
+
+  def self.update(params)
+    if params.kind_of?(Array)
+      batch_update(params)
+    else
+      params.id = YandexDirect.request(SERVICE, 'update', {"AdGroups": [params.update_parameters]})["UpdateResults"].first["Id"]
+      params
+    end
+  end
+
+  def parameters
+    hash = {"Name": @name,
+            "CampaignId": @campaign_id,
+            "RegionIds": @region_ids || [0],
+            "TrackingParams": @tracking_params
+          }
+    hash["NegativeKeywords"] = @negative_keywords if @negative_keywords.present?
+    hash
+  end
+
+  def update_parameters
+    hash = {"Name": @name,
+            "RegionIds": @region_ids || [0],
+            "TrackingParams": @tracking_params,
+            "Id": @id
+          }
+    hash["NegativeKeywords"] = @negative_keywords if @negative_keywords.present?
+    hash
+  end
+
+  private
+
+  def self.batch_update(ad_groups)
+    params = ad_groups.map(&:update_parameters)
+    params.each_slice(100) do |add_parameters|
+      YandexDirect.request(SERVICE, 'update', {"AdGroups": add_parameters.compact})["UpdateResults"]
+    end
+  end
+
+  def self.batch_add(ad_groups)
+    params = ad_groups.map(&:parameters)
+    params.each_slice(100) do |add_parameters|
+      YandexDirect.request(SERVICE, 'add', {"AdGroups": add_parameters.compact})["AddResults"]
+    end
+  end
+end

data/lib/services/add.rb

@@ -0,0 +1,162 @@
+class YandexDirect::Add
+  SERVICE = 'ads'
+  attr_accessor :ad_group_id, :campaign_id, :id, :status, :state, :type, :status_clarification, :text, :title, :href, 
+                :display_url_path, :ad_image_hash, :extension_ids, :mobile, :v_card_id, :sitelink_set_id
+
+  def initialize(params)
+    @ad_group_id = params[:ad_group_id]
+    @id = params[:id]
+    @status = params[:status]
+    @campaign_id = params[:campaign_id]
+    @negative_keywords = params[:negative_keywords]
+    @utm_tags = params[:utm_tags]
+    @state = params[:state]
+    @type = params[:type] || "TEXT_AD"
+    @status_clarification = params[:status_clarification]
+    @text = params[:text]
+    @title = params[:title]
+    @href = params[:href]
+    @display_url_path = params[:display_url_path]
+    @ad_image_hash = params[:ad_image_hash]
+    @extension_ids = params[:extension_ids]
+    @mobile = params[:mobile]
+    @v_card_id = params[:v_card_id]
+    @extension_ids = params[:extension_ids]
+    @mobile = params[:mobile]
+    @sitelink_set_id = params[:sitelink_set_id]
+  end
+
+  def self.list(params)
+    selection_criteria = {"Types":  ["TEXT_AD"]}
+    selection_criteria["CampaignIds"] = params[:campaign_ids] if params[:campaign_ids].present?
+    selection_criteria["AdGroupIds"] = params[:ad_group_ids] if params[:ad_group_ids].present?
+    selection_criteria["Ids"] = params[:ids] if params[:ids].present?
+    ads = YandexDirect.request(SERVICE, 'get', { 
+      "SelectionCriteria": selection_criteria,
+      "FieldNames": ['AdGroupId', 'CampaignId', 'State', 'Status', 'StatusClarification', 'Type', 'Id'],
+      "TextAdFieldNames": ['SitelinkSetId', 'Text', 'Title', 'Href']
+    })["Ads"]
+    (ads || []).map{|c| new({ ad_group_id: c["AdGroupId"], id: c["Id"], status: c["Status"], campaign_id: c["CampaignId"], 
+                              state: c["State"], type: c["Type"], status_clarification: c["StatusClarification"], 
+                              sitelink_set_id: c["TextAd"]["SitelinkSetId"], text: c["TextAd"]["Text"], title: c["TextAd"]["Title"], href: c["TextAd"]["Href"]})}
+  end
+
+  def self.add(params)
+    if params.kind_of?(Array)
+      batch_add(params)
+    else
+      special_parameters = params.new_text_add_parameters if params.type == "TEXT_AD"
+      params.id = YandexDirect.request(SERVICE, 'add', {"Ads": [params.add_parameters(special_parameters)]})["AddResults"].first["Id"]
+      params
+    end
+  end
+
+  def self.update(params)
+    if params.kind_of?(Array)
+      batch_update(params)
+    else
+      special_parameters = params.text_add_parameters if params.type == "TEXT_AD"
+      params.id = YandexDirect.request(SERVICE, 'update', {"Ads": [params.update_parameters(special_parameters)]})["UpdateResults"].first["Id"]
+      params
+    end
+  end
+
+  def self.unarchive(ids)
+    ids = [ids] unless params.kind_of?(Array)
+    action('unarchieve', ids)
+  end
+
+  def self.archive(ids)
+    ids = [ids] unless params.kind_of?(Array)
+    action('archieve', ids)
+  end
+
+  def self.stop(ids)
+    ids = [ids] unless params.kind_of?(Array)
+    action('suspend', ids)
+  end
+
+  def self.resume(ids)
+    ids = [ids] unless params.kind_of?(Array)
+    action('resume', ids)
+  end
+
+  def self.moderate(ids)
+    ids = [ids] unless params.kind_of?(Array)
+    action('moderate', ids)
+  end
+
+  def self.delete(ids)
+    ids = [ids] unless params.kind_of?(Array)
+    action('delete', ids)
+  end
+
+  def add_parameters(add_type)
+    hash = {"AdGroupId": @ad_group_id}
+    hash[add_type.first] = add_type.last
+    hash
+  end
+
+  def update_parameters(add_type)
+    hash = {"Id": @id}
+    hash[add_type.first] = add_type.last
+    hash
+  end
+
+  def new_text_add_parameters
+    hash = {"Text": @text, 
+            "Title": @title,
+            "Href": @href,
+            "Mobile": @mobile || "NO",
+            "AdExtensionIds": @extension_ids || []
+           }
+    hash["DisplayUrlPath"] = @display_url_path if @display_url_path.present?
+    hash["VCardId"] = @v_card_id if @v_card_id.present?
+    hash["AdImageHash"] = @ad_image_hash if @ad_image_hash.present?
+    hash["SitelinkSetId"] = @sitelink_set_id if @sitelink_set_id.present?
+    ["TextAd", hash]
+  end
+
+  def text_add_parameters
+    hash = {"Text": @text, 
+            "Title": @title,
+            "Href": @href,
+           }
+    hash["DisplayUrlPath"] = @display_url_path if @display_url_path.present?
+    hash["AdImageHash"] = @ad_image_hash if @ad_image_hash.present?
+    hash["CalloutSetting"]["AdExtensions"] = @extension_ids.map{|e| {"AdExtensionId": e, "Operation": "SET"}} if @extension_ids.present?
+    hash["VCardId"] = @v_card_id if @v_card_id.present?
+    hash["SitelinkSetId"] = @sitelink_set_id if @sitelink_set_id.present?
+    ["TextAd", hash]
+  end
+
+  private
+
+  def self.batch_update(adds)
+    params = adds.map do |add|
+      special_parameters = add.text_add_parameters if add.type == "TEXT_AD"
+      add.update_parameters(special_parameters)
+    end
+    params.each_slice(100) do |add_parameters|
+      YandexDirect.request(SERVICE, 'update', {"Ads": add_parameters.compact})["UpdateResults"]
+    end
+  end
+
+  def self.batch_add(adds)
+    params = adds.map do |add|
+      special_parameters = add.new_text_add_parameters if add.type == "TEXT_AD"
+      add.add_parameters(special_parameters)
+    end
+    params.each_slice(100) do |add_parameters|
+      YandexDirect.request(SERVICE, 'add', {"Ads": add_parameters.compact})["AddResults"]
+    end
+  end
+
+  def action(action_name, params)
+    selection_criteria = {}
+    selection_criteria["CampaignIds"] = params[:campaign_ids] if params[:campaign_ids].present?
+    selection_criteria["AdGroupIds"] = params[:ad_group_ids] if params[:ad_group_ids].present?
+    selection_criteria["Ids"] = params[:ids] if params[:ids].present?
+    YandexDirect.request(SERVICE, 'action_name', {"SelectionCriteria": selection_criteria}) if @id.present? && @id != 0
+  end
+end

data/lib/services/bid.rb

@@ -0,0 +1,27 @@
+class YandexDirect::Bid
+  SERVICE = 'bids'
+
+  def self.list(params)
+    selection_criteria = {}
+    selection_criteria["CampaignIds"] = params[:campaign_ids] if params[:campaign_ids].present?
+    selection_criteria["Ids"] = params[:ids] if params[:ids].present?
+    selection_criteria["AdGroupIds"] = params[:ad_group_ids] if params[:ad_group_ids].present?
+    selection_criteria["KeywordIds"] = params[:keyword_ids] if params[:keyword_ids].present?
+    YandexDirect.request(SERVICE, 'get', { 
+      "SelectionCriteria": selection_criteria,
+      "FieldNames": ["KeywordId", "AdGroupId", "CampaignId", "Bid", "ContextBid", "StrategyPriority", "CompetitorsBids", "SearchPrices", "ContextCoverage", "MinSearchPrice", "CurrentSearchPrice", "AuctionBids"]
+    })["Bids"] || []
+  end
+
+  def self.set(bids)
+    bids.map! do |bid|
+      params = {"Bid": bid[:bid] * 1000000, "StrategyPriority": bid[:StrategyPriority] || "NORMAL"}
+      params["CampaignId"] = bid[:campaign_id] if bid[:campaign_id].present?
+      params["AdGroupId"] = bid[:ad_group_id] if bid[:ad_group_id].present?
+      params["KeywordId"] = bid[:keyword_id] if bid[:keyword_id].present?
+      params["ContextBid"] = bid[:context_bid] * 1000000 if bid[:context_bid].present?
+      params
+    end
+    YandexDirect.request(SERVICE, 'set', {"Bids": bids})["SetResults"]
+  end
+end

data/lib/services/campaign.rb

@@ -0,0 +1,140 @@
+class YandexDirect::Campaign
+  SERVICE = 'campaigns'
+  attr_accessor :name, :start_date, :time_zone, :id, :status, :state, :negative_keywords, :email, :owner_name, 
+                :search_strategy, :network_strategy, :limit_percent, :bid_percent, :end_date, :daily_budget_amount,
+                :daily_budget_mode, :blocked_ips, :excluded_sites, :type, :target_hours
+
+  def initialize(params)
+    @name = params[:name]
+    @id = params[:id]
+    @status = params[:status]
+    @state = params[:state]
+    @start_date = params[:start_date]
+    @time_zone = params[:time_zone]
+    @negative_keywords = {"Items": params[:negative_keywords]} if params[:negative_keywords].present?
+    @email = params[:email]
+    @owner_name = params[:owner_name]
+    @limit_percent = params[:limit_percent]
+    @bid_percent = params[:bid_percent]
+    @end_date = params[:end_date]
+    @daily_budget_amount = params[:daily_budget_amount]
+    @daily_budget_mode = params[:daily_budget_mode]
+    @blocked_ips = params[:blocked_ips]
+    @excluded_sites = params[:excluded_sites]
+    @search_strategy = params[:search_strategy]
+    @network_strategy = params[:network_strategy]
+    @target_hours = params[:target_hours]
+    @type == params[:type] || "TEXT_CAMPAIGN"
+  end
+
+  def self.list
+    YandexDirect.request(SERVICE, 'get', { 
+      "SelectionCriteria": {
+        "Types": ["TEXT_CAMPAIGN"], 
+        "States": ["OFF", "ON"], 
+        "Statuses": ["ACCEPTED", "DRAFT", "MODERATION"]
+      },
+      "FieldNames": ['Id', 'Name', 'State', 'Status', 'TimeTargeting', 'NegativeKeywords', 'ClientInfo', 'Type'],
+      "TextCampaignFieldNames": ["BiddingStrategy"]
+    })["Campaigns"].map{|c| new({ name: c["Name"], id: c["Id"], status: c["Status"], state: c["State"], type: c["Type"],
+                                  target_hours: c["TimeTargeting"]["Schedule"]["Items"], owner_name: c["ClientInfo"],
+                                  negative_keywords: (c["NegativeKeywords"].present? ? c["NegativeKeywords"]["Items"] : nil), search_strategy: c["TextCampaign"]["BiddingStrategy"]["Search"]["BiddingStrategyType"], 
+                                  network_strategy: c["TextCampaign"]["BiddingStrategy"]["Network"]["BiddingStrategyType"]})}
+  end
+
+  def self.add(params)
+    if params.kind_of?(Array)
+      batch_add(params)
+    else
+      special_parameters = params.text_campaign_parameters if  params.type.blank? || params.type == "TEXT_CAMPAIGN"
+      params.id = YandexDirect.request(SERVICE, 'add', {"Campaigns": [params.parameters(special_parameters)]})["AddResults"].first["Id"]
+      params
+    end
+  end
+
+  def self.update(params)
+    if params.kind_of?(Array)
+      batch_update(params)
+    else
+      special_parameters = params.text_campaign_parameters if params.type.blank? || params.type == "TEXT_CAMPAIGN"
+      params.id = YandexDirect.request(SERVICE, 'update', {"Campaigns": [params.parameters(special_parameters)]})["UpdateResults"].first["Id"]
+      params
+    end
+  end
+
+  def parameters(campaign_type)
+    hash = {"Name": @name,
+            "ClientInfo": @owner_name,
+            "Notification": {  
+              "EmailSettings": {
+                "Email": @email,
+                "SendAccountNews": "YES",
+                "SendWarnings": "YES"
+              }
+            },
+            "TimeTargeting": {
+              "Schedule": {
+                "Items": @target_hours
+              },
+              "ConsiderWorkingWeekends": "YES",
+              "HolidaysSchedule": {
+                "SuspendOnHolidays": "NO",
+                "BidPercent": 100,
+                "StartHour": 0,
+                "EndHour": 24
+              } 
+            },
+            "TimeZone": @time_zone
+          }
+    hash["NegativeKeywords"] = @negative_keywords if @negative_keywords.present?
+    hash["DailyBudget"] = {"Amount": @daily_budget_amount, "Mode": @daily_budget_mode} if @daily_budget_mode.present? && @daily_budget_amount.present?
+    hash["BlockedIps"] = {"Items": @blocked_ips} if @blocked_ips.present?
+    hash["ExcludedSites"] = {"Items": @excluded_sites} if @excluded_sites.present?
+    hash["Id"] = @id if @id.present? && @id != 0
+    hash["StartDate"] = @start_date if @start_date.present?
+    hash["EndDate"] = @end_date if @end_date.present?
+    hash[campaign_type.first] = campaign_type.last
+    hash
+  end
+
+  def text_campaign_parameters
+    ["TextCampaign", {"BiddingStrategy": {
+                        "Search": {
+                          "BiddingStrategyType": @search_strategy
+                        }, 
+                        "Network": { 
+                          "BiddingStrategyType": @network_strategy,
+                          "NetworkDefault": {
+                            "LimitPercent": @limit_percent,
+                            "BidPercent": @bid_percent
+                          }
+                        }
+                      }
+                    }
+    ]
+  end
+
+  private
+
+  def self.batch_add(campaigns)
+    params = []
+    campaigns.each do |campaign|
+      special_parameters = campaign.text_campaign_parameters if campaign.type.blank? || campaign.type == "TEXT_CAMPAIGN"
+      params.push(campaign.parameters(special_parameters))
+    end
+    params.each_slice(10) do |add_parameters|
+      YandexDirect.request(SERVICE, 'add', {"Campaigns": add_parameters.compact})["AddResults"].map{|r| r["Id"]}
+    end
+  end
+
+  def self.batch_update(campaigns)
+    params = []
+    campaigns.each do |campaign|
+      special_parameters = campaign.text_campaign_parameters if campaign.type.blank? || campaign.type == "TEXT_CAMPAIGN"
+      params.push(campaign.parameters(special_parameters))
+    end
+    params.each_slice(10) do |add_parameters|
+      YandexDirect.request(SERVICE, 'update', {"Campaigns": add_parameters.compact})["UpdateResults"].map{|r| r["Id"]}
+    end
+  end
+end

data/lib/services/dictionaries.rb

@@ -0,0 +1,7 @@
+module YandexDirect::Dictionaries
+  SERVICE = 'dictionaries'
+
+  def self.get_regions
+    YandexDirect.request(SERVICE, 'get', {"DictionaryNames": ["GeoRegions"]})["GeoRegions"]
+  end
+end

data/lib/services/keyword.rb

@@ -0,0 +1,37 @@
+class YandexDirect::Keyword
+  SERVICE = 'keywords'
+
+  def self.add(params)
+    words = params[:words]
+    ad_group_id = params[:ad_group_id]
+    keywords = words.map do |word|
+      { "Keyword": word[:word],
+        "AdGroupId": ad_group_id,
+        "Bid": word[:bid],
+        "ContextBid": word[:context_bid],
+        "StrategyPriority": word[:strategy_priority] || "NORMAL"
+      }
+    end
+    YandexDirect.request(SERVICE, 'add', {"Keywords": keywords})["AddResults"]
+  end
+
+  def self.list(params)
+    selection_criteria = {"States":  ["ON"], "Statuses": ["ACCEPTED", "DRAFT"]}
+    selection_criteria["CampaignIds"] = params[:campaign_ids] if params[:campaign_ids].present?
+    selection_criteria["Ids"] = params[:ids] if params[:ids].present?
+    selection_criteria["AdGroupIds"] = params[:ad_group_ids] if params[:ad_group_ids].present?
+    YandexDirect.request(SERVICE, 'get', { 
+      "SelectionCriteria": selection_criteria,
+      "FieldNames": ["Id", "Keyword", "State", "Status", "AdGroupId", "CampaignId", "Bid", "ContextBid"]
+    })["Keywords"] || []
+  end
+
+  def self.update(keywords)
+    keywords.map! do |word|
+      { "Id": word[:id],
+        "Keyword": word[:word]
+      }
+    end
+    YandexDirect.request(SERVICE, 'update', {"Keywords": keywords})["AddResults"]
+  end
+end

data/lib/services/sitelink.rb

@@ -0,0 +1,20 @@
+class YandexDirect::Sitelink
+  SERVICE = 'sitelinks'
+
+  def self.add_set(params)
+    sitelinks = params.map do |link|
+      hash = {"Title": link[:title], "Href": link[:href]}
+      hash["Description"] = link[:description] if link[:description].present?
+      hash
+    end
+    YandexDirect.request(SERVICE, 'add', {"SitelinksSets": [{"Sitelinks": sitelinks}]})["AddResults"].first["Id"]
+  end
+
+  def self.get(ids)
+    YandexDirect.request(SERVICE, 'get', {"SelectionCriteria": {"Ids": ids}, "FieldNames": ["Id", "Sitelinks"]})["SitelinksSets"] || []
+  end
+
+  def self.delete(ids)
+    YandexDirect.request(SERVICE, 'delete', {"SelectionCriteria": {"Ids": ids}})
+  end
+end

data/lib/services/vcard.rb

@@ -0,0 +1,33 @@
+class YandexDirect::VCard
+  SERVICE = 'vcards'
+
+  def self.get(ids = nil)
+    params = {"FieldNames": ["Id", "Country", "City", "Street", "House", "Building", "Apartment", "CompanyName", "ExtraMessage", "ContactPerson", "ContactEmail", "MetroStationId", "CampaignId", "Ogrn", "WorkTime", "InstantMessenger", "Phone", "PointOnMap"]}
+    params["SelectionCriteria"] = {"Ids": ids} if ids.present?
+    YandexDirect.request(SERVICE, 'get', params)["VCards"] || []
+  end
+
+  def self.add(params)
+    vcard = { "CampaignId": params[:campaign_id],
+              "Country": params[:country],
+              "City": params[:city],
+              "CompanyName": params[:company_name],
+              "WorkTime": params[:work_time],
+              "Phone": {
+                "CountryCode": params[:country_code],
+                "CityCode": params[:city_code],
+                "PhoneNumber": params[:phone_number],
+                "Extension": params[:phone_extension],
+              }
+            }
+    %w(Street House Building Apartment ExtraMessage Ogrn ContactEmail MetroStationId ContactPerson).each do |key| 
+      vcard[key] = params[key.underscore.to_sym] if params[key.underscore.to_sym].present?
+    end
+    vcard["InstantMessenger"] = {"MessengerClient": params[:messenger_client], "MessengerLogin": params[:messenger_login]} if params[:messenger_client].present? && params[:messenger_login].present?
+    YandexDirect.request(SERVICE, 'add', {"VCards": [vcard]})["AddResults"].first["Id"]
+  end
+
+  def self.delete(ids)
+    YandexDirect.request(SERVICE, 'delete', {"SelectionCriteria": {"Ids": ids}})
+  end
+end

data/lib/tasks/install.rake

@@ -0,0 +1,16 @@
+require 'yaml'
+
+namespace :yandex_direct_api do
+  desc "Create yandex-direct-api configuration file"
+  task install: :environment do
+    File.open(Rails.root.join('config', 'yandex_direct_api.yml'), 'w') do |config| 
+      settings = {'development' => {'token' => '', 'login' => '', 'locale' => 'ru', 'verbose' => true, 'sandbox' => true}, 
+                  'test' => {'token' => '', 'login' => '', 'locale' => 'ru', 'verbose' => 'false', 'sandbox' => true}, 
+                  'production' => {'token' => '', 'login' => '', 'locale' => 'ru', 'verbose' => false, 'sandbox' => false}}
+      config.write(settings.to_yaml)
+    end
+    File.open(Rails.root.join('config', 'initializers', 'yandex_direct_api.rb'), 'w') do |config| 
+      config.write "require 'yandex_direct_api'\nYandexDirect.load File.join(Rails.root, 'config','yandex_direct_api.yml'), Rails.env"
+    end
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: yandex-direct-api
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.0.1
 platform: ruby
 authors:
 - AliceO
@@ -16,7 +16,18 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- README.md
 - Rakefile
+- lib/live/live.rb
+- lib/services/ad_group.rb
+- lib/services/add.rb
+- lib/services/bid.rb
+- lib/services/campaign.rb
+- lib/services/dictionaries.rb
+- lib/services/keyword.rb
+- lib/services/sitelink.rb
+- lib/services/vcard.rb
+- lib/tasks/install.rake
 - lib/yandex_direct_api.rb
 homepage: https://github.com/aliceojjm/yandex-direct-api
 licenses: []