feat: add new param 'metricFilter' in signature method 'get' (#523)

* feat: add new param 'metricFilter' in signature method 'get'

* fix: add new param to AnalyticsTest

* fix: move new param to the last position

* fix: move new param to the last position in analyticsClient

README.md

@@ -237,7 +237,7 @@ The function returns a `Collection` in which each item is an array that holds ke
 For all other queries you can use the `get` function.
 
 ```php
-public function get(Period $period, array $metrics, array $dimensions = [], int $limit = 10, array $orderBy = [], FilterExpression $dimensionFilter = null): Collection
+public function get(Period $period, array $metrics, array $dimensions = [], int $limit = 10, array $orderBy = [], FilterExpression $dimensionFilter = null, FilterExpression $metricFilter = null): Collection
 ```
 
 Here's some extra info on the arguments you can pass:
@@ -284,6 +284,28 @@ $dimensionFilter = new FilterExpression([
 ]);
 ```
 
+`FilterExpression $metricFilter`: filter applied after aggregating the report's rows, similar to SQL having-clause. Dimensions cannot be used in this filter. You can find more details [here](https://cloud.google.com/php/docs/reference/analytics-data/latest/V1beta.RunReportRequest).
+
+For example:
+```php
+use Google\Analytics\Data\V1beta\Filter;
+use Google\Analytics\Data\V1beta\FilterExpression;
+use Google\Analytics\Data\V1beta\Filter\NumericFilter;
+use Google\Analytics\Data\V1beta\NumericValue;
+use Google\Analytics\Data\V1beta\Filter\NumericFilter\Operation;
+
+$metricFilter = new FilterExpression([
+    'filter' => new Filter([
+        'field_name' => 'eventCount',
+        'numeric_filter' => new NumericFilter([
+            'operation' => Operation::GREATER_THAN,
+            'value' => new NumericValue([
+                'int64_value' => 3,
+            ]),
+        ]),
+    ]),    
+]);
+
 ## Testing
 
 Run the tests with:

src/Analytics.php

@@ -214,6 +214,7 @@ public function get(
         int $offset = 0,
         ?FilterExpression $dimensionFilter = null,
         bool $keepEmptyRows = false,
+        ?FilterExpression $metricFilter = null,
     ): Collection {
         return $this->client->get(
             $this->propertyId,
@@ -224,7 +225,8 @@ public function get(
             $orderBy,
             $offset,
             $dimensionFilter,
-            $keepEmptyRows
+            $keepEmptyRows,
+            $metricFilter
         );
     }
 }

src/AnalyticsClient.php

@@ -37,6 +37,7 @@ public function get(
         int $offset = 0,
         ?FilterExpression $dimensionFilter = null,
         bool $keepEmptyRows = false,
+        ?FilterExpression $metricFilter = null,
     ): Collection {
         $typeCaster = resolve(TypeCaster::class);
 
@@ -52,6 +53,7 @@ public function get(
             'orderBys' => $orderBy,
             'dimensionFilter' => $dimensionFilter,
             'keepEmptyRows' => $keepEmptyRows,
+            'metricFilter' => $metricFilter
         ]);
 
         $result = collect();

tests/AnalyticsTest.php

@@ -34,6 +34,7 @@
         0,
         null,
         false,
+        null,
     ];
 
     $this
@@ -74,6 +75,7 @@
         0,
         null,
         false,
+        null,
     ];
 
     $this
@@ -116,6 +118,7 @@
         0,
         null,
         false,
+        null,
     ];
 
     $this
@@ -159,6 +162,7 @@
         0,
         null,
         false,
+        null,
     ];
 
     $this
@@ -203,6 +207,7 @@
         0,
         null,
         false,
+        null,
     ];
 
     $this