docs: add a quickstart sample using a service account

Author: ikuleshov

analyticsdata/README.md

@@ -0,0 +1,48 @@
+# Google Analytics Data API Samples
+
+[![Open in Cloud Shell][shell_img]][shell_link]
+
+[shell_img]: http://gstatic.com/cloudssh/images/open-btn.svg
+[shell_link]: https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googlecloudplatform/php-docs-samples&page=editor&working_dir=analyticsdata
+
+## Description
+
+These samples show how to use the [Google Analytics Data API][analyticsdata-api]
+from PHP.
+
+[analyticsdata-api]: https://developers.google.com/analytics/devguides/reporting/data/v1
+
+## Build and Run
+1.  **Enable APIs** - [Enable the Analytics Data API](https://console.cloud.google.com/flows/enableapi?apiid=analyticsdata.googleapis.com)
+    and create a new project or select an existing project.
+2.  **Download The Credentials** - Configure your project using [Application Default Credentials][adc].
+    Click "Go to credentials" after enabling the APIs. Click "Create Credentials"
+    and select "Service Account Credentials" and download the credentials file. Then set the path to
+    this file to the environment variable `GOOGLE_APPLICATION_CREDENTIALS`:
+```sh
+    $ export GOOGLE_APPLICATION_CREDENTIALS=/path/to/credentials.json
+```
+3.  **Clone the repo** and cd into this directory
+```sh
+    $ git clone https://github.com/GoogleCloudPlatform/php-docs-samples
+    $ cd php-docs-samples/analyticsdata
+```
+4.  **Install dependencies** via [Composer](http://getcomposer.org/doc/00-intro.md).
+    Run `php composer.phar install` (if composer is installed locally) or `composer install`
+    (if composer is installed globally).
+5.  **Uncomment `$property_id` variable** if present in the snippet and specify
+    the value of the GA4 property id you want to access.
+6.  **Run** with the command `php SNIPPET_NAME.php`. For example:
+```sh
+    $ php quickstart.php
+```
+
+## Contributing changes
+
+* See [CONTRIBUTING.md](../CONTRIBUTING.md)
+
+## Licensing
+
+* See [LICENSE](../LICENSE)
+
+[adc]: https://cloud.google.com/docs/authentication/production#obtaining_and_providing_service_account_credentials_manually

analyticsdata/composer.json

@@ -0,0 +1,5 @@
+{
+    "require": {
+        "google/analytics-data": "^0.1.0"
+    }
+}

analyticsdata/quickstart.php

@@ -0,0 +1,67 @@
+
+// Copyright 2021 Google LLC
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+$property_id = 'YOUR-GA4-PROPERTY-ID';
+// [START analytics_data_quickstart]
+
+require 'vendor/autoload.php';
+
+use Google\Analytics\Data\V1alpha\AlphaAnalyticsDataClient;
+use Google\Analytics\Data\V1alpha\DateRange;
+use Google\Analytics\Data\V1alpha\Dimension;
+use Google\Analytics\Data\V1alpha\Entity;
+use Google\Analytics\Data\V1alpha\Metric;
+
+/**
+ * TODO(developer): Uncomment this variable and replace with your GA4
+ *   property ID before running the sample.
+ */
+// $property_id = 'YOUR-GA4-PROPERTY-ID';
+
+
+// Make an API call.
+$client = new AlphaAnalyticsDataClient();
+$response = $client->runReport([
+    'entity' => new Entity([
+        'property_id' => $property_id
+    ]),
+    'dateRanges' => [
+        new DateRange([
+            'start_date' => '2020-03-31',
+            'end_date' => 'today',
+        ]),
+    ],
+    'dimensions' => [new Dimension(
+        [
+            'name' => 'city',
+        ]),
+    ],
+    'metrics' => [new Metric(
+        [
+            'name' => 'activeUsers',
+        ])
+    ]
+]);
+
+// Print results of an API call.
+print 'Report result: ' . PHP_EOL;
+
+foreach ($response->getRows() as $row) {
+    print $row->getDimensionValues()[0]->getValue()
+        . ' ' . $row->getMetricValues()[0]->getValue() . PHP_EOL;
+}
+
+
+// [END analytics_data_quickstart]