google-apis-androidpublisher_v3 0.79.0 → 0.81.0

data/lib/google/apis/androidpublisher_v3/service.rb

@@ -2707,13 +2707,13 @@ module Google
         #   resource.
         # @param [String] regions_version_version
         #   Required. A string representing the version of available regions being used
-        #   for the specified resource. Regional prices for the resource have to be
-        #   specified according to the information published in [this article](https://
-        #   support.google.com/googleplay/android-developer/answer/10532353). Each time
-        #   the supported locations substantially change, the version will be incremented.
-        #   Using this field will ensure that creating and updating the resource with an
-        #   older region's version and set of regional prices and currencies will succeed
-        #   even though a new version is available. The latest version is 2022/02.
+        #   for the specified resource. Regional prices and latest supported version for
+        #   the resource have to be specified according to the information published in [
+        #   this article](https://support.google.com/googleplay/android-developer/answer/
+        #   10532353). Each time the supported locations substantially change, the version
+        #   will be incremented. Using this field will ensure that creating and updating
+        #   the resource with an older region's version and set of regional prices and
+        #   currencies will succeed even though a new version is available.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -2874,13 +2874,13 @@ module Google
         #   Defaults to latency-sensitive.
         # @param [String] regions_version_version
         #   Required. A string representing the version of available regions being used
-        #   for the specified resource. Regional prices for the resource have to be
-        #   specified according to the information published in [this article](https://
-        #   support.google.com/googleplay/android-developer/answer/10532353). Each time
-        #   the supported locations substantially change, the version will be incremented.
-        #   Using this field will ensure that creating and updating the resource with an
-        #   older region's version and set of regional prices and currencies will succeed
-        #   even though a new version is available. The latest version is 2022/02.
+        #   for the specified resource. Regional prices and latest supported version for
+        #   the resource have to be specified according to the information published in [
+        #   this article](https://support.google.com/googleplay/android-developer/answer/
+        #   10532353). Each time the supported locations substantially change, the version
+        #   will be incremented. Using this field will ensure that creating and updating
+        #   the resource with an older region's version and set of regional prices and
+        #   currencies will succeed even though a new version is available.
         # @param [String] update_mask
         #   Required. The list of fields to be updated.
         # @param [String] fields
@@ -3355,13 +3355,13 @@ module Google
         #   see the documentation of the offer_id field on the SubscriptionOffer resource.
         # @param [String] regions_version_version
         #   Required. A string representing the version of available regions being used
-        #   for the specified resource. Regional prices for the resource have to be
-        #   specified according to the information published in [this article](https://
-        #   support.google.com/googleplay/android-developer/answer/10532353). Each time
-        #   the supported locations substantially change, the version will be incremented.
-        #   Using this field will ensure that creating and updating the resource with an
-        #   older region's version and set of regional prices and currencies will succeed
-        #   even though a new version is available. The latest version is 2022/02.
+        #   for the specified resource. Regional prices and latest supported version for
+        #   the resource have to be specified according to the information published in [
+        #   this article](https://support.google.com/googleplay/android-developer/answer/
+        #   10532353). Each time the supported locations substantially change, the version
+        #   will be incremented. Using this field will ensure that creating and updating
+        #   the resource with an older region's version and set of regional prices and
+        #   currencies will succeed even though a new version is available.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -3589,13 +3589,13 @@ module Google
         #   Defaults to latency-sensitive.
         # @param [String] regions_version_version
         #   Required. A string representing the version of available regions being used
-        #   for the specified resource. Regional prices for the resource have to be
-        #   specified according to the information published in [this article](https://
-        #   support.google.com/googleplay/android-developer/answer/10532353). Each time
-        #   the supported locations substantially change, the version will be incremented.
-        #   Using this field will ensure that creating and updating the resource with an
-        #   older region's version and set of regional prices and currencies will succeed
-        #   even though a new version is available. The latest version is 2022/02.
+        #   for the specified resource. Regional prices and latest supported version for
+        #   the resource have to be specified according to the information published in [
+        #   this article](https://support.google.com/googleplay/android-developer/answer/
+        #   10532353). Each time the supported locations substantially change, the version
+        #   will be incremented. Using this field will ensure that creating and updating
+        #   the resource with an older region's version and set of regional prices and
+        #   currencies will succeed even though a new version is available.
         # @param [String] update_mask
         #   Required. The list of fields to be updated.
         # @param [String] fields
@@ -3634,6 +3634,78 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Get order details for a list of orders.
+        # @param [String] package_name
+        #   Required. The package name of the application for which this subscription or
+        #   in-app item was purchased (for example, 'com.some.thing').
+        # @param [Array<String>, String] order_ids
+        #   Required. The list of order IDs to retrieve order details for. There must be
+        #   between 1 and 1000 (inclusive) order IDs per request. If any order ID is not
+        #   found or does not match the provided package, the entire request will fail
+        #   with an error. The order IDs must be distinct.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::AndroidpublisherV3::BatchGetOrdersResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::AndroidpublisherV3::BatchGetOrdersResponse]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def batchget_order(package_name, order_ids: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'androidpublisher/v3/applications/{packageName}/orders:batchGet', options)
+          command.response_representation = Google::Apis::AndroidpublisherV3::BatchGetOrdersResponse::Representation
+          command.response_class = Google::Apis::AndroidpublisherV3::BatchGetOrdersResponse
+          command.params['packageName'] = package_name unless package_name.nil?
+          command.query['orderIds'] = order_ids unless order_ids.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Get order details for a single order.
+        # @param [String] package_name
+        #   Required. The package name of the application for which this subscription or
+        #   in-app item was purchased (for example, 'com.some.thing').
+        # @param [String] order_id
+        #   Required. The order ID provided to the user when the subscription or in-app
+        #   order was purchased.
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::AndroidpublisherV3::Order] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::AndroidpublisherV3::Order]
+        #
+        # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
+        # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
+        # @raise [Google::Apis::AuthorizationError] Authorization is required
+        def get_order(package_name, order_id, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'androidpublisher/v3/applications/{packageName}/orders/{orderId}', options)
+          command.response_representation = Google::Apis::AndroidpublisherV3::Order::Representation
+          command.response_class = Google::Apis::AndroidpublisherV3::Order
+          command.params['packageName'] = package_name unless package_name.nil?
+          command.params['orderId'] = order_id unless order_id.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Refunds a user's subscription or in-app purchase order. Orders older than 3
         # years cannot be refunded.
         # @param [String] package_name
@@ -3789,7 +3861,9 @@ module Google
         #   The package name of the application for which this subscription was purchased (
         #   for example, 'com.some.thing').
         # @param [String] subscription_id
-        #   The purchased subscription ID (for example, 'monthly001').
+        #   Note: Since May 21, 2025, subscription_id is not required, and not recommended
+        #   for subscription with add-ons. The purchased subscription ID (for example, '
+        #   monthly001').
         # @param [String] token
         #   The token provided to the user's device when the subscription was purchased.
         # @param [Google::Apis::AndroidpublisherV3::SubscriptionPurchasesAcknowledgeRequest] subscription_purchases_acknowledge_request_object
@@ -3828,7 +3902,9 @@ module Google
         #   The package name of the application for which this subscription was purchased (
         #   for example, 'com.some.thing').
         # @param [String] subscription_id
-        #   The purchased subscription ID (for example, 'monthly001').
+        #   Note: Since May 21, 2025, subscription_id is not required, and not recommended
+        #   for subscription with add-ons. The purchased subscription ID (for example, '
+        #   monthly001').
         # @param [String] token
         #   The token provided to the user's device when the subscription was purchased.
         # @param [String] fields
@@ -3898,8 +3974,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Checks whether a user's subscription purchase is valid and returns its expiry
-        # time.
+        # Deprecated: Use purchases.subscriptionsv2.get instead. Checks whether a user's
+        # subscription purchase is valid and returns its expiry time.
         # @param [String] package_name
         #   The package name of the application for which this subscription was purchased (
         #   for example, 'com.some.thing').
@@ -3936,8 +4012,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Refunds a user's subscription purchase, but the subscription remains valid
-        # until its expiration time and it will continue to recur.
+        # Deprecated: Use orders.refund instead. Refunds a user's subscription purchase,
+        # but the subscription remains valid until its expiration time and it will
+        # continue to recur.
         # @param [String] package_name
         #   The package name of the application for which this subscription was purchased (
         #   for example, 'com.some.thing').
@@ -3972,8 +4049,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Refunds and immediately revokes a user's subscription purchase. Access to the
-        # subscription will be terminated immediately and it will stop recurring.
+        # Deprecated: Use purchases.subscriptionsv2.revoke instead. Refunds and
+        # immediately revokes a user's subscription purchase. Access to the subscription
+        # will be terminated immediately and it will stop recurring.
         # @param [String] package_name
         #   The package name of the application for which this subscription was purchased (
         #   for example, 'com.some.thing').

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-androidpublisher_v3
 version: !ruby/object:Gem::Version
-  version: 0.79.0
+  version: 0.81.0
 platform: ruby
 authors:
 - Google LLC
@@ -57,7 +57,7 @@ licenses:
 metadata:
   bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
   changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-androidpublisher_v3/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-androidpublisher_v3/v0.79.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-androidpublisher_v3/v0.81.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-androidpublisher_v3
 rdoc_options: []
 require_paths:
@@ -73,7 +73,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.8
+rubygems_version: 3.6.9
 specification_version: 4
 summary: Simple REST client for Google Play Android Developer API V3
 test_files: []