feat(androidpublisher): update the api

#### androidpublisher:v3

The following keys were added:
- resources.purchases.resources.subscriptions.methods.get.deprecated (Total Keys: 1)
- resources.purchases.resources.subscriptions.methods.refund.deprecated (Total Keys: 1)
- resources.purchases.resources.subscriptions.methods.revoke.deprecated (Total Keys: 1)
- schemas.SubscriptionPurchaseV2.properties.latestOrderId.deprecated (Total Keys: 1)

Author: yoshi-automation

docs/dyn/androidpublisher_v3.orders.html

@@ -104,7 +104,7 @@ <h3>Method Details</h3>
 
     { # Response for the orders.batchGet API.
   &quot;orders&quot;: [ # Details for the requested order IDs.
-    { # Details of an order.
+    { # The Order resource encapsulates comprehensive information about a transaction made on Google Play. It includes a variety of attributes that provide details about the order itself, the products purchased, and the history of events related to the order. The Orders APIs provide real-time access to your order data within the Google Play ecosystem. You can retrieve detailed information and metadata for both one-time and recurring orders, including transaction details like charges, taxes, and refunds, as well as metadata such as pricing phases for subscriptions. The Orders APIs let you automate tasks related to order management, reducing the need for manual checks via the Play Developer Console. The following are some of the use cases for this API: + Real-time order data retrieval - Get order details and metadata immediately after a purchase using an order ID. + Order update synchronization - Periodically sync order updates to maintain an up-to-date record of order information. Note: + The Orders API calls count towards your Play Developer API quota, which defaults to 200K daily, and may be insufficient to sync extensive order histories. + A maximum of 1000 orders can be retrieved per call. Using larger page sizes is recommended to minimize quota usage. Check your quota in the Cloud Console and request more if required.
       &quot;buyerAddress&quot;: { # Address information for the customer, for use in tax computation. # Address information for the customer, for use in tax computation. When Google is the Merchant of Record for the order, only country is shown.
         &quot;buyerCountry&quot;: &quot;A String&quot;, # Two letter country code based on ISO-3166-1 Alpha-2 (UN country codes).
         &quot;buyerPostcode&quot;: &quot;A String&quot;, # Postal code of an address. When Google is the Merchant of Record for the order, this information is not included.
@@ -245,7 +245,7 @@ <h3>Method Details</h3>
 Returns:
   An object of the form:
 
-    { # Details of an order.
+    { # The Order resource encapsulates comprehensive information about a transaction made on Google Play. It includes a variety of attributes that provide details about the order itself, the products purchased, and the history of events related to the order. The Orders APIs provide real-time access to your order data within the Google Play ecosystem. You can retrieve detailed information and metadata for both one-time and recurring orders, including transaction details like charges, taxes, and refunds, as well as metadata such as pricing phases for subscriptions. The Orders APIs let you automate tasks related to order management, reducing the need for manual checks via the Play Developer Console. The following are some of the use cases for this API: + Real-time order data retrieval - Get order details and metadata immediately after a purchase using an order ID. + Order update synchronization - Periodically sync order updates to maintain an up-to-date record of order information. Note: + The Orders API calls count towards your Play Developer API quota, which defaults to 200K daily, and may be insufficient to sync extensive order histories. + A maximum of 1000 orders can be retrieved per call. Using larger page sizes is recommended to minimize quota usage. Check your quota in the Cloud Console and request more if required.
   &quot;buyerAddress&quot;: { # Address information for the customer, for use in tax computation. # Address information for the customer, for use in tax computation. When Google is the Merchant of Record for the order, only country is shown.
     &quot;buyerCountry&quot;: &quot;A String&quot;, # Two letter country code based on ISO-3166-1 Alpha-2 (UN country codes).
     &quot;buyerPostcode&quot;: &quot;A String&quot;, # Postal code of an address. When Google is the Merchant of Record for the order, this information is not included.

docs/dyn/androidpublisher_v3.purchases.subscriptions.html

@@ -88,13 +88,13 @@ <h2>Instance Methods</h2>
 <p class="firstline">Defers a user's subscription purchase until a specified future expiration time.</p>
 <p class="toc_element">
   <code><a href="#get">get(packageName, subscriptionId, token, x__xgafv=None)</a></code></p>
-<p class="firstline">Checks whether a user's subscription purchase is valid and returns its expiry time.</p>
+<p class="firstline">Deprecated: Use purchases.subscriptionsv2.get instead. Checks whether a user's subscription purchase is valid and returns its expiry time.</p>
 <p class="toc_element">
   <code><a href="#refund">refund(packageName, subscriptionId, token, x__xgafv=None)</a></code></p>
-<p class="firstline">Refunds a user's subscription purchase, but the subscription remains valid until its expiration time and it will continue to recur.</p>
+<p class="firstline">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.</p>
 <p class="toc_element">
   <code><a href="#revoke">revoke(packageName, subscriptionId, token, x__xgafv=None)</a></code></p>
-<p class="firstline">Refunds and immediately revokes a user's subscription purchase. Access to the subscription will be terminated immediately and it will stop recurring.</p>
+<p class="firstline">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.</p>
 <h3>Method Details</h3>
 <div class="method">
     <code class="details" id="acknowledge">acknowledge(packageName, subscriptionId, token, body=None, x__xgafv=None)</code>
@@ -171,7 +171,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="get">get(packageName, subscriptionId, token, x__xgafv=None)</code>
-  <pre>Checks whether a user&#x27;s subscription purchase is valid and returns its expiry time.
+  <pre>Deprecated: Use purchases.subscriptionsv2.get instead. Checks whether a user&#x27;s subscription purchase is valid and returns its expiry time.
 
 Args:
   packageName: string, The package name of the application for which this subscription was purchased (for example, &#x27;com.some.thing&#x27;). (required)
@@ -234,7 +234,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="refund">refund(packageName, subscriptionId, token, x__xgafv=None)</code>
-  <pre>Refunds a user&#x27;s subscription purchase, but the subscription remains valid until its expiration time and it will continue to recur.
+  <pre>Deprecated: Use orders.refund instead. Refunds a user&#x27;s subscription purchase, but the subscription remains valid until its expiration time and it will continue to recur.
 
 Args:
   packageName: string, The package name of the application for which this subscription was purchased (for example, &#x27;com.some.thing&#x27;). (required)
@@ -249,7 +249,7 @@ <h3>Method Details</h3>
 
 <div class="method">
     <code class="details" id="revoke">revoke(packageName, subscriptionId, token, x__xgafv=None)</code>
-  <pre>Refunds and immediately revokes a user&#x27;s subscription purchase. Access to the subscription will be terminated immediately and it will stop recurring.
+  <pre>Deprecated: Use purchases.subscriptionsv2.revoke instead. Refunds and immediately revokes a user&#x27;s subscription purchase. Access to the subscription will be terminated immediately and it will stop recurring.
 
 Args:
   packageName: string, The package name of the application for which this subscription was purchased (for example, &#x27;com.some.thing&#x27;). (required)

docs/dyn/androidpublisher_v3.purchases.subscriptionsv2.html

@@ -127,7 +127,7 @@ <h3>Method Details</h3>
     &quot;obfuscatedExternalProfileId&quot;: &quot;A String&quot;, # An obfuscated version of the id that is uniquely associated with the user&#x27;s profile in your app. Only present if specified using https://developer.android.com/reference/com/android/billingclient/api/BillingFlowParams.Builder#setobfuscatedprofileid when the purchase was made.
   },
   &quot;kind&quot;: &quot;A String&quot;, # This kind represents a SubscriptionPurchaseV2 object in the androidpublisher service.
-  &quot;latestOrderId&quot;: &quot;A String&quot;, # The order id of the latest order associated with the purchase of the subscription. For autoRenewing subscription, this is the order id of signup order if it is not renewed yet, or the last recurring order id (success, pending, or declined order). For prepaid subscription, this is the order id associated with the queried purchase token.
+  &quot;latestOrderId&quot;: &quot;A String&quot;, # Deprecated: Use line_items.latest_successful_order_id instead. The order id of the latest order associated with the purchase of the subscription. For autoRenewing subscription, this is the order id of signup order if it is not renewed yet, or the last recurring order id (success, pending, or declined order). For prepaid subscription, this is the order id associated with the queried purchase token.
   &quot;lineItems&quot;: [ # Item-level info for a subscription purchase. The items in the same purchase should be either all with AutoRenewingPlan or all with PrepaidPlan.
     { # Item-level info for a subscription purchase.
       &quot;autoRenewingPlan&quot;: { # Information related to an auto renewing plan. # The item is auto renewing.

googleapiclient/discovery_cache/documents/androidpublisher.v3.json

@@ -4146,7 +4146,8 @@
 ]
 },
 "get": {
-"description": "Checks whether a user's subscription purchase is valid and returns its expiry time.",
+"deprecated": true,
+"description": "Deprecated: Use purchases.subscriptionsv2.get instead. Checks whether a user's subscription purchase is valid and returns its expiry time.",
 "flatPath": "androidpublisher/v3/applications/{packageName}/purchases/subscriptions/{subscriptionId}/tokens/{token}",
 "httpMethod": "GET",
 "id": "androidpublisher.purchases.subscriptions.get",
@@ -4184,7 +4185,8 @@
 ]
 },
 "refund": {
-"description": "Refunds a user's subscription purchase, but the subscription remains valid until its expiration time and it will continue to recur.",
+"deprecated": true,
+"description": "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.",
 "flatPath": "androidpublisher/v3/applications/{packageName}/purchases/subscriptions/{subscriptionId}/tokens/{token}:refund",
 "httpMethod": "POST",
 "id": "androidpublisher.purchases.subscriptions.refund",
@@ -4219,7 +4221,8 @@
 ]
 },
 "revoke": {
-"description": "Refunds and immediately revokes a user's subscription purchase. Access to the subscription will be terminated immediately and it will stop recurring.",
+"deprecated": true,
+"description": "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.",
 "flatPath": "androidpublisher/v3/applications/{packageName}/purchases/subscriptions/{subscriptionId}/tokens/{token}:revoke",
 "httpMethod": "POST",
 "id": "androidpublisher.purchases.subscriptions.revoke",
@@ -4793,7 +4796,7 @@
 }
 }
 },
-"revision": "20250519",
+"revision": "20250520",
 "rootUrl": "https://androidpublisher.googleapis.com/",
 "schemas": {
 "Abi": {
@@ -7775,7 +7778,7 @@ false
 "type": "object"
 },
 "Order": {
-"description": "Details of an order.",
+"description": "The Order resource encapsulates comprehensive information about a transaction made on Google Play. It includes a variety of attributes that provide details about the order itself, the products purchased, and the history of events related to the order. The Orders APIs provide real-time access to your order data within the Google Play ecosystem. You can retrieve detailed information and metadata for both one-time and recurring orders, including transaction details like charges, taxes, and refunds, as well as metadata such as pricing phases for subscriptions. The Orders APIs let you automate tasks related to order management, reducing the need for manual checks via the Play Developer Console. The following are some of the use cases for this API: + Real-time order data retrieval - Get order details and metadata immediately after a purchase using an order ID. + Order update synchronization - Periodically sync order updates to maintain an up-to-date record of order information. Note: + The Orders API calls count towards your Play Developer API quota, which defaults to 200K daily, and may be insufficient to sync extensive order histories. + A maximum of 1000 orders can be retrieved per call. Using larger page sizes is recommended to minimize quota usage. Check your quota in the Cloud Console and request more if required.",
 "id": "Order",
 "properties": {
 "buyerAddress": {
@@ -9450,7 +9453,8 @@ false
 "type": "string"
 },
 "latestOrderId": {
-"description": "The order id of the latest order associated with the purchase of the subscription. For autoRenewing subscription, this is the order id of signup order if it is not renewed yet, or the last recurring order id (success, pending, or declined order). For prepaid subscription, this is the order id associated with the queried purchase token.",
+"deprecated": true,
+"description": "Deprecated: Use line_items.latest_successful_order_id instead. The order id of the latest order associated with the purchase of the subscription. For autoRenewing subscription, this is the order id of signup order if it is not renewed yet, or the last recurring order id (success, pending, or declined order). For prepaid subscription, this is the order id associated with the queried purchase token.",
 "type": "string"
 },
 "lineItems": {