@maxim_mazurok/gapi.client.cloudbilling-v1beta 0.0.20220914

package/index.d.ts

@@ -0,0 +1,449 @@
+/* Type definitions for non-npm package Cloud Billing API v1beta 0.0 */
+// Project: https://cloud.google.com/billing/
+// Definitions by: Maxim Mazurok <https://github.com/Maxim-Mazurok>
+//                 Nick Amoscato <https://github.com/namoscato>
+//                 Declan Vong <https://github.com/declanvong>
+// Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
+
+// IMPORTANT
+// This file was generated by https://github.com/Maxim-Mazurok/google-api-typings-generator. Please do not edit it manually.
+// In case of any problems please post issue to https://github.com/Maxim-Mazurok/google-api-typings-generator
+// Generated from: https://cloudbilling.googleapis.com/$discovery/rest?version=v1beta
+// Revision: 20220914
+
+/// <reference types="gapi.client" />
+
+declare namespace gapi.client {
+    /** Load Cloud Billing API v1beta */
+    function load(urlOrObject: "https://cloudbilling.googleapis.com/$discovery/rest?version=v1beta"): Promise<void>;
+    /** @deprecated Please load APIs with discovery documents. */
+    function load(name: "cloudbilling", version: "v1beta"): Promise<void>;
+    /** @deprecated Please load APIs with discovery documents. */
+    function load(name: "cloudbilling", version: "v1beta", callback: () => any): void;
+
+    namespace cloudbilling {
+        interface CloudStorageWorkload {
+            /** Data retrieval usage. A retrieval cost applies when data or metadata is read, copied, or rewritten . For example: units such as "GiBy/s" or "By/s". */
+            dataRetrieval?: Usage;
+            /** Data storage usage. The amount of data stored in buckets. For example: units such as "GiBy/s" or "TBy/mo". */
+            dataStored?: Usage;
+            /** Specify dual regions. */
+            dualRegion?: DualRegional;
+            /** Specify multi regions. */
+            multiRegion?: MultiRegional;
+            /**
+             * Class A operation usage in Cloud Storage, such as listing the objects in buckets. See the [operations pricing](https://cloud.google.com/storage/pricing#operations-pricing) tables
+             * for a list of which operations fall into each class. For example: units such as "1/s".
+             */
+            operationA?: Usage;
+            /**
+             * Class B operation usage in Cloud Storage, such as `getIamPolicy`. See the [operations pricing](https://cloud.google.com/storage/pricing#operations-pricing) tables for a list of
+             * which operations fall into each class. For example: units such as "1/s".
+             */
+            operationB?: Usage;
+            /** Specify a single region. */
+            region?: Regional;
+            /** The [storage class](https://cloud.google.com/storage/docs/storage-classes#classes) of the data and operation. For example: "standard" or "nearline". */
+            storageClass?: string;
+        }
+        interface Commitment {
+            /** Required. A name for this commitment. All commitments in a CostScenario must have unique names. Each name must be a maximum of 32 characters. */
+            name?: string;
+            /** A resource-based committed use discount (CUD). */
+            vmResourceBasedCud?: VmResourceBasedCud;
+        }
+        interface CommitmentCostEstimate {
+            /** Total estimated costs for the commitment. */
+            commitmentTotalCostEstimate?: CostEstimate;
+            /** The name of the commitment, as specified in the `CostScenario`. */
+            name?: string;
+            /** Estimated costs for each SKU in the commitment. */
+            skuCostEstimates?: SkuCostEstimate[];
+        }
+        interface ComputeVmWorkload {
+            /** Defines whether each instance has confidential compute enabled. */
+            enableConfidentialCompute?: boolean;
+            /** Guest accelerators attached to each machine. */
+            guestAccelerator?: GuestAccelerator;
+            /** VM usage. This is specified as a unitless quantity which indicates the number of instances running. */
+            instancesRunning?: Usage;
+            /** Premium image licenses used by each instance. */
+            licenses?: string[];
+            /** The machine type. */
+            machineType?: MachineType;
+            /** Persistent disks attached to each instance. Must include a boot disk. */
+            persistentDisks?: PersistentDisk[];
+            /** Defines whether each instance is preemptible. */
+            preemptible?: boolean;
+            /** The [region](https://cloud.google.com/compute/docs/regions-zones) where the VMs run. For example: "us-central1". */
+            region?: string;
+        }
+        interface CostEstimate {
+            /** The estimated credits applied. */
+            creditEstimates?: CreditEstimate[];
+            /** The estimated net cost after applying credits. */
+            netCostEstimate?: Money;
+            /** The estimated cost prior to applying credits. */
+            preCreditCostEstimate?: Money;
+        }
+        interface CostEstimationResult {
+            /** Required. The ISO 4217 currency code for the cost estimate. */
+            currencyCode?: string;
+            /** Required. Estimated costs for each idealized month of a `CostScenario`. */
+            segmentCostEstimates?: SegmentCostEstimate[];
+            /** Required. Information about SKUs used in the estimate. */
+            skus?: Sku[];
+        }
+        interface CostScenario {
+            /**
+             * New commitments to estimate the costs for. The cost of the commitments will be included in the estimate result and discounts the commitment entitles will be included in the workload
+             * cost estimates. A maximum of 100 workloads can be provided.
+             */
+            commitments?: Commitment[];
+            /** Configuration for the scenario. */
+            scenarioConfig?: ScenarioConfig;
+            /** The Google Cloud usage whose costs are estimated. A maximum of 100 workloads can be provided. */
+            workloads?: Workload[];
+        }
+        interface CreditEstimate {
+            /** The estimated credit amount. */
+            creditAmount?: Money;
+            /** The credit description. */
+            creditDescription?: string;
+            /** The credit type. */
+            creditType?: string;
+        }
+        interface CustomMachineType {
+            /**
+             * Required. The machine series. Only certain [machine series](https://cloud.google.com/compute/docs/general-purpose-machines#custom_machine_types) support custom configurations. For
+             * example: "n1".
+             */
+            machineSeries?: string;
+            /**
+             * Required. Memory size of the VM in GB (2^30 bytes). Must be an increment of 0.25 (256 MB). Each [machine
+             * series](https://cloud.google.com/compute/docs/machine-types#machine_type_comparison) has limitations on allowed values for the ratio of memory-to-vCPU count.
+             */
+            memorySizeGb?: number;
+            /** Required. The number of vCPUs. The allowed values depend on the [machine series](https://cloud.google.com/compute/docs/machine-types#machine_type_comparison). */
+            virtualCpuCount?: string;
+        }
+        interface DualRegional {
+            /** The [location name](https://cloud.google.com/storage/docs/locations#available-locations) where the data is stored. For example: "asia1" for dual region. */
+            name?: string;
+        }
+        interface EstimateCostScenarioForBillingAccountRequest {
+            /** The scenario to estimate costs for. */
+            costScenario?: CostScenario;
+        }
+        interface EstimateCostScenarioForBillingAccountResponse {
+            /** The result of the cost estimation. */
+            costEstimationResult?: CostEstimationResult;
+        }
+        interface EstimateCostScenarioWithListPriceRequest {
+            /** The scenario to estimate costs for. */
+            costScenario?: CostScenario;
+        }
+        interface EstimateCostScenarioWithListPriceResponse {
+            /** The result of the cost estimation. */
+            costEstimationResult?: CostEstimationResult;
+        }
+        interface EstimationTimePoint {
+            /** The point in time, relative to the start of the time frame covered by the cost estimate. */
+            estimationTimeFrameOffset?: string;
+        }
+        interface GuestAccelerator {
+            /** The number of the guest accelerator cards exposed to each instance. */
+            acceleratorCount?: string;
+            /** The type of the guest accelerator cards. For example: "nvidia-tesla-t4". */
+            acceleratorType?: string;
+        }
+        interface MachineType {
+            customMachineType?: CustomMachineType;
+            predefinedMachineType?: PredefinedMachineType;
+        }
+        interface Money {
+            /** The three-letter currency code defined in ISO 4217. */
+            currencyCode?: string;
+            /**
+             * Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units`
+             * is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example $-1.75 is represented as `units`=-1 and
+             * `nanos`=-750,000,000.
+             */
+            nanos?: number;
+            /** The whole units of the amount. For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar. */
+            units?: string;
+        }
+        interface MultiRegional {
+            /** The [location name](https://cloud.google.com/storage/docs/locations#available-locations) where the data is stored. For example: "us" for multi-region. */
+            name?: string;
+        }
+        interface PersistentDisk {
+            /** Specifies the size of disk. Must be at least 10 GB. */
+            diskSize?: Usage;
+            /** The [disk type](https://cloud.google.com/compute/docs/disks#disk-types). For example: "pd-standard". */
+            diskType?: string;
+            /**
+             * Indicates how many IOPS to provision for the disk for extreme persistent disks. This sets the number of I/O operations per second that the disk can handle. Values must be between
+             * 10,000 and 120,000.
+             */
+            provisionedIops?: Usage;
+            /** The geographic scope of the disk. Defaults to `SCOPE_ZONAL` if not specified. */
+            scope?: string;
+        }
+        interface PredefinedMachineType {
+            /** The [machine type](https://cloud.google.com/compute/docs/machine-types). For example: "n1-standard1". */
+            machineType?: string;
+        }
+        interface Price {
+            /** The timestamp within the estimation time frame when the price was set. */
+            effectiveTime?: EstimationTimePoint;
+            /** The type of price. Possible values: "RATE" */
+            priceType?: string;
+            /** A set of tiered rates. */
+            rate?: Rate;
+        }
+        interface Rate {
+            /** The service tiers. */
+            tiers?: RateTier[];
+            /** The SKU's pricing unit. For example, if the tier price is $1 per 1000000 Bytes, then this field will show 'By'. The `start_amount` field in each tier will be in this unit. */
+            unit?: string;
+            /** The SKU's count for the pricing unit. For example, if the tier price is $1 per 1000000 Bytes, then this column will show 1000000. */
+            unitCount?: number;
+        }
+        interface RateTier {
+            /** The price for this tier. */
+            price?: Money;
+            /** The magnitude of usage in which the tier interval begins. Example: "From 100 GiBi the price is $1 per byte" implies `start_amount` = 100 */
+            startAmount?: number;
+        }
+        interface Regional {
+            /** The [location name](https://cloud.google.com/storage/docs/locations#available-locations). For example: "us-central1" for region. */
+            name?: string;
+        }
+        interface ScenarioConfig {
+            /**
+             * Time frame for the estimate. Workloads must specify usage for this duration. Duration must be at least 1 hour (3,600 seconds) and at most 10 years (315,360,000 seconds). The
+             * calculations for years and months are based on a 730-hour (2,628,000-second) month.
+             */
+            estimateDuration?: string;
+        }
+        interface SegmentCostEstimate {
+            /** Estimated costs for each commitment. */
+            commitmentCostEstimates?: CommitmentCostEstimate[];
+            /** Timestamp for the start of the segment. */
+            segmentStartTime?: EstimationTimePoint;
+            /** Total estimated costs for the time segment. */
+            segmentTotalCostEstimate?: CostEstimate;
+            /** Estimated costs for each workload. */
+            workloadCostEstimates?: WorkloadCostEstimate[];
+        }
+        interface Sku {
+            /** The display name for the SKU. Example: A2 Instance Core running in Americas */
+            displayName?: string;
+            /**
+             * A timeline of prices for a SKU in chronological order. Note: The API currently only supports using a constant price for the entire estimation time frame so this list will contain a
+             * single value.
+             */
+            prices?: Price[];
+            /** The resource name for the SKU. Example: "services/DA34-426B-A397/skus/AA95-CD31-42FE" */
+            sku?: string;
+        }
+        interface SkuCostEstimate {
+            /** The estimated cost for the usage on this SKU. */
+            costEstimate?: CostEstimate;
+            /** The resource name for the SKU. Example: "services/DA34-426B-A397/skus/AA95-CD31-42FE" More information about the SKU can be found in the `skus` field of the `CostEstimationResult`. */
+            sku?: string;
+            /** The amount of usage on this SKU. */
+            usageAmount?: number;
+            /** The unit for the usage on this SKU. */
+            usageUnit?: string;
+        }
+        interface Usage {
+            /** A timeline of usage rates over the estimate interval. */
+            usageRateTimeline?: UsageRateTimeline;
+        }
+        interface UsageRateTimeline {
+            /**
+             * The unit for the usage rate in each timeline entry. The supported units are a subset of [The Unified Code for Units of Measure](https://ucum.org/ucum.html) standard: * **Time units
+             * (TIME-UNIT)** * `s` second * `min` minute * `h` hour * `d` day * `wk` week * `mo` month * `yr` year * `ms` millisecond * `us` microsecond * `ns` nanosecond * **Basic storage units
+             * (BASIC-STORAGE-UNIT)** * `bit` bit * `By` byte * **Count units (COUNT-UNIT)** * `count` count * **Prefixes (PREFIX)** * `k` kilo (10^3) * `M` mega (10^6) * `G` giga (10^9) * `T`
+             * tera (10^12) * `P` peta (10^15) * `Ki` kibi (2^10) * `Mi` mebi (2^20) * `Gi` gibi (2^30) * `Ti` tebi (2^40) * `Pi` pebi (2^50) **Grammar** The grammar also includes these
+             * connectors: * `/` division or ratio (as an infix operator). For example: `kBy/{email}` or `MiBy/10ms`. * `.` multiplication or composition (as an infix operator). For example:
+             * `GBy.d` or `k{watt}.h`. The grammar for a unit is as follows: ``` Expression = Component { "." Component } { "/" Component } ; Component = ( [ PREFIX ] UNIT | "%" ) [ Annotation ] |
+             * Annotation | "1" ; UNIT = TIME-UNIT | STORAGE-UNIT | DATA-UNIT | COUNT-UNIT Annotation = "{" NAME "}" ; ``` Examples: * Request per second: `1/s` or `{requests}/s` * GibiBytes:
+             * `GiBy` * GibiBytes * seconds: `GiBy.s`
+             */
+            unit?: string;
+            /**
+             * The timeline entries. Each entry has a start time and usage rate. The start time specifies the effective time of the usage rate. The entries must be sorted by start time in an
+             * increasing order.
+             */
+            usageRateTimelineEntries?: UsageRateTimelineEntry[];
+        }
+        interface UsageRateTimelineEntry {
+            /**
+             * The effective time for this entry. The usage rate is in effect starting at this time until the effective time of the subsequent entry in the timeline. The last entry defines the
+             * usage rate until the end of the `Usage` time frame. Must correspond to an integer number of hours.
+             */
+            effectiveTime?: EstimationTimePoint;
+            /** The usage rate. */
+            usageRate?: number;
+        }
+        interface VmResourceBasedCud {
+            /** Guest accelerator, known as GPU. */
+            guestAccelerator?: GuestAccelerator;
+            /**
+             * The machine series for CUD. For example: "n1" for general purpose N1 machine type commitments. "n2" for general purpose N2 machine type commitments. "e2" for general purpose E2
+             * machine type commitments. "n2d" for general purpose N2D machine type commitments. "t2d" for general purpose T2D machine type commitments. "c2"/"c2d" for compute-optimized
+             * commitments. "m1"/"m2" for the memory-optimized commitments. "a2' for the accelerator-optimized commitments.
+             */
+            machineSeries?: string;
+            /** Memory size of the VM in GB (2^30 bytes). Must be an increment of 0.25 (256 MB). */
+            memorySizeGb?: number;
+            /** Commitment usage plan. */
+            plan?: string;
+            /** The region where the VM runs. For example: "us-central1" */
+            region?: string;
+            /** The number of vCPUs. The number of vCPUs must be an integer of 0 or more and can be even or odd. */
+            virtualCpuCount?: string;
+        }
+        interface Workload {
+            /** Usage on Google Cloud Storage. */
+            cloudStorageWorkload?: CloudStorageWorkload;
+            /** Usage of a Google Compute Engine Virtual Machine. */
+            computeVmWorkload?: ComputeVmWorkload;
+            /** Required. A name for this workload. All workloads in a `CostScenario` must have a unique `name`. Each `name` must be a maximum of 32 characters. */
+            name?: string;
+        }
+        interface WorkloadCostEstimate {
+            /** The name of the workload, as specified in the `CostScenario`. */
+            name?: string;
+            /** Estimated costs for each SKU in the workload. */
+            skuCostEstimates?: SkuCostEstimate[];
+            /** Total estimated costs for the workload. */
+            workloadTotalCostEstimate?: CostEstimate;
+        }
+        interface BillingAccountsResource {
+            /** Use custom pricing in the estimate, using a `CostScenario` with a defined `billingAccount`. */
+            estimateCostScenario(request: {
+                /** V1 error format. */
+                "$.xgafv"?: string;
+                /** OAuth access token. */
+                access_token?: string;
+                /** Data format for response. */
+                alt?: string;
+                /**
+                 * Resource name of the billing account for the cost estimate. The resource name has the form `billingAccounts/{billing_acount_id}`. For example,
+                 * `billingAccounts/012345-567890-ABCDEF` is the resource name for billing account `012345-567890-ABCDEF`. Must be specified.
+                 */
+                billingAccount: string;
+                /** JSONP */
+                callback?: string;
+                /** Selector specifying which fields to include in a partial response. */
+                fields?: string;
+                /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+                key?: string;
+                /** OAuth 2.0 token for the current user. */
+                oauth_token?: string;
+                /** Returns response with indentations and line breaks. */
+                prettyPrint?: boolean;
+                /** 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. */
+                quotaUser?: string;
+                /** Upload protocol for media (e.g. "raw", "multipart"). */
+                upload_protocol?: string;
+                /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+                uploadType?: string;
+                /** Request body */
+                resource: EstimateCostScenarioForBillingAccountRequest;
+            }): Request<EstimateCostScenarioForBillingAccountResponse>;
+            estimateCostScenario(request: {
+                /** V1 error format. */
+                "$.xgafv"?: string;
+                /** OAuth access token. */
+                access_token?: string;
+                /** Data format for response. */
+                alt?: string;
+                /**
+                 * Resource name of the billing account for the cost estimate. The resource name has the form `billingAccounts/{billing_acount_id}`. For example,
+                 * `billingAccounts/012345-567890-ABCDEF` is the resource name for billing account `012345-567890-ABCDEF`. Must be specified.
+                 */
+                billingAccount: string;
+                /** JSONP */
+                callback?: string;
+                /** Selector specifying which fields to include in a partial response. */
+                fields?: string;
+                /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+                key?: string;
+                /** OAuth 2.0 token for the current user. */
+                oauth_token?: string;
+                /** Returns response with indentations and line breaks. */
+                prettyPrint?: boolean;
+                /** 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. */
+                quotaUser?: string;
+                /** Upload protocol for media (e.g. "raw", "multipart"). */
+                upload_protocol?: string;
+                /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+                uploadType?: string;
+            },
+            body: EstimateCostScenarioForBillingAccountRequest): Request<EstimateCostScenarioForBillingAccountResponse>;
+        }
+        interface V1betaResource {
+            /** Estimate list prices using a `CostScenario` without a defined `billingAccount`. */
+            estimateCostScenario(request: {
+                /** V1 error format. */
+                "$.xgafv"?: string;
+                /** OAuth access token. */
+                access_token?: string;
+                /** Data format for response. */
+                alt?: string;
+                /** JSONP */
+                callback?: string;
+                /** Selector specifying which fields to include in a partial response. */
+                fields?: string;
+                /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+                key?: string;
+                /** OAuth 2.0 token for the current user. */
+                oauth_token?: string;
+                /** Returns response with indentations and line breaks. */
+                prettyPrint?: boolean;
+                /** 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. */
+                quotaUser?: string;
+                /** Upload protocol for media (e.g. "raw", "multipart"). */
+                upload_protocol?: string;
+                /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+                uploadType?: string;
+                /** Request body */
+                resource: EstimateCostScenarioWithListPriceRequest;
+            }): Request<EstimateCostScenarioWithListPriceResponse>;
+            estimateCostScenario(request: {
+                /** V1 error format. */
+                "$.xgafv"?: string;
+                /** OAuth access token. */
+                access_token?: string;
+                /** Data format for response. */
+                alt?: string;
+                /** JSONP */
+                callback?: string;
+                /** Selector specifying which fields to include in a partial response. */
+                fields?: string;
+                /** API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token. */
+                key?: string;
+                /** OAuth 2.0 token for the current user. */
+                oauth_token?: string;
+                /** Returns response with indentations and line breaks. */
+                prettyPrint?: boolean;
+                /** 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. */
+                quotaUser?: string;
+                /** Upload protocol for media (e.g. "raw", "multipart"). */
+                upload_protocol?: string;
+                /** Legacy upload protocol for media (e.g. "media", "multipart"). */
+                uploadType?: string;
+            },
+            body: EstimateCostScenarioWithListPriceRequest): Request<EstimateCostScenarioWithListPriceResponse>;
+        }
+
+        const billingAccounts: BillingAccountsResource;
+
+        const v1beta: V1betaResource;
+    }
+}

package/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "@maxim_mazurok/gapi.client.cloudbilling-v1beta",
+  "version": "0.0.20220914",
+  "description": "TypeScript typings for Cloud Billing API v1beta",
+  "license": "MIT",
+  "author": {
+    "email": "maxim@mazurok.com",
+    "name": "Maxim Mazurok",
+    "url": "https://maxim.mazurok.com"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Maxim-Mazurok/google-api-typings-generator.git"
+  },
+  "types": "index.d.ts",
+  "dependencies": {
+    "@types/gapi.client": "*",
+    "@types/gapi.client.discovery": "*"
+  }
+}

package/readme.md

@@ -0,0 +1,84 @@
+# TypeScript typings for Cloud Billing API v1beta
+
+Allows developers to manage billing for their Google Cloud Platform projects programmatically.
+For detailed description please check [documentation](https://cloud.google.com/billing/).
+
+## Installing
+
+Install typings for Cloud Billing API:
+
+```
+npm install @types/gapi.client.cloudbilling-v1beta --save-dev
+```
+
+## Usage
+
+You need to initialize Google API client in your code:
+
+```typescript
+gapi.load('client', () => {
+  // now we can use gapi.client
+  // ...
+});
+```
+
+Then load api client wrapper:
+
+```typescript
+gapi.client.load('https://cloudbilling.googleapis.com/$discovery/rest?version=v1beta', () => {
+  // now we can use:
+  // gapi.client.cloudbilling
+});
+```
+
+```typescript
+// Deprecated, use discovery document URL, see https://github.com/google/google-api-javascript-client/blob/master/docs/reference.md#----gapiclientloadname----version----callback--
+gapi.client.load('cloudbilling', 'v1beta', () => {
+  // now we can use:
+  // gapi.client.cloudbilling
+});
+```
+
+Don't forget to authenticate your client before sending any request to resources:
+
+```typescript
+// declare client_id registered in Google Developers Console
+var client_id = '',
+  scope = [
+      // View and manage your Google Cloud Platform billing accounts
+      'https://www.googleapis.com/auth/cloud-billing',
+
+      // View your Google Cloud Platform billing accounts
+      'https://www.googleapis.com/auth/cloud-billing.readonly',
+
+      // See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account.
+      'https://www.googleapis.com/auth/cloud-platform',
+    ],
+    immediate = true;
+// ...
+
+gapi.auth.authorize(
+  { client_id: client_id, scope: scope, immediate: immediate },
+  authResult => {
+    if (authResult && !authResult.error) {
+        /* handle successful authorization */
+    } else {
+        /* handle authorization error */
+    }
+});
+```
+
+After that you can use Cloud Billing API resources: <!-- TODO: make this work for multiple namespaces -->
+
+```typescript
+
+/*
+Use custom pricing in the estimate, using a `CostScenario` with a defined `billingAccount`.
+*/
+await gapi.client.cloudbilling.billingAccounts.estimateCostScenario({ billingAccount: "billingAccount",  });
+
+/*
+Estimate list prices using a `CostScenario` without a defined `billingAccount`.
+*/
+await gapi.client.cloudbilling.estimateCostScenario({  });
+```

package/tests.ts

@@ -0,0 +1,360 @@
+/* This is stub file for gapi.client.cloudbilling-v1beta definition tests */
+// IMPORTANT
+// This file was generated by https://github.com/Maxim-Mazurok/google-api-typings-generator. Please do not edit it manually.
+// In case of any problems please post issue to https://github.com/Maxim-Mazurok/google-api-typings-generator
+
+// Revision: 20220914
+
+gapi.load('client', async () => {
+    /** now we can use gapi.client */
+
+    await gapi.client.load('https://cloudbilling.googleapis.com/$discovery/rest?version=v1beta');
+    /** now we can use gapi.client.cloudbilling */
+
+    /** don't forget to authenticate your client before sending any request to resources: */
+    /** declare client_id registered in Google Developers Console */
+    const client_id = '<<PUT YOUR CLIENT ID HERE>>';
+    const scope = [
+        /** View and manage your Google Cloud Platform billing accounts */
+        'https://www.googleapis.com/auth/cloud-billing',
+        /** View your Google Cloud Platform billing accounts */
+        'https://www.googleapis.com/auth/cloud-billing.readonly',
+        /** See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account. */
+        'https://www.googleapis.com/auth/cloud-platform',
+    ];
+    const immediate = false;
+    gapi.auth.authorize({ client_id, scope, immediate }, authResult => {
+        if (authResult && !authResult.error) {
+            /** handle successful authorization */
+            run();
+        } else {
+            /** handle authorization error */
+        }
+    });
+
+    async function run() {
+        /** Use custom pricing in the estimate, using a `CostScenario` with a defined `billingAccount`. */
+        await gapi.client.cloudbilling.billingAccounts.estimateCostScenario({
+            billingAccount: "Test string",
+        }, {
+            costScenario: {
+                commitments: [
+                    {
+                        name: "Test string",
+                        vmResourceBasedCud: {
+                            guestAccelerator: {
+                                acceleratorCount: "Test string",
+                                acceleratorType: "Test string",
+                            },
+                            machineSeries: "Test string",
+                            memorySizeGb: 42,
+                            plan: "Test string",
+                            region: "Test string",
+                            virtualCpuCount: "Test string",
+                        },
+                    }
+                ],
+                scenarioConfig: {
+                    estimateDuration: "Test string",
+                },
+                workloads: [
+                    {
+                        cloudStorageWorkload: {
+                            dataRetrieval: {
+                                usageRateTimeline: {
+                                    unit: "Test string",
+                                    usageRateTimelineEntries: [
+                                        {
+                                            effectiveTime: {
+                                                estimationTimeFrameOffset: "Test string",
+                                            },
+                                            usageRate: 42,
+                                        }
+                                    ],
+                                },
+                            },
+                            dataStored: {
+                                usageRateTimeline: {
+                                    unit: "Test string",
+                                    usageRateTimelineEntries: [
+                                        {
+                                            effectiveTime: {
+                                                estimationTimeFrameOffset: "Test string",
+                                            },
+                                            usageRate: 42,
+                                        }
+                                    ],
+                                },
+                            },
+                            dualRegion: {
+                                name: "Test string",
+                            },
+                            multiRegion: {
+                                name: "Test string",
+                            },
+                            operationA: {
+                                usageRateTimeline: {
+                                    unit: "Test string",
+                                    usageRateTimelineEntries: [
+                                        {
+                                            effectiveTime: {
+                                                estimationTimeFrameOffset: "Test string",
+                                            },
+                                            usageRate: 42,
+                                        }
+                                    ],
+                                },
+                            },
+                            operationB: {
+                                usageRateTimeline: {
+                                    unit: "Test string",
+                                    usageRateTimelineEntries: [
+                                        {
+                                            effectiveTime: {
+                                                estimationTimeFrameOffset: "Test string",
+                                            },
+                                            usageRate: 42,
+                                        }
+                                    ],
+                                },
+                            },
+                            region: {
+                                name: "Test string",
+                            },
+                            storageClass: "Test string",
+                        },
+                        computeVmWorkload: {
+                            enableConfidentialCompute: true,
+                            guestAccelerator: {
+                                acceleratorCount: "Test string",
+                                acceleratorType: "Test string",
+                            },
+                            instancesRunning: {
+                                usageRateTimeline: {
+                                    unit: "Test string",
+                                    usageRateTimelineEntries: [
+                                        {
+                                            effectiveTime: {
+                                                estimationTimeFrameOffset: "Test string",
+                                            },
+                                            usageRate: 42,
+                                        }
+                                    ],
+                                },
+                            },
+                            licenses: [
+                                "Test string"
+                            ],
+                            machineType: {
+                                customMachineType: {
+                                    machineSeries: "Test string",
+                                    memorySizeGb: 42,
+                                    virtualCpuCount: "Test string",
+                                },
+                                predefinedMachineType: {
+                                    machineType: "Test string",
+                                },
+                            },
+                            persistentDisks: [
+                                {
+                                    diskSize: {
+                                        usageRateTimeline: {
+                                            unit: "Test string",
+                                            usageRateTimelineEntries: [
+                                                {
+                                                    effectiveTime: {
+                                                        estimationTimeFrameOffset: "Test string",
+                                                    },
+                                                    usageRate: 42,
+                                                }
+                                            ],
+                                        },
+                                    },
+                                    diskType: "Test string",
+                                    provisionedIops: {
+                                        usageRateTimeline: {
+                                            unit: "Test string",
+                                            usageRateTimelineEntries: [
+                                                {
+                                                    effectiveTime: {
+                                                        estimationTimeFrameOffset: "Test string",
+                                                    },
+                                                    usageRate: 42,
+                                                }
+                                            ],
+                                        },
+                                    },
+                                    scope: "Test string",
+                                }
+                            ],
+                            preemptible: true,
+                            region: "Test string",
+                        },
+                        name: "Test string",
+                    }
+                ],
+            },
+        });
+        /** Estimate list prices using a `CostScenario` without a defined `billingAccount`. */
+        await gapi.client.cloudbilling.v1beta.estimateCostScenario({
+        }, {
+            costScenario: {
+                commitments: [
+                    {
+                        name: "Test string",
+                        vmResourceBasedCud: {
+                            guestAccelerator: {
+                                acceleratorCount: "Test string",
+                                acceleratorType: "Test string",
+                            },
+                            machineSeries: "Test string",
+                            memorySizeGb: 42,
+                            plan: "Test string",
+                            region: "Test string",
+                            virtualCpuCount: "Test string",
+                        },
+                    }
+                ],
+                scenarioConfig: {
+                    estimateDuration: "Test string",
+                },
+                workloads: [
+                    {
+                        cloudStorageWorkload: {
+                            dataRetrieval: {
+                                usageRateTimeline: {
+                                    unit: "Test string",
+                                    usageRateTimelineEntries: [
+                                        {
+                                            effectiveTime: {
+                                                estimationTimeFrameOffset: "Test string",
+                                            },
+                                            usageRate: 42,
+                                        }
+                                    ],
+                                },
+                            },
+                            dataStored: {
+                                usageRateTimeline: {
+                                    unit: "Test string",
+                                    usageRateTimelineEntries: [
+                                        {
+                                            effectiveTime: {
+                                                estimationTimeFrameOffset: "Test string",
+                                            },
+                                            usageRate: 42,
+                                        }
+                                    ],
+                                },
+                            },
+                            dualRegion: {
+                                name: "Test string",
+                            },
+                            multiRegion: {
+                                name: "Test string",
+                            },
+                            operationA: {
+                                usageRateTimeline: {
+                                    unit: "Test string",
+                                    usageRateTimelineEntries: [
+                                        {
+                                            effectiveTime: {
+                                                estimationTimeFrameOffset: "Test string",
+                                            },
+                                            usageRate: 42,
+                                        }
+                                    ],
+                                },
+                            },
+                            operationB: {
+                                usageRateTimeline: {
+                                    unit: "Test string",
+                                    usageRateTimelineEntries: [
+                                        {
+                                            effectiveTime: {
+                                                estimationTimeFrameOffset: "Test string",
+                                            },
+                                            usageRate: 42,
+                                        }
+                                    ],
+                                },
+                            },
+                            region: {
+                                name: "Test string",
+                            },
+                            storageClass: "Test string",
+                        },
+                        computeVmWorkload: {
+                            enableConfidentialCompute: true,
+                            guestAccelerator: {
+                                acceleratorCount: "Test string",
+                                acceleratorType: "Test string",
+                            },
+                            instancesRunning: {
+                                usageRateTimeline: {
+                                    unit: "Test string",
+                                    usageRateTimelineEntries: [
+                                        {
+                                            effectiveTime: {
+                                                estimationTimeFrameOffset: "Test string",
+                                            },
+                                            usageRate: 42,
+                                        }
+                                    ],
+                                },
+                            },
+                            licenses: [
+                                "Test string"
+                            ],
+                            machineType: {
+                                customMachineType: {
+                                    machineSeries: "Test string",
+                                    memorySizeGb: 42,
+                                    virtualCpuCount: "Test string",
+                                },
+                                predefinedMachineType: {
+                                    machineType: "Test string",
+                                },
+                            },
+                            persistentDisks: [
+                                {
+                                    diskSize: {
+                                        usageRateTimeline: {
+                                            unit: "Test string",
+                                            usageRateTimelineEntries: [
+                                                {
+                                                    effectiveTime: {
+                                                        estimationTimeFrameOffset: "Test string",
+                                                    },
+                                                    usageRate: 42,
+                                                }
+                                            ],
+                                        },
+                                    },
+                                    diskType: "Test string",
+                                    provisionedIops: {
+                                        usageRateTimeline: {
+                                            unit: "Test string",
+                                            usageRateTimelineEntries: [
+                                                {
+                                                    effectiveTime: {
+                                                        estimationTimeFrameOffset: "Test string",
+                                                    },
+                                                    usageRate: 42,
+                                                }
+                                            ],
+                                        },
+                                    },
+                                    scope: "Test string",
+                                }
+                            ],
+                            preemptible: true,
+                            region: "Test string",
+                        },
+                        name: "Test string",
+                    }
+                ],
+            },
+        });
+    }
+});

package/tsconfig.json

@@ -0,0 +1,18 @@
+{
+    "compilerOptions": {
+        "module": "commonjs",
+        "lib": ["es6", "dom"],
+        "noImplicitAny": true,
+        "noImplicitThis": true,
+        "strictNullChecks": true,
+        "baseUrl": "../",
+        "typeRoots": [
+            "../"
+        ],
+        "types": [],
+        "noEmit": true,
+        "forceConsistentCasingInFileNames": true,
+        "strictFunctionTypes": true
+    },
+    "files": ["index.d.ts", "tests.ts"]
+}

package/tslint.json

@@ -0,0 +1,6 @@
+{
+    "extends": "dtslint/dtslint.json",
+    "rules": {
+        "no-redundant-jsdoc": false
+    }
+}