feat: Automated regeneration of analyticsdata v1alpha client (#1612)

This PR was generated using Autosynth. 🌈


<details><summary>Log from Synthtool</summary>

```
2020-12-03 01:32:56,607 synthtool [DEBUG] > Executing /home/kbuilder/.cache/synthtool/google-api-ruby-client/synth.py.
On branch autosynth-analyticsdata-v1alpha
nothing to commit, working tree clean
2020-12-03 01:32:56,635 synthtool [DEBUG] > Running: docker run --rm -v/home/kbuilder/.cache/synthtool/google-api-ruby-client:/workspace -v/var/run/docker.sock:/var/run/docker.sock -w /workspace --entrypoint script/synth.rb gcr.io/cloud-devrel-kokoro-resources/yoshi-ruby/autosynth analyticsdata v1alpha
DEBUG:synthtool:Running: docker run --rm -v/home/kbuilder/.cache/synthtool/google-api-ruby-client:/workspace -v/var/run/docker.sock:/var/run/docker.sock -w /workspace --entrypoint script/synth.rb gcr.io/cloud-devrel-kokoro-resources/yoshi-ruby/autosynth analyticsdata v1alpha
bundle install
Don't run Bundler as root. Bundler can ask for sudo if it is needed, and
installing your bundle as root will break this application for all non-root
users on this machine.
The dependency jruby-openssl (>= 0) will be unused by any of the platforms Bundler is installing for. Bundler is installing for ruby but the dependency is only for java. To add those platforms to the bundle, run `bundle lock --add-platform java`.
Fetching gem metadata from https://rubygems.org/.........
Fetching gem metadata from https://rubygems.org/.
Resolving dependencies...
Fetching rake 11.3.0
Installing rake 11.3.0
Fetching concurrent-ruby 1.1.7
Installing concurrent-ruby 1.1.7
Fetching i18n 1.8.5
Installing i18n 1.8.5
Fetching minitest 5.14.2
Installing minitest 5.14.2
Fetching thread_safe 0.3.6
Installing thread_safe 0.3.6
Fetching tzinfo 1.2.8
Installing tzinfo 1.2.8
Fetching activesupport 5.0.7.2
Installing activesupport 5.0.7.2
Fetching public_suffix 4.0.6
Installing public_suffix 4.0.6
Fetching addressable 2.7.0
Installing addressable 2.7.0
Fetching ast 2.4.1
Installing ast 2.4.1
Using bundler 2.1.4
Fetching byebug 11.1.3
Installing byebug 11.1.3 with native extensions
Fetching coderay 1.1.3
Installing coderay 1.1.3
Fetching json 2.3.1
Installing json 2.3.1 with native extensions
Fetching docile 1.3.2
Installing docile 1.3.2
Fetching simplecov-html 0.10.2
Installing simplecov-html 0.10.2
Fetching simplecov 0.16.1
Installing simplecov 0.16.1
Using sync 0.5.0
Fetching tins 1.26.0
Installing tins 1.26.0
Fetching term-ansicolor 1.7.1
Installing term-ansicolor 1.7.1
Fetching thor 0.20.3
Installing thor 0.20.3
Fetching coveralls 0.8.23
Installing coveralls 0.8.23
Fetching crack 0.4.4
Installing crack 0.4.4
Fetching declarative 0.0.20
Installing declarative 0.0.20
Fetching declarative-option 0.1.0
Installing declarative-option 0.1.0
Fetching diff-lcs 1.4.4
Installing diff-lcs 1.4.4
Fetching dotenv 2.7.6
Installing dotenv 2.7.6
Fetching fakefs 0.20.1
Installing fakefs 0.20.1
Fetching multipart-post 2.1.1
Installing multipart-post 2.1.1
Fetching ruby2_keywords 0.0.2
Installing ruby2_keywords 0.0.2
Fetching faraday 1.1.0
Installing faraday 1.1.0
Fetching gems 1.2.0
Installing gems 1.2.0
Fetching github-markup 1.7.0
Installing github-markup 1.7.0
Fetching jwt 2.2.2
Installing jwt 2.2.2
Fetching memoist 0.16.2
Installing memoist 0.16.2
Fetching multi_json 1.15.0
Installing multi_json 1.15.0
Fetching os 0.9.6
Installing os 0.9.6
Fetching signet 0.14.0
Installing signet 0.14.0
Fetching googleauth 0.14.0
Installing googleauth 0.14.0
Fetching httpclient 2.8.3
Installing httpclient 2.8.3
Fetching mini_mime 1.0.2
Installing mini_mime 1.0.2
Fetching uber 0.1.0
Installing uber 0.1.0
Fetching representable 3.0.4
Installing representable 3.0.4
Fetching retriable 3.1.2
Installing retriable 3.1.2
Fetching rexml 3.2.4
Installing rexml 3.2.4
Using google-api-client 0.50.0 from source at `.`
Fetching google-id-token 1.4.2
Installing google-id-token 1.4.2
Fetching hashdiff 1.0.1
Installing hashdiff 1.0.1
Fetching mime-types-data 3.2020.1104
Installing mime-types-data 3.2020.1104
Fetching mime-types 3.3.1
Installing mime-types 3.3.1
Fetching multi_xml 0.6.0
Installing multi_xml 0.6.0
Fetching httparty 0.18.1
Installing httparty 0.18.1
Fetching rspec-support 3.10.0
Installing rspec-support 3.10.0
Fetching rspec-core 3.10.0
Installing rspec-core 3.10.0
Fetching rspec-expectations 3.10.0
Installing rspec-expectations 3.10.0
Fetching rspec-mocks 3.10.0
Installing rspec-mocks 3.10.0
Fetching rspec 3.10.0
Installing rspec 3.10.0
Fetching json_spec 1.1.5
Installing json_spec 1.1.5
Fetching launchy 2.5.0
Installing launchy 2.5.0
Fetching little-plugger 1.1.4
Installing little-plugger 1.1.4
Fetching logging 2.3.0
Installing logging 2.3.0
Fetching method_source 1.0.0
Installing method_source 1.0.0
Fetching opencensus 0.5.0
Installing opencensus 0.5.0
Fetching parallel 1.20.1
Installing parallel 1.20.1
Fetching parser 2.7.2.0
Installing parser 2.7.2.0
Fetching powerpack 0.1.3
Installing powerpack 0.1.3
Fetching pry 0.13.1
Installing pry 0.13.1
Fetching pry-byebug 3.9.0
Installing pry-byebug 3.9.0
Fetching yard 0.9.25
Installing yard 0.9.25
Fetching pry-doc 0.13.5
Installing pry-doc 0.13.5
Fetching rainbow 2.2.2
Installing rainbow 2.2.2 with native extensions
Fetching redcarpet 3.5.0
Installing redcarpet 3.5.0 with native extensions
Fetching redis 3.3.5
Installing redis 3.3.5
Fetching rmail 1.1.4
Installing rmail 1.1.4
Fetching ruby-progressbar 1.10.1
Installing ruby-progressbar 1.10.1
Fetching unicode-display_width 1.7.0
Installing unicode-display_width 1.7.0
Fetching rubocop 0.49.1
Installing rubocop 0.49.1
Fetching webmock 2.3.2
Installing webmock 2.3.2
Bundle complete! 31 Gemfile dependencies, 78 gems now installed.
Use `bundle info [gemname]` to see where a bundled gem is installed.
Post-install message from i18n:

HEADS UP! i18n 1.1 changed fallbacks to exclude default locale.
But that may break your application.

If you are upgrading your Rails application from an older version of Rails:

Please check your Rails app for 'config.i18n.fallbacks = true'.
If you're using I18n (>= 1.1.0) and Rails (< 5.2.2), this should be
'config.i18n.fallbacks = [I18n.default_locale]'.
If not, fallbacks will be broken in your app by I18n 1.1.x.

If you are starting a NEW Rails application, you can ignore this notice.

For more info see:
https://github.com/svenfuchs/i18n/releases/tag/v1.1.0

Post-install message from httparty:
When you HTTParty, you must party hard!
echo a | bundle exec bin/generate-api gen generated --api=analyticsdata.v1alpha --names-out=/workspace/api_names_out.yaml
Loading analyticsdata, version v1alpha from https://raw.githubusercontent.com/googleapis/discovery-artifact-manager/master/discoveries/analyticsdata.v1alpha.json
    conflict  google/apis/analyticsdata_v1alpha.rb
<icsdata_v1alpha.rb? (enter "h" for help) [Ynaqdhm] a
       force  google/apis/analyticsdata_v1alpha.rb
   identical  google/apis/analyticsdata_v1alpha/service.rb
    conflict  google/apis/analyticsdata_v1alpha/classes.rb
       force  google/apis/analyticsdata_v1alpha/classes.rb
   identical  google/apis/analyticsdata_v1alpha/representations.rb
   identical  /workspace/api_names_out.yaml
2020-12-03 01:33:20,691 synthtool [DEBUG] > Wrote metadata to generated/google/apis/analyticsdata_v1alpha/synth.metadata.
DEBUG:synthtool:Wrote metadata to generated/google/apis/analyticsdata_v1alpha/synth.metadata.

```
</details>

Full log will be available here:
https://source.cloud.google.com/results/invocations/7b006b37-fae5-4e1c-9d57-231db3ac031c/targets

- [ ] To automatically regenerate this PR, check this box.

generated/google/apis/analyticsdata_v1alpha.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://developers.google.com/analytics/devguides/reporting/data/v1/
     module AnalyticsdataV1alpha
       VERSION = 'V1alpha'
-      REVISION = '20201118'
+      REVISION = '20201201'
 
       # View and manage your Google Analytics data
       AUTH_ANALYTICS = 'https://www.googleapis.com/auth/analytics'

generated/google/apis/analyticsdata_v1alpha/classes.rb

@@ -157,9 +157,9 @@ module Google
         end
       end
       
-      # Defines a cohort. A cohort is a group of users who share a common
+      # Defines a cohort selection criteria. A cohort is a group of users who share a
-      # characteristic. For example, all users with the same acquisition date belong
+      # common characteristic. For example, users with the same `firstTouchDate`
-      # to the same cohort.
+      # belong to the same cohort.
       class Cohort
         include Google::Apis::Core::Hashable
       
@@ -169,8 +169,7 @@ module Google
         # @return [Google::Apis::AnalyticsdataV1alpha::DateRange]
         attr_accessor :date_range
       
-        # The dimension used by cohort. Only supports `firstTouchDate` for retention
+        # Dimension used by the cohort. Required and only supports `firstTouchDate`.
-        # report.
         # Corresponds to the JSON property `dimension`
         # @return [String]
         attr_accessor :dimension
@@ -195,11 +194,11 @@ module Google
         end
       end
       
-      # Settings of a cohort report.
+      # Optional settings of a cohort report.
       class CohortReportSettings
         include Google::Apis::Core::Hashable
       
-        # If true, accumulates the result from first visit day to the end day. Not
+        # If true, accumulates the result from first touch day to the end day. Not
         # supported in `RunReportRequest`.
         # Corresponds to the JSON property `accumulate`
         # @return [Boolean]
@@ -216,21 +215,34 @@ module Google
         end
       end
       
-      # Specification for a cohort report.
+      # Specification of cohorts for a cohort report. Cohort reports can be used for
+      # example to create a time series of user retention for the cohort. For example,
+      # you could select the cohort of users that were acquired in the first week of
+      # September and follow that cohort for the next six weeks. Selecting the users
+      # acquired in the first week of September cohort is specified in the `cohort`
+      # object. Following that cohort for the next six weeks is specified in the `
+      # cohortsRange` object. The report response could show a weekly time series
+      # where say your app has retained 60% of this cohort after three weeks and 25%
+      # of this cohort after six weeks. These two percentages can be calculated by the
+      # metric `cohortActiveUsers/cohortTotalUsers` and will be separate rows in the
+      # report.
       class CohortSpec
         include Google::Apis::Core::Hashable
       
-        # Settings of a cohort report.
+        # Optional settings of a cohort report.
         # Corresponds to the JSON property `cohortReportSettings`
         # @return [Google::Apis::AnalyticsdataV1alpha::CohortReportSettings]
         attr_accessor :cohort_report_settings
       
-        # The definition for the cohorts.
+        # Defines the selection criteria to group users into cohorts. Most cohort
+        # reports define only a single cohort. If multiple cohorts are specified, each
+        # cohort can be recognized in the report by their name.
         # Corresponds to the JSON property `cohorts`
         # @return [Array<Google::Apis::AnalyticsdataV1alpha::Cohort>]
         attr_accessor :cohorts
       
-        # Describes date range for a cohort report.
+        # Configures the extended reporting date range for a cohort report. Specifies an
+        # offset duration to follow the cohorts over.
         # Corresponds to the JSON property `cohortsRange`
         # @return [Google::Apis::AnalyticsdataV1alpha::CohortsRange]
         attr_accessor :cohorts_range
@@ -247,23 +259,39 @@ module Google
         end
       end
       
-      # Describes date range for a cohort report.
+      # Configures the extended reporting date range for a cohort report. Specifies an
+      # offset duration to follow the cohorts over.
       class CohortsRange
         include Google::Apis::Core::Hashable
       
-        # For daily cohorts, this will be the end day offset. For weekly cohorts, this
+        # `endOffset` specifies the end date of the extended reporting date range for a
-        # will be the week offset.
+        # cohort report. `endOffset` can be any positive integer but is commonly set to
+        # 5 to 10 so that reports contain data on the cohort for the next several
+        # granularity time periods. If `granularity` is `DAILY`, the `endDate` of the
+        # extended reporting date range is `endDate` of the cohort plus `endOffset` days.
+        # If `granularity` is `WEEKLY`, the `endDate` of the extended reporting date
+        # range is `endDate` of the cohort plus `endOffset * 7` days. If `granularity`
+        # is `MONTHLY`, the `endDate` of the extended reporting date range is `endDate`
+        # of the cohort plus `endOffset * 30` days.
         # Corresponds to the JSON property `endOffset`
         # @return [Fixnum]
         attr_accessor :end_offset
       
-        # Reporting date range for each cohort is calculated based on these three fields.
+        # The granularity used to interpret the `startOffset` and `endOffset` for the
+        # extended reporting date range for a cohort report.
         # Corresponds to the JSON property `granularity`
         # @return [String]
         attr_accessor :granularity
       
-        # For daily cohorts, this will be the start day offset. For weekly cohorts, this
+        # `startOffset` specifies the start date of the extended reporting date range
-        # will be the week offset.
+        # for a cohort report. `startOffset` is commonly set to 0 so that reports
+        # contain data from the acquisition of the cohort forward. If `granularity` is `
+        # DAILY`, the `startDate` of the extended reporting date range is `startDate` of
+        # the cohort plus `startOffset` days. If `granularity` is `WEEKLY`, the `
+        # startDate` of the extended reporting date range is `startDate` of the cohort
+        # plus `startOffset * 7` days. If `granularity` is `MONTHLY`, the `startDate` of
+        # the extended reporting date range is `startDate` of the cohort plus `
+        # startOffset * 30` days.
         # Corresponds to the JSON property `startOffset`
         # @return [Fixnum]
         attr_accessor :start_offset
@@ -1263,7 +1291,17 @@ module Google
       class RunPivotReportRequest
         include Google::Apis::Core::Hashable
       
-        # Specification for a cohort report.
+        # Specification of cohorts for a cohort report. Cohort reports can be used for
+        # example to create a time series of user retention for the cohort. For example,
+        # you could select the cohort of users that were acquired in the first week of
+        # September and follow that cohort for the next six weeks. Selecting the users
+        # acquired in the first week of September cohort is specified in the `cohort`
+        # object. Following that cohort for the next six weeks is specified in the `
+        # cohortsRange` object. The report response could show a weekly time series
+        # where say your app has retained 60% of this cohort after three weeks and 25%
+        # of this cohort after six weeks. These two percentages can be calculated by the
+        # metric `cohortActiveUsers/cohortTotalUsers` and will be separate rows in the
+        # report.
         # Corresponds to the JSON property `cohortSpec`
         # @return [Google::Apis::AnalyticsdataV1alpha::CohortSpec]
         attr_accessor :cohort_spec
@@ -1564,7 +1602,17 @@ module Google
       class RunReportRequest
         include Google::Apis::Core::Hashable
       
-        # Specification for a cohort report.
+        # Specification of cohorts for a cohort report. Cohort reports can be used for
+        # example to create a time series of user retention for the cohort. For example,
+        # you could select the cohort of users that were acquired in the first week of
+        # September and follow that cohort for the next six weeks. Selecting the users
+        # acquired in the first week of September cohort is specified in the `cohort`
+        # object. Following that cohort for the next six weeks is specified in the `
+        # cohortsRange` object. The report response could show a weekly time series
+        # where say your app has retained 60% of this cohort after three weeks and 25%
+        # of this cohort after six weeks. These two percentages can be calculated by the
+        # metric `cohortActiveUsers/cohortTotalUsers` and will be separate rows in the
+        # report.
         # Corresponds to the JSON property `cohortSpec`
         # @return [Google::Apis::AnalyticsdataV1alpha::CohortSpec]
         attr_accessor :cohort_spec

generated/google/apis/analyticsdata_v1alpha/synth.metadata

@@ -4,7 +4,7 @@
       "git": {
         "name": ".",
         "remote": "https://github.com/googleapis/google-api-ruby-client.git",
-        "sha": "b264d974a86e5acbc70cd73915eaf73daac61a63"
+        "sha": "0f920ae5ebe394e34a9ce17dd866bea7a4621f7d"
       }
     }
   ]