@gpc-cli/api 1.0.28 → 1.0.30

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 GPC Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -2,7 +2,7 @@
 
 Typed Google Play Developer API v3 client for TypeScript. Part of [GPC](https://github.com/yasserstudio/gpc).
 
-208 endpoints across edits, releases, tracks, listings, subscriptions, in-app products, purchases, reviews, vitals, reports, users, and testers. Built-in rate limiting, retry logic, and pagination.
+215 endpoints across edits, releases, tracks, listings, subscriptions, in-app products, purchases, reviews, vitals, reports, users, and testers. Built-in rate limiting, retry logic, and pagination.
 
 ## Install
 
@@ -29,18 +29,18 @@ await client.edits.delete("com.example.app", edit.id);
 
 ## Client Factories
 
-| Factory | Purpose |
-| ------- | ------- |
-| `createApiClient(options)` | Core Play API: apps, releases, listings, monetization, purchases |
-| `createReportingClient(options)` | Vitals, crash rates, ANR, error reporting |
-| `createUsersClient(options)` | Developer account users and permission grants |
-| `createHttpClient(options)` | Low-level HTTP with auth, retry, and rate limiting |
+| Factory                          | Purpose                                                          |
+| -------------------------------- | ---------------------------------------------------------------- |
+| `createApiClient(options)`       | Core Play API: apps, releases, listings, monetization, purchases |
+| `createReportingClient(options)` | Vitals, crash rates, ANR, error reporting                        |
+| `createUsersClient(options)`     | Developer account users and permission grants                    |
+| `createHttpClient(options)`      | Low-level HTTP with auth, retry, and rate limiting               |
 
 ```typescript
 const options: ApiClientOptions = {
-  auth,                    // Required: { getAccessToken(): Promise<string> }
-  maxRetries: 3,           // Default retry count
-  timeout: 30_000,         // Request timeout in ms
+  auth, // Required: { getAccessToken(): Promise<string> }
+  maxRetries: 3, // Default retry count
+  timeout: 30_000, // Request timeout in ms
   onRetry: (entry) => console.warn(`Retry #${entry.attempt}`),
 };
 ```
@@ -92,31 +92,31 @@ await client.purchases.acknowledgeProduct("com.example.app", "coins_100", token)
 
 ## All API Modules
 
-| Module | Methods |
-| ------ | ------- |
-| `client.edits` | insert, get, validate, commit, delete |
-| `client.bundles` | upload, list |
-| `client.tracks` | list, get, update |
-| `client.listings` | list, get, update, delete, deleteAll |
-| `client.images` | list, upload, delete, deleteAll |
-| `client.subscriptions` | list, get, create, patch, archive, activate/deactivate base plans and offers |
-| `client.inappproducts` | list, get, create, update, delete, batchGet, batchUpdate, batchDelete |
-| `client.oneTimeProducts` | list, get, create, patch, delete, batchGet, batchUpdate, batchDelete |
-| `client.purchases` | getProduct, acknowledgeProduct, getSubscriptionV2, revokeSubscription, refund, listVoided |
-| `client.reviews` | list, get, reply |
-| `client.testers` | get, update |
-| `client.reports` | list |
-| `client.monetization` | convertRegionPrices |
-| `client.deobfuscation` | upload |
-| `client.expansionFiles` | get, update, patch, upload |
-| `client.dataSafety` | get, update |
-| `client.deviceTiers` | list, get, create |
-| `client.internalSharing` | uploadBundle, uploadApk |
-| `client.generatedApks` | list, download |
-| `client.externalTransactions` | create, get, refund |
-| `client.appRecovery` | create, deploy, cancel, list |
-| `reporting.*` | queryMetricSet, getAnomalies, searchErrorIssues, searchErrorReports |
-| `users.*` | list, get, create, patch, delete, listGrants, createGrant, patchGrant, deleteGrant |
+| Module                        | Methods                                                                                   |
+| ----------------------------- | ----------------------------------------------------------------------------------------- |
+| `client.edits`                | insert, get, validate, commit, delete                                                     |
+| `client.bundles`              | upload, list                                                                              |
+| `client.tracks`               | list, get, update                                                                         |
+| `client.listings`             | list, get, update, delete, deleteAll                                                      |
+| `client.images`               | list, upload, delete, deleteAll                                                           |
+| `client.subscriptions`        | list, get, create, patch, archive, activate/deactivate base plans and offers              |
+| `client.inappproducts`        | list, get, create, update, delete, batchGet, batchUpdate, batchDelete                     |
+| `client.oneTimeProducts`      | list, get, create, patch, delete, batchGet, batchUpdate, batchDelete                      |
+| `client.purchases`            | getProduct, acknowledgeProduct, getSubscriptionV2, revokeSubscription, refund, listVoided |
+| `client.reviews`              | list, get, reply                                                                          |
+| `client.testers`              | get, update                                                                               |
+| `client.reports`              | list                                                                                      |
+| `client.monetization`         | convertRegionPrices                                                                       |
+| `client.deobfuscation`        | upload                                                                                    |
+| `client.expansionFiles`       | get, update, patch, upload                                                                |
+| `client.dataSafety`           | get, update                                                                               |
+| `client.deviceTiers`          | list, get, create                                                                         |
+| `client.internalSharing`      | uploadBundle, uploadApk                                                                   |
+| `client.generatedApks`        | list, download                                                                            |
+| `client.externalTransactions` | create, get, refund                                                                       |
+| `client.appRecovery`          | create, deploy, cancel, list                                                              |
+| `reporting.*`                 | queryMetricSet, getAnomalies, searchErrorIssues, searchErrorReports                       |
+| `users.*`                     | list, get, create, patch, delete, listGrants, createGrant, patchGrant, deleteGrant        |
 
 ## Pagination
 
@@ -146,7 +146,7 @@ try {
   await client.tracks.get("com.example.app", editId, "production");
 } catch (error) {
   if (error instanceof ApiError) {
-    console.error(error.code);       // "API_NOT_FOUND"
+    console.error(error.code); // "API_NOT_FOUND"
     console.error(error.statusCode); // 404
     console.error(error.suggestion); // actionable fix
   }
@@ -159,12 +159,30 @@ All Google Play API types are exported:
 
 ```typescript
 import type {
-  PlayApiClient, ReportingApiClient, UsersApiClient, ApiClientOptions,
-  Track, Release, ReleaseStatus, Bundle, Listing,
-  Subscription, BasePlan, SubscriptionOffer, InAppProduct,
-  Review, ProductPurchase, SubscriptionPurchaseV2, VoidedPurchase,
-  MetricSetQuery, MetricSetResponse, ErrorIssue,
-  User, Grant, ImageType, Money,
+  PlayApiClient,
+  ReportingApiClient,
+  UsersApiClient,
+  ApiClientOptions,
+  Track,
+  Release,
+  ReleaseStatus,
+  Bundle,
+  Listing,
+  Subscription,
+  BasePlan,
+  SubscriptionOffer,
+  InAppProduct,
+  Review,
+  ProductPurchase,
+  SubscriptionPurchaseV2,
+  VoidedPurchase,
+  MetricSetQuery,
+  MetricSetResponse,
+  ErrorIssue,
+  User,
+  Grant,
+  ImageType,
+  Money,
 } from "@gpc-cli/api";
 ```
 

package/dist/index.d.ts

@@ -395,6 +395,27 @@ interface BasePlanMigratePricesRequest {
     };
     latencyTolerance?: ProductUpdateLatencyTolerance;
 }
+interface BatchMigratePricesRequest {
+    requests: {
+        packageName: string;
+        productId: string;
+        basePlanId: string;
+        regionalPriceMigrations: {
+            regionCode: string;
+            oldestAllowedPriceVersionTime?: string;
+            priceIncreaseType?: string;
+        }[];
+        regionsVersion?: {
+            version?: string;
+        };
+        latencyTolerance?: ProductUpdateLatencyTolerance;
+    }[];
+}
+interface BatchMigratePricesResponse {
+    responses: {
+        subscription?: Subscription;
+    }[];
+}
 interface SubscriptionOfferPhase {
     recurrenceCount: number;
     duration: string;
@@ -458,8 +479,6 @@ interface SubscriptionPurchaseV2 {
     subscriptionState: string;
     acknowledgementState?: string;
     linkedPurchaseToken?: string;
-    /** Current offer phase: free trial, introductory price, proration, or base plan price. (Jan 2026) */
-    offerPhase?: string;
     /** Resubscription context when purchase originates from Play Store. (Nov 2025) */
     outOfAppPurchaseContext?: {
         externalTransactionToken?: string;
@@ -529,8 +548,13 @@ interface SubscriptionPurchaseLineItem {
             offerId?: string;
         };
     };
-    /** Current offer phase identifier. (Jan 2026) */
-    offerPhase?: string;
+    /** Current offer phase (union field — exactly one set). (Jan 2026) */
+    offerPhase?: {
+        basePrice?: Record<string, unknown>;
+        freeTrial?: Record<string, unknown>;
+        introductoryPrice?: Record<string, unknown>;
+        proratedPeriod?: Record<string, unknown>;
+    };
 }
 interface SubscriptionPurchase {
     startTimeMillis: string;
@@ -638,9 +662,39 @@ interface ProductPurchaseLineItem {
         offerTags?: string[];
     };
 }
+/**
+ * Request body for purchases.subscriptions.acknowledge.
+ * externalAccountId is used to associate a resubscription purchase with a
+ * user identifier. (Nov 2025)
+ */
+interface AcknowledgeSubscriptionRequest {
+    developerPayload?: string;
+    externalAccountId?: string;
+}
 interface SubscriptionsV2CancelRequest {
     cancellationType?: string;
 }
+/**
+ * Request body for purchases.subscriptionsv2.revoke.
+ * revocationContext is a union — exactly one of fullRefund, proratedRefund,
+ * or itemBasedRefund should be set. itemBasedRefund targets a single add-on
+ * product by productId. (May 2025)
+ */
+interface RevokeSubscriptionV2Request {
+    revocationContext?: {
+        fullRefund?: Record<string, never>;
+        proratedRefund?: Record<string, never>;
+        itemBasedRefund?: {
+            productId: string;
+        };
+    };
+}
+/**
+ * Request body for purchases.subscriptionsv2.defer.
+ * For subscriptions with add-ons, the billing date of all line items is
+ * deferred together server-side — no per-line-item field is required in
+ * the request. (Jan 2026)
+ */
 interface SubscriptionsV2DeferRequest {
     deferralInfo: {
         desiredExpiryTime: string;
@@ -888,14 +942,26 @@ interface TaxAndComplianceSettings {
 interface OneTimeOffer {
     packageName: string;
     productId: string;
+    purchaseOptionId: string;
     offerId: string;
-    regionalConfigs: Record<string, OneTimeOfferRegionalConfig>;
+    state?: "DRAFT" | "ACTIVE" | "CANCELLED" | "INACTIVE";
+    regionalPricingAndAvailabilityConfigs?: Record<string, OneTimeOfferRegionalConfig>;
+    /** @deprecated Use regionalPricingAndAvailabilityConfigs instead */
+    regionalConfigs?: Record<string, OneTimeOfferRegionalConfig>;
     otherRegionsConfig?: {
         usdPrice: {
             units: string;
             nanos?: number;
         };
     };
+    offerTags?: Array<{
+        tag: string;
+    }>;
+    regionsVersion?: {
+        version: string;
+    };
+    preOrderOffer?: Record<string, unknown>;
+    discountedOffer?: Record<string, unknown>;
 }
 interface OneTimeOfferRegionalConfig {
     price: {
@@ -910,25 +976,25 @@ interface OneTimeProductsListResponse {
     nextPageToken?: string;
 }
 interface OneTimeOffersListResponse {
-    oneTimeOffers: OneTimeOffer[];
+    oneTimeProductOffers?: OneTimeOffer[];
+    /** @deprecated Use oneTimeProductOffers */
+    oneTimeOffers?: OneTimeOffer[];
     nextPageToken?: string;
 }
-interface PurchaseOption {
-    packageName: string;
-    productId: string;
-    purchaseOptionId: string;
-    stateInfo?: {
-        activeState?: Record<string, unknown>;
-        inactiveState?: Record<string, unknown>;
-    };
-    listings?: Record<string, {
-        title: string;
-        description?: string;
-    }>;
+interface SystemApkDeviceSpec {
+    supportedAbis?: string[];
+    supportedLocales?: string[];
+    screenDensity?: number;
 }
-interface PurchaseOptionsListResponse {
-    purchaseOptions: PurchaseOption[];
-    nextPageToken?: string;
+interface SystemApkOptions {
+    uncompressedNativeLibraries?: boolean;
+    uncompressedDexFiles?: boolean;
+    rotated?: boolean;
+}
+interface SystemApkVariant {
+    variantId?: number;
+    deviceSpec?: SystemApkDeviceSpec;
+    options?: SystemApkOptions;
 }
 interface InAppProductsBatchUpdateRequest {
     requests: {
@@ -972,7 +1038,7 @@ interface ReleaseSummary {
     activeArtifacts?: {
         versionCode: number;
     }[];
-    releaseLifecycleState?: 'RELEASE_LIFECYCLE_STATE_UNSPECIFIED' | 'DRAFT' | 'NOT_SENT_FOR_REVIEW' | 'IN_REVIEW' | 'APPROVED_NOT_PUBLISHED' | 'NOT_APPROVED' | 'PUBLISHED';
+    releaseLifecycleState?: "RELEASE_LIFECYCLE_STATE_UNSPECIFIED" | "DRAFT" | "NOT_SENT_FOR_REVIEW" | "IN_REVIEW" | "APPROVED_NOT_PUBLISHED" | "NOT_APPROVED" | "PUBLISHED";
 }
 interface ReleasesListResponse {
     releases: ReleaseSummary[];
@@ -1085,6 +1151,7 @@ interface PlayApiClient {
         deactivateBasePlan(packageName: string, productId: string, basePlanId: string): Promise<Subscription>;
         deleteBasePlan(packageName: string, productId: string, basePlanId: string): Promise<void>;
         migratePrices(packageName: string, productId: string, basePlanId: string, body: BasePlanMigratePricesRequest): Promise<Subscription>;
+        batchMigratePrices(packageName: string, productId: string, body: BatchMigratePricesRequest): Promise<BatchMigratePricesResponse>;
         listOffers(packageName: string, productId: string, basePlanId: string): Promise<OffersListResponse>;
         getOffer(packageName: string, productId: string, basePlanId: string, offerId: string): Promise<SubscriptionOffer>;
         createOffer(packageName: string, productId: string, basePlanId: string, data: SubscriptionOffer, offerId?: string, regionsVersion?: string): Promise<SubscriptionOffer>;
@@ -1138,6 +1205,10 @@ interface PlayApiClient {
             autoConvertMissingPrices?: boolean;
             allowMissing?: boolean;
         }): Promise<InAppProduct>;
+        patch(packageName: string, sku: string, data: Partial<InAppProduct>, options?: {
+            autoConvertMissingPrices?: boolean;
+            latencyTolerance?: string;
+        }): Promise<InAppProduct>;
         delete(packageName: string, sku: string): Promise<void>;
         batchUpdate(packageName: string, requests: InAppProductsBatchUpdateRequest): Promise<InAppProductsBatchUpdateResponse>;
         batchGet(packageName: string, skus: string[]): Promise<InAppProduct[]>;
@@ -1153,11 +1224,8 @@ interface PlayApiClient {
         getSubscriptionV1(packageName: string, subscriptionId: string, token: string): Promise<SubscriptionPurchase>;
         cancelSubscription(packageName: string, subscriptionId: string, token: string): Promise<void>;
         deferSubscription(packageName: string, subscriptionId: string, token: string, body: SubscriptionDeferRequest): Promise<SubscriptionDeferResponse>;
-        acknowledgeSubscription(packageName: string, subscriptionId: string, token: string, body?: {
-            developerPayload?: string;
-        }): Promise<void>;
-        revokeSubscriptionV2(packageName: string, token: string): Promise<void>;
-        refundSubscriptionV2(packageName: string, token: string): Promise<void>;
+        acknowledgeSubscription(packageName: string, subscriptionId: string, token: string, body?: AcknowledgeSubscriptionRequest): Promise<void>;
+        revokeSubscriptionV2(packageName: string, token: string, body?: RevokeSubscriptionV2Request): Promise<void>;
         /** V2 cancel with cancellationType support. (Sep 2025) */
         cancelSubscriptionV2(packageName: string, token: string, body?: SubscriptionsV2CancelRequest): Promise<void>;
         /** V2 defer for subscriptions with add-ons. (Jan 2026) */
@@ -1191,6 +1259,7 @@ interface PlayApiClient {
     testers: {
         get(packageName: string, editId: string, track: string): Promise<Testers>;
         update(packageName: string, editId: string, track: string, testers: Testers): Promise<Testers>;
+        patch(packageName: string, editId: string, track: string, testers: Partial<Testers>): Promise<Testers>;
     };
     deobfuscation: {
         upload(packageName: string, editId: string, versionCode: number, filePath: string, fileType?: DeobfuscationFileType): Promise<DeobfuscationFile>;
@@ -1221,11 +1290,11 @@ interface PlayApiClient {
         create(packageName: string, product: OneTimeProduct, regionsVersion?: string): Promise<OneTimeProduct>;
         update(packageName: string, productId: string, product: Partial<OneTimeProduct>, updateMask?: string, regionsVersion?: string, options?: MutationOptions): Promise<OneTimeProduct>;
         delete(packageName: string, productId: string): Promise<void>;
-        listOffers(packageName: string, productId: string): Promise<OneTimeOffersListResponse>;
-        getOffer(packageName: string, productId: string, offerId: string): Promise<OneTimeOffer>;
-        createOffer(packageName: string, productId: string, offer: OneTimeOffer, regionsVersion?: string): Promise<OneTimeOffer>;
-        updateOffer(packageName: string, productId: string, offerId: string, offer: Partial<OneTimeOffer>, updateMask?: string, regionsVersion?: string, options?: MutationOptions): Promise<OneTimeOffer>;
-        deleteOffer(packageName: string, productId: string, offerId: string): Promise<void>;
+        listOffers(packageName: string, productId: string, purchaseOptionId?: string): Promise<OneTimeOffersListResponse>;
+        getOffer(packageName: string, productId: string, purchaseOptionId: string, offerId: string): Promise<OneTimeOffer>;
+        createOffer(packageName: string, productId: string, purchaseOptionId: string, offer: OneTimeOffer, regionsVersion?: string): Promise<OneTimeOffer>;
+        updateOffer(packageName: string, productId: string, purchaseOptionId: string, offerId: string, offer: Partial<OneTimeOffer>, updateMask?: string, regionsVersion?: string, options?: MutationOptions): Promise<OneTimeOffer>;
+        deleteOffer(packageName: string, productId: string, purchaseOptionId: string, offerId: string): Promise<void>;
         batchGet(packageName: string, productIds: string[]): Promise<OneTimeProduct[]>;
         batchUpdate(packageName: string, requests: {
             requests: Array<{
@@ -1237,13 +1306,63 @@ interface PlayApiClient {
             oneTimeProducts: OneTimeProduct[];
         }>;
         batchDelete(packageName: string, productIds: string[]): Promise<void>;
-    };
-    purchaseOptions: {
-        list(packageName: string): Promise<PurchaseOptionsListResponse>;
-        get(packageName: string, purchaseOptionId: string): Promise<PurchaseOption>;
-        create(packageName: string, data: PurchaseOption): Promise<PurchaseOption>;
-        activate(packageName: string, purchaseOptionId: string): Promise<PurchaseOption>;
-        deactivate(packageName: string, purchaseOptionId: string): Promise<PurchaseOption>;
+        batchDeletePurchaseOptions(packageName: string, productId: string, requests: Array<{
+            packageName: string;
+            productId: string;
+            purchaseOptionId: string;
+            force?: boolean;
+            latencyTolerance?: string;
+        }>): Promise<void>;
+        batchUpdatePurchaseOptionStates(packageName: string, productId: string, requests: Array<{
+            activatePurchaseOptionRequest?: {
+                packageName: string;
+                productId: string;
+                purchaseOptionId: string;
+                latencyTolerance?: string;
+            };
+            deactivatePurchaseOptionRequest?: {
+                packageName: string;
+                productId: string;
+                purchaseOptionId: string;
+                latencyTolerance?: string;
+            };
+        }>): Promise<{
+            oneTimeProducts: OneTimeProduct[];
+        }>;
+        cancelOffer(packageName: string, productId: string, purchaseOptionId: string, offerId: string, latencyTolerance?: string): Promise<OneTimeOffer>;
+        batchGetOffers(packageName: string, productId: string, purchaseOptionId: string, requests: Array<{
+            packageName: string;
+            productId: string;
+            purchaseOptionId: string;
+            offerId: string;
+        }>): Promise<{
+            oneTimeProductOffers: OneTimeOffer[];
+        }>;
+        batchUpdateOffers(packageName: string, productId: string, purchaseOptionId: string, requests: Array<{
+            oneTimeProductOffer: Partial<OneTimeOffer>;
+            updateMask?: string;
+            regionsVersion?: {
+                version: string;
+            };
+            allowMissing?: boolean;
+            latencyTolerance?: string;
+        }>): Promise<{
+            oneTimeProductOffers: OneTimeOffer[];
+        }>;
+        batchUpdateOfferStates(packageName: string, productId: string, purchaseOptionId: string, requests: Array<{
+            activateOneTimeProductOfferRequest?: Record<string, unknown>;
+            deactivateOneTimeProductOfferRequest?: Record<string, unknown>;
+            cancelOneTimeProductOfferRequest?: Record<string, unknown>;
+        }>): Promise<{
+            oneTimeProductOffers: OneTimeOffer[];
+        }>;
+        batchDeleteOffers(packageName: string, productId: string, purchaseOptionId: string, requests: Array<{
+            packageName: string;
+            productId: string;
+            purchaseOptionId: string;
+            offerId: string;
+            latencyTolerance?: string;
+        }>): Promise<void>;
     };
     internalAppSharing: {
         uploadBundle(packageName: string, bundlePath: string): Promise<InternalAppSharingArtifact>;
@@ -1253,6 +1372,14 @@ interface PlayApiClient {
         list(packageName: string, versionCode: number): Promise<GeneratedApk[]>;
         download(packageName: string, versionCode: number, id: string): Promise<ArrayBuffer>;
     };
+    systemApks: {
+        create(packageName: string, versionCode: number, variant: SystemApkVariant): Promise<SystemApkVariant>;
+        list(packageName: string, versionCode: number): Promise<{
+            variants: SystemApkVariant[];
+        }>;
+        get(packageName: string, versionCode: number, variantId: number): Promise<SystemApkVariant>;
+        download(packageName: string, versionCode: number, variantId: number): Promise<ArrayBuffer>;
+    };
 }
 declare function createApiClient(options: ApiClientOptions): PlayApiClient;
 
@@ -1273,11 +1400,11 @@ interface UsersApiClient {
         pageToken?: string;
         pageSize?: number;
     }): Promise<UsersListResponse>;
-    get(developerId: string, userId: string): Promise<User>;
     create(developerId: string, user: Partial<User>): Promise<User>;
     update(developerId: string, userId: string, user: Partial<User>, updateMask?: string): Promise<User>;
     delete(developerId: string, userId: string): Promise<void>;
     grants: {
+        /** Not in official API reference but may work as an undocumented endpoint. */
         list(developerId: string, email: string): Promise<GrantsListResponse>;
         create(developerId: string, email: string, grant: Partial<Grant>): Promise<Grant>;
         patch(developerId: string, email: string, packageName: string, grant: Partial<Grant>, updateMask?: string): Promise<Grant>;
@@ -1429,4 +1556,4 @@ declare class PlayApiError extends Error {
 /** Files below this threshold use simple upload instead. */
 declare const RESUMABLE_THRESHOLD: number;
 
-export { type Achievement, type Anomaly, type AnomalyDetectionResponse, type ApiClientOptions, type ApiResponse, type ApkInfo, type ApksListResponse, type AppDetails, type AppEdit, type AppRecoveriesListResponse, type AppRecoveryAction, type AppRecoveryTargeting, type BasePlan, type BasePlanMigratePricesRequest, type BatchGetOrdersResponse, type Bundle, type BundleListResponse, type ChangesInReviewBehavior, type ConvertRegionPricesRequest, type ConvertRegionPricesResponse, type ConvertedRegionPrice, type CountryAvailability, type CreateAppRecoveryActionRequest, type CustomApp, type CustomAppsListResponse, type DataSafety, type DataSafetyDataType, type DataSafetyPurpose, type DeobfuscationFile, type DeobfuscationFileType, type DeobfuscationUploadResponse, type DeveloperComment, type DeveloperPermission, type DeviceGroup, type DeviceSelector, type DeviceTier, type DeviceTierConfig, type DeviceTierConfigsListResponse, type EditCommitOptions, type EnterpriseApiClient, type ErrorIssue, type ErrorIssuesResponse, type ErrorReport, type ErrorReportsResponse, type ExpansionFile, type ExpansionFileType, type ExternalTransaction, type ExternalTransactionAmount, type ExternalTransactionRefund, type ExternallyHostedApk, type ExternallyHostedApkResponse, type GameEvent, type GamesApiClient, type GeneratedApk, type GeneratedApksPerVersion, type Grant, type GrantsListResponse, type HttpClient, type Image, type ImageType, type ImageUploadResponse, type ImagesDeleteAllResponse, type ImagesListResponse, type InAppProduct, type InAppProductListing, type InAppProductsBatchDeleteRequest, type InAppProductsBatchGetRequest, type InAppProductsBatchUpdateRequest, type InAppProductsBatchUpdateResponse, type InAppProductsListResponse, type InternalAppSharingArtifact, type Leaderboard, type LeaderboardScore, type Listing, type ListingsListResponse, type MetricRow, type MetricSetQuery, type MetricSetResponse, type Money, type MutationOptions, type OffersListResponse, type OneTimeOffer, type OneTimeOfferRegionalConfig, type OneTimeOffersListResponse, type OneTimeProduct, type OneTimeProductListing, type OneTimeProductsListResponse, type Order, type OrderLineItem, type PagedResponse, type PaginateOptions, type PlayApiClient, PlayApiError, type ProductPurchase, type ProductPurchaseLineItem, type ProductPurchaseV2, type ProductUpdateLatencyTolerance, type PurchaseOption, type PurchaseOptionsListResponse, RATE_LIMIT_BUCKETS, RESUMABLE_THRESHOLD, type RateLimitBucket, type RateLimiter, type RegionalBasePlanConfig, type Release, type ReleaseNote, type ReleaseStatus, type ReleaseSummary, type ReleasesListResponse, type ReportBucket, type ReportType, type ReportingAggregation, type ReportingApiClient, type ReportingDimension, type ReportsListResponse, type ResumableUploadOptions, type RetryLogEntry, type Review, type ReviewComment, type ReviewReplyRequest, type ReviewReplyResponse, type ReviewsListOptions, type ReviewsListResponse, type StatsDimension, type Subscription, type SubscriptionDeferRequest, type SubscriptionDeferResponse, type SubscriptionListing, type SubscriptionOffer, type SubscriptionOfferPhase, type SubscriptionPurchase, type SubscriptionPurchaseLineItem, type SubscriptionPurchaseV2, type SubscriptionsBatchGetRequest, type SubscriptionsBatchGetResponse, type SubscriptionsBatchUpdateRequest, type SubscriptionsBatchUpdateResponse, type SubscriptionsListResponse, type SubscriptionsV2CancelRequest, type SubscriptionsV2DeferRequest, type SubscriptionsV2DeferResponse, type TaxAndComplianceSettings, type Testers, type TokenPagination, type Track, type TrackListResponse, type UploadProgressEvent, type UploadResponse, type User, type UserComment, type UsersApiClient, type UsersListResponse, type VitalsMetricSet, type VoidedPurchase, type VoidedPurchasesListResponse, createApiClient, createEnterpriseClient, createGamesClient, createHttpClient, createRateLimiter, createReportingClient, createUsersClient, paginate, paginateAll, paginateParallel, resolveBucket };
+export { type Achievement, type AcknowledgeSubscriptionRequest, type Anomaly, type AnomalyDetectionResponse, type ApiClientOptions, type ApiResponse, type ApkInfo, type ApksListResponse, type AppDetails, type AppEdit, type AppRecoveriesListResponse, type AppRecoveryAction, type AppRecoveryTargeting, type BasePlan, type BasePlanMigratePricesRequest, type BatchGetOrdersResponse, type BatchMigratePricesRequest, type BatchMigratePricesResponse, type Bundle, type BundleListResponse, type ChangesInReviewBehavior, type ConvertRegionPricesRequest, type ConvertRegionPricesResponse, type ConvertedRegionPrice, type CountryAvailability, type CreateAppRecoveryActionRequest, type CustomApp, type CustomAppsListResponse, type DataSafety, type DataSafetyDataType, type DataSafetyPurpose, type DeobfuscationFile, type DeobfuscationFileType, type DeobfuscationUploadResponse, type DeveloperComment, type DeveloperPermission, type DeviceGroup, type DeviceSelector, type DeviceTier, type DeviceTierConfig, type DeviceTierConfigsListResponse, type EditCommitOptions, type EnterpriseApiClient, type ErrorIssue, type ErrorIssuesResponse, type ErrorReport, type ErrorReportsResponse, type ExpansionFile, type ExpansionFileType, type ExternalTransaction, type ExternalTransactionAmount, type ExternalTransactionRefund, type ExternallyHostedApk, type ExternallyHostedApkResponse, type GameEvent, type GamesApiClient, type GeneratedApk, type GeneratedApksPerVersion, type Grant, type GrantsListResponse, type HttpClient, type Image, type ImageType, type ImageUploadResponse, type ImagesDeleteAllResponse, type ImagesListResponse, type InAppProduct, type InAppProductListing, type InAppProductsBatchDeleteRequest, type InAppProductsBatchGetRequest, type InAppProductsBatchUpdateRequest, type InAppProductsBatchUpdateResponse, type InAppProductsListResponse, type InternalAppSharingArtifact, type Leaderboard, type LeaderboardScore, type Listing, type ListingsListResponse, type MetricRow, type MetricSetQuery, type MetricSetResponse, type Money, type MutationOptions, type OffersListResponse, type OneTimeOffer, type OneTimeOfferRegionalConfig, type OneTimeOffersListResponse, type OneTimeProduct, type OneTimeProductListing, type OneTimeProductsListResponse, type Order, type OrderLineItem, type PagedResponse, type PaginateOptions, type PlayApiClient, PlayApiError, type ProductPurchase, type ProductPurchaseLineItem, type ProductPurchaseV2, type ProductUpdateLatencyTolerance, RATE_LIMIT_BUCKETS, RESUMABLE_THRESHOLD, type RateLimitBucket, type RateLimiter, type RegionalBasePlanConfig, type Release, type ReleaseNote, type ReleaseStatus, type ReleaseSummary, type ReleasesListResponse, type ReportBucket, type ReportType, type ReportingAggregation, type ReportingApiClient, type ReportingDimension, type ReportsListResponse, type ResumableUploadOptions, type RetryLogEntry, type Review, type ReviewComment, type ReviewReplyRequest, type ReviewReplyResponse, type ReviewsListOptions, type ReviewsListResponse, type RevokeSubscriptionV2Request, type StatsDimension, type Subscription, type SubscriptionDeferRequest, type SubscriptionDeferResponse, type SubscriptionListing, type SubscriptionOffer, type SubscriptionOfferPhase, type SubscriptionPurchase, type SubscriptionPurchaseLineItem, type SubscriptionPurchaseV2, type SubscriptionsBatchGetRequest, type SubscriptionsBatchGetResponse, type SubscriptionsBatchUpdateRequest, type SubscriptionsBatchUpdateResponse, type SubscriptionsListResponse, type SubscriptionsV2CancelRequest, type SubscriptionsV2DeferRequest, type SubscriptionsV2DeferResponse, type SystemApkDeviceSpec, type SystemApkOptions, type SystemApkVariant, type TaxAndComplianceSettings, type Testers, type TokenPagination, type Track, type TrackListResponse, type UploadProgressEvent, type UploadResponse, type User, type UserComment, type UsersApiClient, type UsersListResponse, type VitalsMetricSet, type VoidedPurchase, type VoidedPurchasesListResponse, createApiClient, createEnterpriseClient, createGamesClient, createHttpClient, createRateLimiter, createReportingClient, createUsersClient, paginate, paginateAll, paginateParallel, resolveBucket };