google-apis-playablelocations_v3 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: f15da2287f97170a79746a349e5b16dc89ef0032c34b8bfbb347dbee8f505025
+  data.tar.gz: 7738bc5e3e87b42f89db472aab6d7404d490ab46fc4b8fb00d56c327cfae99ac
+SHA512:
+  metadata.gz: 843f2785a445d77a05c5716605e1128e8b7738c83102dabd0e1eab779d6ea4fc56adb736f0a90dddb79b6148fd678800911a26dd4e879b85246856224315988a
+  data.tar.gz: 613355945ba63ea28a83f88c84909ae16d77683b0c46046ad1238c341edef8e131e0e0fcf3e0da6aa24d672bb4a3087c0099c56b1670385dd1efa9741ae3d8c4

data/.yardopts

@@ -0,0 +1,13 @@
+--hide-void-return
+--no-private
+--verbose
+--title=google-apis-playablelocations_v3
+--markup-provider=redcarpet
+--markup=markdown
+--main OVERVIEW.md
+lib/google/apis/playablelocations_v3/*.rb
+lib/google/apis/playablelocations_v3.rb
+-
+OVERVIEW.md
+CHANGELOG.md
+LICENSE.md

data/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Release history for google-apis-playablelocations_v3
+
+### v0.1.0 (2021-01-07)
+
+* Regenerated using generator version 0.1.1
+* Regenerated from discovery document revision 20201013
+

data/LICENSE.md

@@ -0,0 +1,202 @@
+
+                                  Apache License
+                            Version 2.0, January 2004
+                         http://www.apache.org/licenses/
+
+    TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+    1. Definitions.
+
+       "License" shall mean the terms and conditions for use, reproduction,
+       and distribution as defined by Sections 1 through 9 of this document.
+
+       "Licensor" shall mean the copyright owner or entity authorized by
+       the copyright owner that is granting the License.
+
+       "Legal Entity" shall mean the union of the acting entity and all
+       other entities that control, are controlled by, or are under common
+       control with that entity. For the purposes of this definition,
+       "control" means (i) the power, direct or indirect, to cause the
+       direction or management of such entity, whether by contract or
+       otherwise, or (ii) ownership of fifty percent (50%) or more of the
+       outstanding shares, or (iii) beneficial ownership of such entity.
+
+       "You" (or "Your") shall mean an individual or Legal Entity
+       exercising permissions granted by this License.
+
+       "Source" form shall mean the preferred form for making modifications,
+       including but not limited to software source code, documentation
+       source, and configuration files.
+
+       "Object" form shall mean any form resulting from mechanical
+       transformation or translation of a Source form, including but
+       not limited to compiled object code, generated documentation,
+       and conversions to other media types.
+
+       "Work" shall mean the work of authorship, whether in Source or
+       Object form, made available under the License, as indicated by a
+       copyright notice that is included in or attached to the work
+       (an example is provided in the Appendix below).
+
+       "Derivative Works" shall mean any work, whether in Source or Object
+       form, that is based on (or derived from) the Work and for which the
+       editorial revisions, annotations, elaborations, or other modifications
+       represent, as a whole, an original work of authorship. For the purposes
+       of this License, Derivative Works shall not include works that remain
+       separable from, or merely link (or bind by name) to the interfaces of,
+       the Work and Derivative Works thereof.
+
+       "Contribution" shall mean any work of authorship, including
+       the original version of the Work and any modifications or additions
+       to that Work or Derivative Works thereof, that is intentionally
+       submitted to Licensor for inclusion in the Work by the copyright owner
+       or by an individual or Legal Entity authorized to submit on behalf of
+       the copyright owner. For the purposes of this definition, "submitted"
+       means any form of electronic, verbal, or written communication sent
+       to the Licensor or its representatives, including but not limited to
+       communication on electronic mailing lists, source code control systems,
+       and issue tracking systems that are managed by, or on behalf of, the
+       Licensor for the purpose of discussing and improving the Work, but
+       excluding communication that is conspicuously marked or otherwise
+       designated in writing by the copyright owner as "Not a Contribution."
+
+       "Contributor" shall mean Licensor and any individual or Legal Entity
+       on behalf of whom a Contribution has been received by Licensor and
+       subsequently incorporated within the Work.
+
+    2. Grant of Copyright License. Subject to the terms and conditions of
+       this License, each Contributor hereby grants to You a perpetual,
+       worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+       copyright license to reproduce, prepare Derivative Works of,
+       publicly display, publicly perform, sublicense, and distribute the
+       Work and such Derivative Works in Source or Object form.
+
+    3. Grant of Patent License. Subject to the terms and conditions of
+       this License, each Contributor hereby grants to You a perpetual,
+       worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+       (except as stated in this section) patent license to make, have made,
+       use, offer to sell, sell, import, and otherwise transfer the Work,
+       where such license applies only to those patent claims licensable
+       by such Contributor that are necessarily infringed by their
+       Contribution(s) alone or by combination of their Contribution(s)
+       with the Work to which such Contribution(s) was submitted. If You
+       institute patent litigation against any entity (including a
+       cross-claim or counterclaim in a lawsuit) alleging that the Work
+       or a Contribution incorporated within the Work constitutes direct
+       or contributory patent infringement, then any patent licenses
+       granted to You under this License for that Work shall terminate
+       as of the date such litigation is filed.
+
+    4. Redistribution. You may reproduce and distribute copies of the
+       Work or Derivative Works thereof in any medium, with or without
+       modifications, and in Source or Object form, provided that You
+       meet the following conditions:
+
+       (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+       (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+       (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+       (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+       You may add Your own copyright statement to Your modifications and
+       may provide additional or different license terms and conditions
+       for use, reproduction, or distribution of Your modifications, or
+       for any such Derivative Works as a whole, provided Your use,
+       reproduction, and distribution of the Work otherwise complies with
+       the conditions stated in this License.
+
+    5. Submission of Contributions. Unless You explicitly state otherwise,
+       any Contribution intentionally submitted for inclusion in the Work
+       by You to the Licensor shall be under the terms and conditions of
+       this License, without any additional terms or conditions.
+       Notwithstanding the above, nothing herein shall supersede or modify
+       the terms of any separate license agreement you may have executed
+       with Licensor regarding such Contributions.
+
+    6. Trademarks. This License does not grant permission to use the trade
+       names, trademarks, service marks, or product names of the Licensor,
+       except as required for reasonable and customary use in describing the
+       origin of the Work and reproducing the content of the NOTICE file.
+
+    7. Disclaimer of Warranty. Unless required by applicable law or
+       agreed to in writing, Licensor provides the Work (and each
+       Contributor provides its Contributions) on an "AS IS" BASIS,
+       WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+       implied, including, without limitation, any warranties or conditions
+       of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+       PARTICULAR PURPOSE. You are solely responsible for determining the
+       appropriateness of using or redistributing the Work and assume any
+       risks associated with Your exercise of permissions under this License.
+
+    8. Limitation of Liability. In no event and under no legal theory,
+       whether in tort (including negligence), contract, or otherwise,
+       unless required by applicable law (such as deliberate and grossly
+       negligent acts) or agreed to in writing, shall any Contributor be
+       liable to You for damages, including any direct, indirect, special,
+       incidental, or consequential damages of any character arising as a
+       result of this License or out of the use or inability to use the
+       Work (including but not limited to damages for loss of goodwill,
+       work stoppage, computer failure or malfunction, or any and all
+       other commercial damages or losses), even if such Contributor
+       has been advised of the possibility of such damages.
+
+    9. Accepting Warranty or Additional Liability. While redistributing
+       the Work or Derivative Works thereof, You may choose to offer,
+       and charge a fee for, acceptance of support, warranty, indemnity,
+       or other liability obligations and/or rights consistent with this
+       License. However, in accepting such obligations, You may act only
+       on Your own behalf and on Your sole responsibility, not on behalf
+       of any other Contributor, and only if You agree to indemnify,
+       defend, and hold each Contributor harmless for any liability
+       incurred by, or claims asserted against, such Contributor by reason
+       of your accepting any such warranty or additional liability.
+
+    END OF TERMS AND CONDITIONS
+
+    APPENDIX: How to apply the Apache License to your work.
+
+       To apply the Apache License to your work, attach the following
+       boilerplate notice, with the fields enclosed by brackets "[]"
+       replaced with your own identifying information. (Don't include
+       the brackets!)  The text should be enclosed in the appropriate
+       comment syntax for the file format. We also recommend that a
+       file or class name and description of purpose be included on the
+       same "printed page" as the copyright notice for easier
+       identification within third-party archives.
+
+    Copyright [yyyy] [name of copyright owner]
+
+    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.

data/OVERVIEW.md

@@ -0,0 +1,96 @@
+# Simple REST client for version V3 of the Playable Locations API
+
+This is a simple client library for version V3 of the Playable Locations API. It provides:
+
+* A client object that connects to the HTTP/JSON REST endpoint for the service.
+* Ruby objects for data structures related to the service.
+* Integration with the googleauth gem for authentication using OAuth, API keys, and service accounts.
+* Control of retry, pagination, and timeouts.
+
+Note that although this client library is supported and will continue to be updated to track changes to the service, it is otherwise considered complete and not under active development. Many Google services, especially Google Cloud Platform services, may provide a more modern client that is under more active development and improvement. See the section below titled *Which client should I use?* for more information.
+
+## Getting started
+
+### Before you begin
+
+There are a few setup steps you need to complete before you can use this library:
+
+ 1. If you don't already have a Google account, [sign up](https://www.google.com/accounts).
+ 2. If you have never created a Google APIs Console project, read about [Managing Projects](https://cloud.google.com/resource-manager/docs/creating-managing-projects) and create a project in the [Google API Console](https://console.cloud.google.com/).
+ 3. Most APIs need to be enabled for your project. [Enable it](https://console.cloud.google.com/apis/library/playablelocations.googleapis.com) in the console.
+
+### Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'google-apis-playablelocations_v3', '~> 0.1'
+```
+
+And then execute:
+
+```
+$ bundle
+```
+
+Or install it yourself as:
+
+```
+$ gem install google-apis-playablelocations_v3
+```
+
+### Creating a client object
+
+Once the gem is installed, you can load the client code and instantiate a client.
+
+```ruby
+# Load the client
+require "google/apis/playablelocations_v3"
+
+# Create a client object
+client = Google::Apis::PlayablelocationsV3::PlayableLocationsService.new
+
+# Authenticate calls
+client.authentication = # ... use the googleauth gem to create credentials
+```
+
+See the class reference docs for information on the methods you can call from a client.
+
+## Documentation
+
+More detailed descriptions of the Google simple REST clients are available in two documents.
+
+ *  The [Usage Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/usage-guide.md) discusses how to make API calls, how to use the provided data structures, and how to work the various features of the client library, including media upload and download, error handling, retries, pagination, and logging.
+ *  The [Auth Guide](https://github.com/googleapis/google-api-ruby-client/blob/master/docs/auth-guide.md) discusses authentication in the client libraries, including API keys, OAuth 2.0, service accounts, and environment variables.
+
+(Note: the above documents are written for the simple REST clients in general, and their examples may not reflect the Playablelocations service in particular.)
+
+For reference information on specific calls in the Playable Locations API, see the {Google::Apis::PlayablelocationsV3::PlayableLocationsService class reference docs}.
+
+## Which client should I use?
+
+Google provides two types of Ruby API client libraries: **simple REST clients** and **modern clients**.
+
+This library, `google-apis-playablelocations_v3`, is a simple REST client. You can identify these clients by their gem names, which are always in the form `google-apis-<servicename>_<serviceversion>`. The simple REST clients connect to HTTP/JSON REST endpoints and are automatically generated from service discovery documents. They support most API functionality, but their class interfaces are sometimes awkward.
+
+Modern clients are produced by a modern code generator, sometimes combined with hand-crafted functionality. Most modern clients connect to high-performance gRPC endpoints, although a few are backed by REST services. Modern clients are available for many Google services, especially Google Cloud Platform services, but do not yet support all the services covered by the simple clients.
+
+Gem names for modern clients are often of the form `google-cloud-<service_name>`. (For example, [google-cloud-pubsub](https://rubygems.org/gems/google-cloud-pubsub).) Note that most modern clients also have corresponding "versioned" gems with names like `google-cloud-<service_name>-<version>`. (For example, [google-cloud-pubsub-v1](https://rubygems.org/gems/google-cloud-pubsub-v1).) The "versioned" gems can be used directly, but often provide lower-level interfaces. In most cases, the main gem is recommended.
+
+**For most users, we recommend the modern client, if one is available.** Compared with simple clients, modern clients are generally much easier to use and more Ruby-like, support more advanced features such as streaming and long-running operations, and often provide much better performance. You may consider using a simple client instead, if a modern client is not yet available for the service you want to use, or if you are not able to use gRPC on your infrastructure.
+
+The [product documentation](https://developers.google.com/maps/contact-sales/) may provide guidance regarding the preferred client library to use.
+
+## Supported Ruby versions
+
+This library is supported on Ruby 2.5+.
+
+Google provides official support for Ruby versions that are actively supported by Ruby Core -- that is, Ruby versions that are either in normal maintenance or in security maintenance, and not end of life. Currently, this means Ruby 2.5 and later. Older versions of Ruby _may_ still work, but are unsupported and not recommended. See https://www.ruby-lang.org/en/downloads/branches/ for details about the Ruby support schedule.
+
+## License
+
+This library is licensed under Apache 2.0. Full license text is available in the {file:LICENSE.md LICENSE}.
+
+## Support
+
+Please [report bugs at the project on Github](https://github.com/google/google-api-ruby-client/issues). Don't hesitate to [ask questions](http://stackoverflow.com/questions/tagged/google-api-ruby-client) about the client or APIs on [StackOverflow](http://stackoverflow.com).

data/lib/google-apis-playablelocations_v3.rb

@@ -0,0 +1,15 @@
+# Copyright 2020 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.
+
+require "google/apis/playablelocations_v3"

data/lib/google/apis/playablelocations_v3.rb

@@ -0,0 +1,33 @@
+# Copyright 2020 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.
+
+require 'google/apis/playablelocations_v3/service.rb'
+require 'google/apis/playablelocations_v3/classes.rb'
+require 'google/apis/playablelocations_v3/representations.rb'
+require 'google/apis/playablelocations_v3/gem_version.rb'
+
+module Google
+  module Apis
+    # Playable Locations API
+    #
+    # 
+    #
+    # @see https://developers.google.com/maps/contact-sales/
+    module PlayablelocationsV3
+      # Version of the Playable Locations API this client connects to.
+      # This is NOT the gem version.
+      VERSION = 'V3'
+    end
+  end
+end

data/lib/google/apis/playablelocations_v3/classes.rb

@@ -0,0 +1,586 @@
+# Copyright 2020 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.
+
+require 'date'
+require 'google/apis/core/base_service'
+require 'google/apis/core/json_representation'
+require 'google/apis/core/hashable'
+require 'google/apis/errors'
+
+module Google
+  module Apis
+    module PlayablelocationsV3
+      
+      # Encapsulates impression event details.
+      class GoogleMapsPlayablelocationsV3Impression
+        include Google::Apis::Core::Hashable
+      
+        # An arbitrary, developer-defined type identifier for each type of game object
+        # used in your game. Since players interact with differ types of game objects in
+        # different ways, this field allows you to segregate impression data by type for
+        # analysis. You should assign a unique `game_object_type` ID to represent a
+        # distinct type of game object in your game. For example, 1=monster location, 2=
+        # powerup location.
+        # Corresponds to the JSON property `gameObjectType`
+        # @return [Fixnum]
+        attr_accessor :game_object_type
+      
+        # Required. The type of impression event.
+        # Corresponds to the JSON property `impressionType`
+        # @return [String]
+        attr_accessor :impression_type
+      
+        # Required. The name of the playable location.
+        # Corresponds to the JSON property `locationName`
+        # @return [String]
+        attr_accessor :location_name
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @game_object_type = args[:game_object_type] if args.key?(:game_object_type)
+          @impression_type = args[:impression_type] if args.key?(:impression_type)
+          @location_name = args[:location_name] if args.key?(:location_name)
+        end
+      end
+      
+      # A request for logging impressions.
+      class GoogleMapsPlayablelocationsV3LogImpressionsRequest
+        include Google::Apis::Core::Hashable
+      
+        # Client information.
+        # Corresponds to the JSON property `clientInfo`
+        # @return [Google::Apis::PlayablelocationsV3::GoogleMapsUnityClientInfo]
+        attr_accessor :client_info
+      
+        # Required. Impression event details. The maximum number of impression reports
+        # that you can log at once is 50.
+        # Corresponds to the JSON property `impressions`
+        # @return [Array<Google::Apis::PlayablelocationsV3::GoogleMapsPlayablelocationsV3Impression>]
+        attr_accessor :impressions
+      
+        # Required. A string that uniquely identifies the log impressions request. This
+        # allows you to detect duplicate requests. We recommend that you use UUIDs for
+        # this value. The value must not exceed 50 characters. You should reuse the `
+        # request_id` only when retrying a request in case of failure. In this case, the
+        # request must be identical to the one that failed.
+        # Corresponds to the JSON property `requestId`
+        # @return [String]
+        attr_accessor :request_id
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @client_info = args[:client_info] if args.key?(:client_info)
+          @impressions = args[:impressions] if args.key?(:impressions)
+          @request_id = args[:request_id] if args.key?(:request_id)
+        end
+      end
+      
+      # A response for the LogImpressions method. This method returns no data upon
+      # success.
+      class GoogleMapsPlayablelocationsV3LogImpressionsResponse
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
+      # A request for logging your player's bad location reports.
+      class GoogleMapsPlayablelocationsV3LogPlayerReportsRequest
+        include Google::Apis::Core::Hashable
+      
+        # Client information.
+        # Corresponds to the JSON property `clientInfo`
+        # @return [Google::Apis::PlayablelocationsV3::GoogleMapsUnityClientInfo]
+        attr_accessor :client_info
+      
+        # Required. Player reports. The maximum number of player reports that you can
+        # log at once is 50.
+        # Corresponds to the JSON property `playerReports`
+        # @return [Array<Google::Apis::PlayablelocationsV3::GoogleMapsPlayablelocationsV3PlayerReport>]
+        attr_accessor :player_reports
+      
+        # Required. A string that uniquely identifies the log player reports request.
+        # This allows you to detect duplicate requests. We recommend that you use UUIDs
+        # for this value. The value must not exceed 50 characters. You should reuse the `
+        # request_id` only when retrying a request in the case of a failure. In that
+        # case, the request must be identical to the one that failed.
+        # Corresponds to the JSON property `requestId`
+        # @return [String]
+        attr_accessor :request_id
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @client_info = args[:client_info] if args.key?(:client_info)
+          @player_reports = args[:player_reports] if args.key?(:player_reports)
+          @request_id = args[:request_id] if args.key?(:request_id)
+        end
+      end
+      
+      # A response for the LogPlayerReports method. This method returns no data upon
+      # success.
+      class GoogleMapsPlayablelocationsV3LogPlayerReportsResponse
+        include Google::Apis::Core::Hashable
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+        end
+      end
+      
+      # A report submitted by a player about a playable location that is considered
+      # inappropriate for use in the game.
+      class GoogleMapsPlayablelocationsV3PlayerReport
+        include Google::Apis::Core::Hashable
+      
+        # Language code (in BCP-47 format) indicating the language of the freeform
+        # description provided in `reason_details`. Examples are "en", "en-US" or "ja-
+        # Latn". For more information, see http://www.unicode.org/reports/tr35/#
+        # Unicode_locale_identifier.
+        # Corresponds to the JSON property `languageCode`
+        # @return [String]
+        attr_accessor :language_code
+      
+        # Required. The name of the playable location.
+        # Corresponds to the JSON property `locationName`
+        # @return [String]
+        attr_accessor :location_name
+      
+        # Required. A free-form description detailing why the playable location is
+        # considered bad.
+        # Corresponds to the JSON property `reasonDetails`
+        # @return [String]
+        attr_accessor :reason_details
+      
+        # Required. One or more reasons why this playable location is considered bad.
+        # Corresponds to the JSON property `reasons`
+        # @return [Array<String>]
+        attr_accessor :reasons
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @language_code = args[:language_code] if args.key?(:language_code)
+          @location_name = args[:location_name] if args.key?(:location_name)
+          @reason_details = args[:reason_details] if args.key?(:reason_details)
+          @reasons = args[:reasons] if args.key?(:reasons)
+        end
+      end
+      
+      # Specifies the area to search for playable locations.
+      class GoogleMapsPlayablelocationsV3SampleAreaFilter
+        include Google::Apis::Core::Hashable
+      
+        # Required. The S2 cell ID of the area you want. This must be between cell level
+        # 11 and 14 (inclusive). S2 cells are 64-bit integers that identify areas on the
+        # Earth. They are hierarchical, and can therefore be used for spatial indexing.
+        # The S2 geometry library is available in a number of languages: * [C++](https://
+        # github.com/google/s2geometry) * [Java](https://github.com/google/s2-geometry-
+        # library-java) * [Go](https://github.com/golang/geo) * [Python](https://github.
+        # com/google/s2geometry/tree/master/src/python)
+        # Corresponds to the JSON property `s2CellId`
+        # @return [Fixnum]
+        attr_accessor :s2_cell_id
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @s2_cell_id = args[:s2_cell_id] if args.key?(:s2_cell_id)
+        end
+      end
+      
+      # Encapsulates a filter criterion for searching for a set of playable locations.
+      class GoogleMapsPlayablelocationsV3SampleCriterion
+        include Google::Apis::Core::Hashable
+      
+        # Specifies which `PlayableLocation` fields are returned. `name` (which is used
+        # for logging impressions), `center_point` and `place_id` (or `plus_code`) are
+        # always returned. The following fields are omitted unless you specify them here:
+        # * snapped_point * types Note: The more fields you include, the more expensive
+        # in terms of data and associated latency your query will be.
+        # Corresponds to the JSON property `fieldsToReturn`
+        # @return [String]
+        attr_accessor :fields_to_return
+      
+        # Specifies the filters to use when searching for playable locations.
+        # Corresponds to the JSON property `filter`
+        # @return [Google::Apis::PlayablelocationsV3::GoogleMapsPlayablelocationsV3SampleFilter]
+        attr_accessor :filter
+      
+        # Required. An arbitrary, developer-defined identifier of the type of game
+        # object that the playable location is used for. This field allows you to
+        # specify criteria per game object type when searching for playable locations.
+        # You should assign a unique `game_object_type` ID across all `request_criteria`
+        # to represent a distinct type of game object. For example, 1=monster location,
+        # 2=powerup location. The response contains a map.
+        # Corresponds to the JSON property `gameObjectType`
+        # @return [Fixnum]
+        attr_accessor :game_object_type
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @fields_to_return = args[:fields_to_return] if args.key?(:fields_to_return)
+          @filter = args[:filter] if args.key?(:filter)
+          @game_object_type = args[:game_object_type] if args.key?(:game_object_type)
+        end
+      end
+      
+      # Specifies the filters to use when searching for playable locations.
+      class GoogleMapsPlayablelocationsV3SampleFilter
+        include Google::Apis::Core::Hashable
+      
+        # Restricts the set of playable locations to just the [types](/maps/
+        # documentation/gaming/tt/types) that you want.
+        # Corresponds to the JSON property `includedTypes`
+        # @return [Array<String>]
+        attr_accessor :included_types
+      
+        # Specifies the maximum number of playable locations to return. This value must
+        # not be greater than 1000. The default value is 100. Only the top-ranking
+        # playable locations are returned.
+        # Corresponds to the JSON property `maxLocationCount`
+        # @return [Fixnum]
+        attr_accessor :max_location_count
+      
+        # A set of options that specifies the separation between playable locations.
+        # Corresponds to the JSON property `spacing`
+        # @return [Google::Apis::PlayablelocationsV3::GoogleMapsPlayablelocationsV3SampleSpacingOptions]
+        attr_accessor :spacing
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @included_types = args[:included_types] if args.key?(:included_types)
+          @max_location_count = args[:max_location_count] if args.key?(:max_location_count)
+          @spacing = args[:spacing] if args.key?(:spacing)
+        end
+      end
+      
+      # A geographical point suitable for placing game objects in location-based games.
+      class GoogleMapsPlayablelocationsV3SamplePlayableLocation
+        include Google::Apis::Core::Hashable
+      
+        # An object that represents a latitude/longitude pair. This is expressed as a
+        # pair of doubles to represent degrees latitude and degrees longitude. Unless
+        # specified otherwise, this must conform to the WGS84 standard. Values must be
+        # within normalized ranges.
+        # Corresponds to the JSON property `centerPoint`
+        # @return [Google::Apis::PlayablelocationsV3::GoogleTypeLatLng]
+        attr_accessor :center_point
+      
+        # Required. The name of this playable location.
+        # Corresponds to the JSON property `name`
+        # @return [String]
+        attr_accessor :name
+      
+        # A [place ID] (https://developers.google.com/places/place-id)
+        # Corresponds to the JSON property `placeId`
+        # @return [String]
+        attr_accessor :place_id
+      
+        # A [plus code] (http://openlocationcode.com)
+        # Corresponds to the JSON property `plusCode`
+        # @return [String]
+        attr_accessor :plus_code
+      
+        # An object that represents a latitude/longitude pair. This is expressed as a
+        # pair of doubles to represent degrees latitude and degrees longitude. Unless
+        # specified otherwise, this must conform to the WGS84 standard. Values must be
+        # within normalized ranges.
+        # Corresponds to the JSON property `snappedPoint`
+        # @return [Google::Apis::PlayablelocationsV3::GoogleTypeLatLng]
+        attr_accessor :snapped_point
+      
+        # A collection of [Playable Location Types](/maps/documentation/gaming/tt/types)
+        # for this playable location. The first type in the collection is the primary
+        # type. Type information might not be available for all playable locations.
+        # Corresponds to the JSON property `types`
+        # @return [Array<String>]
+        attr_accessor :types
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @center_point = args[:center_point] if args.key?(:center_point)
+          @name = args[:name] if args.key?(:name)
+          @place_id = args[:place_id] if args.key?(:place_id)
+          @plus_code = args[:plus_code] if args.key?(:plus_code)
+          @snapped_point = args[:snapped_point] if args.key?(:snapped_point)
+          @types = args[:types] if args.key?(:types)
+        end
+      end
+      
+      # A list of PlayableLocation objects that satisfies a single Criterion.
+      class GoogleMapsPlayablelocationsV3SamplePlayableLocationList
+        include Google::Apis::Core::Hashable
+      
+        # A list of playable locations for this game object type.
+        # Corresponds to the JSON property `locations`
+        # @return [Array<Google::Apis::PlayablelocationsV3::GoogleMapsPlayablelocationsV3SamplePlayableLocation>]
+        attr_accessor :locations
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @locations = args[:locations] if args.key?(:locations)
+        end
+      end
+      
+      # Life of a query: - When a game starts in a new location, your game server
+      # issues a SamplePlayableLocations request. The request specifies the S2 cell,
+      # and contains one or more "criteria" for filtering: - Criterion 0: i locations
+      # for long-lived bases, or level 0 monsters, or... - Criterion 1: j locations
+      # for short-lived bases, or level 1 monsters, ... - Criterion 2: k locations for
+      # random objects. - etc (up to 5 criterion may be specified). `
+      # PlayableLocationList` will then contain mutually exclusive lists of `
+      # PlayableLocation` objects that satisfy each of the criteria. Think of it as a
+      # collection of real-world locations that you can then associate with your game
+      # state. Note: These points are impermanent in nature. E.g, parks can close, and
+      # places can be removed. The response specifies how long you can expect the
+      # playable locations to last. Once they expire, you should query the `
+      # samplePlayableLocations` API again to get a fresh view of the real world.
+      class GoogleMapsPlayablelocationsV3SamplePlayableLocationsRequest
+        include Google::Apis::Core::Hashable
+      
+        # Specifies the area to search for playable locations.
+        # Corresponds to the JSON property `areaFilter`
+        # @return [Google::Apis::PlayablelocationsV3::GoogleMapsPlayablelocationsV3SampleAreaFilter]
+        attr_accessor :area_filter
+      
+        # Required. Specifies one or more (up to 5) criteria for filtering the returned
+        # playable locations.
+        # Corresponds to the JSON property `criteria`
+        # @return [Array<Google::Apis::PlayablelocationsV3::GoogleMapsPlayablelocationsV3SampleCriterion>]
+        attr_accessor :criteria
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @area_filter = args[:area_filter] if args.key?(:area_filter)
+          @criteria = args[:criteria] if args.key?(:criteria)
+        end
+      end
+      
+      # Response for the SamplePlayableLocations method.
+      class GoogleMapsPlayablelocationsV3SamplePlayableLocationsResponse
+        include Google::Apis::Core::Hashable
+      
+        # Each PlayableLocation object corresponds to a game_object_type specified in
+        # the request.
+        # Corresponds to the JSON property `locationsPerGameObjectType`
+        # @return [Hash<String,Google::Apis::PlayablelocationsV3::GoogleMapsPlayablelocationsV3SamplePlayableLocationList>]
+        attr_accessor :locations_per_game_object_type
+      
+        # Required. Specifies the "time-to-live" for the set of playable locations. You
+        # can use this value to determine how long to cache the set of playable
+        # locations. After this length of time, your back-end game server should issue a
+        # new SamplePlayableLocations request to get a fresh set of playable locations (
+        # because for example, they might have been removed, a park might have closed
+        # for the day, a business might have closed permanently).
+        # Corresponds to the JSON property `ttl`
+        # @return [String]
+        attr_accessor :ttl
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @locations_per_game_object_type = args[:locations_per_game_object_type] if args.key?(:locations_per_game_object_type)
+          @ttl = args[:ttl] if args.key?(:ttl)
+        end
+      end
+      
+      # A set of options that specifies the separation between playable locations.
+      class GoogleMapsPlayablelocationsV3SampleSpacingOptions
+        include Google::Apis::Core::Hashable
+      
+        # Required. The minimum spacing between any two playable locations, measured in
+        # meters. The minimum value is 30. The maximum value is 1000. Inputs will be
+        # rounded up to the next 10 meter interval. The default value is 200m. Set this
+        # field to remove tight clusters of playable locations. Note: The spacing is a
+        # greedy algorithm. It optimizes for selecting the highest ranking locations
+        # first, not to maximize the number of locations selected. Consider the
+        # following scenario: * Rank: A: 2, B: 1, C: 3. * Distance: A--200m--B--200m--C
+        # If spacing=250, it will pick the highest ranked location [B], not [A, C]. Note:
+        # Spacing works within the game object type itself, as well as the previous
+        # ones. Suppose three game object types, each with the following spacing: * X:
+        # 400m, Y: undefined, Z: 200m. 1. Add locations for X, within 400m of each other.
+        # 2. Add locations for Y, without any spacing. 3. Finally, add locations for Z
+        # within 200m of each other as well X and Y. The distance diagram between those
+        # locations end up as: * From->To. * X->X: 400m * Y->X, Y->Y: unspecified. * Z->
+        # X, Z->Y, Z->Z: 200m.
+        # Corresponds to the JSON property `minSpacingMeters`
+        # @return [Float]
+        attr_accessor :min_spacing_meters
+      
+        # Specifies whether the minimum spacing constraint applies to the center-point
+        # or to the snapped point of playable locations. The default value is `
+        # CENTER_POINT`. If a snapped point is not available for a playable location,
+        # its center-point is used instead. Set this to the point type used in your game.
+        # Corresponds to the JSON property `pointType`
+        # @return [String]
+        attr_accessor :point_type
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @min_spacing_meters = args[:min_spacing_meters] if args.key?(:min_spacing_meters)
+          @point_type = args[:point_type] if args.key?(:point_type)
+        end
+      end
+      
+      # Client information.
+      class GoogleMapsUnityClientInfo
+        include Google::Apis::Core::Hashable
+      
+        # API client name and version. For example, the SDK calling the API. The exact
+        # format is up to the client.
+        # Corresponds to the JSON property `apiClient`
+        # @return [String]
+        attr_accessor :api_client
+      
+        # Application ID, such as the package name on Android and the bundle identifier
+        # on iOS platforms.
+        # Corresponds to the JSON property `applicationId`
+        # @return [String]
+        attr_accessor :application_id
+      
+        # Application version number, such as "1.2.3". The exact format is application-
+        # dependent.
+        # Corresponds to the JSON property `applicationVersion`
+        # @return [String]
+        attr_accessor :application_version
+      
+        # Device model as reported by the device. The exact format is platform-dependent.
+        # Corresponds to the JSON property `deviceModel`
+        # @return [String]
+        attr_accessor :device_model
+      
+        # Language code (in BCP-47 format) indicating the UI language of the client.
+        # Examples are "en", "en-US" or "ja-Latn". For more information, see http://www.
+        # unicode.org/reports/tr35/#Unicode_locale_identifier.
+        # Corresponds to the JSON property `languageCode`
+        # @return [String]
+        attr_accessor :language_code
+      
+        # Operating system name and version as reported by the OS. For example, "Mac OS
+        # X 10.10.4". The exact format is platform-dependent.
+        # Corresponds to the JSON property `operatingSystem`
+        # @return [String]
+        attr_accessor :operating_system
+      
+        # Build number/version of the operating system. e.g., the contents of android.os.
+        # Build.ID in Android, or the contents of sysctl "kern.osversion" in iOS.
+        # Corresponds to the JSON property `operatingSystemBuild`
+        # @return [String]
+        attr_accessor :operating_system_build
+      
+        # Platform where the application is running.
+        # Corresponds to the JSON property `platform`
+        # @return [String]
+        attr_accessor :platform
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @api_client = args[:api_client] if args.key?(:api_client)
+          @application_id = args[:application_id] if args.key?(:application_id)
+          @application_version = args[:application_version] if args.key?(:application_version)
+          @device_model = args[:device_model] if args.key?(:device_model)
+          @language_code = args[:language_code] if args.key?(:language_code)
+          @operating_system = args[:operating_system] if args.key?(:operating_system)
+          @operating_system_build = args[:operating_system_build] if args.key?(:operating_system_build)
+          @platform = args[:platform] if args.key?(:platform)
+        end
+      end
+      
+      # An object that represents a latitude/longitude pair. This is expressed as a
+      # pair of doubles to represent degrees latitude and degrees longitude. Unless
+      # specified otherwise, this must conform to the WGS84 standard. Values must be
+      # within normalized ranges.
+      class GoogleTypeLatLng
+        include Google::Apis::Core::Hashable
+      
+        # The latitude in degrees. It must be in the range [-90.0, +90.0].
+        # Corresponds to the JSON property `latitude`
+        # @return [Float]
+        attr_accessor :latitude
+      
+        # The longitude in degrees. It must be in the range [-180.0, +180.0].
+        # Corresponds to the JSON property `longitude`
+        # @return [Float]
+        attr_accessor :longitude
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @latitude = args[:latitude] if args.key?(:latitude)
+          @longitude = args[:longitude] if args.key?(:longitude)
+        end
+      end
+    end
+  end
+end