google_analytics_v4_api 0.0.2 → 0.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5828f263cac248518f859fccee88c665c9b69ce3f34deaa4a3ffc2f2d00b8048
-  data.tar.gz: 1931b205744ff560afad9fb9b62666ef334b2cbda04551618bab5b5bced048dc
+  metadata.gz: 516d5859258748f1f4749df54b064cc3caf1b9707028041fd0db0084a75d719d
+  data.tar.gz: 0030de2106fff16d2ad13e7feb9c98af718fa0c55b04c30a9eecd462ff8df08a
 SHA512:
-  metadata.gz: 1647ea49bf56b68d0303c4730e3cdcdda21bc97ab88f59ab3e55f3c10e5adffbede326db4c9a3496f71f637b7ba909f9de0fed3c8e7010912c359c90d1edfeca
-  data.tar.gz: b20b7207cb4d6575a3fb94f4dbb1a3688e2ca25b3d7a30fdff6029eaed96cfd6dfa919f0cb71b9a36fbf8db40212beefdb311c7b17e28a5091a34dd37c50cf03
+  metadata.gz: 3bee4ad056696d0829191e46f6187c0d5a29cfeaebc5ad7fba3ea3b0766aa7d004b1b99ec26f854f4f7cf6d636c94f1f3b097e2ad5991413e7507be3e545443c
+  data.tar.gz: 060b03b7c94203270e627dcc35ae8e1262ccbb467040b5221c86518c4815b16a5239d3c77699ea43a8b5b511160d948143a4069aaa3b67b8af8d398e14ef4be6

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    google_analytics_v4_api (0.0.2)
+    google_analytics_v4_api (0.0.3)
 
 GEM
   remote: https://rubygems.org/

data/README.md

@@ -1,6 +1,6 @@
 # Google Analytics v4 API Ruby Gem
 This is a simple wrapper to interact with the Google Analytics v4 API (currently in beta) with Ruby.
-It's based on the [Admin API guide](https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1beta) and the
+It's based on the [Admin API guide](https://developers.google.com/analytics/devguides/config/admin/v1/rest) and the
 [Reports API guide](https://developers.google.com/analytics/devguides/reporting/data/v1/basics?authuser=1#report_response)
 
 ## Usage
@@ -11,12 +11,13 @@ gem 'google_analytics_v4_api'
 
 You will need a way to get a user's valid (and fresh) token (I personally use the `gem omnioauth`), and then:
 
+### Management API
 ```rb
 client = GoogleAnalyticsV4Api::Client.new(token)
 # List all the accounts
 accounts = client.accounts
 # Or get one particular account
-account = client.account("account/24696xxx")
+account = client.account("accounts/24696xxx")
 
 # List all the properties for a particular account
 properties = client.properties("accounts/24596xxx")
@@ -29,8 +30,60 @@ properties = account.properties
 property = account.property("properties/33783xxx")
 ```
 
-The rest is still being defined.
+### Data API
+```rb
+filter = {
+  "andGroup": {
+    "expressions": [
+      {
+        "filter": {
+          "fieldName": "countryId",
+          "stringFilter": {
+            "value": "CL"
+          }
+        }
+      },
+      {
+        "filter": {
+          "fieldName": "pagePath",
+          "stringFilter": {
+            "matchType": "CONTAINS",
+            "value": "events",
+            "caseSensitive": false
+          }
+        }
+      }
+    ]
+  }
+}
+report = GoogleAnalyticsV4Api::Report.new(
+          dimensions: ['pagePath', 'countryId'],
+          metrics: ['sessions', 'screenPageViews'],
+          dimension_filter: filter,
+          start_date: Date.today - 30, #optional, 30 days ago by default
+          end_date: Date.today - 1) #optional, today by default
+
+response = property.run_report(report)
+
+# Get raw data from the response
+response.raw_dimension_headers
+=> [{"name"=>"pagePath"}, {"name"=>"countryId"}]
+response.raw_metric_headers
+=> [{"name"=>"sessions", "type"=>"TYPE_INTEGER"}, {"name"=>"screenPageViews", "type"=>"TYPE_INTEGER"}]
+response.rows.first
+=> {"dimensionValues"=>[{"value"=>"/events"}, {"value"=>"CL"}], "metricValues"=>[{"value"=>"58"}, {"value"=>"78"}]}
+
+# Or get a simplified version of the response
+response.dimension_headers
+=> ["pagePath", "countryId"]
+response.metric_headers
+=> ["sessions", "screenPageViews"]
+response.parsed_rows.first.data
+=> {"pagePath"=>"/events", "countryId"=>"CL", "sessions"=>58, "screenPageViews"=>78}
 
+```
+Dimensions and Metrics are available [here](https://developers.google.com/analytics/devguides/reporting/data/v1/api-schema)
+Information about Filters is available [here](https://developers.google.com/analytics/devguides/reporting/data/v1/basics#dimension_filters)
 
 ## Development
 

data/lib/google_analytics_v4_api/client.rb

@@ -3,6 +3,8 @@
 module GoogleAnalyticsV4Api
   class Client
 
+    attr_accessor :access_token
+
     def initialize(access_token)
       @access_token = access_token
     end

data/lib/google_analytics_v4_api/property.rb

@@ -17,6 +17,11 @@ module GoogleAnalyticsV4Api
       @client.account(parent)
     end
 
+    def run_report(report)
+      response = Request.post(access_token: @client.access_token, path: "/#{name}:runReport", payload: report.to_json)
+      ReportResponse.new(response)
+    end
+
     def self.parse_list(client, body)
       JSON.parse(body)["properties"].map do |attrs|
         GoogleAnalyticsV4Api::Property.new(client, attrs)

data/lib/google_analytics_v4_api/report.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+require 'json'
+require 'date'
+
+module GoogleAnalyticsV4Api
+  class Report
+    attr_accessor :date_ranges, :dimensions, :metrics, :dimension_filter
+
+    def initialize(start_date: nil, end_date: nil, dimensions: [], metrics: [], dimension_filter: {})
+      @date_ranges = [{ "startDate": start_date || (Date.today - 30), "endDate": end_date || Date.today }]
+      @dimensions = dimensions.map { |dimension| { "name": dimension } }
+      @metrics = metrics.map { |metric| { "name": metric } }
+      @dimension_filter = dimension_filter
+    end
+
+    def to_json
+      {
+        "dateRanges": @date_ranges,
+        "dimensions": @dimensions,
+        "metrics": @metrics,
+        "dimensionFilter": @dimension_filter
+      }.to_json
+    end
+  end
+end

data/lib/google_analytics_v4_api/report_response.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+require 'json'
+require 'date'
+
+module GoogleAnalyticsV4Api
+  class ReportResponse
+
+    attr_accessor :body, :raw_dimension_headers, :raw_metric_headers, :rows, :row_count, :metadata, :kind
+
+    def initialize(body)
+      @body = JSON.parse body
+      @raw_dimension_headers = @body["dimensionHeaders"]
+      @raw_metric_headers = @body["metricHeaders"]
+      @rows = @body["rows"]
+      @row_cont = @body["rowCount"]
+      @metadata = @body["metadata"]
+      @kind = @body["kind"]
+    end
+
+    def dimension_headers
+      @dimension_headers ||= @raw_dimension_headers.map { |header| header["name"] }
+    end
+
+    def metric_headers
+      @metric_headers ||= @raw_metric_headers.map { |header| header["name"] }
+    end
+
+    def parsed_rows
+      @rows.map do |row|
+        ReportResponseRow.new(row, @raw_dimension_headers, @raw_metric_headers)
+      end
+    end
+
+  end
+end

data/lib/google_analytics_v4_api/report_response_row.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+require 'json'
+require 'date'
+
+module GoogleAnalyticsV4Api
+  class ReportResponseRow
+
+    attr_accessor :data
+
+    def initialize(row, raw_dimension_headers, raw_metric_headers)
+      # "dimensionHeaders"=>[{"name"=>"pagePath"}, {"name"=>"countryId"}],
+      # "metricHeaders"=>[{"name"=>"sessions", "type"=>"TYPE_INTEGER"}, {"name"=>"screenPageViews", "type"=>"TYPE_INTEGER"}],
+      # a row: {"dimensionValues"=>[{"value"=>"/events"}, {"value"=>"CL"}], "metricValues"=>[{"value"=>"62"}, {"value"=>"82"}]}
+      @raw_row = row
+      @data = {}
+      raw_dimension_headers.each_with_index do |dimension_header, index|
+        @data[dimension_header["name"]] = row["dimensionValues"][index]["value"]
+      end
+      raw_metric_headers.each_with_index do |metric_header, index|
+        @data[metric_header["name"]] = cast(row["metricValues"][index]["value"], metric_header["type"])
+      end
+    end
+
+    def cast(value, type)
+      words = type.split("_")
+      return value unless words[0] == 'TYPE'
+      return value.to_i if words[1] == "INTEGER"
+      return value.to_f if words[1].in? %w(FLOAT SECONDS MILLISECONDS MINUTES HOURS STANDARD CURRENCY FEET MILES METERS KILOMETERS)
+
+      value
+    end
+
+  end
+end

data/lib/google_analytics_v4_api/request.rb

@@ -7,10 +7,10 @@ module GoogleAnalyticsV4Api
   class Request
 
     ADMIN_URL = "https://analyticsadmin.googleapis.com/v1beta"
-    DATA_URL = "https://analyticsdata.googleapis.com/v1beta/properties/{{PROPERTY_ID}}:runReport"
+    DATA_URL = "https://analyticsdata.googleapis.com/v1beta"
 
-    def self.get(access_token:, url: nil, path:, params: {})
-      url = "#{url || ADMIN_URL}#{path}"
+    def self.get(access_token:, url: ADMIN_URL, path:, params: {})
+      url = "#{url}#{path}"
       url += "?#{URI.encode_www_form params}" unless params.empty?
       uri = URI(url)
 
@@ -26,8 +26,19 @@ module GoogleAnalyticsV4Api
       response
     end
 
-    def self.post(access_token:, url: nil, path:, params: {})
+    def self.post(access_token:, url: DATA_URL, path:, payload: nil)
+      url = URI("#{url}#{path}")
 
+      https = Net::HTTP.new(url.host, url.port)
+      https.use_ssl = true
+
+      request = Net::HTTP::Post.new(url)
+      request["Authorization"] = "Bearer #{access_token}"
+      request["Content-Type"] = "application/javascript"
+      request.body = payload
+
+      response = https.request(request)
+      response.read_body
     end
 
   end

data/lib/google_analytics_v4_api/version.rb

@@ -1,3 +1,3 @@
 module GoogleAnalyticsV4Api
-  VERSION = "0.0.2"
+  VERSION = "0.0.3"
 end

data/lib/google_analytics_v4_api.rb

@@ -5,5 +5,8 @@ module GoogleAnalyticsV4Api
   autoload :Account, "google_analytics_v4_api/account"
   autoload :Property, "google_analytics_v4_api/property"
   autoload :Request, "google_analytics_v4_api/request"
+  autoload :Report, "google_analytics_v4_api/report"
+  autoload :ReportResponse, "google_analytics_v4_api/report_response"
+  autoload :ReportResponseRow, "google_analytics_v4_api/report_response_row"
   autoload :Error, "google_analytics_v4_api/error"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google_analytics_v4_api
 version: !ruby/object:Gem::Version
-  version: 0.0.2
+  version: 0.0.3
 platform: ruby
 authors:
 - Gustavo Garcia
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-01-07 00:00:00.000000000 Z
+date: 2023-01-09 00:00:00.000000000 Z
 dependencies: []
 description: A very humble wrapper for the Google Analytics V4 API to be used in conjuntion
   with OAuth2
@@ -33,6 +33,9 @@ files:
 - lib/google_analytics_v4_api/client.rb
 - lib/google_analytics_v4_api/error.rb
 - lib/google_analytics_v4_api/property.rb
+- lib/google_analytics_v4_api/report.rb
+- lib/google_analytics_v4_api/report_response.rb
+- lib/google_analytics_v4_api/report_response_row.rb
 - lib/google_analytics_v4_api/request.rb
 - lib/google_analytics_v4_api/version.rb
 homepage: https://github.com/dailytics/google_analytics_v4_api