Class: Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice

Inherits:
Object
  • Object
show all
Extended by:
Protobuf::MessageExts::ClassMethods
Includes:
Protobuf::MessageExts
Defined in:
proto_docs/google/cloud/commerceproducer/v1beta/sku.rb

Overview

The price of the SKU, active during a particular time range. Prices are in all cases in USD. Customers are billed in the currency of their billing account, subject to the currency conversion rate in effect at the time.

Defined Under Namespace

Classes: AiPlatformDeployedModelUsageFee, AiPlatformManagedModelEndpointLocation, AiPlatformManagedModelUsageFee, AiPlatformProvisionedThroughputFee, ComputeEngineLicenseUsageFee, FlatSubscriptionFee, InactiveSkuPrice, KubernetesEnginePodUsageFee, ManagedServiceMetricUsageFee, TieredPrice

Instance Attribute Summary collapse

Instance Attribute Details

#ai_platform_deployed_model_usage_fee::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformDeployedModelUsageFee (readonly)

Returns Output only. The SKU prices usage of an AI model deployed on AI Platform.

Note: The following fields are mutually exclusive: ai_platform_deployed_model_usage_fee, inactive, managed_service_metric_usage_fee, gce_license_usage_fee, gke_pod_usage_fee, ai_platform_managed_model_usage_fee, ai_platform_provisioned_throughput_fee, flat_subscription_fee. If a field in that set is populated, all other fields in the set will automatically be cleared.

Returns:

  • (::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformDeployedModelUsageFee)

    Output only. The SKU prices usage of an AI model deployed on AI Platform.

    Note: The following fields are mutually exclusive: ai_platform_deployed_model_usage_fee, inactive, managed_service_metric_usage_fee, gce_license_usage_fee, gke_pod_usage_fee, ai_platform_managed_model_usage_fee, ai_platform_provisioned_throughput_fee, flat_subscription_fee. If a field in that set is populated, all other fields in the set will automatically be cleared.



125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
# File 'proto_docs/google/cloud/commerceproducer/v1beta/sku.rb', line 125

class SkuPrice
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # Representation for a SKU that is not active and has no price.
  class InactiveSkuPrice
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Details about a SKU pricing usage of a [partner-reported custom billing
  # metric](https://cloud.google.com/service-infrastructure/docs/reporting-billing-metrics)
  # defined by the partner in the Service Management API and reported using
  # the Service Control API.
  #
  # The customer's usage charge is computed by converting the customer's
  # reported consumption to the SKU's composite price unit and applying the
  # graduated price from the appropriate price tier.
  # @!attribute [r] tiered_price
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::TieredPrice]
  #     Output only. [Tiered
  #     pricing](https://cloud.google.com/billing/docs/how-to/pricing-table#tiered-pricing)
  #     of the SKU.
  # @!attribute [r] canonical_metric
  #   @return [::String]
  #     Output only. The name of the metric, in canonical format.
  #
  #     Note that in the canonical format the first character of the path
  #     component of the metric name is always uppercase, which may differ
  #     from the metric name in the service config. For example, a metric
  #     appearing in the service config as 'example.com/example_metric' will
  #     appear here in the SKU as 'example.com/Example_metric'. In the Service
  #     Management and Service Control APIs these two metric names are
  #     considered distinct, either or both may be defined, and usage must be
  #     reported using a name matching the name of a metric defined in the
  #     service config. But for billing purposes usage reported using either
  #     name will be aggregated under the canonical metric name.
  #
  #     Example: "example.com/Example_metric"
  class ManagedServiceMetricUsageFee
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Details about a SKU pricing usage of a [Compute Engine
  # License](https://cloud.google.com/compute/docs/licenses/about).
  #
  # The SKU applies to a single license, and may be further scoped to a
  # [Compute
  # Engine VM Instance](https://cloud.google.com/compute/docs/instances)
  # machine resource type (e.g. "vCPU") and size range for that machine
  # resource. Instances deployed from [Compute
  # Engine Images](https://cloud.google.com/compute/docs/images)
  # incorporating the target license and (if applicable) matching the machine
  # resource type size range will be charged by the SKU. A single license may
  # be priced by multiple SKUs covering different combinations of machine
  # resource type and size range, allowing a single running instance to be
  # charged by up to one SKU per machine resource type, with pricing tiered
  # according to machine shape.
  # @!attribute [rw] price_per_unit
  #   @return [::Google::Type::Money]
  #     The price per unit of usage.
  #     The customer's usage charge is computed by measuring the customer's
  #     consumption denominated in price units and multiplying by this price.
  # @!attribute [r] license_code
  #   @return [::String]
  #     Output only. The license code of the target Compute Engine License.
  #     Note that this is the numeric license code itself in uint64 format used
  #     to reference licenses attached to images, not the resource name of the
  #     related [Compute Engine LicenseCode
  #     resource](https://cloud.google.com/compute/docs/reference/rest/v1/licenseCodes).
  #
  #     Example: "1234567890123456789"
  # @!attribute [r] machine_resource
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::ComputeEngineLicenseUsageFee::MachineResource]
  #     Output only. The machine resource type that the SKU applies to, if any.
  #     SKUs with a non-default value are referred to as "resource-based" SKUs.
  # @!attribute [r] machine_resource_range
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::ComputeEngineLicenseUsageFee::MachineResourceRange]
  #     Output only. The range of machine resource values that the SKU applies
  #     to. Unset when the SKU is not scoped to a particular machine resource
  #     type. The collection of SKUs in effect at any given time targeting the
  #     same license and machine resource type will cover all possible values
  #     for that machine resource type without overlap. Such a collection of
  #     SKUs form a "tiered" price structure over the possible values of the
  #     machine resource, with each SKU acting as a "tier".
  #
  #     NOTE: This is distinct from a SKU with [tiered
  #     pricing](https://cloud.google.com/billing/docs/how-to/pricing-table#tiered-pricing).
  # @!attribute [r] usage_calculation
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::ComputeEngineLicenseUsageFee::UsageCalculation]
  #     Output only. Determines how the customer's usage is calculated.
  # @!attribute [r] unit
  #   @return [::String]
  #     Output only. The price unit of the SKU.
  #     See https://ucum.org/ucum.html for the format of the price unit.
  #     For linear-priced memory SKUs, the price unit is 'GiBy.h'.
  #     For all other SKUs, the price unit is 'h'. This includes linear-priced
  #     vCPU and GPU SKUs because these resources have unitless dimensions and
  #     the application of these scaling factors does not change the price
  #     unit.
  class ComputeEngineLicenseUsageFee
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # The range of machine resource values that the SKU applies to.
    # @!attribute [r] start_value
    #   @return [::Integer]
    #     Output only. The inclusive lower bound of the range.
    #     While the number zero may be the start of a range, it is not a
    #     possible machine resource value. An instance cannot exist with zero
    #     vCPU or memory, and an instance with no attached accelerators lacks a
    #     GPU dimension entirely rather than having a GPU count of zero.
    # @!attribute [r] end_value
    #   @return [::Integer]
    #     Output only. The exclusive upper bound of the range.
    #     If no end value is specified, the range is unbounded from above.
    class MachineResourceRange
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # The machine resource type that the SKU applies to, if any.
    module MachineResource
      # The SKU applies to all instances irrespective of machine shape.
      # This is referred to as "instance-based pricing" because the price
      # is the same for all instances.
      MACHINE_RESOURCE_UNSPECIFIED = 0

      # The SKU applies based on the instance's vCPU count.
      VCPU_COUNT = 1

      # The SKU applies based on the instance's memory size in bytes.
      MEMORY_BYTES = 2

      # The SKU applies based on the instance's GPU count.
      GPU_COUNT = 3
    end

    # Determines how the customer's usage is calculated.
    module UsageCalculation
      # Unused.
      USAGE_CALCULATION_UNSPECIFIED = 0

      # Usage is calculated from instance runtime.
      # The customer's usage is metered according to the [Compute Engine VM
      # instance pricing
      # model](https://cloud.google.com/compute/vm-instance-pricing),
      # measured on a per-instance basis in units of hours, with a minimum
      # duration of one minute and an increment of one second.
      #
      # A SKU using this usage calculation is referred to as "flat" because
      # the customer's usage charge is independent of the instance's machine
      # resource shape apart from determining whether the SKU applies to the
      # instance.
      INSTANCE_RUNTIME = 1

      # Usage is calculated from instance runtime and size.
      # This calculation mode is only applicable to resource-based SKUs.
      # Usage is calculated by measuring the instance runtime in the same
      # manner as for `INSTANCE_RUNTIME` and multiplying by the instance's
      # machine resource value matching the SKU's machine resource type.
      # This converts the price from per-instance-hour to
      # per-instance-hour-per-machine-resource, which changes the price unit
      # for memory SKUs to 'GiBy.h'. The price unit otherwise remains 'h'
      # because the other machine resources are dimensionless.
      #
      # A SKU using this usage calculation is referred to as "linear" because
      # the customer's usage charge is linearly proportional to the
      # instance's machine resource value.
      LINEAR_RESOURCE_SCALED_INSTANCE_RUNTIME = 2
    end
  end

  # Details about a SKU pricing usage of software running on a Kubernetes
  # Engine pod.
  #
  # The SKU applies to pods annotated with the SKU's parent service name, and
  # may be further scoped to a [k8s pod resource
  # type](https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/)
  # (e.g. "CPU") and size range for that resource type. Running pods
  # annotated with the parent service's service name and matching the pod
  # resource type size range will be charged by the SKU. A service may be
  # priced by multiple SKUs covering different combinations of pod resource
  # type and size range, allowing a single running pod to be charged by up to
  # one SKU per pod resource type, with pricing tiered according to pod
  # shape.
  # @!attribute [rw] price_per_unit
  #   @return [::Google::Type::Money]
  #     The price per unit of usage.
  #     The customer's usage charge is computed by measuring the customer's
  #     consumption denominated in price units and multiplying by this price.
  # @!attribute [r] pod_resource
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::KubernetesEnginePodUsageFee::PodResource]
  #     Output only. The pod resource type that the SKU applies to.
  #     SKUs with a non-default value are referred to as "resource-based" SKUs.
  # @!attribute [r] pod_resource_range
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::KubernetesEnginePodUsageFee::PodResourceRange]
  #     Output only. The range of pod resource values that the SKU applies to.
  #     The collection of SKUs in effect at any given time targeting the same
  #     service annotation and pod resource type will cover all possible values
  #     for that pod resource type without overlap. Such a collection of SKUs
  #     form a "tiered" price structure over the possible values of the pod
  #     resource, with each SKU acting as a "tier".
  #
  #     NOTE: This is distinct from a SKU with [tiered
  #     pricing](https://cloud.google.com/billing/docs/how-to/pricing-table#tiered-pricing).
  # @!attribute [r] usage_calculation
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::KubernetesEnginePodUsageFee::UsageCalculation]
  #     Output only. Determines how the customer's usage is calculated.
  # @!attribute [r] unit
  #   @return [::String]
  #     Output only. The price unit of the SKU.
  #     See https://ucum.org/ucum.html for the format of the price unit.
  #     For linear-priced memory SKUs, the price unit is 'GiBy.h'.
  #     For all other SKUs, the price unit is 'h'. This includes linear-priced
  #     VCPU, GPU, and TPU SKUs because these resources have unitless
  #     dimensions and the application of these scaling factors does not change
  #     the price unit.
  class KubernetesEnginePodUsageFee
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # The range of pod resource values that the SKU applies to.
    # @!attribute [r] start_value
    #   @return [::Integer]
    #     Output only. The inclusive lower bound of the range.
    # @!attribute [r] end_value
    #   @return [::Integer]
    #     Output only. The exclusive upper bound of the range.
    #     If no end value is specified, the range is unbounded from above.
    class PodResourceRange
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # The pod [resource
    # type](https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/)
    # that the SKU applies to.
    module PodResource
      # Unused.
      POD_RESOURCE_UNSPECIFIED = 0

      # The SKU applies based on the pod's [vCPU
      # count](https://kubernetes.io/docs/tasks/configure-pod-container/assign-cpu-resource/).
      VCPU_COUNT = 1

      # The SKU applies based on the pod's [memory
      # size](https://kubernetes.io/docs/tasks/configure-pod-container/assign-memory-resource/)
      # in bytes.
      MEMORY_BYTES = 2

      # The SKU applies based on the pod's GPU count.
      GPU_COUNT = 3

      # The SKU applies based on the pod's [TPU
      # count](https://cloud.google.com/kubernetes-engine/docs/concepts/tpus#how_tpus_work).
      TPU_COUNT = 4
    end

    # Determines how the customer's usage is calculated.
    module UsageCalculation
      # Unused.
      USAGE_CALCULATION_UNSPECIFIED = 0

      # Usage is calculated from pod runtime.
      # The customer's usage is metered in a manner similar to the [GKE
      # Autopilot mode for pods without specific hardware
      # requirements](https://cloud.google.com/kubernetes-engine/pricing),
      # priced on a per-pod basis in units of hours and measured in
      # one-second increments, with no minimum duration.
      #
      # A SKU using this usage calculation is referred to as "flat" because
      # the customer's usage charge is independent of the pod shape apart
      # from determining whether the SKU applies to the pod.
      POD_RUNTIME = 1

      # Usage is calculated from pod runtime and size.
      # This calculation mode is only applicable to resource-based SKUs.
      # Usage is calculated by measuring the pod runtime in the same manner
      # as for `POD_RUNTIME` and multiplying by the pod's resource value
      # matching the SKU's pod resource type.
      # This converts the price from per-pod-hour to
      # per-pod-hour-per-resource, which changes the price unit for memory
      # SKUs to 'GiBy.h'. The price unit otherwise remains 'h' because the
      # other resources are dimensionless.
      #
      # A SKU using this usage calculation is referred to as "linear" because
      # the customer's usage charge is linearly proportional to the
      # pod's resource value.
      LINEAR_RESOURCE_SCALED_POD_RUNTIME = 2
    end
  end

  # Details about a SKU pricing usage of an [AI Platform Managed Model
  # (MaaS)](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/partner-models/use-partner-models).
  # @!attribute [r] tiered_price
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::TieredPrice]
  #     Output only. [Tiered
  #     pricing](https://cloud.google.com/billing/docs/how-to/pricing-table#tiered-pricing)
  #     of the SKU.
  # @!attribute [r] usage_metric
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::AiPlatformManagedModelUsageMetric]
  #     Output only. The usage metric that the SKU applies to.
  # @!attribute [r] location
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelEndpointLocation]
  #     Output only. The model endpoint location where usage is priced by this
  #     SKU. If no location is specified, the SKU applies to usage in all
  #     locations.
  # @!attribute [r] prediction_mode
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::PredictionMode]
  #     Output only. The prediction mode of requests that the SKU applies to.
  # @!attribute [r] combined_request_input_tokens_range
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::CombinedRequestInputTokensRange]
  #     Output only. The range of aggregated input token values covered by the
  #     SKU. Unset if the SKU is not scoped to a particular range. A request is
  #     in scope for this SKU if its aggregated input token value falls within
  #     the range. The collection of SKUs in effect at any given time scoped to
  #     a particular aggregated input token value range will cover all possible
  #     values without overlap. Such a collection of SKUs form a "tiered" price
  #     structure over the possible value, with each SKU acting as a "tier".
  #
  #     NOTE: This is distinct from a SKU with [tiered
  #     pricing](https://cloud.google.com/billing/docs/how-to/pricing-table#tiered-pricing).
  # @!attribute [r] provisioned_throughput_overage
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::ProvisionedThroughputOverage]
  #     Output only. Set when the SKU is a historical provisioned throughput
  #     overage SKU. Starting 2025-08-26 such SKUs have no effect, and usage in
  #     excess of provisioned throughput quota is now metered as standard
  #     usage. This field is set only in historical SKU timeline entries for
  #     overage SKUs belonging to partners that offered provisioned throughput
  #     for AI Platform managed model products prior to the unification of
  #     standard usage and provisioned throughput overage metering.
  class AiPlatformManagedModelUsageFee
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # The usage metric that the SKU applies to.
    # @!attribute [r] input_tokens_metric
    #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::AiPlatformManagedModelUsageMetric::InputTokensMetric]
    #     Output only. Input tokens read from the prediction endpoint input.
    #
    #     Note: The following fields are mutually exclusive: `input_tokens_metric`, `cache_read_input_tokens_metric`, `cache_write_input_tokens_metric`, `output_tokens_metric`, `web_search_requests_metric`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] cache_read_input_tokens_metric
    #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::AiPlatformManagedModelUsageMetric::CacheReadInputTokensMetric]
    #     Output only. Input tokens read from the cache.
    #
    #     Note: The following fields are mutually exclusive: `cache_read_input_tokens_metric`, `input_tokens_metric`, `cache_write_input_tokens_metric`, `output_tokens_metric`, `web_search_requests_metric`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] cache_write_input_tokens_metric
    #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::AiPlatformManagedModelUsageMetric::CacheWriteInputTokensMetric]
    #     Output only. Input tokens written to the cache.
    #
    #     Note: The following fields are mutually exclusive: `cache_write_input_tokens_metric`, `input_tokens_metric`, `cache_read_input_tokens_metric`, `output_tokens_metric`, `web_search_requests_metric`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] output_tokens_metric
    #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::AiPlatformManagedModelUsageMetric::OutputTokensMetric]
    #     Output only. Output tokens returned from the prediction endpoint.
    #
    #     Note: The following fields are mutually exclusive: `output_tokens_metric`, `input_tokens_metric`, `cache_read_input_tokens_metric`, `cache_write_input_tokens_metric`, `web_search_requests_metric`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] web_search_requests_metric
    #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::AiPlatformManagedModelUsageMetric::WebSearchRequestsMetric]
    #     Output only. Web search requests executed by the model.
    #
    #     Note: The following fields are mutually exclusive: `web_search_requests_metric`, `input_tokens_metric`, `cache_read_input_tokens_metric`, `cache_write_input_tokens_metric`, `output_tokens_metric`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    class AiPlatformManagedModelUsageMetric
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # Input tokens read from the input to the prediction endpoint.
      # The unit for this metric is dimensionless.
      class InputTokensMetric
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end

      # Input tokens read from the cache.
      # The unit for this metric is dimensionless.
      class CacheReadInputTokensMetric
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end

      # Input tokens written to the cache.
      # The unit for this metric is dimensionless.
      # @!attribute [r] ttl
      #   @return [::Google::Protobuf::Duration]
      #     Output only. The duration the write is retained in the cache.
      class CacheWriteInputTokensMetric
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end

      # Output tokens returned from the prediction endpoint.
      # The unit for this metric is dimensionless.
      class OutputTokensMetric
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end

      # Web search requests executed by the model.
      # The unit for this metric is dimensionless.
      class WebSearchRequestsMetric
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end
    end

    # The range of aggregated input token values covered by the SKU.
    #
    # A request to a managed model has an aggregated input token value
    # determined by the sum of the metric values of the input token metrics.
    #
    # * input tokens
    # * cache read input tokens
    # * cache write input tokens
    # @!attribute [r] start_value
    #   @return [::Integer]
    #     Output only. The inclusive lower bound of the range.
    # @!attribute [r] end_value
    #   @return [::Integer]
    #     Output only. The exclusive upper bound of the range.
    #     If no end value is specified, the range is unbounded from above.
    class CombinedRequestInputTokensRange
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # Additional details present for historical provisioned throughput
    # "overage" SKUs that applied charges only to usage above the customer's
    # provisioned throughput quota threshold.
    # @!attribute [r] service
    #   @return [::String]
    #     Output only. The service whose usage the overage SKU applied to.
    class ProvisionedThroughputOverage
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # The prediction modes of requests that the SKU applies to.
    module PredictionMode
      # The SKU does not distinguish between prediction modes.
      PREDICTION_MODE_UNSPECIFIED = 0

      # The SKU applies to online prediction.
      ONLINE_PREDICTION = 1

      # The SKU applies to batch prediction.
      BATCH_PREDICTION = 2
    end
  end

  # Details about a SKU pricing reservation of [AI Platform Provisioned
  # Throughput](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/provisioned-throughput).
  #
  # Customers may purchase provisioned throughput reservations for AI
  # Platform managed model products. This provides the customer with
  # provisioned throughput quota for a particular model and location. Model
  # usage below the provisioned throughput quota threshold is voided and is
  # not charged by the product's managed model usage fees.
  # @!attribute [r] term_duration_months
  #   @return [::Integer]
  #     Output only. The duration of the provisioned throughput reservation
  #     in months.
  # @!attribute [rw] gsu_price_per_unit
  #   @return [::Google::Type::Money]
  #     The price per [Generative AI Scale Unit
  #     (GSU)](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/provisioned-throughput/measure-provisioned-throughput)
  #     per `unit`.
  #     A provisioned throughput reservation reserves a certain number of
  #     GSUs, and the customer is billed for those GSUs on a continuous basis
  #     for the duration of the reservation.
  # @!attribute [r] location
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelEndpointLocation]
  #     Output only. The location where provisioned throughput is priced by
  #     this SKU.
  # @!attribute [r] unit
  #   @return [::String]
  #     Output only. The price unit of the SKU.
  #     See https://ucum.org/ucum.html for the format of the price unit.
  #     Since provisioned throughput reservations are billed by duration, this
  #     will always be a time unit. The price unit of a provisioned throughput
  #     SKU is not necessarily the same as the reservation term.
  #     This field is unrelated to the [Generative AI Scale Unit
  #     (GSU)](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/provisioned-throughput/measure-provisioned-throughput).
  #
  #     Currently the unit is always months ('mo').
  #     Additional time units may be supported in future.
  #
  #     The customary unit month ('mo') requires special handling to account
  #     for the variable duration of months. A price may be denominated in
  #     units of months, but the duration the reservation is active is measured
  #     in metric time and customers are billed on that basis. The exact hourly
  #     or per-second price can be calculated by dividing the monthly price
  #     by the number of hours or seconds in the desired month. A reservation
  #     active for N months is rarely billed exactly N times the monthly price.
  #     This is intended and is not a billing error.
  class AiPlatformProvisionedThroughputFee
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Details about a SKU pricing usage of an [AI Platform Self Deployed
  # Model](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/model-garden/self-deployed-models).
  # @!attribute [r] accelerator_type
  #   @return [::String]
  #     Output only. The SKU applies to a specific accelerator type.
  #     Contains the name of the matching [AI Platform AcceleratorType](
  #     https://docs.cloud.google.com/gemini-enterprise-agent-platform/reference/rest/v1/MachineSpec#AcceleratorType).
  #     The corresponding linear scaling value is the dimensionless
  #     [`accelerator_count`](https://docs.cloud.google.com/gemini-enterprise-agent-platform/reference/rest/v1/MachineSpec#FIELDS.accelerator_count).
  # @!attribute [r] price_per_unit
  #   @return [::Google::Type::Money]
  #     Output only. The price per unit of usage.
  #     The customer's usage charge is computed by measuring the customer's
  #     consumption denominated in price units and multiplying by this price.
  # @!attribute [r] unit
  #   @return [::String]
  #     Output only. The price unit of the SKU.
  #     See https://ucum.org/ucum.html for the format of the price unit.
  #     Currently the unit is always hours ('h'). This may change in future.
  # @!attribute [r] usage_calculation
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformDeployedModelUsageFee::UsageCalculation]
  #     Output only. Determines how the customer's usage is calculated.
  class AiPlatformDeployedModelUsageFee
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Determines how the customer's usage is calculated.
    module UsageCalculation
      # Unused.
      USAGE_CALCULATION_UNSPECIFIED = 0

      # Usage is calculated from deployment runtime and size.
      # Usage is calculated by measuring the deployment runtime in hours and
      # multiplying by the amount of the deployed model's hardware resource
      # matching the SKU's hardware resource type.
      # This results in a composite `unit` of hours ('h') multiplied by the
      # unit that denominates the hardware resource, though note that
      # multiplying by the dimensionless unit ("1") has no effect.
      LINEAR_RESOURCE_SCALED_DEPLOYMENT_RUNTIME = 2
    end
  end

  # Details about a SKU charging a flat subscription fee.
  # @!attribute [r] price_per_unit
  #   @return [::Google::Type::Money]
  #     Output only. The price per time unit the subscription is active.
  # @!attribute [r] unit
  #   @return [::String]
  #     Output only. The unit of the subscription SKU.
  #     See https://ucum.org/ucum.html for the format of the price unit.
  #     Since subscriptions are billed by duration, this will always be a time
  #     unit. The price unit of a subscription SKU is not necessarily the same
  #     as the subscription period of the corresponding StandardOffers.
  #
  #     Currently the unit is always months ('mo').
  #     Additional time units may be supported in future.
  #
  #     The unit month ('mo') is a customary time unit and requires special
  #     handling to account for the variable duration of months. A price may be
  #     denominated in units of months, but the duration the subscription is
  #     active is measured in metric time and customers are billed on that
  #     basis. The exact hourly or per-second price can be calculated by
  #     dividing the monthly price by the number of hours or seconds in the
  #     desired month. A subscription active for N months is rarely billed
  #     exactly N times the monthly price. This is intended and is not a
  #     billing error.
  class FlatSubscriptionFee
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Price structure for a SKU charging a [tiered
  # price](https://cloud.google.com/billing/docs/how-to/pricing-table#tiered-pricing).
  # @!attribute [r] unit
  #   @return [::String]
  #     Output only. Usage unit used for defining price tiers and for scaling
  #     with the price_unit_count to form the composite price unit.
  #
  #     See https://ucum.org/ucum.html for the format of the price unit.
  #     A unitless dimension, such as a count, is represented as `1`.
  # @!attribute [r] unit_description
  #   @return [::String]
  #     Output only. The display description of the unit, supplied at time of
  #     onboarding. This value is recommended to be set at least for
  #     dimensionless metrics, but may be empty if no description was provided
  #     at time of onboarding.
  # @!attribute [r] price_unit_count
  #   @return [::Google::Type::Decimal]
  #     Output only. Scaling  the `unit` by the `price_unit_count` forms the
  #     composite "price unit" which is priced by the price tiers.
  #
  #     This scaling factor is in addition to any numerical prefix symbol on
  #     the `unit`, so the same composite "price unit" can be represented in
  #     several ways, differing only in their presentation to users.
  #
  #     Examples:
  #
  #     * $1    per 1    bytes     : unit = By,  price_unit_count = 1
  #     * $1000 per 1    kilobytes : unit = kBy, price_unit_count = 1
  #     * $5000 per 5    kilobytes : unit = kBy, price_unit_count = 5
  # @!attribute [r] price_tiers
  #   @return [::Array<::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::TieredPrice::PriceTier>]
  #     Output only. The list of price tiers for the SKU, ordered by the
  #     start_amount.
  #
  #     The tiers are non-overlapping and are collectively bounded below by
  #     zero and unbounded above to cover the entire range of possible metric
  #     usage. Each tier is bounded below inclusively by its start_amount and
  #     bounded above exclusively by the start_amount of the next tier, or else
  #     unbounded above if there is no next tier.
  #
  #     Usage of the metric is aggregated by customer billing account on a
  #     monthly basis and billed in a graduated manner according to the price
  #     tiers, with each marginal unit of usage priced accoring to the tier in
  #     which it falls.
  class TieredPrice
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # A [price
    # tier](https://cloud.google.com/billing/docs/how-to/pricing-table#tiered-pricing)
    # pricing metric usage within a range.
    #
    # Each marginal unit of usage is priced according to the price tier in
    # which it falls.
    # @!attribute [r] start_amount
    #   @return [::Google::Type::Decimal]
    #     Output only. Inclusive lower bound of the tier interval, denominated
    #     in `unit`.
    # @!attribute [r] price
    #   @return [::Google::Type::Money]
    #     Output only. The price per `price_unit_count` of `unit` in the tier.
    #     The price is applied fractionally if the customer's usage within the
    #     tier is not an integer multiple of `price_unit_count`.
    class PriceTier
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end
  end

  # Location scope for a SKU that applies to an AI Platform Managed Model
  # endpoint.
  # @!attribute [r] region_id
  #   @return [::String]
  #     Output only. The SKU applies to a region.
  #
  #     Note: The following fields are mutually exclusive: `region_id`, `global_endpoint`, `multi_region_id`. If a field in that set is populated, all other fields in the set will automatically be cleared.
  # @!attribute [r] global_endpoint
  #   @return [::Boolean]
  #     Output only. The SKU applies to a [global
  #     endpoint](https://docs.cloud.google.com/gemini-enterprise-agent-platform/resources/locations).
  #     **Note**: This is distinct from the conventional meaning of "global"
  #     as a SKU that applies to all locations.
  #
  #     Note: The following fields are mutually exclusive: `global_endpoint`, `region_id`, `multi_region_id`. If a field in that set is populated, all other fields in the set will automatically be cleared.
  # @!attribute [r] multi_region_id
  #   @return [::String]
  #     Output only. The SKU applies to a multi-region.
  #
  #     Note: The following fields are mutually exclusive: `multi_region_id`, `region_id`, `global_endpoint`. If a field in that set is populated, all other fields in the set will automatically be cleared.
  class AiPlatformManagedModelEndpointLocation
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end
end

#ai_platform_managed_model_usage_fee::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee (readonly)

Returns Output only. The SKU prices usage of an AI Platform Managed Model (MaaS).

Note: The following fields are mutually exclusive: ai_platform_managed_model_usage_fee, inactive, managed_service_metric_usage_fee, gce_license_usage_fee, gke_pod_usage_fee, ai_platform_provisioned_throughput_fee, ai_platform_deployed_model_usage_fee, flat_subscription_fee. If a field in that set is populated, all other fields in the set will automatically be cleared.

Returns:

  • (::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee)

    Output only. The SKU prices usage of an AI Platform Managed Model (MaaS).

    Note: The following fields are mutually exclusive: ai_platform_managed_model_usage_fee, inactive, managed_service_metric_usage_fee, gce_license_usage_fee, gke_pod_usage_fee, ai_platform_provisioned_throughput_fee, ai_platform_deployed_model_usage_fee, flat_subscription_fee. If a field in that set is populated, all other fields in the set will automatically be cleared.



125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
# File 'proto_docs/google/cloud/commerceproducer/v1beta/sku.rb', line 125

class SkuPrice
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # Representation for a SKU that is not active and has no price.
  class InactiveSkuPrice
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Details about a SKU pricing usage of a [partner-reported custom billing
  # metric](https://cloud.google.com/service-infrastructure/docs/reporting-billing-metrics)
  # defined by the partner in the Service Management API and reported using
  # the Service Control API.
  #
  # The customer's usage charge is computed by converting the customer's
  # reported consumption to the SKU's composite price unit and applying the
  # graduated price from the appropriate price tier.
  # @!attribute [r] tiered_price
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::TieredPrice]
  #     Output only. [Tiered
  #     pricing](https://cloud.google.com/billing/docs/how-to/pricing-table#tiered-pricing)
  #     of the SKU.
  # @!attribute [r] canonical_metric
  #   @return [::String]
  #     Output only. The name of the metric, in canonical format.
  #
  #     Note that in the canonical format the first character of the path
  #     component of the metric name is always uppercase, which may differ
  #     from the metric name in the service config. For example, a metric
  #     appearing in the service config as 'example.com/example_metric' will
  #     appear here in the SKU as 'example.com/Example_metric'. In the Service
  #     Management and Service Control APIs these two metric names are
  #     considered distinct, either or both may be defined, and usage must be
  #     reported using a name matching the name of a metric defined in the
  #     service config. But for billing purposes usage reported using either
  #     name will be aggregated under the canonical metric name.
  #
  #     Example: "example.com/Example_metric"
  class ManagedServiceMetricUsageFee
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Details about a SKU pricing usage of a [Compute Engine
  # License](https://cloud.google.com/compute/docs/licenses/about).
  #
  # The SKU applies to a single license, and may be further scoped to a
  # [Compute
  # Engine VM Instance](https://cloud.google.com/compute/docs/instances)
  # machine resource type (e.g. "vCPU") and size range for that machine
  # resource. Instances deployed from [Compute
  # Engine Images](https://cloud.google.com/compute/docs/images)
  # incorporating the target license and (if applicable) matching the machine
  # resource type size range will be charged by the SKU. A single license may
  # be priced by multiple SKUs covering different combinations of machine
  # resource type and size range, allowing a single running instance to be
  # charged by up to one SKU per machine resource type, with pricing tiered
  # according to machine shape.
  # @!attribute [rw] price_per_unit
  #   @return [::Google::Type::Money]
  #     The price per unit of usage.
  #     The customer's usage charge is computed by measuring the customer's
  #     consumption denominated in price units and multiplying by this price.
  # @!attribute [r] license_code
  #   @return [::String]
  #     Output only. The license code of the target Compute Engine License.
  #     Note that this is the numeric license code itself in uint64 format used
  #     to reference licenses attached to images, not the resource name of the
  #     related [Compute Engine LicenseCode
  #     resource](https://cloud.google.com/compute/docs/reference/rest/v1/licenseCodes).
  #
  #     Example: "1234567890123456789"
  # @!attribute [r] machine_resource
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::ComputeEngineLicenseUsageFee::MachineResource]
  #     Output only. The machine resource type that the SKU applies to, if any.
  #     SKUs with a non-default value are referred to as "resource-based" SKUs.
  # @!attribute [r] machine_resource_range
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::ComputeEngineLicenseUsageFee::MachineResourceRange]
  #     Output only. The range of machine resource values that the SKU applies
  #     to. Unset when the SKU is not scoped to a particular machine resource
  #     type. The collection of SKUs in effect at any given time targeting the
  #     same license and machine resource type will cover all possible values
  #     for that machine resource type without overlap. Such a collection of
  #     SKUs form a "tiered" price structure over the possible values of the
  #     machine resource, with each SKU acting as a "tier".
  #
  #     NOTE: This is distinct from a SKU with [tiered
  #     pricing](https://cloud.google.com/billing/docs/how-to/pricing-table#tiered-pricing).
  # @!attribute [r] usage_calculation
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::ComputeEngineLicenseUsageFee::UsageCalculation]
  #     Output only. Determines how the customer's usage is calculated.
  # @!attribute [r] unit
  #   @return [::String]
  #     Output only. The price unit of the SKU.
  #     See https://ucum.org/ucum.html for the format of the price unit.
  #     For linear-priced memory SKUs, the price unit is 'GiBy.h'.
  #     For all other SKUs, the price unit is 'h'. This includes linear-priced
  #     vCPU and GPU SKUs because these resources have unitless dimensions and
  #     the application of these scaling factors does not change the price
  #     unit.
  class ComputeEngineLicenseUsageFee
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # The range of machine resource values that the SKU applies to.
    # @!attribute [r] start_value
    #   @return [::Integer]
    #     Output only. The inclusive lower bound of the range.
    #     While the number zero may be the start of a range, it is not a
    #     possible machine resource value. An instance cannot exist with zero
    #     vCPU or memory, and an instance with no attached accelerators lacks a
    #     GPU dimension entirely rather than having a GPU count of zero.
    # @!attribute [r] end_value
    #   @return [::Integer]
    #     Output only. The exclusive upper bound of the range.
    #     If no end value is specified, the range is unbounded from above.
    class MachineResourceRange
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # The machine resource type that the SKU applies to, if any.
    module MachineResource
      # The SKU applies to all instances irrespective of machine shape.
      # This is referred to as "instance-based pricing" because the price
      # is the same for all instances.
      MACHINE_RESOURCE_UNSPECIFIED = 0

      # The SKU applies based on the instance's vCPU count.
      VCPU_COUNT = 1

      # The SKU applies based on the instance's memory size in bytes.
      MEMORY_BYTES = 2

      # The SKU applies based on the instance's GPU count.
      GPU_COUNT = 3
    end

    # Determines how the customer's usage is calculated.
    module UsageCalculation
      # Unused.
      USAGE_CALCULATION_UNSPECIFIED = 0

      # Usage is calculated from instance runtime.
      # The customer's usage is metered according to the [Compute Engine VM
      # instance pricing
      # model](https://cloud.google.com/compute/vm-instance-pricing),
      # measured on a per-instance basis in units of hours, with a minimum
      # duration of one minute and an increment of one second.
      #
      # A SKU using this usage calculation is referred to as "flat" because
      # the customer's usage charge is independent of the instance's machine
      # resource shape apart from determining whether the SKU applies to the
      # instance.
      INSTANCE_RUNTIME = 1

      # Usage is calculated from instance runtime and size.
      # This calculation mode is only applicable to resource-based SKUs.
      # Usage is calculated by measuring the instance runtime in the same
      # manner as for `INSTANCE_RUNTIME` and multiplying by the instance's
      # machine resource value matching the SKU's machine resource type.
      # This converts the price from per-instance-hour to
      # per-instance-hour-per-machine-resource, which changes the price unit
      # for memory SKUs to 'GiBy.h'. The price unit otherwise remains 'h'
      # because the other machine resources are dimensionless.
      #
      # A SKU using this usage calculation is referred to as "linear" because
      # the customer's usage charge is linearly proportional to the
      # instance's machine resource value.
      LINEAR_RESOURCE_SCALED_INSTANCE_RUNTIME = 2
    end
  end

  # Details about a SKU pricing usage of software running on a Kubernetes
  # Engine pod.
  #
  # The SKU applies to pods annotated with the SKU's parent service name, and
  # may be further scoped to a [k8s pod resource
  # type](https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/)
  # (e.g. "CPU") and size range for that resource type. Running pods
  # annotated with the parent service's service name and matching the pod
  # resource type size range will be charged by the SKU. A service may be
  # priced by multiple SKUs covering different combinations of pod resource
  # type and size range, allowing a single running pod to be charged by up to
  # one SKU per pod resource type, with pricing tiered according to pod
  # shape.
  # @!attribute [rw] price_per_unit
  #   @return [::Google::Type::Money]
  #     The price per unit of usage.
  #     The customer's usage charge is computed by measuring the customer's
  #     consumption denominated in price units and multiplying by this price.
  # @!attribute [r] pod_resource
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::KubernetesEnginePodUsageFee::PodResource]
  #     Output only. The pod resource type that the SKU applies to.
  #     SKUs with a non-default value are referred to as "resource-based" SKUs.
  # @!attribute [r] pod_resource_range
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::KubernetesEnginePodUsageFee::PodResourceRange]
  #     Output only. The range of pod resource values that the SKU applies to.
  #     The collection of SKUs in effect at any given time targeting the same
  #     service annotation and pod resource type will cover all possible values
  #     for that pod resource type without overlap. Such a collection of SKUs
  #     form a "tiered" price structure over the possible values of the pod
  #     resource, with each SKU acting as a "tier".
  #
  #     NOTE: This is distinct from a SKU with [tiered
  #     pricing](https://cloud.google.com/billing/docs/how-to/pricing-table#tiered-pricing).
  # @!attribute [r] usage_calculation
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::KubernetesEnginePodUsageFee::UsageCalculation]
  #     Output only. Determines how the customer's usage is calculated.
  # @!attribute [r] unit
  #   @return [::String]
  #     Output only. The price unit of the SKU.
  #     See https://ucum.org/ucum.html for the format of the price unit.
  #     For linear-priced memory SKUs, the price unit is 'GiBy.h'.
  #     For all other SKUs, the price unit is 'h'. This includes linear-priced
  #     VCPU, GPU, and TPU SKUs because these resources have unitless
  #     dimensions and the application of these scaling factors does not change
  #     the price unit.
  class KubernetesEnginePodUsageFee
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # The range of pod resource values that the SKU applies to.
    # @!attribute [r] start_value
    #   @return [::Integer]
    #     Output only. The inclusive lower bound of the range.
    # @!attribute [r] end_value
    #   @return [::Integer]
    #     Output only. The exclusive upper bound of the range.
    #     If no end value is specified, the range is unbounded from above.
    class PodResourceRange
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # The pod [resource
    # type](https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/)
    # that the SKU applies to.
    module PodResource
      # Unused.
      POD_RESOURCE_UNSPECIFIED = 0

      # The SKU applies based on the pod's [vCPU
      # count](https://kubernetes.io/docs/tasks/configure-pod-container/assign-cpu-resource/).
      VCPU_COUNT = 1

      # The SKU applies based on the pod's [memory
      # size](https://kubernetes.io/docs/tasks/configure-pod-container/assign-memory-resource/)
      # in bytes.
      MEMORY_BYTES = 2

      # The SKU applies based on the pod's GPU count.
      GPU_COUNT = 3

      # The SKU applies based on the pod's [TPU
      # count](https://cloud.google.com/kubernetes-engine/docs/concepts/tpus#how_tpus_work).
      TPU_COUNT = 4
    end

    # Determines how the customer's usage is calculated.
    module UsageCalculation
      # Unused.
      USAGE_CALCULATION_UNSPECIFIED = 0

      # Usage is calculated from pod runtime.
      # The customer's usage is metered in a manner similar to the [GKE
      # Autopilot mode for pods without specific hardware
      # requirements](https://cloud.google.com/kubernetes-engine/pricing),
      # priced on a per-pod basis in units of hours and measured in
      # one-second increments, with no minimum duration.
      #
      # A SKU using this usage calculation is referred to as "flat" because
      # the customer's usage charge is independent of the pod shape apart
      # from determining whether the SKU applies to the pod.
      POD_RUNTIME = 1

      # Usage is calculated from pod runtime and size.
      # This calculation mode is only applicable to resource-based SKUs.
      # Usage is calculated by measuring the pod runtime in the same manner
      # as for `POD_RUNTIME` and multiplying by the pod's resource value
      # matching the SKU's pod resource type.
      # This converts the price from per-pod-hour to
      # per-pod-hour-per-resource, which changes the price unit for memory
      # SKUs to 'GiBy.h'. The price unit otherwise remains 'h' because the
      # other resources are dimensionless.
      #
      # A SKU using this usage calculation is referred to as "linear" because
      # the customer's usage charge is linearly proportional to the
      # pod's resource value.
      LINEAR_RESOURCE_SCALED_POD_RUNTIME = 2
    end
  end

  # Details about a SKU pricing usage of an [AI Platform Managed Model
  # (MaaS)](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/partner-models/use-partner-models).
  # @!attribute [r] tiered_price
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::TieredPrice]
  #     Output only. [Tiered
  #     pricing](https://cloud.google.com/billing/docs/how-to/pricing-table#tiered-pricing)
  #     of the SKU.
  # @!attribute [r] usage_metric
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::AiPlatformManagedModelUsageMetric]
  #     Output only. The usage metric that the SKU applies to.
  # @!attribute [r] location
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelEndpointLocation]
  #     Output only. The model endpoint location where usage is priced by this
  #     SKU. If no location is specified, the SKU applies to usage in all
  #     locations.
  # @!attribute [r] prediction_mode
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::PredictionMode]
  #     Output only. The prediction mode of requests that the SKU applies to.
  # @!attribute [r] combined_request_input_tokens_range
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::CombinedRequestInputTokensRange]
  #     Output only. The range of aggregated input token values covered by the
  #     SKU. Unset if the SKU is not scoped to a particular range. A request is
  #     in scope for this SKU if its aggregated input token value falls within
  #     the range. The collection of SKUs in effect at any given time scoped to
  #     a particular aggregated input token value range will cover all possible
  #     values without overlap. Such a collection of SKUs form a "tiered" price
  #     structure over the possible value, with each SKU acting as a "tier".
  #
  #     NOTE: This is distinct from a SKU with [tiered
  #     pricing](https://cloud.google.com/billing/docs/how-to/pricing-table#tiered-pricing).
  # @!attribute [r] provisioned_throughput_overage
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::ProvisionedThroughputOverage]
  #     Output only. Set when the SKU is a historical provisioned throughput
  #     overage SKU. Starting 2025-08-26 such SKUs have no effect, and usage in
  #     excess of provisioned throughput quota is now metered as standard
  #     usage. This field is set only in historical SKU timeline entries for
  #     overage SKUs belonging to partners that offered provisioned throughput
  #     for AI Platform managed model products prior to the unification of
  #     standard usage and provisioned throughput overage metering.
  class AiPlatformManagedModelUsageFee
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # The usage metric that the SKU applies to.
    # @!attribute [r] input_tokens_metric
    #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::AiPlatformManagedModelUsageMetric::InputTokensMetric]
    #     Output only. Input tokens read from the prediction endpoint input.
    #
    #     Note: The following fields are mutually exclusive: `input_tokens_metric`, `cache_read_input_tokens_metric`, `cache_write_input_tokens_metric`, `output_tokens_metric`, `web_search_requests_metric`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] cache_read_input_tokens_metric
    #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::AiPlatformManagedModelUsageMetric::CacheReadInputTokensMetric]
    #     Output only. Input tokens read from the cache.
    #
    #     Note: The following fields are mutually exclusive: `cache_read_input_tokens_metric`, `input_tokens_metric`, `cache_write_input_tokens_metric`, `output_tokens_metric`, `web_search_requests_metric`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] cache_write_input_tokens_metric
    #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::AiPlatformManagedModelUsageMetric::CacheWriteInputTokensMetric]
    #     Output only. Input tokens written to the cache.
    #
    #     Note: The following fields are mutually exclusive: `cache_write_input_tokens_metric`, `input_tokens_metric`, `cache_read_input_tokens_metric`, `output_tokens_metric`, `web_search_requests_metric`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] output_tokens_metric
    #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::AiPlatformManagedModelUsageMetric::OutputTokensMetric]
    #     Output only. Output tokens returned from the prediction endpoint.
    #
    #     Note: The following fields are mutually exclusive: `output_tokens_metric`, `input_tokens_metric`, `cache_read_input_tokens_metric`, `cache_write_input_tokens_metric`, `web_search_requests_metric`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] web_search_requests_metric
    #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::AiPlatformManagedModelUsageMetric::WebSearchRequestsMetric]
    #     Output only. Web search requests executed by the model.
    #
    #     Note: The following fields are mutually exclusive: `web_search_requests_metric`, `input_tokens_metric`, `cache_read_input_tokens_metric`, `cache_write_input_tokens_metric`, `output_tokens_metric`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    class AiPlatformManagedModelUsageMetric
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # Input tokens read from the input to the prediction endpoint.
      # The unit for this metric is dimensionless.
      class InputTokensMetric
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end

      # Input tokens read from the cache.
      # The unit for this metric is dimensionless.
      class CacheReadInputTokensMetric
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end

      # Input tokens written to the cache.
      # The unit for this metric is dimensionless.
      # @!attribute [r] ttl
      #   @return [::Google::Protobuf::Duration]
      #     Output only. The duration the write is retained in the cache.
      class CacheWriteInputTokensMetric
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end

      # Output tokens returned from the prediction endpoint.
      # The unit for this metric is dimensionless.
      class OutputTokensMetric
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end

      # Web search requests executed by the model.
      # The unit for this metric is dimensionless.
      class WebSearchRequestsMetric
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end
    end

    # The range of aggregated input token values covered by the SKU.
    #
    # A request to a managed model has an aggregated input token value
    # determined by the sum of the metric values of the input token metrics.
    #
    # * input tokens
    # * cache read input tokens
    # * cache write input tokens
    # @!attribute [r] start_value
    #   @return [::Integer]
    #     Output only. The inclusive lower bound of the range.
    # @!attribute [r] end_value
    #   @return [::Integer]
    #     Output only. The exclusive upper bound of the range.
    #     If no end value is specified, the range is unbounded from above.
    class CombinedRequestInputTokensRange
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # Additional details present for historical provisioned throughput
    # "overage" SKUs that applied charges only to usage above the customer's
    # provisioned throughput quota threshold.
    # @!attribute [r] service
    #   @return [::String]
    #     Output only. The service whose usage the overage SKU applied to.
    class ProvisionedThroughputOverage
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # The prediction modes of requests that the SKU applies to.
    module PredictionMode
      # The SKU does not distinguish between prediction modes.
      PREDICTION_MODE_UNSPECIFIED = 0

      # The SKU applies to online prediction.
      ONLINE_PREDICTION = 1

      # The SKU applies to batch prediction.
      BATCH_PREDICTION = 2
    end
  end

  # Details about a SKU pricing reservation of [AI Platform Provisioned
  # Throughput](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/provisioned-throughput).
  #
  # Customers may purchase provisioned throughput reservations for AI
  # Platform managed model products. This provides the customer with
  # provisioned throughput quota for a particular model and location. Model
  # usage below the provisioned throughput quota threshold is voided and is
  # not charged by the product's managed model usage fees.
  # @!attribute [r] term_duration_months
  #   @return [::Integer]
  #     Output only. The duration of the provisioned throughput reservation
  #     in months.
  # @!attribute [rw] gsu_price_per_unit
  #   @return [::Google::Type::Money]
  #     The price per [Generative AI Scale Unit
  #     (GSU)](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/provisioned-throughput/measure-provisioned-throughput)
  #     per `unit`.
  #     A provisioned throughput reservation reserves a certain number of
  #     GSUs, and the customer is billed for those GSUs on a continuous basis
  #     for the duration of the reservation.
  # @!attribute [r] location
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelEndpointLocation]
  #     Output only. The location where provisioned throughput is priced by
  #     this SKU.
  # @!attribute [r] unit
  #   @return [::String]
  #     Output only. The price unit of the SKU.
  #     See https://ucum.org/ucum.html for the format of the price unit.
  #     Since provisioned throughput reservations are billed by duration, this
  #     will always be a time unit. The price unit of a provisioned throughput
  #     SKU is not necessarily the same as the reservation term.
  #     This field is unrelated to the [Generative AI Scale Unit
  #     (GSU)](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/provisioned-throughput/measure-provisioned-throughput).
  #
  #     Currently the unit is always months ('mo').
  #     Additional time units may be supported in future.
  #
  #     The customary unit month ('mo') requires special handling to account
  #     for the variable duration of months. A price may be denominated in
  #     units of months, but the duration the reservation is active is measured
  #     in metric time and customers are billed on that basis. The exact hourly
  #     or per-second price can be calculated by dividing the monthly price
  #     by the number of hours or seconds in the desired month. A reservation
  #     active for N months is rarely billed exactly N times the monthly price.
  #     This is intended and is not a billing error.
  class AiPlatformProvisionedThroughputFee
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Details about a SKU pricing usage of an [AI Platform Self Deployed
  # Model](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/model-garden/self-deployed-models).
  # @!attribute [r] accelerator_type
  #   @return [::String]
  #     Output only. The SKU applies to a specific accelerator type.
  #     Contains the name of the matching [AI Platform AcceleratorType](
  #     https://docs.cloud.google.com/gemini-enterprise-agent-platform/reference/rest/v1/MachineSpec#AcceleratorType).
  #     The corresponding linear scaling value is the dimensionless
  #     [`accelerator_count`](https://docs.cloud.google.com/gemini-enterprise-agent-platform/reference/rest/v1/MachineSpec#FIELDS.accelerator_count).
  # @!attribute [r] price_per_unit
  #   @return [::Google::Type::Money]
  #     Output only. The price per unit of usage.
  #     The customer's usage charge is computed by measuring the customer's
  #     consumption denominated in price units and multiplying by this price.
  # @!attribute [r] unit
  #   @return [::String]
  #     Output only. The price unit of the SKU.
  #     See https://ucum.org/ucum.html for the format of the price unit.
  #     Currently the unit is always hours ('h'). This may change in future.
  # @!attribute [r] usage_calculation
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformDeployedModelUsageFee::UsageCalculation]
  #     Output only. Determines how the customer's usage is calculated.
  class AiPlatformDeployedModelUsageFee
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Determines how the customer's usage is calculated.
    module UsageCalculation
      # Unused.
      USAGE_CALCULATION_UNSPECIFIED = 0

      # Usage is calculated from deployment runtime and size.
      # Usage is calculated by measuring the deployment runtime in hours and
      # multiplying by the amount of the deployed model's hardware resource
      # matching the SKU's hardware resource type.
      # This results in a composite `unit` of hours ('h') multiplied by the
      # unit that denominates the hardware resource, though note that
      # multiplying by the dimensionless unit ("1") has no effect.
      LINEAR_RESOURCE_SCALED_DEPLOYMENT_RUNTIME = 2
    end
  end

  # Details about a SKU charging a flat subscription fee.
  # @!attribute [r] price_per_unit
  #   @return [::Google::Type::Money]
  #     Output only. The price per time unit the subscription is active.
  # @!attribute [r] unit
  #   @return [::String]
  #     Output only. The unit of the subscription SKU.
  #     See https://ucum.org/ucum.html for the format of the price unit.
  #     Since subscriptions are billed by duration, this will always be a time
  #     unit. The price unit of a subscription SKU is not necessarily the same
  #     as the subscription period of the corresponding StandardOffers.
  #
  #     Currently the unit is always months ('mo').
  #     Additional time units may be supported in future.
  #
  #     The unit month ('mo') is a customary time unit and requires special
  #     handling to account for the variable duration of months. A price may be
  #     denominated in units of months, but the duration the subscription is
  #     active is measured in metric time and customers are billed on that
  #     basis. The exact hourly or per-second price can be calculated by
  #     dividing the monthly price by the number of hours or seconds in the
  #     desired month. A subscription active for N months is rarely billed
  #     exactly N times the monthly price. This is intended and is not a
  #     billing error.
  class FlatSubscriptionFee
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Price structure for a SKU charging a [tiered
  # price](https://cloud.google.com/billing/docs/how-to/pricing-table#tiered-pricing).
  # @!attribute [r] unit
  #   @return [::String]
  #     Output only. Usage unit used for defining price tiers and for scaling
  #     with the price_unit_count to form the composite price unit.
  #
  #     See https://ucum.org/ucum.html for the format of the price unit.
  #     A unitless dimension, such as a count, is represented as `1`.
  # @!attribute [r] unit_description
  #   @return [::String]
  #     Output only. The display description of the unit, supplied at time of
  #     onboarding. This value is recommended to be set at least for
  #     dimensionless metrics, but may be empty if no description was provided
  #     at time of onboarding.
  # @!attribute [r] price_unit_count
  #   @return [::Google::Type::Decimal]
  #     Output only. Scaling  the `unit` by the `price_unit_count` forms the
  #     composite "price unit" which is priced by the price tiers.
  #
  #     This scaling factor is in addition to any numerical prefix symbol on
  #     the `unit`, so the same composite "price unit" can be represented in
  #     several ways, differing only in their presentation to users.
  #
  #     Examples:
  #
  #     * $1    per 1    bytes     : unit = By,  price_unit_count = 1
  #     * $1000 per 1    kilobytes : unit = kBy, price_unit_count = 1
  #     * $5000 per 5    kilobytes : unit = kBy, price_unit_count = 5
  # @!attribute [r] price_tiers
  #   @return [::Array<::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::TieredPrice::PriceTier>]
  #     Output only. The list of price tiers for the SKU, ordered by the
  #     start_amount.
  #
  #     The tiers are non-overlapping and are collectively bounded below by
  #     zero and unbounded above to cover the entire range of possible metric
  #     usage. Each tier is bounded below inclusively by its start_amount and
  #     bounded above exclusively by the start_amount of the next tier, or else
  #     unbounded above if there is no next tier.
  #
  #     Usage of the metric is aggregated by customer billing account on a
  #     monthly basis and billed in a graduated manner according to the price
  #     tiers, with each marginal unit of usage priced accoring to the tier in
  #     which it falls.
  class TieredPrice
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # A [price
    # tier](https://cloud.google.com/billing/docs/how-to/pricing-table#tiered-pricing)
    # pricing metric usage within a range.
    #
    # Each marginal unit of usage is priced according to the price tier in
    # which it falls.
    # @!attribute [r] start_amount
    #   @return [::Google::Type::Decimal]
    #     Output only. Inclusive lower bound of the tier interval, denominated
    #     in `unit`.
    # @!attribute [r] price
    #   @return [::Google::Type::Money]
    #     Output only. The price per `price_unit_count` of `unit` in the tier.
    #     The price is applied fractionally if the customer's usage within the
    #     tier is not an integer multiple of `price_unit_count`.
    class PriceTier
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end
  end

  # Location scope for a SKU that applies to an AI Platform Managed Model
  # endpoint.
  # @!attribute [r] region_id
  #   @return [::String]
  #     Output only. The SKU applies to a region.
  #
  #     Note: The following fields are mutually exclusive: `region_id`, `global_endpoint`, `multi_region_id`. If a field in that set is populated, all other fields in the set will automatically be cleared.
  # @!attribute [r] global_endpoint
  #   @return [::Boolean]
  #     Output only. The SKU applies to a [global
  #     endpoint](https://docs.cloud.google.com/gemini-enterprise-agent-platform/resources/locations).
  #     **Note**: This is distinct from the conventional meaning of "global"
  #     as a SKU that applies to all locations.
  #
  #     Note: The following fields are mutually exclusive: `global_endpoint`, `region_id`, `multi_region_id`. If a field in that set is populated, all other fields in the set will automatically be cleared.
  # @!attribute [r] multi_region_id
  #   @return [::String]
  #     Output only. The SKU applies to a multi-region.
  #
  #     Note: The following fields are mutually exclusive: `multi_region_id`, `region_id`, `global_endpoint`. If a field in that set is populated, all other fields in the set will automatically be cleared.
  class AiPlatformManagedModelEndpointLocation
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end
end

#ai_platform_provisioned_throughput_fee::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformProvisionedThroughputFee (readonly)

Returns Output only. The SKU prices reservation of AI Platform provisioned throughput.

Note: The following fields are mutually exclusive: ai_platform_provisioned_throughput_fee, inactive, managed_service_metric_usage_fee, gce_license_usage_fee, gke_pod_usage_fee, ai_platform_managed_model_usage_fee, ai_platform_deployed_model_usage_fee, flat_subscription_fee. If a field in that set is populated, all other fields in the set will automatically be cleared.

Returns:

  • (::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformProvisionedThroughputFee)

    Output only. The SKU prices reservation of AI Platform provisioned throughput.

    Note: The following fields are mutually exclusive: ai_platform_provisioned_throughput_fee, inactive, managed_service_metric_usage_fee, gce_license_usage_fee, gke_pod_usage_fee, ai_platform_managed_model_usage_fee, ai_platform_deployed_model_usage_fee, flat_subscription_fee. If a field in that set is populated, all other fields in the set will automatically be cleared.



125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
# File 'proto_docs/google/cloud/commerceproducer/v1beta/sku.rb', line 125

class SkuPrice
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # Representation for a SKU that is not active and has no price.
  class InactiveSkuPrice
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Details about a SKU pricing usage of a [partner-reported custom billing
  # metric](https://cloud.google.com/service-infrastructure/docs/reporting-billing-metrics)
  # defined by the partner in the Service Management API and reported using
  # the Service Control API.
  #
  # The customer's usage charge is computed by converting the customer's
  # reported consumption to the SKU's composite price unit and applying the
  # graduated price from the appropriate price tier.
  # @!attribute [r] tiered_price
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::TieredPrice]
  #     Output only. [Tiered
  #     pricing](https://cloud.google.com/billing/docs/how-to/pricing-table#tiered-pricing)
  #     of the SKU.
  # @!attribute [r] canonical_metric
  #   @return [::String]
  #     Output only. The name of the metric, in canonical format.
  #
  #     Note that in the canonical format the first character of the path
  #     component of the metric name is always uppercase, which may differ
  #     from the metric name in the service config. For example, a metric
  #     appearing in the service config as 'example.com/example_metric' will
  #     appear here in the SKU as 'example.com/Example_metric'. In the Service
  #     Management and Service Control APIs these two metric names are
  #     considered distinct, either or both may be defined, and usage must be
  #     reported using a name matching the name of a metric defined in the
  #     service config. But for billing purposes usage reported using either
  #     name will be aggregated under the canonical metric name.
  #
  #     Example: "example.com/Example_metric"
  class ManagedServiceMetricUsageFee
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Details about a SKU pricing usage of a [Compute Engine
  # License](https://cloud.google.com/compute/docs/licenses/about).
  #
  # The SKU applies to a single license, and may be further scoped to a
  # [Compute
  # Engine VM Instance](https://cloud.google.com/compute/docs/instances)
  # machine resource type (e.g. "vCPU") and size range for that machine
  # resource. Instances deployed from [Compute
  # Engine Images](https://cloud.google.com/compute/docs/images)
  # incorporating the target license and (if applicable) matching the machine
  # resource type size range will be charged by the SKU. A single license may
  # be priced by multiple SKUs covering different combinations of machine
  # resource type and size range, allowing a single running instance to be
  # charged by up to one SKU per machine resource type, with pricing tiered
  # according to machine shape.
  # @!attribute [rw] price_per_unit
  #   @return [::Google::Type::Money]
  #     The price per unit of usage.
  #     The customer's usage charge is computed by measuring the customer's
  #     consumption denominated in price units and multiplying by this price.
  # @!attribute [r] license_code
  #   @return [::String]
  #     Output only. The license code of the target Compute Engine License.
  #     Note that this is the numeric license code itself in uint64 format used
  #     to reference licenses attached to images, not the resource name of the
  #     related [Compute Engine LicenseCode
  #     resource](https://cloud.google.com/compute/docs/reference/rest/v1/licenseCodes).
  #
  #     Example: "1234567890123456789"
  # @!attribute [r] machine_resource
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::ComputeEngineLicenseUsageFee::MachineResource]
  #     Output only. The machine resource type that the SKU applies to, if any.
  #     SKUs with a non-default value are referred to as "resource-based" SKUs.
  # @!attribute [r] machine_resource_range
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::ComputeEngineLicenseUsageFee::MachineResourceRange]
  #     Output only. The range of machine resource values that the SKU applies
  #     to. Unset when the SKU is not scoped to a particular machine resource
  #     type. The collection of SKUs in effect at any given time targeting the
  #     same license and machine resource type will cover all possible values
  #     for that machine resource type without overlap. Such a collection of
  #     SKUs form a "tiered" price structure over the possible values of the
  #     machine resource, with each SKU acting as a "tier".
  #
  #     NOTE: This is distinct from a SKU with [tiered
  #     pricing](https://cloud.google.com/billing/docs/how-to/pricing-table#tiered-pricing).
  # @!attribute [r] usage_calculation
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::ComputeEngineLicenseUsageFee::UsageCalculation]
  #     Output only. Determines how the customer's usage is calculated.
  # @!attribute [r] unit
  #   @return [::String]
  #     Output only. The price unit of the SKU.
  #     See https://ucum.org/ucum.html for the format of the price unit.
  #     For linear-priced memory SKUs, the price unit is 'GiBy.h'.
  #     For all other SKUs, the price unit is 'h'. This includes linear-priced
  #     vCPU and GPU SKUs because these resources have unitless dimensions and
  #     the application of these scaling factors does not change the price
  #     unit.
  class ComputeEngineLicenseUsageFee
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # The range of machine resource values that the SKU applies to.
    # @!attribute [r] start_value
    #   @return [::Integer]
    #     Output only. The inclusive lower bound of the range.
    #     While the number zero may be the start of a range, it is not a
    #     possible machine resource value. An instance cannot exist with zero
    #     vCPU or memory, and an instance with no attached accelerators lacks a
    #     GPU dimension entirely rather than having a GPU count of zero.
    # @!attribute [r] end_value
    #   @return [::Integer]
    #     Output only. The exclusive upper bound of the range.
    #     If no end value is specified, the range is unbounded from above.
    class MachineResourceRange
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # The machine resource type that the SKU applies to, if any.
    module MachineResource
      # The SKU applies to all instances irrespective of machine shape.
      # This is referred to as "instance-based pricing" because the price
      # is the same for all instances.
      MACHINE_RESOURCE_UNSPECIFIED = 0

      # The SKU applies based on the instance's vCPU count.
      VCPU_COUNT = 1

      # The SKU applies based on the instance's memory size in bytes.
      MEMORY_BYTES = 2

      # The SKU applies based on the instance's GPU count.
      GPU_COUNT = 3
    end

    # Determines how the customer's usage is calculated.
    module UsageCalculation
      # Unused.
      USAGE_CALCULATION_UNSPECIFIED = 0

      # Usage is calculated from instance runtime.
      # The customer's usage is metered according to the [Compute Engine VM
      # instance pricing
      # model](https://cloud.google.com/compute/vm-instance-pricing),
      # measured on a per-instance basis in units of hours, with a minimum
      # duration of one minute and an increment of one second.
      #
      # A SKU using this usage calculation is referred to as "flat" because
      # the customer's usage charge is independent of the instance's machine
      # resource shape apart from determining whether the SKU applies to the
      # instance.
      INSTANCE_RUNTIME = 1

      # Usage is calculated from instance runtime and size.
      # This calculation mode is only applicable to resource-based SKUs.
      # Usage is calculated by measuring the instance runtime in the same
      # manner as for `INSTANCE_RUNTIME` and multiplying by the instance's
      # machine resource value matching the SKU's machine resource type.
      # This converts the price from per-instance-hour to
      # per-instance-hour-per-machine-resource, which changes the price unit
      # for memory SKUs to 'GiBy.h'. The price unit otherwise remains 'h'
      # because the other machine resources are dimensionless.
      #
      # A SKU using this usage calculation is referred to as "linear" because
      # the customer's usage charge is linearly proportional to the
      # instance's machine resource value.
      LINEAR_RESOURCE_SCALED_INSTANCE_RUNTIME = 2
    end
  end

  # Details about a SKU pricing usage of software running on a Kubernetes
  # Engine pod.
  #
  # The SKU applies to pods annotated with the SKU's parent service name, and
  # may be further scoped to a [k8s pod resource
  # type](https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/)
  # (e.g. "CPU") and size range for that resource type. Running pods
  # annotated with the parent service's service name and matching the pod
  # resource type size range will be charged by the SKU. A service may be
  # priced by multiple SKUs covering different combinations of pod resource
  # type and size range, allowing a single running pod to be charged by up to
  # one SKU per pod resource type, with pricing tiered according to pod
  # shape.
  # @!attribute [rw] price_per_unit
  #   @return [::Google::Type::Money]
  #     The price per unit of usage.
  #     The customer's usage charge is computed by measuring the customer's
  #     consumption denominated in price units and multiplying by this price.
  # @!attribute [r] pod_resource
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::KubernetesEnginePodUsageFee::PodResource]
  #     Output only. The pod resource type that the SKU applies to.
  #     SKUs with a non-default value are referred to as "resource-based" SKUs.
  # @!attribute [r] pod_resource_range
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::KubernetesEnginePodUsageFee::PodResourceRange]
  #     Output only. The range of pod resource values that the SKU applies to.
  #     The collection of SKUs in effect at any given time targeting the same
  #     service annotation and pod resource type will cover all possible values
  #     for that pod resource type without overlap. Such a collection of SKUs
  #     form a "tiered" price structure over the possible values of the pod
  #     resource, with each SKU acting as a "tier".
  #
  #     NOTE: This is distinct from a SKU with [tiered
  #     pricing](https://cloud.google.com/billing/docs/how-to/pricing-table#tiered-pricing).
  # @!attribute [r] usage_calculation
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::KubernetesEnginePodUsageFee::UsageCalculation]
  #     Output only. Determines how the customer's usage is calculated.
  # @!attribute [r] unit
  #   @return [::String]
  #     Output only. The price unit of the SKU.
  #     See https://ucum.org/ucum.html for the format of the price unit.
  #     For linear-priced memory SKUs, the price unit is 'GiBy.h'.
  #     For all other SKUs, the price unit is 'h'. This includes linear-priced
  #     VCPU, GPU, and TPU SKUs because these resources have unitless
  #     dimensions and the application of these scaling factors does not change
  #     the price unit.
  class KubernetesEnginePodUsageFee
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # The range of pod resource values that the SKU applies to.
    # @!attribute [r] start_value
    #   @return [::Integer]
    #     Output only. The inclusive lower bound of the range.
    # @!attribute [r] end_value
    #   @return [::Integer]
    #     Output only. The exclusive upper bound of the range.
    #     If no end value is specified, the range is unbounded from above.
    class PodResourceRange
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # The pod [resource
    # type](https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/)
    # that the SKU applies to.
    module PodResource
      # Unused.
      POD_RESOURCE_UNSPECIFIED = 0

      # The SKU applies based on the pod's [vCPU
      # count](https://kubernetes.io/docs/tasks/configure-pod-container/assign-cpu-resource/).
      VCPU_COUNT = 1

      # The SKU applies based on the pod's [memory
      # size](https://kubernetes.io/docs/tasks/configure-pod-container/assign-memory-resource/)
      # in bytes.
      MEMORY_BYTES = 2

      # The SKU applies based on the pod's GPU count.
      GPU_COUNT = 3

      # The SKU applies based on the pod's [TPU
      # count](https://cloud.google.com/kubernetes-engine/docs/concepts/tpus#how_tpus_work).
      TPU_COUNT = 4
    end

    # Determines how the customer's usage is calculated.
    module UsageCalculation
      # Unused.
      USAGE_CALCULATION_UNSPECIFIED = 0

      # Usage is calculated from pod runtime.
      # The customer's usage is metered in a manner similar to the [GKE
      # Autopilot mode for pods without specific hardware
      # requirements](https://cloud.google.com/kubernetes-engine/pricing),
      # priced on a per-pod basis in units of hours and measured in
      # one-second increments, with no minimum duration.
      #
      # A SKU using this usage calculation is referred to as "flat" because
      # the customer's usage charge is independent of the pod shape apart
      # from determining whether the SKU applies to the pod.
      POD_RUNTIME = 1

      # Usage is calculated from pod runtime and size.
      # This calculation mode is only applicable to resource-based SKUs.
      # Usage is calculated by measuring the pod runtime in the same manner
      # as for `POD_RUNTIME` and multiplying by the pod's resource value
      # matching the SKU's pod resource type.
      # This converts the price from per-pod-hour to
      # per-pod-hour-per-resource, which changes the price unit for memory
      # SKUs to 'GiBy.h'. The price unit otherwise remains 'h' because the
      # other resources are dimensionless.
      #
      # A SKU using this usage calculation is referred to as "linear" because
      # the customer's usage charge is linearly proportional to the
      # pod's resource value.
      LINEAR_RESOURCE_SCALED_POD_RUNTIME = 2
    end
  end

  # Details about a SKU pricing usage of an [AI Platform Managed Model
  # (MaaS)](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/partner-models/use-partner-models).
  # @!attribute [r] tiered_price
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::TieredPrice]
  #     Output only. [Tiered
  #     pricing](https://cloud.google.com/billing/docs/how-to/pricing-table#tiered-pricing)
  #     of the SKU.
  # @!attribute [r] usage_metric
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::AiPlatformManagedModelUsageMetric]
  #     Output only. The usage metric that the SKU applies to.
  # @!attribute [r] location
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelEndpointLocation]
  #     Output only. The model endpoint location where usage is priced by this
  #     SKU. If no location is specified, the SKU applies to usage in all
  #     locations.
  # @!attribute [r] prediction_mode
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::PredictionMode]
  #     Output only. The prediction mode of requests that the SKU applies to.
  # @!attribute [r] combined_request_input_tokens_range
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::CombinedRequestInputTokensRange]
  #     Output only. The range of aggregated input token values covered by the
  #     SKU. Unset if the SKU is not scoped to a particular range. A request is
  #     in scope for this SKU if its aggregated input token value falls within
  #     the range. The collection of SKUs in effect at any given time scoped to
  #     a particular aggregated input token value range will cover all possible
  #     values without overlap. Such a collection of SKUs form a "tiered" price
  #     structure over the possible value, with each SKU acting as a "tier".
  #
  #     NOTE: This is distinct from a SKU with [tiered
  #     pricing](https://cloud.google.com/billing/docs/how-to/pricing-table#tiered-pricing).
  # @!attribute [r] provisioned_throughput_overage
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::ProvisionedThroughputOverage]
  #     Output only. Set when the SKU is a historical provisioned throughput
  #     overage SKU. Starting 2025-08-26 such SKUs have no effect, and usage in
  #     excess of provisioned throughput quota is now metered as standard
  #     usage. This field is set only in historical SKU timeline entries for
  #     overage SKUs belonging to partners that offered provisioned throughput
  #     for AI Platform managed model products prior to the unification of
  #     standard usage and provisioned throughput overage metering.
  class AiPlatformManagedModelUsageFee
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # The usage metric that the SKU applies to.
    # @!attribute [r] input_tokens_metric
    #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::AiPlatformManagedModelUsageMetric::InputTokensMetric]
    #     Output only. Input tokens read from the prediction endpoint input.
    #
    #     Note: The following fields are mutually exclusive: `input_tokens_metric`, `cache_read_input_tokens_metric`, `cache_write_input_tokens_metric`, `output_tokens_metric`, `web_search_requests_metric`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] cache_read_input_tokens_metric
    #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::AiPlatformManagedModelUsageMetric::CacheReadInputTokensMetric]
    #     Output only. Input tokens read from the cache.
    #
    #     Note: The following fields are mutually exclusive: `cache_read_input_tokens_metric`, `input_tokens_metric`, `cache_write_input_tokens_metric`, `output_tokens_metric`, `web_search_requests_metric`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] cache_write_input_tokens_metric
    #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::AiPlatformManagedModelUsageMetric::CacheWriteInputTokensMetric]
    #     Output only. Input tokens written to the cache.
    #
    #     Note: The following fields are mutually exclusive: `cache_write_input_tokens_metric`, `input_tokens_metric`, `cache_read_input_tokens_metric`, `output_tokens_metric`, `web_search_requests_metric`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] output_tokens_metric
    #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::AiPlatformManagedModelUsageMetric::OutputTokensMetric]
    #     Output only. Output tokens returned from the prediction endpoint.
    #
    #     Note: The following fields are mutually exclusive: `output_tokens_metric`, `input_tokens_metric`, `cache_read_input_tokens_metric`, `cache_write_input_tokens_metric`, `web_search_requests_metric`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] web_search_requests_metric
    #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::AiPlatformManagedModelUsageMetric::WebSearchRequestsMetric]
    #     Output only. Web search requests executed by the model.
    #
    #     Note: The following fields are mutually exclusive: `web_search_requests_metric`, `input_tokens_metric`, `cache_read_input_tokens_metric`, `cache_write_input_tokens_metric`, `output_tokens_metric`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    class AiPlatformManagedModelUsageMetric
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # Input tokens read from the input to the prediction endpoint.
      # The unit for this metric is dimensionless.
      class InputTokensMetric
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end

      # Input tokens read from the cache.
      # The unit for this metric is dimensionless.
      class CacheReadInputTokensMetric
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end

      # Input tokens written to the cache.
      # The unit for this metric is dimensionless.
      # @!attribute [r] ttl
      #   @return [::Google::Protobuf::Duration]
      #     Output only. The duration the write is retained in the cache.
      class CacheWriteInputTokensMetric
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end

      # Output tokens returned from the prediction endpoint.
      # The unit for this metric is dimensionless.
      class OutputTokensMetric
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end

      # Web search requests executed by the model.
      # The unit for this metric is dimensionless.
      class WebSearchRequestsMetric
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end
    end

    # The range of aggregated input token values covered by the SKU.
    #
    # A request to a managed model has an aggregated input token value
    # determined by the sum of the metric values of the input token metrics.
    #
    # * input tokens
    # * cache read input tokens
    # * cache write input tokens
    # @!attribute [r] start_value
    #   @return [::Integer]
    #     Output only. The inclusive lower bound of the range.
    # @!attribute [r] end_value
    #   @return [::Integer]
    #     Output only. The exclusive upper bound of the range.
    #     If no end value is specified, the range is unbounded from above.
    class CombinedRequestInputTokensRange
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # Additional details present for historical provisioned throughput
    # "overage" SKUs that applied charges only to usage above the customer's
    # provisioned throughput quota threshold.
    # @!attribute [r] service
    #   @return [::String]
    #     Output only. The service whose usage the overage SKU applied to.
    class ProvisionedThroughputOverage
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # The prediction modes of requests that the SKU applies to.
    module PredictionMode
      # The SKU does not distinguish between prediction modes.
      PREDICTION_MODE_UNSPECIFIED = 0

      # The SKU applies to online prediction.
      ONLINE_PREDICTION = 1

      # The SKU applies to batch prediction.
      BATCH_PREDICTION = 2
    end
  end

  # Details about a SKU pricing reservation of [AI Platform Provisioned
  # Throughput](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/provisioned-throughput).
  #
  # Customers may purchase provisioned throughput reservations for AI
  # Platform managed model products. This provides the customer with
  # provisioned throughput quota for a particular model and location. Model
  # usage below the provisioned throughput quota threshold is voided and is
  # not charged by the product's managed model usage fees.
  # @!attribute [r] term_duration_months
  #   @return [::Integer]
  #     Output only. The duration of the provisioned throughput reservation
  #     in months.
  # @!attribute [rw] gsu_price_per_unit
  #   @return [::Google::Type::Money]
  #     The price per [Generative AI Scale Unit
  #     (GSU)](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/provisioned-throughput/measure-provisioned-throughput)
  #     per `unit`.
  #     A provisioned throughput reservation reserves a certain number of
  #     GSUs, and the customer is billed for those GSUs on a continuous basis
  #     for the duration of the reservation.
  # @!attribute [r] location
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelEndpointLocation]
  #     Output only. The location where provisioned throughput is priced by
  #     this SKU.
  # @!attribute [r] unit
  #   @return [::String]
  #     Output only. The price unit of the SKU.
  #     See https://ucum.org/ucum.html for the format of the price unit.
  #     Since provisioned throughput reservations are billed by duration, this
  #     will always be a time unit. The price unit of a provisioned throughput
  #     SKU is not necessarily the same as the reservation term.
  #     This field is unrelated to the [Generative AI Scale Unit
  #     (GSU)](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/provisioned-throughput/measure-provisioned-throughput).
  #
  #     Currently the unit is always months ('mo').
  #     Additional time units may be supported in future.
  #
  #     The customary unit month ('mo') requires special handling to account
  #     for the variable duration of months. A price may be denominated in
  #     units of months, but the duration the reservation is active is measured
  #     in metric time and customers are billed on that basis. The exact hourly
  #     or per-second price can be calculated by dividing the monthly price
  #     by the number of hours or seconds in the desired month. A reservation
  #     active for N months is rarely billed exactly N times the monthly price.
  #     This is intended and is not a billing error.
  class AiPlatformProvisionedThroughputFee
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Details about a SKU pricing usage of an [AI Platform Self Deployed
  # Model](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/model-garden/self-deployed-models).
  # @!attribute [r] accelerator_type
  #   @return [::String]
  #     Output only. The SKU applies to a specific accelerator type.
  #     Contains the name of the matching [AI Platform AcceleratorType](
  #     https://docs.cloud.google.com/gemini-enterprise-agent-platform/reference/rest/v1/MachineSpec#AcceleratorType).
  #     The corresponding linear scaling value is the dimensionless
  #     [`accelerator_count`](https://docs.cloud.google.com/gemini-enterprise-agent-platform/reference/rest/v1/MachineSpec#FIELDS.accelerator_count).
  # @!attribute [r] price_per_unit
  #   @return [::Google::Type::Money]
  #     Output only. The price per unit of usage.
  #     The customer's usage charge is computed by measuring the customer's
  #     consumption denominated in price units and multiplying by this price.
  # @!attribute [r] unit
  #   @return [::String]
  #     Output only. The price unit of the SKU.
  #     See https://ucum.org/ucum.html for the format of the price unit.
  #     Currently the unit is always hours ('h'). This may change in future.
  # @!attribute [r] usage_calculation
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformDeployedModelUsageFee::UsageCalculation]
  #     Output only. Determines how the customer's usage is calculated.
  class AiPlatformDeployedModelUsageFee
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Determines how the customer's usage is calculated.
    module UsageCalculation
      # Unused.
      USAGE_CALCULATION_UNSPECIFIED = 0

      # Usage is calculated from deployment runtime and size.
      # Usage is calculated by measuring the deployment runtime in hours and
      # multiplying by the amount of the deployed model's hardware resource
      # matching the SKU's hardware resource type.
      # This results in a composite `unit` of hours ('h') multiplied by the
      # unit that denominates the hardware resource, though note that
      # multiplying by the dimensionless unit ("1") has no effect.
      LINEAR_RESOURCE_SCALED_DEPLOYMENT_RUNTIME = 2
    end
  end

  # Details about a SKU charging a flat subscription fee.
  # @!attribute [r] price_per_unit
  #   @return [::Google::Type::Money]
  #     Output only. The price per time unit the subscription is active.
  # @!attribute [r] unit
  #   @return [::String]
  #     Output only. The unit of the subscription SKU.
  #     See https://ucum.org/ucum.html for the format of the price unit.
  #     Since subscriptions are billed by duration, this will always be a time
  #     unit. The price unit of a subscription SKU is not necessarily the same
  #     as the subscription period of the corresponding StandardOffers.
  #
  #     Currently the unit is always months ('mo').
  #     Additional time units may be supported in future.
  #
  #     The unit month ('mo') is a customary time unit and requires special
  #     handling to account for the variable duration of months. A price may be
  #     denominated in units of months, but the duration the subscription is
  #     active is measured in metric time and customers are billed on that
  #     basis. The exact hourly or per-second price can be calculated by
  #     dividing the monthly price by the number of hours or seconds in the
  #     desired month. A subscription active for N months is rarely billed
  #     exactly N times the monthly price. This is intended and is not a
  #     billing error.
  class FlatSubscriptionFee
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Price structure for a SKU charging a [tiered
  # price](https://cloud.google.com/billing/docs/how-to/pricing-table#tiered-pricing).
  # @!attribute [r] unit
  #   @return [::String]
  #     Output only. Usage unit used for defining price tiers and for scaling
  #     with the price_unit_count to form the composite price unit.
  #
  #     See https://ucum.org/ucum.html for the format of the price unit.
  #     A unitless dimension, such as a count, is represented as `1`.
  # @!attribute [r] unit_description
  #   @return [::String]
  #     Output only. The display description of the unit, supplied at time of
  #     onboarding. This value is recommended to be set at least for
  #     dimensionless metrics, but may be empty if no description was provided
  #     at time of onboarding.
  # @!attribute [r] price_unit_count
  #   @return [::Google::Type::Decimal]
  #     Output only. Scaling  the `unit` by the `price_unit_count` forms the
  #     composite "price unit" which is priced by the price tiers.
  #
  #     This scaling factor is in addition to any numerical prefix symbol on
  #     the `unit`, so the same composite "price unit" can be represented in
  #     several ways, differing only in their presentation to users.
  #
  #     Examples:
  #
  #     * $1    per 1    bytes     : unit = By,  price_unit_count = 1
  #     * $1000 per 1    kilobytes : unit = kBy, price_unit_count = 1
  #     * $5000 per 5    kilobytes : unit = kBy, price_unit_count = 5
  # @!attribute [r] price_tiers
  #   @return [::Array<::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::TieredPrice::PriceTier>]
  #     Output only. The list of price tiers for the SKU, ordered by the
  #     start_amount.
  #
  #     The tiers are non-overlapping and are collectively bounded below by
  #     zero and unbounded above to cover the entire range of possible metric
  #     usage. Each tier is bounded below inclusively by its start_amount and
  #     bounded above exclusively by the start_amount of the next tier, or else
  #     unbounded above if there is no next tier.
  #
  #     Usage of the metric is aggregated by customer billing account on a
  #     monthly basis and billed in a graduated manner according to the price
  #     tiers, with each marginal unit of usage priced accoring to the tier in
  #     which it falls.
  class TieredPrice
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # A [price
    # tier](https://cloud.google.com/billing/docs/how-to/pricing-table#tiered-pricing)
    # pricing metric usage within a range.
    #
    # Each marginal unit of usage is priced according to the price tier in
    # which it falls.
    # @!attribute [r] start_amount
    #   @return [::Google::Type::Decimal]
    #     Output only. Inclusive lower bound of the tier interval, denominated
    #     in `unit`.
    # @!attribute [r] price
    #   @return [::Google::Type::Money]
    #     Output only. The price per `price_unit_count` of `unit` in the tier.
    #     The price is applied fractionally if the customer's usage within the
    #     tier is not an integer multiple of `price_unit_count`.
    class PriceTier
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end
  end

  # Location scope for a SKU that applies to an AI Platform Managed Model
  # endpoint.
  # @!attribute [r] region_id
  #   @return [::String]
  #     Output only. The SKU applies to a region.
  #
  #     Note: The following fields are mutually exclusive: `region_id`, `global_endpoint`, `multi_region_id`. If a field in that set is populated, all other fields in the set will automatically be cleared.
  # @!attribute [r] global_endpoint
  #   @return [::Boolean]
  #     Output only. The SKU applies to a [global
  #     endpoint](https://docs.cloud.google.com/gemini-enterprise-agent-platform/resources/locations).
  #     **Note**: This is distinct from the conventional meaning of "global"
  #     as a SKU that applies to all locations.
  #
  #     Note: The following fields are mutually exclusive: `global_endpoint`, `region_id`, `multi_region_id`. If a field in that set is populated, all other fields in the set will automatically be cleared.
  # @!attribute [r] multi_region_id
  #   @return [::String]
  #     Output only. The SKU applies to a multi-region.
  #
  #     Note: The following fields are mutually exclusive: `multi_region_id`, `region_id`, `global_endpoint`. If a field in that set is populated, all other fields in the set will automatically be cleared.
  class AiPlatformManagedModelEndpointLocation
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end
end

#effective_time::Google::Protobuf::Timestamp (readonly)

Returns Output only. The start of the time interval during which this price is effective.

Returns:



125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
# File 'proto_docs/google/cloud/commerceproducer/v1beta/sku.rb', line 125

class SkuPrice
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # Representation for a SKU that is not active and has no price.
  class InactiveSkuPrice
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Details about a SKU pricing usage of a [partner-reported custom billing
  # metric](https://cloud.google.com/service-infrastructure/docs/reporting-billing-metrics)
  # defined by the partner in the Service Management API and reported using
  # the Service Control API.
  #
  # The customer's usage charge is computed by converting the customer's
  # reported consumption to the SKU's composite price unit and applying the
  # graduated price from the appropriate price tier.
  # @!attribute [r] tiered_price
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::TieredPrice]
  #     Output only. [Tiered
  #     pricing](https://cloud.google.com/billing/docs/how-to/pricing-table#tiered-pricing)
  #     of the SKU.
  # @!attribute [r] canonical_metric
  #   @return [::String]
  #     Output only. The name of the metric, in canonical format.
  #
  #     Note that in the canonical format the first character of the path
  #     component of the metric name is always uppercase, which may differ
  #     from the metric name in the service config. For example, a metric
  #     appearing in the service config as 'example.com/example_metric' will
  #     appear here in the SKU as 'example.com/Example_metric'. In the Service
  #     Management and Service Control APIs these two metric names are
  #     considered distinct, either or both may be defined, and usage must be
  #     reported using a name matching the name of a metric defined in the
  #     service config. But for billing purposes usage reported using either
  #     name will be aggregated under the canonical metric name.
  #
  #     Example: "example.com/Example_metric"
  class ManagedServiceMetricUsageFee
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Details about a SKU pricing usage of a [Compute Engine
  # License](https://cloud.google.com/compute/docs/licenses/about).
  #
  # The SKU applies to a single license, and may be further scoped to a
  # [Compute
  # Engine VM Instance](https://cloud.google.com/compute/docs/instances)
  # machine resource type (e.g. "vCPU") and size range for that machine
  # resource. Instances deployed from [Compute
  # Engine Images](https://cloud.google.com/compute/docs/images)
  # incorporating the target license and (if applicable) matching the machine
  # resource type size range will be charged by the SKU. A single license may
  # be priced by multiple SKUs covering different combinations of machine
  # resource type and size range, allowing a single running instance to be
  # charged by up to one SKU per machine resource type, with pricing tiered
  # according to machine shape.
  # @!attribute [rw] price_per_unit
  #   @return [::Google::Type::Money]
  #     The price per unit of usage.
  #     The customer's usage charge is computed by measuring the customer's
  #     consumption denominated in price units and multiplying by this price.
  # @!attribute [r] license_code
  #   @return [::String]
  #     Output only. The license code of the target Compute Engine License.
  #     Note that this is the numeric license code itself in uint64 format used
  #     to reference licenses attached to images, not the resource name of the
  #     related [Compute Engine LicenseCode
  #     resource](https://cloud.google.com/compute/docs/reference/rest/v1/licenseCodes).
  #
  #     Example: "1234567890123456789"
  # @!attribute [r] machine_resource
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::ComputeEngineLicenseUsageFee::MachineResource]
  #     Output only. The machine resource type that the SKU applies to, if any.
  #     SKUs with a non-default value are referred to as "resource-based" SKUs.
  # @!attribute [r] machine_resource_range
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::ComputeEngineLicenseUsageFee::MachineResourceRange]
  #     Output only. The range of machine resource values that the SKU applies
  #     to. Unset when the SKU is not scoped to a particular machine resource
  #     type. The collection of SKUs in effect at any given time targeting the
  #     same license and machine resource type will cover all possible values
  #     for that machine resource type without overlap. Such a collection of
  #     SKUs form a "tiered" price structure over the possible values of the
  #     machine resource, with each SKU acting as a "tier".
  #
  #     NOTE: This is distinct from a SKU with [tiered
  #     pricing](https://cloud.google.com/billing/docs/how-to/pricing-table#tiered-pricing).
  # @!attribute [r] usage_calculation
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::ComputeEngineLicenseUsageFee::UsageCalculation]
  #     Output only. Determines how the customer's usage is calculated.
  # @!attribute [r] unit
  #   @return [::String]
  #     Output only. The price unit of the SKU.
  #     See https://ucum.org/ucum.html for the format of the price unit.
  #     For linear-priced memory SKUs, the price unit is 'GiBy.h'.
  #     For all other SKUs, the price unit is 'h'. This includes linear-priced
  #     vCPU and GPU SKUs because these resources have unitless dimensions and
  #     the application of these scaling factors does not change the price
  #     unit.
  class ComputeEngineLicenseUsageFee
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # The range of machine resource values that the SKU applies to.
    # @!attribute [r] start_value
    #   @return [::Integer]
    #     Output only. The inclusive lower bound of the range.
    #     While the number zero may be the start of a range, it is not a
    #     possible machine resource value. An instance cannot exist with zero
    #     vCPU or memory, and an instance with no attached accelerators lacks a
    #     GPU dimension entirely rather than having a GPU count of zero.
    # @!attribute [r] end_value
    #   @return [::Integer]
    #     Output only. The exclusive upper bound of the range.
    #     If no end value is specified, the range is unbounded from above.
    class MachineResourceRange
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # The machine resource type that the SKU applies to, if any.
    module MachineResource
      # The SKU applies to all instances irrespective of machine shape.
      # This is referred to as "instance-based pricing" because the price
      # is the same for all instances.
      MACHINE_RESOURCE_UNSPECIFIED = 0

      # The SKU applies based on the instance's vCPU count.
      VCPU_COUNT = 1

      # The SKU applies based on the instance's memory size in bytes.
      MEMORY_BYTES = 2

      # The SKU applies based on the instance's GPU count.
      GPU_COUNT = 3
    end

    # Determines how the customer's usage is calculated.
    module UsageCalculation
      # Unused.
      USAGE_CALCULATION_UNSPECIFIED = 0

      # Usage is calculated from instance runtime.
      # The customer's usage is metered according to the [Compute Engine VM
      # instance pricing
      # model](https://cloud.google.com/compute/vm-instance-pricing),
      # measured on a per-instance basis in units of hours, with a minimum
      # duration of one minute and an increment of one second.
      #
      # A SKU using this usage calculation is referred to as "flat" because
      # the customer's usage charge is independent of the instance's machine
      # resource shape apart from determining whether the SKU applies to the
      # instance.
      INSTANCE_RUNTIME = 1

      # Usage is calculated from instance runtime and size.
      # This calculation mode is only applicable to resource-based SKUs.
      # Usage is calculated by measuring the instance runtime in the same
      # manner as for `INSTANCE_RUNTIME` and multiplying by the instance's
      # machine resource value matching the SKU's machine resource type.
      # This converts the price from per-instance-hour to
      # per-instance-hour-per-machine-resource, which changes the price unit
      # for memory SKUs to 'GiBy.h'. The price unit otherwise remains 'h'
      # because the other machine resources are dimensionless.
      #
      # A SKU using this usage calculation is referred to as "linear" because
      # the customer's usage charge is linearly proportional to the
      # instance's machine resource value.
      LINEAR_RESOURCE_SCALED_INSTANCE_RUNTIME = 2
    end
  end

  # Details about a SKU pricing usage of software running on a Kubernetes
  # Engine pod.
  #
  # The SKU applies to pods annotated with the SKU's parent service name, and
  # may be further scoped to a [k8s pod resource
  # type](https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/)
  # (e.g. "CPU") and size range for that resource type. Running pods
  # annotated with the parent service's service name and matching the pod
  # resource type size range will be charged by the SKU. A service may be
  # priced by multiple SKUs covering different combinations of pod resource
  # type and size range, allowing a single running pod to be charged by up to
  # one SKU per pod resource type, with pricing tiered according to pod
  # shape.
  # @!attribute [rw] price_per_unit
  #   @return [::Google::Type::Money]
  #     The price per unit of usage.
  #     The customer's usage charge is computed by measuring the customer's
  #     consumption denominated in price units and multiplying by this price.
  # @!attribute [r] pod_resource
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::KubernetesEnginePodUsageFee::PodResource]
  #     Output only. The pod resource type that the SKU applies to.
  #     SKUs with a non-default value are referred to as "resource-based" SKUs.
  # @!attribute [r] pod_resource_range
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::KubernetesEnginePodUsageFee::PodResourceRange]
  #     Output only. The range of pod resource values that the SKU applies to.
  #     The collection of SKUs in effect at any given time targeting the same
  #     service annotation and pod resource type will cover all possible values
  #     for that pod resource type without overlap. Such a collection of SKUs
  #     form a "tiered" price structure over the possible values of the pod
  #     resource, with each SKU acting as a "tier".
  #
  #     NOTE: This is distinct from a SKU with [tiered
  #     pricing](https://cloud.google.com/billing/docs/how-to/pricing-table#tiered-pricing).
  # @!attribute [r] usage_calculation
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::KubernetesEnginePodUsageFee::UsageCalculation]
  #     Output only. Determines how the customer's usage is calculated.
  # @!attribute [r] unit
  #   @return [::String]
  #     Output only. The price unit of the SKU.
  #     See https://ucum.org/ucum.html for the format of the price unit.
  #     For linear-priced memory SKUs, the price unit is 'GiBy.h'.
  #     For all other SKUs, the price unit is 'h'. This includes linear-priced
  #     VCPU, GPU, and TPU SKUs because these resources have unitless
  #     dimensions and the application of these scaling factors does not change
  #     the price unit.
  class KubernetesEnginePodUsageFee
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # The range of pod resource values that the SKU applies to.
    # @!attribute [r] start_value
    #   @return [::Integer]
    #     Output only. The inclusive lower bound of the range.
    # @!attribute [r] end_value
    #   @return [::Integer]
    #     Output only. The exclusive upper bound of the range.
    #     If no end value is specified, the range is unbounded from above.
    class PodResourceRange
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # The pod [resource
    # type](https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/)
    # that the SKU applies to.
    module PodResource
      # Unused.
      POD_RESOURCE_UNSPECIFIED = 0

      # The SKU applies based on the pod's [vCPU
      # count](https://kubernetes.io/docs/tasks/configure-pod-container/assign-cpu-resource/).
      VCPU_COUNT = 1

      # The SKU applies based on the pod's [memory
      # size](https://kubernetes.io/docs/tasks/configure-pod-container/assign-memory-resource/)
      # in bytes.
      MEMORY_BYTES = 2

      # The SKU applies based on the pod's GPU count.
      GPU_COUNT = 3

      # The SKU applies based on the pod's [TPU
      # count](https://cloud.google.com/kubernetes-engine/docs/concepts/tpus#how_tpus_work).
      TPU_COUNT = 4
    end

    # Determines how the customer's usage is calculated.
    module UsageCalculation
      # Unused.
      USAGE_CALCULATION_UNSPECIFIED = 0

      # Usage is calculated from pod runtime.
      # The customer's usage is metered in a manner similar to the [GKE
      # Autopilot mode for pods without specific hardware
      # requirements](https://cloud.google.com/kubernetes-engine/pricing),
      # priced on a per-pod basis in units of hours and measured in
      # one-second increments, with no minimum duration.
      #
      # A SKU using this usage calculation is referred to as "flat" because
      # the customer's usage charge is independent of the pod shape apart
      # from determining whether the SKU applies to the pod.
      POD_RUNTIME = 1

      # Usage is calculated from pod runtime and size.
      # This calculation mode is only applicable to resource-based SKUs.
      # Usage is calculated by measuring the pod runtime in the same manner
      # as for `POD_RUNTIME` and multiplying by the pod's resource value
      # matching the SKU's pod resource type.
      # This converts the price from per-pod-hour to
      # per-pod-hour-per-resource, which changes the price unit for memory
      # SKUs to 'GiBy.h'. The price unit otherwise remains 'h' because the
      # other resources are dimensionless.
      #
      # A SKU using this usage calculation is referred to as "linear" because
      # the customer's usage charge is linearly proportional to the
      # pod's resource value.
      LINEAR_RESOURCE_SCALED_POD_RUNTIME = 2
    end
  end

  # Details about a SKU pricing usage of an [AI Platform Managed Model
  # (MaaS)](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/partner-models/use-partner-models).
  # @!attribute [r] tiered_price
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::TieredPrice]
  #     Output only. [Tiered
  #     pricing](https://cloud.google.com/billing/docs/how-to/pricing-table#tiered-pricing)
  #     of the SKU.
  # @!attribute [r] usage_metric
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::AiPlatformManagedModelUsageMetric]
  #     Output only. The usage metric that the SKU applies to.
  # @!attribute [r] location
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelEndpointLocation]
  #     Output only. The model endpoint location where usage is priced by this
  #     SKU. If no location is specified, the SKU applies to usage in all
  #     locations.
  # @!attribute [r] prediction_mode
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::PredictionMode]
  #     Output only. The prediction mode of requests that the SKU applies to.
  # @!attribute [r] combined_request_input_tokens_range
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::CombinedRequestInputTokensRange]
  #     Output only. The range of aggregated input token values covered by the
  #     SKU. Unset if the SKU is not scoped to a particular range. A request is
  #     in scope for this SKU if its aggregated input token value falls within
  #     the range. The collection of SKUs in effect at any given time scoped to
  #     a particular aggregated input token value range will cover all possible
  #     values without overlap. Such a collection of SKUs form a "tiered" price
  #     structure over the possible value, with each SKU acting as a "tier".
  #
  #     NOTE: This is distinct from a SKU with [tiered
  #     pricing](https://cloud.google.com/billing/docs/how-to/pricing-table#tiered-pricing).
  # @!attribute [r] provisioned_throughput_overage
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::ProvisionedThroughputOverage]
  #     Output only. Set when the SKU is a historical provisioned throughput
  #     overage SKU. Starting 2025-08-26 such SKUs have no effect, and usage in
  #     excess of provisioned throughput quota is now metered as standard
  #     usage. This field is set only in historical SKU timeline entries for
  #     overage SKUs belonging to partners that offered provisioned throughput
  #     for AI Platform managed model products prior to the unification of
  #     standard usage and provisioned throughput overage metering.
  class AiPlatformManagedModelUsageFee
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # The usage metric that the SKU applies to.
    # @!attribute [r] input_tokens_metric
    #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::AiPlatformManagedModelUsageMetric::InputTokensMetric]
    #     Output only. Input tokens read from the prediction endpoint input.
    #
    #     Note: The following fields are mutually exclusive: `input_tokens_metric`, `cache_read_input_tokens_metric`, `cache_write_input_tokens_metric`, `output_tokens_metric`, `web_search_requests_metric`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] cache_read_input_tokens_metric
    #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::AiPlatformManagedModelUsageMetric::CacheReadInputTokensMetric]
    #     Output only. Input tokens read from the cache.
    #
    #     Note: The following fields are mutually exclusive: `cache_read_input_tokens_metric`, `input_tokens_metric`, `cache_write_input_tokens_metric`, `output_tokens_metric`, `web_search_requests_metric`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] cache_write_input_tokens_metric
    #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::AiPlatformManagedModelUsageMetric::CacheWriteInputTokensMetric]
    #     Output only. Input tokens written to the cache.
    #
    #     Note: The following fields are mutually exclusive: `cache_write_input_tokens_metric`, `input_tokens_metric`, `cache_read_input_tokens_metric`, `output_tokens_metric`, `web_search_requests_metric`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] output_tokens_metric
    #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::AiPlatformManagedModelUsageMetric::OutputTokensMetric]
    #     Output only. Output tokens returned from the prediction endpoint.
    #
    #     Note: The following fields are mutually exclusive: `output_tokens_metric`, `input_tokens_metric`, `cache_read_input_tokens_metric`, `cache_write_input_tokens_metric`, `web_search_requests_metric`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] web_search_requests_metric
    #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::AiPlatformManagedModelUsageMetric::WebSearchRequestsMetric]
    #     Output only. Web search requests executed by the model.
    #
    #     Note: The following fields are mutually exclusive: `web_search_requests_metric`, `input_tokens_metric`, `cache_read_input_tokens_metric`, `cache_write_input_tokens_metric`, `output_tokens_metric`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    class AiPlatformManagedModelUsageMetric
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # Input tokens read from the input to the prediction endpoint.
      # The unit for this metric is dimensionless.
      class InputTokensMetric
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end

      # Input tokens read from the cache.
      # The unit for this metric is dimensionless.
      class CacheReadInputTokensMetric
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end

      # Input tokens written to the cache.
      # The unit for this metric is dimensionless.
      # @!attribute [r] ttl
      #   @return [::Google::Protobuf::Duration]
      #     Output only. The duration the write is retained in the cache.
      class CacheWriteInputTokensMetric
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end

      # Output tokens returned from the prediction endpoint.
      # The unit for this metric is dimensionless.
      class OutputTokensMetric
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end

      # Web search requests executed by the model.
      # The unit for this metric is dimensionless.
      class WebSearchRequestsMetric
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end
    end

    # The range of aggregated input token values covered by the SKU.
    #
    # A request to a managed model has an aggregated input token value
    # determined by the sum of the metric values of the input token metrics.
    #
    # * input tokens
    # * cache read input tokens
    # * cache write input tokens
    # @!attribute [r] start_value
    #   @return [::Integer]
    #     Output only. The inclusive lower bound of the range.
    # @!attribute [r] end_value
    #   @return [::Integer]
    #     Output only. The exclusive upper bound of the range.
    #     If no end value is specified, the range is unbounded from above.
    class CombinedRequestInputTokensRange
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # Additional details present for historical provisioned throughput
    # "overage" SKUs that applied charges only to usage above the customer's
    # provisioned throughput quota threshold.
    # @!attribute [r] service
    #   @return [::String]
    #     Output only. The service whose usage the overage SKU applied to.
    class ProvisionedThroughputOverage
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # The prediction modes of requests that the SKU applies to.
    module PredictionMode
      # The SKU does not distinguish between prediction modes.
      PREDICTION_MODE_UNSPECIFIED = 0

      # The SKU applies to online prediction.
      ONLINE_PREDICTION = 1

      # The SKU applies to batch prediction.
      BATCH_PREDICTION = 2
    end
  end

  # Details about a SKU pricing reservation of [AI Platform Provisioned
  # Throughput](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/provisioned-throughput).
  #
  # Customers may purchase provisioned throughput reservations for AI
  # Platform managed model products. This provides the customer with
  # provisioned throughput quota for a particular model and location. Model
  # usage below the provisioned throughput quota threshold is voided and is
  # not charged by the product's managed model usage fees.
  # @!attribute [r] term_duration_months
  #   @return [::Integer]
  #     Output only. The duration of the provisioned throughput reservation
  #     in months.
  # @!attribute [rw] gsu_price_per_unit
  #   @return [::Google::Type::Money]
  #     The price per [Generative AI Scale Unit
  #     (GSU)](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/provisioned-throughput/measure-provisioned-throughput)
  #     per `unit`.
  #     A provisioned throughput reservation reserves a certain number of
  #     GSUs, and the customer is billed for those GSUs on a continuous basis
  #     for the duration of the reservation.
  # @!attribute [r] location
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelEndpointLocation]
  #     Output only. The location where provisioned throughput is priced by
  #     this SKU.
  # @!attribute [r] unit
  #   @return [::String]
  #     Output only. The price unit of the SKU.
  #     See https://ucum.org/ucum.html for the format of the price unit.
  #     Since provisioned throughput reservations are billed by duration, this
  #     will always be a time unit. The price unit of a provisioned throughput
  #     SKU is not necessarily the same as the reservation term.
  #     This field is unrelated to the [Generative AI Scale Unit
  #     (GSU)](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/provisioned-throughput/measure-provisioned-throughput).
  #
  #     Currently the unit is always months ('mo').
  #     Additional time units may be supported in future.
  #
  #     The customary unit month ('mo') requires special handling to account
  #     for the variable duration of months. A price may be denominated in
  #     units of months, but the duration the reservation is active is measured
  #     in metric time and customers are billed on that basis. The exact hourly
  #     or per-second price can be calculated by dividing the monthly price
  #     by the number of hours or seconds in the desired month. A reservation
  #     active for N months is rarely billed exactly N times the monthly price.
  #     This is intended and is not a billing error.
  class AiPlatformProvisionedThroughputFee
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Details about a SKU pricing usage of an [AI Platform Self Deployed
  # Model](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/model-garden/self-deployed-models).
  # @!attribute [r] accelerator_type
  #   @return [::String]
  #     Output only. The SKU applies to a specific accelerator type.
  #     Contains the name of the matching [AI Platform AcceleratorType](
  #     https://docs.cloud.google.com/gemini-enterprise-agent-platform/reference/rest/v1/MachineSpec#AcceleratorType).
  #     The corresponding linear scaling value is the dimensionless
  #     [`accelerator_count`](https://docs.cloud.google.com/gemini-enterprise-agent-platform/reference/rest/v1/MachineSpec#FIELDS.accelerator_count).
  # @!attribute [r] price_per_unit
  #   @return [::Google::Type::Money]
  #     Output only. The price per unit of usage.
  #     The customer's usage charge is computed by measuring the customer's
  #     consumption denominated in price units and multiplying by this price.
  # @!attribute [r] unit
  #   @return [::String]
  #     Output only. The price unit of the SKU.
  #     See https://ucum.org/ucum.html for the format of the price unit.
  #     Currently the unit is always hours ('h'). This may change in future.
  # @!attribute [r] usage_calculation
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformDeployedModelUsageFee::UsageCalculation]
  #     Output only. Determines how the customer's usage is calculated.
  class AiPlatformDeployedModelUsageFee
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Determines how the customer's usage is calculated.
    module UsageCalculation
      # Unused.
      USAGE_CALCULATION_UNSPECIFIED = 0

      # Usage is calculated from deployment runtime and size.
      # Usage is calculated by measuring the deployment runtime in hours and
      # multiplying by the amount of the deployed model's hardware resource
      # matching the SKU's hardware resource type.
      # This results in a composite `unit` of hours ('h') multiplied by the
      # unit that denominates the hardware resource, though note that
      # multiplying by the dimensionless unit ("1") has no effect.
      LINEAR_RESOURCE_SCALED_DEPLOYMENT_RUNTIME = 2
    end
  end

  # Details about a SKU charging a flat subscription fee.
  # @!attribute [r] price_per_unit
  #   @return [::Google::Type::Money]
  #     Output only. The price per time unit the subscription is active.
  # @!attribute [r] unit
  #   @return [::String]
  #     Output only. The unit of the subscription SKU.
  #     See https://ucum.org/ucum.html for the format of the price unit.
  #     Since subscriptions are billed by duration, this will always be a time
  #     unit. The price unit of a subscription SKU is not necessarily the same
  #     as the subscription period of the corresponding StandardOffers.
  #
  #     Currently the unit is always months ('mo').
  #     Additional time units may be supported in future.
  #
  #     The unit month ('mo') is a customary time unit and requires special
  #     handling to account for the variable duration of months. A price may be
  #     denominated in units of months, but the duration the subscription is
  #     active is measured in metric time and customers are billed on that
  #     basis. The exact hourly or per-second price can be calculated by
  #     dividing the monthly price by the number of hours or seconds in the
  #     desired month. A subscription active for N months is rarely billed
  #     exactly N times the monthly price. This is intended and is not a
  #     billing error.
  class FlatSubscriptionFee
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Price structure for a SKU charging a [tiered
  # price](https://cloud.google.com/billing/docs/how-to/pricing-table#tiered-pricing).
  # @!attribute [r] unit
  #   @return [::String]
  #     Output only. Usage unit used for defining price tiers and for scaling
  #     with the price_unit_count to form the composite price unit.
  #
  #     See https://ucum.org/ucum.html for the format of the price unit.
  #     A unitless dimension, such as a count, is represented as `1`.
  # @!attribute [r] unit_description
  #   @return [::String]
  #     Output only. The display description of the unit, supplied at time of
  #     onboarding. This value is recommended to be set at least for
  #     dimensionless metrics, but may be empty if no description was provided
  #     at time of onboarding.
  # @!attribute [r] price_unit_count
  #   @return [::Google::Type::Decimal]
  #     Output only. Scaling  the `unit` by the `price_unit_count` forms the
  #     composite "price unit" which is priced by the price tiers.
  #
  #     This scaling factor is in addition to any numerical prefix symbol on
  #     the `unit`, so the same composite "price unit" can be represented in
  #     several ways, differing only in their presentation to users.
  #
  #     Examples:
  #
  #     * $1    per 1    bytes     : unit = By,  price_unit_count = 1
  #     * $1000 per 1    kilobytes : unit = kBy, price_unit_count = 1
  #     * $5000 per 5    kilobytes : unit = kBy, price_unit_count = 5
  # @!attribute [r] price_tiers
  #   @return [::Array<::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::TieredPrice::PriceTier>]
  #     Output only. The list of price tiers for the SKU, ordered by the
  #     start_amount.
  #
  #     The tiers are non-overlapping and are collectively bounded below by
  #     zero and unbounded above to cover the entire range of possible metric
  #     usage. Each tier is bounded below inclusively by its start_amount and
  #     bounded above exclusively by the start_amount of the next tier, or else
  #     unbounded above if there is no next tier.
  #
  #     Usage of the metric is aggregated by customer billing account on a
  #     monthly basis and billed in a graduated manner according to the price
  #     tiers, with each marginal unit of usage priced accoring to the tier in
  #     which it falls.
  class TieredPrice
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # A [price
    # tier](https://cloud.google.com/billing/docs/how-to/pricing-table#tiered-pricing)
    # pricing metric usage within a range.
    #
    # Each marginal unit of usage is priced according to the price tier in
    # which it falls.
    # @!attribute [r] start_amount
    #   @return [::Google::Type::Decimal]
    #     Output only. Inclusive lower bound of the tier interval, denominated
    #     in `unit`.
    # @!attribute [r] price
    #   @return [::Google::Type::Money]
    #     Output only. The price per `price_unit_count` of `unit` in the tier.
    #     The price is applied fractionally if the customer's usage within the
    #     tier is not an integer multiple of `price_unit_count`.
    class PriceTier
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end
  end

  # Location scope for a SKU that applies to an AI Platform Managed Model
  # endpoint.
  # @!attribute [r] region_id
  #   @return [::String]
  #     Output only. The SKU applies to a region.
  #
  #     Note: The following fields are mutually exclusive: `region_id`, `global_endpoint`, `multi_region_id`. If a field in that set is populated, all other fields in the set will automatically be cleared.
  # @!attribute [r] global_endpoint
  #   @return [::Boolean]
  #     Output only. The SKU applies to a [global
  #     endpoint](https://docs.cloud.google.com/gemini-enterprise-agent-platform/resources/locations).
  #     **Note**: This is distinct from the conventional meaning of "global"
  #     as a SKU that applies to all locations.
  #
  #     Note: The following fields are mutually exclusive: `global_endpoint`, `region_id`, `multi_region_id`. If a field in that set is populated, all other fields in the set will automatically be cleared.
  # @!attribute [r] multi_region_id
  #   @return [::String]
  #     Output only. The SKU applies to a multi-region.
  #
  #     Note: The following fields are mutually exclusive: `multi_region_id`, `region_id`, `global_endpoint`. If a field in that set is populated, all other fields in the set will automatically be cleared.
  class AiPlatformManagedModelEndpointLocation
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end
end

#flat_subscription_fee::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::FlatSubscriptionFee (readonly)

Returns Output only. The SKU applies a flat subscription fee.

Note: The following fields are mutually exclusive: flat_subscription_fee, inactive, managed_service_metric_usage_fee, gce_license_usage_fee, gke_pod_usage_fee, ai_platform_managed_model_usage_fee, ai_platform_provisioned_throughput_fee, ai_platform_deployed_model_usage_fee. If a field in that set is populated, all other fields in the set will automatically be cleared.

Returns:

  • (::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::FlatSubscriptionFee)

    Output only. The SKU applies a flat subscription fee.

    Note: The following fields are mutually exclusive: flat_subscription_fee, inactive, managed_service_metric_usage_fee, gce_license_usage_fee, gke_pod_usage_fee, ai_platform_managed_model_usage_fee, ai_platform_provisioned_throughput_fee, ai_platform_deployed_model_usage_fee. If a field in that set is populated, all other fields in the set will automatically be cleared.



125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
# File 'proto_docs/google/cloud/commerceproducer/v1beta/sku.rb', line 125

class SkuPrice
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # Representation for a SKU that is not active and has no price.
  class InactiveSkuPrice
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Details about a SKU pricing usage of a [partner-reported custom billing
  # metric](https://cloud.google.com/service-infrastructure/docs/reporting-billing-metrics)
  # defined by the partner in the Service Management API and reported using
  # the Service Control API.
  #
  # The customer's usage charge is computed by converting the customer's
  # reported consumption to the SKU's composite price unit and applying the
  # graduated price from the appropriate price tier.
  # @!attribute [r] tiered_price
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::TieredPrice]
  #     Output only. [Tiered
  #     pricing](https://cloud.google.com/billing/docs/how-to/pricing-table#tiered-pricing)
  #     of the SKU.
  # @!attribute [r] canonical_metric
  #   @return [::String]
  #     Output only. The name of the metric, in canonical format.
  #
  #     Note that in the canonical format the first character of the path
  #     component of the metric name is always uppercase, which may differ
  #     from the metric name in the service config. For example, a metric
  #     appearing in the service config as 'example.com/example_metric' will
  #     appear here in the SKU as 'example.com/Example_metric'. In the Service
  #     Management and Service Control APIs these two metric names are
  #     considered distinct, either or both may be defined, and usage must be
  #     reported using a name matching the name of a metric defined in the
  #     service config. But for billing purposes usage reported using either
  #     name will be aggregated under the canonical metric name.
  #
  #     Example: "example.com/Example_metric"
  class ManagedServiceMetricUsageFee
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Details about a SKU pricing usage of a [Compute Engine
  # License](https://cloud.google.com/compute/docs/licenses/about).
  #
  # The SKU applies to a single license, and may be further scoped to a
  # [Compute
  # Engine VM Instance](https://cloud.google.com/compute/docs/instances)
  # machine resource type (e.g. "vCPU") and size range for that machine
  # resource. Instances deployed from [Compute
  # Engine Images](https://cloud.google.com/compute/docs/images)
  # incorporating the target license and (if applicable) matching the machine
  # resource type size range will be charged by the SKU. A single license may
  # be priced by multiple SKUs covering different combinations of machine
  # resource type and size range, allowing a single running instance to be
  # charged by up to one SKU per machine resource type, with pricing tiered
  # according to machine shape.
  # @!attribute [rw] price_per_unit
  #   @return [::Google::Type::Money]
  #     The price per unit of usage.
  #     The customer's usage charge is computed by measuring the customer's
  #     consumption denominated in price units and multiplying by this price.
  # @!attribute [r] license_code
  #   @return [::String]
  #     Output only. The license code of the target Compute Engine License.
  #     Note that this is the numeric license code itself in uint64 format used
  #     to reference licenses attached to images, not the resource name of the
  #     related [Compute Engine LicenseCode
  #     resource](https://cloud.google.com/compute/docs/reference/rest/v1/licenseCodes).
  #
  #     Example: "1234567890123456789"
  # @!attribute [r] machine_resource
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::ComputeEngineLicenseUsageFee::MachineResource]
  #     Output only. The machine resource type that the SKU applies to, if any.
  #     SKUs with a non-default value are referred to as "resource-based" SKUs.
  # @!attribute [r] machine_resource_range
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::ComputeEngineLicenseUsageFee::MachineResourceRange]
  #     Output only. The range of machine resource values that the SKU applies
  #     to. Unset when the SKU is not scoped to a particular machine resource
  #     type. The collection of SKUs in effect at any given time targeting the
  #     same license and machine resource type will cover all possible values
  #     for that machine resource type without overlap. Such a collection of
  #     SKUs form a "tiered" price structure over the possible values of the
  #     machine resource, with each SKU acting as a "tier".
  #
  #     NOTE: This is distinct from a SKU with [tiered
  #     pricing](https://cloud.google.com/billing/docs/how-to/pricing-table#tiered-pricing).
  # @!attribute [r] usage_calculation
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::ComputeEngineLicenseUsageFee::UsageCalculation]
  #     Output only. Determines how the customer's usage is calculated.
  # @!attribute [r] unit
  #   @return [::String]
  #     Output only. The price unit of the SKU.
  #     See https://ucum.org/ucum.html for the format of the price unit.
  #     For linear-priced memory SKUs, the price unit is 'GiBy.h'.
  #     For all other SKUs, the price unit is 'h'. This includes linear-priced
  #     vCPU and GPU SKUs because these resources have unitless dimensions and
  #     the application of these scaling factors does not change the price
  #     unit.
  class ComputeEngineLicenseUsageFee
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # The range of machine resource values that the SKU applies to.
    # @!attribute [r] start_value
    #   @return [::Integer]
    #     Output only. The inclusive lower bound of the range.
    #     While the number zero may be the start of a range, it is not a
    #     possible machine resource value. An instance cannot exist with zero
    #     vCPU or memory, and an instance with no attached accelerators lacks a
    #     GPU dimension entirely rather than having a GPU count of zero.
    # @!attribute [r] end_value
    #   @return [::Integer]
    #     Output only. The exclusive upper bound of the range.
    #     If no end value is specified, the range is unbounded from above.
    class MachineResourceRange
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # The machine resource type that the SKU applies to, if any.
    module MachineResource
      # The SKU applies to all instances irrespective of machine shape.
      # This is referred to as "instance-based pricing" because the price
      # is the same for all instances.
      MACHINE_RESOURCE_UNSPECIFIED = 0

      # The SKU applies based on the instance's vCPU count.
      VCPU_COUNT = 1

      # The SKU applies based on the instance's memory size in bytes.
      MEMORY_BYTES = 2

      # The SKU applies based on the instance's GPU count.
      GPU_COUNT = 3
    end

    # Determines how the customer's usage is calculated.
    module UsageCalculation
      # Unused.
      USAGE_CALCULATION_UNSPECIFIED = 0

      # Usage is calculated from instance runtime.
      # The customer's usage is metered according to the [Compute Engine VM
      # instance pricing
      # model](https://cloud.google.com/compute/vm-instance-pricing),
      # measured on a per-instance basis in units of hours, with a minimum
      # duration of one minute and an increment of one second.
      #
      # A SKU using this usage calculation is referred to as "flat" because
      # the customer's usage charge is independent of the instance's machine
      # resource shape apart from determining whether the SKU applies to the
      # instance.
      INSTANCE_RUNTIME = 1

      # Usage is calculated from instance runtime and size.
      # This calculation mode is only applicable to resource-based SKUs.
      # Usage is calculated by measuring the instance runtime in the same
      # manner as for `INSTANCE_RUNTIME` and multiplying by the instance's
      # machine resource value matching the SKU's machine resource type.
      # This converts the price from per-instance-hour to
      # per-instance-hour-per-machine-resource, which changes the price unit
      # for memory SKUs to 'GiBy.h'. The price unit otherwise remains 'h'
      # because the other machine resources are dimensionless.
      #
      # A SKU using this usage calculation is referred to as "linear" because
      # the customer's usage charge is linearly proportional to the
      # instance's machine resource value.
      LINEAR_RESOURCE_SCALED_INSTANCE_RUNTIME = 2
    end
  end

  # Details about a SKU pricing usage of software running on a Kubernetes
  # Engine pod.
  #
  # The SKU applies to pods annotated with the SKU's parent service name, and
  # may be further scoped to a [k8s pod resource
  # type](https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/)
  # (e.g. "CPU") and size range for that resource type. Running pods
  # annotated with the parent service's service name and matching the pod
  # resource type size range will be charged by the SKU. A service may be
  # priced by multiple SKUs covering different combinations of pod resource
  # type and size range, allowing a single running pod to be charged by up to
  # one SKU per pod resource type, with pricing tiered according to pod
  # shape.
  # @!attribute [rw] price_per_unit
  #   @return [::Google::Type::Money]
  #     The price per unit of usage.
  #     The customer's usage charge is computed by measuring the customer's
  #     consumption denominated in price units and multiplying by this price.
  # @!attribute [r] pod_resource
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::KubernetesEnginePodUsageFee::PodResource]
  #     Output only. The pod resource type that the SKU applies to.
  #     SKUs with a non-default value are referred to as "resource-based" SKUs.
  # @!attribute [r] pod_resource_range
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::KubernetesEnginePodUsageFee::PodResourceRange]
  #     Output only. The range of pod resource values that the SKU applies to.
  #     The collection of SKUs in effect at any given time targeting the same
  #     service annotation and pod resource type will cover all possible values
  #     for that pod resource type without overlap. Such a collection of SKUs
  #     form a "tiered" price structure over the possible values of the pod
  #     resource, with each SKU acting as a "tier".
  #
  #     NOTE: This is distinct from a SKU with [tiered
  #     pricing](https://cloud.google.com/billing/docs/how-to/pricing-table#tiered-pricing).
  # @!attribute [r] usage_calculation
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::KubernetesEnginePodUsageFee::UsageCalculation]
  #     Output only. Determines how the customer's usage is calculated.
  # @!attribute [r] unit
  #   @return [::String]
  #     Output only. The price unit of the SKU.
  #     See https://ucum.org/ucum.html for the format of the price unit.
  #     For linear-priced memory SKUs, the price unit is 'GiBy.h'.
  #     For all other SKUs, the price unit is 'h'. This includes linear-priced
  #     VCPU, GPU, and TPU SKUs because these resources have unitless
  #     dimensions and the application of these scaling factors does not change
  #     the price unit.
  class KubernetesEnginePodUsageFee
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # The range of pod resource values that the SKU applies to.
    # @!attribute [r] start_value
    #   @return [::Integer]
    #     Output only. The inclusive lower bound of the range.
    # @!attribute [r] end_value
    #   @return [::Integer]
    #     Output only. The exclusive upper bound of the range.
    #     If no end value is specified, the range is unbounded from above.
    class PodResourceRange
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # The pod [resource
    # type](https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/)
    # that the SKU applies to.
    module PodResource
      # Unused.
      POD_RESOURCE_UNSPECIFIED = 0

      # The SKU applies based on the pod's [vCPU
      # count](https://kubernetes.io/docs/tasks/configure-pod-container/assign-cpu-resource/).
      VCPU_COUNT = 1

      # The SKU applies based on the pod's [memory
      # size](https://kubernetes.io/docs/tasks/configure-pod-container/assign-memory-resource/)
      # in bytes.
      MEMORY_BYTES = 2

      # The SKU applies based on the pod's GPU count.
      GPU_COUNT = 3

      # The SKU applies based on the pod's [TPU
      # count](https://cloud.google.com/kubernetes-engine/docs/concepts/tpus#how_tpus_work).
      TPU_COUNT = 4
    end

    # Determines how the customer's usage is calculated.
    module UsageCalculation
      # Unused.
      USAGE_CALCULATION_UNSPECIFIED = 0

      # Usage is calculated from pod runtime.
      # The customer's usage is metered in a manner similar to the [GKE
      # Autopilot mode for pods without specific hardware
      # requirements](https://cloud.google.com/kubernetes-engine/pricing),
      # priced on a per-pod basis in units of hours and measured in
      # one-second increments, with no minimum duration.
      #
      # A SKU using this usage calculation is referred to as "flat" because
      # the customer's usage charge is independent of the pod shape apart
      # from determining whether the SKU applies to the pod.
      POD_RUNTIME = 1

      # Usage is calculated from pod runtime and size.
      # This calculation mode is only applicable to resource-based SKUs.
      # Usage is calculated by measuring the pod runtime in the same manner
      # as for `POD_RUNTIME` and multiplying by the pod's resource value
      # matching the SKU's pod resource type.
      # This converts the price from per-pod-hour to
      # per-pod-hour-per-resource, which changes the price unit for memory
      # SKUs to 'GiBy.h'. The price unit otherwise remains 'h' because the
      # other resources are dimensionless.
      #
      # A SKU using this usage calculation is referred to as "linear" because
      # the customer's usage charge is linearly proportional to the
      # pod's resource value.
      LINEAR_RESOURCE_SCALED_POD_RUNTIME = 2
    end
  end

  # Details about a SKU pricing usage of an [AI Platform Managed Model
  # (MaaS)](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/partner-models/use-partner-models).
  # @!attribute [r] tiered_price
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::TieredPrice]
  #     Output only. [Tiered
  #     pricing](https://cloud.google.com/billing/docs/how-to/pricing-table#tiered-pricing)
  #     of the SKU.
  # @!attribute [r] usage_metric
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::AiPlatformManagedModelUsageMetric]
  #     Output only. The usage metric that the SKU applies to.
  # @!attribute [r] location
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelEndpointLocation]
  #     Output only. The model endpoint location where usage is priced by this
  #     SKU. If no location is specified, the SKU applies to usage in all
  #     locations.
  # @!attribute [r] prediction_mode
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::PredictionMode]
  #     Output only. The prediction mode of requests that the SKU applies to.
  # @!attribute [r] combined_request_input_tokens_range
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::CombinedRequestInputTokensRange]
  #     Output only. The range of aggregated input token values covered by the
  #     SKU. Unset if the SKU is not scoped to a particular range. A request is
  #     in scope for this SKU if its aggregated input token value falls within
  #     the range. The collection of SKUs in effect at any given time scoped to
  #     a particular aggregated input token value range will cover all possible
  #     values without overlap. Such a collection of SKUs form a "tiered" price
  #     structure over the possible value, with each SKU acting as a "tier".
  #
  #     NOTE: This is distinct from a SKU with [tiered
  #     pricing](https://cloud.google.com/billing/docs/how-to/pricing-table#tiered-pricing).
  # @!attribute [r] provisioned_throughput_overage
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::ProvisionedThroughputOverage]
  #     Output only. Set when the SKU is a historical provisioned throughput
  #     overage SKU. Starting 2025-08-26 such SKUs have no effect, and usage in
  #     excess of provisioned throughput quota is now metered as standard
  #     usage. This field is set only in historical SKU timeline entries for
  #     overage SKUs belonging to partners that offered provisioned throughput
  #     for AI Platform managed model products prior to the unification of
  #     standard usage and provisioned throughput overage metering.
  class AiPlatformManagedModelUsageFee
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # The usage metric that the SKU applies to.
    # @!attribute [r] input_tokens_metric
    #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::AiPlatformManagedModelUsageMetric::InputTokensMetric]
    #     Output only. Input tokens read from the prediction endpoint input.
    #
    #     Note: The following fields are mutually exclusive: `input_tokens_metric`, `cache_read_input_tokens_metric`, `cache_write_input_tokens_metric`, `output_tokens_metric`, `web_search_requests_metric`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] cache_read_input_tokens_metric
    #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::AiPlatformManagedModelUsageMetric::CacheReadInputTokensMetric]
    #     Output only. Input tokens read from the cache.
    #
    #     Note: The following fields are mutually exclusive: `cache_read_input_tokens_metric`, `input_tokens_metric`, `cache_write_input_tokens_metric`, `output_tokens_metric`, `web_search_requests_metric`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] cache_write_input_tokens_metric
    #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::AiPlatformManagedModelUsageMetric::CacheWriteInputTokensMetric]
    #     Output only. Input tokens written to the cache.
    #
    #     Note: The following fields are mutually exclusive: `cache_write_input_tokens_metric`, `input_tokens_metric`, `cache_read_input_tokens_metric`, `output_tokens_metric`, `web_search_requests_metric`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] output_tokens_metric
    #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::AiPlatformManagedModelUsageMetric::OutputTokensMetric]
    #     Output only. Output tokens returned from the prediction endpoint.
    #
    #     Note: The following fields are mutually exclusive: `output_tokens_metric`, `input_tokens_metric`, `cache_read_input_tokens_metric`, `cache_write_input_tokens_metric`, `web_search_requests_metric`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] web_search_requests_metric
    #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::AiPlatformManagedModelUsageMetric::WebSearchRequestsMetric]
    #     Output only. Web search requests executed by the model.
    #
    #     Note: The following fields are mutually exclusive: `web_search_requests_metric`, `input_tokens_metric`, `cache_read_input_tokens_metric`, `cache_write_input_tokens_metric`, `output_tokens_metric`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    class AiPlatformManagedModelUsageMetric
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # Input tokens read from the input to the prediction endpoint.
      # The unit for this metric is dimensionless.
      class InputTokensMetric
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end

      # Input tokens read from the cache.
      # The unit for this metric is dimensionless.
      class CacheReadInputTokensMetric
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end

      # Input tokens written to the cache.
      # The unit for this metric is dimensionless.
      # @!attribute [r] ttl
      #   @return [::Google::Protobuf::Duration]
      #     Output only. The duration the write is retained in the cache.
      class CacheWriteInputTokensMetric
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end

      # Output tokens returned from the prediction endpoint.
      # The unit for this metric is dimensionless.
      class OutputTokensMetric
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end

      # Web search requests executed by the model.
      # The unit for this metric is dimensionless.
      class WebSearchRequestsMetric
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end
    end

    # The range of aggregated input token values covered by the SKU.
    #
    # A request to a managed model has an aggregated input token value
    # determined by the sum of the metric values of the input token metrics.
    #
    # * input tokens
    # * cache read input tokens
    # * cache write input tokens
    # @!attribute [r] start_value
    #   @return [::Integer]
    #     Output only. The inclusive lower bound of the range.
    # @!attribute [r] end_value
    #   @return [::Integer]
    #     Output only. The exclusive upper bound of the range.
    #     If no end value is specified, the range is unbounded from above.
    class CombinedRequestInputTokensRange
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # Additional details present for historical provisioned throughput
    # "overage" SKUs that applied charges only to usage above the customer's
    # provisioned throughput quota threshold.
    # @!attribute [r] service
    #   @return [::String]
    #     Output only. The service whose usage the overage SKU applied to.
    class ProvisionedThroughputOverage
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # The prediction modes of requests that the SKU applies to.
    module PredictionMode
      # The SKU does not distinguish between prediction modes.
      PREDICTION_MODE_UNSPECIFIED = 0

      # The SKU applies to online prediction.
      ONLINE_PREDICTION = 1

      # The SKU applies to batch prediction.
      BATCH_PREDICTION = 2
    end
  end

  # Details about a SKU pricing reservation of [AI Platform Provisioned
  # Throughput](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/provisioned-throughput).
  #
  # Customers may purchase provisioned throughput reservations for AI
  # Platform managed model products. This provides the customer with
  # provisioned throughput quota for a particular model and location. Model
  # usage below the provisioned throughput quota threshold is voided and is
  # not charged by the product's managed model usage fees.
  # @!attribute [r] term_duration_months
  #   @return [::Integer]
  #     Output only. The duration of the provisioned throughput reservation
  #     in months.
  # @!attribute [rw] gsu_price_per_unit
  #   @return [::Google::Type::Money]
  #     The price per [Generative AI Scale Unit
  #     (GSU)](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/provisioned-throughput/measure-provisioned-throughput)
  #     per `unit`.
  #     A provisioned throughput reservation reserves a certain number of
  #     GSUs, and the customer is billed for those GSUs on a continuous basis
  #     for the duration of the reservation.
  # @!attribute [r] location
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelEndpointLocation]
  #     Output only. The location where provisioned throughput is priced by
  #     this SKU.
  # @!attribute [r] unit
  #   @return [::String]
  #     Output only. The price unit of the SKU.
  #     See https://ucum.org/ucum.html for the format of the price unit.
  #     Since provisioned throughput reservations are billed by duration, this
  #     will always be a time unit. The price unit of a provisioned throughput
  #     SKU is not necessarily the same as the reservation term.
  #     This field is unrelated to the [Generative AI Scale Unit
  #     (GSU)](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/provisioned-throughput/measure-provisioned-throughput).
  #
  #     Currently the unit is always months ('mo').
  #     Additional time units may be supported in future.
  #
  #     The customary unit month ('mo') requires special handling to account
  #     for the variable duration of months. A price may be denominated in
  #     units of months, but the duration the reservation is active is measured
  #     in metric time and customers are billed on that basis. The exact hourly
  #     or per-second price can be calculated by dividing the monthly price
  #     by the number of hours or seconds in the desired month. A reservation
  #     active for N months is rarely billed exactly N times the monthly price.
  #     This is intended and is not a billing error.
  class AiPlatformProvisionedThroughputFee
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Details about a SKU pricing usage of an [AI Platform Self Deployed
  # Model](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/model-garden/self-deployed-models).
  # @!attribute [r] accelerator_type
  #   @return [::String]
  #     Output only. The SKU applies to a specific accelerator type.
  #     Contains the name of the matching [AI Platform AcceleratorType](
  #     https://docs.cloud.google.com/gemini-enterprise-agent-platform/reference/rest/v1/MachineSpec#AcceleratorType).
  #     The corresponding linear scaling value is the dimensionless
  #     [`accelerator_count`](https://docs.cloud.google.com/gemini-enterprise-agent-platform/reference/rest/v1/MachineSpec#FIELDS.accelerator_count).
  # @!attribute [r] price_per_unit
  #   @return [::Google::Type::Money]
  #     Output only. The price per unit of usage.
  #     The customer's usage charge is computed by measuring the customer's
  #     consumption denominated in price units and multiplying by this price.
  # @!attribute [r] unit
  #   @return [::String]
  #     Output only. The price unit of the SKU.
  #     See https://ucum.org/ucum.html for the format of the price unit.
  #     Currently the unit is always hours ('h'). This may change in future.
  # @!attribute [r] usage_calculation
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformDeployedModelUsageFee::UsageCalculation]
  #     Output only. Determines how the customer's usage is calculated.
  class AiPlatformDeployedModelUsageFee
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Determines how the customer's usage is calculated.
    module UsageCalculation
      # Unused.
      USAGE_CALCULATION_UNSPECIFIED = 0

      # Usage is calculated from deployment runtime and size.
      # Usage is calculated by measuring the deployment runtime in hours and
      # multiplying by the amount of the deployed model's hardware resource
      # matching the SKU's hardware resource type.
      # This results in a composite `unit` of hours ('h') multiplied by the
      # unit that denominates the hardware resource, though note that
      # multiplying by the dimensionless unit ("1") has no effect.
      LINEAR_RESOURCE_SCALED_DEPLOYMENT_RUNTIME = 2
    end
  end

  # Details about a SKU charging a flat subscription fee.
  # @!attribute [r] price_per_unit
  #   @return [::Google::Type::Money]
  #     Output only. The price per time unit the subscription is active.
  # @!attribute [r] unit
  #   @return [::String]
  #     Output only. The unit of the subscription SKU.
  #     See https://ucum.org/ucum.html for the format of the price unit.
  #     Since subscriptions are billed by duration, this will always be a time
  #     unit. The price unit of a subscription SKU is not necessarily the same
  #     as the subscription period of the corresponding StandardOffers.
  #
  #     Currently the unit is always months ('mo').
  #     Additional time units may be supported in future.
  #
  #     The unit month ('mo') is a customary time unit and requires special
  #     handling to account for the variable duration of months. A price may be
  #     denominated in units of months, but the duration the subscription is
  #     active is measured in metric time and customers are billed on that
  #     basis. The exact hourly or per-second price can be calculated by
  #     dividing the monthly price by the number of hours or seconds in the
  #     desired month. A subscription active for N months is rarely billed
  #     exactly N times the monthly price. This is intended and is not a
  #     billing error.
  class FlatSubscriptionFee
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Price structure for a SKU charging a [tiered
  # price](https://cloud.google.com/billing/docs/how-to/pricing-table#tiered-pricing).
  # @!attribute [r] unit
  #   @return [::String]
  #     Output only. Usage unit used for defining price tiers and for scaling
  #     with the price_unit_count to form the composite price unit.
  #
  #     See https://ucum.org/ucum.html for the format of the price unit.
  #     A unitless dimension, such as a count, is represented as `1`.
  # @!attribute [r] unit_description
  #   @return [::String]
  #     Output only. The display description of the unit, supplied at time of
  #     onboarding. This value is recommended to be set at least for
  #     dimensionless metrics, but may be empty if no description was provided
  #     at time of onboarding.
  # @!attribute [r] price_unit_count
  #   @return [::Google::Type::Decimal]
  #     Output only. Scaling  the `unit` by the `price_unit_count` forms the
  #     composite "price unit" which is priced by the price tiers.
  #
  #     This scaling factor is in addition to any numerical prefix symbol on
  #     the `unit`, so the same composite "price unit" can be represented in
  #     several ways, differing only in their presentation to users.
  #
  #     Examples:
  #
  #     * $1    per 1    bytes     : unit = By,  price_unit_count = 1
  #     * $1000 per 1    kilobytes : unit = kBy, price_unit_count = 1
  #     * $5000 per 5    kilobytes : unit = kBy, price_unit_count = 5
  # @!attribute [r] price_tiers
  #   @return [::Array<::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::TieredPrice::PriceTier>]
  #     Output only. The list of price tiers for the SKU, ordered by the
  #     start_amount.
  #
  #     The tiers are non-overlapping and are collectively bounded below by
  #     zero and unbounded above to cover the entire range of possible metric
  #     usage. Each tier is bounded below inclusively by its start_amount and
  #     bounded above exclusively by the start_amount of the next tier, or else
  #     unbounded above if there is no next tier.
  #
  #     Usage of the metric is aggregated by customer billing account on a
  #     monthly basis and billed in a graduated manner according to the price
  #     tiers, with each marginal unit of usage priced accoring to the tier in
  #     which it falls.
  class TieredPrice
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # A [price
    # tier](https://cloud.google.com/billing/docs/how-to/pricing-table#tiered-pricing)
    # pricing metric usage within a range.
    #
    # Each marginal unit of usage is priced according to the price tier in
    # which it falls.
    # @!attribute [r] start_amount
    #   @return [::Google::Type::Decimal]
    #     Output only. Inclusive lower bound of the tier interval, denominated
    #     in `unit`.
    # @!attribute [r] price
    #   @return [::Google::Type::Money]
    #     Output only. The price per `price_unit_count` of `unit` in the tier.
    #     The price is applied fractionally if the customer's usage within the
    #     tier is not an integer multiple of `price_unit_count`.
    class PriceTier
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end
  end

  # Location scope for a SKU that applies to an AI Platform Managed Model
  # endpoint.
  # @!attribute [r] region_id
  #   @return [::String]
  #     Output only. The SKU applies to a region.
  #
  #     Note: The following fields are mutually exclusive: `region_id`, `global_endpoint`, `multi_region_id`. If a field in that set is populated, all other fields in the set will automatically be cleared.
  # @!attribute [r] global_endpoint
  #   @return [::Boolean]
  #     Output only. The SKU applies to a [global
  #     endpoint](https://docs.cloud.google.com/gemini-enterprise-agent-platform/resources/locations).
  #     **Note**: This is distinct from the conventional meaning of "global"
  #     as a SKU that applies to all locations.
  #
  #     Note: The following fields are mutually exclusive: `global_endpoint`, `region_id`, `multi_region_id`. If a field in that set is populated, all other fields in the set will automatically be cleared.
  # @!attribute [r] multi_region_id
  #   @return [::String]
  #     Output only. The SKU applies to a multi-region.
  #
  #     Note: The following fields are mutually exclusive: `multi_region_id`, `region_id`, `global_endpoint`. If a field in that set is populated, all other fields in the set will automatically be cleared.
  class AiPlatformManagedModelEndpointLocation
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end
end

#gce_license_usage_fee::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::ComputeEngineLicenseUsageFee (readonly)

Returns Output only. The SKU prices usage of a Compute Engine License via a license fee applied to running instances that use the license.

Note: The following fields are mutually exclusive: gce_license_usage_fee, inactive, managed_service_metric_usage_fee, gke_pod_usage_fee, ai_platform_managed_model_usage_fee, ai_platform_provisioned_throughput_fee, ai_platform_deployed_model_usage_fee, flat_subscription_fee. If a field in that set is populated, all other fields in the set will automatically be cleared.

Returns:

  • (::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::ComputeEngineLicenseUsageFee)

    Output only. The SKU prices usage of a Compute Engine License via a license fee applied to running instances that use the license.

    Note: The following fields are mutually exclusive: gce_license_usage_fee, inactive, managed_service_metric_usage_fee, gke_pod_usage_fee, ai_platform_managed_model_usage_fee, ai_platform_provisioned_throughput_fee, ai_platform_deployed_model_usage_fee, flat_subscription_fee. If a field in that set is populated, all other fields in the set will automatically be cleared.



125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
# File 'proto_docs/google/cloud/commerceproducer/v1beta/sku.rb', line 125

class SkuPrice
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # Representation for a SKU that is not active and has no price.
  class InactiveSkuPrice
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Details about a SKU pricing usage of a [partner-reported custom billing
  # metric](https://cloud.google.com/service-infrastructure/docs/reporting-billing-metrics)
  # defined by the partner in the Service Management API and reported using
  # the Service Control API.
  #
  # The customer's usage charge is computed by converting the customer's
  # reported consumption to the SKU's composite price unit and applying the
  # graduated price from the appropriate price tier.
  # @!attribute [r] tiered_price
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::TieredPrice]
  #     Output only. [Tiered
  #     pricing](https://cloud.google.com/billing/docs/how-to/pricing-table#tiered-pricing)
  #     of the SKU.
  # @!attribute [r] canonical_metric
  #   @return [::String]
  #     Output only. The name of the metric, in canonical format.
  #
  #     Note that in the canonical format the first character of the path
  #     component of the metric name is always uppercase, which may differ
  #     from the metric name in the service config. For example, a metric
  #     appearing in the service config as 'example.com/example_metric' will
  #     appear here in the SKU as 'example.com/Example_metric'. In the Service
  #     Management and Service Control APIs these two metric names are
  #     considered distinct, either or both may be defined, and usage must be
  #     reported using a name matching the name of a metric defined in the
  #     service config. But for billing purposes usage reported using either
  #     name will be aggregated under the canonical metric name.
  #
  #     Example: "example.com/Example_metric"
  class ManagedServiceMetricUsageFee
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Details about a SKU pricing usage of a [Compute Engine
  # License](https://cloud.google.com/compute/docs/licenses/about).
  #
  # The SKU applies to a single license, and may be further scoped to a
  # [Compute
  # Engine VM Instance](https://cloud.google.com/compute/docs/instances)
  # machine resource type (e.g. "vCPU") and size range for that machine
  # resource. Instances deployed from [Compute
  # Engine Images](https://cloud.google.com/compute/docs/images)
  # incorporating the target license and (if applicable) matching the machine
  # resource type size range will be charged by the SKU. A single license may
  # be priced by multiple SKUs covering different combinations of machine
  # resource type and size range, allowing a single running instance to be
  # charged by up to one SKU per machine resource type, with pricing tiered
  # according to machine shape.
  # @!attribute [rw] price_per_unit
  #   @return [::Google::Type::Money]
  #     The price per unit of usage.
  #     The customer's usage charge is computed by measuring the customer's
  #     consumption denominated in price units and multiplying by this price.
  # @!attribute [r] license_code
  #   @return [::String]
  #     Output only. The license code of the target Compute Engine License.
  #     Note that this is the numeric license code itself in uint64 format used
  #     to reference licenses attached to images, not the resource name of the
  #     related [Compute Engine LicenseCode
  #     resource](https://cloud.google.com/compute/docs/reference/rest/v1/licenseCodes).
  #
  #     Example: "1234567890123456789"
  # @!attribute [r] machine_resource
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::ComputeEngineLicenseUsageFee::MachineResource]
  #     Output only. The machine resource type that the SKU applies to, if any.
  #     SKUs with a non-default value are referred to as "resource-based" SKUs.
  # @!attribute [r] machine_resource_range
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::ComputeEngineLicenseUsageFee::MachineResourceRange]
  #     Output only. The range of machine resource values that the SKU applies
  #     to. Unset when the SKU is not scoped to a particular machine resource
  #     type. The collection of SKUs in effect at any given time targeting the
  #     same license and machine resource type will cover all possible values
  #     for that machine resource type without overlap. Such a collection of
  #     SKUs form a "tiered" price structure over the possible values of the
  #     machine resource, with each SKU acting as a "tier".
  #
  #     NOTE: This is distinct from a SKU with [tiered
  #     pricing](https://cloud.google.com/billing/docs/how-to/pricing-table#tiered-pricing).
  # @!attribute [r] usage_calculation
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::ComputeEngineLicenseUsageFee::UsageCalculation]
  #     Output only. Determines how the customer's usage is calculated.
  # @!attribute [r] unit
  #   @return [::String]
  #     Output only. The price unit of the SKU.
  #     See https://ucum.org/ucum.html for the format of the price unit.
  #     For linear-priced memory SKUs, the price unit is 'GiBy.h'.
  #     For all other SKUs, the price unit is 'h'. This includes linear-priced
  #     vCPU and GPU SKUs because these resources have unitless dimensions and
  #     the application of these scaling factors does not change the price
  #     unit.
  class ComputeEngineLicenseUsageFee
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # The range of machine resource values that the SKU applies to.
    # @!attribute [r] start_value
    #   @return [::Integer]
    #     Output only. The inclusive lower bound of the range.
    #     While the number zero may be the start of a range, it is not a
    #     possible machine resource value. An instance cannot exist with zero
    #     vCPU or memory, and an instance with no attached accelerators lacks a
    #     GPU dimension entirely rather than having a GPU count of zero.
    # @!attribute [r] end_value
    #   @return [::Integer]
    #     Output only. The exclusive upper bound of the range.
    #     If no end value is specified, the range is unbounded from above.
    class MachineResourceRange
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # The machine resource type that the SKU applies to, if any.
    module MachineResource
      # The SKU applies to all instances irrespective of machine shape.
      # This is referred to as "instance-based pricing" because the price
      # is the same for all instances.
      MACHINE_RESOURCE_UNSPECIFIED = 0

      # The SKU applies based on the instance's vCPU count.
      VCPU_COUNT = 1

      # The SKU applies based on the instance's memory size in bytes.
      MEMORY_BYTES = 2

      # The SKU applies based on the instance's GPU count.
      GPU_COUNT = 3
    end

    # Determines how the customer's usage is calculated.
    module UsageCalculation
      # Unused.
      USAGE_CALCULATION_UNSPECIFIED = 0

      # Usage is calculated from instance runtime.
      # The customer's usage is metered according to the [Compute Engine VM
      # instance pricing
      # model](https://cloud.google.com/compute/vm-instance-pricing),
      # measured on a per-instance basis in units of hours, with a minimum
      # duration of one minute and an increment of one second.
      #
      # A SKU using this usage calculation is referred to as "flat" because
      # the customer's usage charge is independent of the instance's machine
      # resource shape apart from determining whether the SKU applies to the
      # instance.
      INSTANCE_RUNTIME = 1

      # Usage is calculated from instance runtime and size.
      # This calculation mode is only applicable to resource-based SKUs.
      # Usage is calculated by measuring the instance runtime in the same
      # manner as for `INSTANCE_RUNTIME` and multiplying by the instance's
      # machine resource value matching the SKU's machine resource type.
      # This converts the price from per-instance-hour to
      # per-instance-hour-per-machine-resource, which changes the price unit
      # for memory SKUs to 'GiBy.h'. The price unit otherwise remains 'h'
      # because the other machine resources are dimensionless.
      #
      # A SKU using this usage calculation is referred to as "linear" because
      # the customer's usage charge is linearly proportional to the
      # instance's machine resource value.
      LINEAR_RESOURCE_SCALED_INSTANCE_RUNTIME = 2
    end
  end

  # Details about a SKU pricing usage of software running on a Kubernetes
  # Engine pod.
  #
  # The SKU applies to pods annotated with the SKU's parent service name, and
  # may be further scoped to a [k8s pod resource
  # type](https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/)
  # (e.g. "CPU") and size range for that resource type. Running pods
  # annotated with the parent service's service name and matching the pod
  # resource type size range will be charged by the SKU. A service may be
  # priced by multiple SKUs covering different combinations of pod resource
  # type and size range, allowing a single running pod to be charged by up to
  # one SKU per pod resource type, with pricing tiered according to pod
  # shape.
  # @!attribute [rw] price_per_unit
  #   @return [::Google::Type::Money]
  #     The price per unit of usage.
  #     The customer's usage charge is computed by measuring the customer's
  #     consumption denominated in price units and multiplying by this price.
  # @!attribute [r] pod_resource
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::KubernetesEnginePodUsageFee::PodResource]
  #     Output only. The pod resource type that the SKU applies to.
  #     SKUs with a non-default value are referred to as "resource-based" SKUs.
  # @!attribute [r] pod_resource_range
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::KubernetesEnginePodUsageFee::PodResourceRange]
  #     Output only. The range of pod resource values that the SKU applies to.
  #     The collection of SKUs in effect at any given time targeting the same
  #     service annotation and pod resource type will cover all possible values
  #     for that pod resource type without overlap. Such a collection of SKUs
  #     form a "tiered" price structure over the possible values of the pod
  #     resource, with each SKU acting as a "tier".
  #
  #     NOTE: This is distinct from a SKU with [tiered
  #     pricing](https://cloud.google.com/billing/docs/how-to/pricing-table#tiered-pricing).
  # @!attribute [r] usage_calculation
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::KubernetesEnginePodUsageFee::UsageCalculation]
  #     Output only. Determines how the customer's usage is calculated.
  # @!attribute [r] unit
  #   @return [::String]
  #     Output only. The price unit of the SKU.
  #     See https://ucum.org/ucum.html for the format of the price unit.
  #     For linear-priced memory SKUs, the price unit is 'GiBy.h'.
  #     For all other SKUs, the price unit is 'h'. This includes linear-priced
  #     VCPU, GPU, and TPU SKUs because these resources have unitless
  #     dimensions and the application of these scaling factors does not change
  #     the price unit.
  class KubernetesEnginePodUsageFee
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # The range of pod resource values that the SKU applies to.
    # @!attribute [r] start_value
    #   @return [::Integer]
    #     Output only. The inclusive lower bound of the range.
    # @!attribute [r] end_value
    #   @return [::Integer]
    #     Output only. The exclusive upper bound of the range.
    #     If no end value is specified, the range is unbounded from above.
    class PodResourceRange
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # The pod [resource
    # type](https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/)
    # that the SKU applies to.
    module PodResource
      # Unused.
      POD_RESOURCE_UNSPECIFIED = 0

      # The SKU applies based on the pod's [vCPU
      # count](https://kubernetes.io/docs/tasks/configure-pod-container/assign-cpu-resource/).
      VCPU_COUNT = 1

      # The SKU applies based on the pod's [memory
      # size](https://kubernetes.io/docs/tasks/configure-pod-container/assign-memory-resource/)
      # in bytes.
      MEMORY_BYTES = 2

      # The SKU applies based on the pod's GPU count.
      GPU_COUNT = 3

      # The SKU applies based on the pod's [TPU
      # count](https://cloud.google.com/kubernetes-engine/docs/concepts/tpus#how_tpus_work).
      TPU_COUNT = 4
    end

    # Determines how the customer's usage is calculated.
    module UsageCalculation
      # Unused.
      USAGE_CALCULATION_UNSPECIFIED = 0

      # Usage is calculated from pod runtime.
      # The customer's usage is metered in a manner similar to the [GKE
      # Autopilot mode for pods without specific hardware
      # requirements](https://cloud.google.com/kubernetes-engine/pricing),
      # priced on a per-pod basis in units of hours and measured in
      # one-second increments, with no minimum duration.
      #
      # A SKU using this usage calculation is referred to as "flat" because
      # the customer's usage charge is independent of the pod shape apart
      # from determining whether the SKU applies to the pod.
      POD_RUNTIME = 1

      # Usage is calculated from pod runtime and size.
      # This calculation mode is only applicable to resource-based SKUs.
      # Usage is calculated by measuring the pod runtime in the same manner
      # as for `POD_RUNTIME` and multiplying by the pod's resource value
      # matching the SKU's pod resource type.
      # This converts the price from per-pod-hour to
      # per-pod-hour-per-resource, which changes the price unit for memory
      # SKUs to 'GiBy.h'. The price unit otherwise remains 'h' because the
      # other resources are dimensionless.
      #
      # A SKU using this usage calculation is referred to as "linear" because
      # the customer's usage charge is linearly proportional to the
      # pod's resource value.
      LINEAR_RESOURCE_SCALED_POD_RUNTIME = 2
    end
  end

  # Details about a SKU pricing usage of an [AI Platform Managed Model
  # (MaaS)](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/partner-models/use-partner-models).
  # @!attribute [r] tiered_price
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::TieredPrice]
  #     Output only. [Tiered
  #     pricing](https://cloud.google.com/billing/docs/how-to/pricing-table#tiered-pricing)
  #     of the SKU.
  # @!attribute [r] usage_metric
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::AiPlatformManagedModelUsageMetric]
  #     Output only. The usage metric that the SKU applies to.
  # @!attribute [r] location
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelEndpointLocation]
  #     Output only. The model endpoint location where usage is priced by this
  #     SKU. If no location is specified, the SKU applies to usage in all
  #     locations.
  # @!attribute [r] prediction_mode
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::PredictionMode]
  #     Output only. The prediction mode of requests that the SKU applies to.
  # @!attribute [r] combined_request_input_tokens_range
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::CombinedRequestInputTokensRange]
  #     Output only. The range of aggregated input token values covered by the
  #     SKU. Unset if the SKU is not scoped to a particular range. A request is
  #     in scope for this SKU if its aggregated input token value falls within
  #     the range. The collection of SKUs in effect at any given time scoped to
  #     a particular aggregated input token value range will cover all possible
  #     values without overlap. Such a collection of SKUs form a "tiered" price
  #     structure over the possible value, with each SKU acting as a "tier".
  #
  #     NOTE: This is distinct from a SKU with [tiered
  #     pricing](https://cloud.google.com/billing/docs/how-to/pricing-table#tiered-pricing).
  # @!attribute [r] provisioned_throughput_overage
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::ProvisionedThroughputOverage]
  #     Output only. Set when the SKU is a historical provisioned throughput
  #     overage SKU. Starting 2025-08-26 such SKUs have no effect, and usage in
  #     excess of provisioned throughput quota is now metered as standard
  #     usage. This field is set only in historical SKU timeline entries for
  #     overage SKUs belonging to partners that offered provisioned throughput
  #     for AI Platform managed model products prior to the unification of
  #     standard usage and provisioned throughput overage metering.
  class AiPlatformManagedModelUsageFee
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # The usage metric that the SKU applies to.
    # @!attribute [r] input_tokens_metric
    #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::AiPlatformManagedModelUsageMetric::InputTokensMetric]
    #     Output only. Input tokens read from the prediction endpoint input.
    #
    #     Note: The following fields are mutually exclusive: `input_tokens_metric`, `cache_read_input_tokens_metric`, `cache_write_input_tokens_metric`, `output_tokens_metric`, `web_search_requests_metric`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] cache_read_input_tokens_metric
    #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::AiPlatformManagedModelUsageMetric::CacheReadInputTokensMetric]
    #     Output only. Input tokens read from the cache.
    #
    #     Note: The following fields are mutually exclusive: `cache_read_input_tokens_metric`, `input_tokens_metric`, `cache_write_input_tokens_metric`, `output_tokens_metric`, `web_search_requests_metric`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] cache_write_input_tokens_metric
    #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::AiPlatformManagedModelUsageMetric::CacheWriteInputTokensMetric]
    #     Output only. Input tokens written to the cache.
    #
    #     Note: The following fields are mutually exclusive: `cache_write_input_tokens_metric`, `input_tokens_metric`, `cache_read_input_tokens_metric`, `output_tokens_metric`, `web_search_requests_metric`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] output_tokens_metric
    #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::AiPlatformManagedModelUsageMetric::OutputTokensMetric]
    #     Output only. Output tokens returned from the prediction endpoint.
    #
    #     Note: The following fields are mutually exclusive: `output_tokens_metric`, `input_tokens_metric`, `cache_read_input_tokens_metric`, `cache_write_input_tokens_metric`, `web_search_requests_metric`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] web_search_requests_metric
    #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::AiPlatformManagedModelUsageMetric::WebSearchRequestsMetric]
    #     Output only. Web search requests executed by the model.
    #
    #     Note: The following fields are mutually exclusive: `web_search_requests_metric`, `input_tokens_metric`, `cache_read_input_tokens_metric`, `cache_write_input_tokens_metric`, `output_tokens_metric`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    class AiPlatformManagedModelUsageMetric
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # Input tokens read from the input to the prediction endpoint.
      # The unit for this metric is dimensionless.
      class InputTokensMetric
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end

      # Input tokens read from the cache.
      # The unit for this metric is dimensionless.
      class CacheReadInputTokensMetric
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end

      # Input tokens written to the cache.
      # The unit for this metric is dimensionless.
      # @!attribute [r] ttl
      #   @return [::Google::Protobuf::Duration]
      #     Output only. The duration the write is retained in the cache.
      class CacheWriteInputTokensMetric
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end

      # Output tokens returned from the prediction endpoint.
      # The unit for this metric is dimensionless.
      class OutputTokensMetric
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end

      # Web search requests executed by the model.
      # The unit for this metric is dimensionless.
      class WebSearchRequestsMetric
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end
    end

    # The range of aggregated input token values covered by the SKU.
    #
    # A request to a managed model has an aggregated input token value
    # determined by the sum of the metric values of the input token metrics.
    #
    # * input tokens
    # * cache read input tokens
    # * cache write input tokens
    # @!attribute [r] start_value
    #   @return [::Integer]
    #     Output only. The inclusive lower bound of the range.
    # @!attribute [r] end_value
    #   @return [::Integer]
    #     Output only. The exclusive upper bound of the range.
    #     If no end value is specified, the range is unbounded from above.
    class CombinedRequestInputTokensRange
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # Additional details present for historical provisioned throughput
    # "overage" SKUs that applied charges only to usage above the customer's
    # provisioned throughput quota threshold.
    # @!attribute [r] service
    #   @return [::String]
    #     Output only. The service whose usage the overage SKU applied to.
    class ProvisionedThroughputOverage
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # The prediction modes of requests that the SKU applies to.
    module PredictionMode
      # The SKU does not distinguish between prediction modes.
      PREDICTION_MODE_UNSPECIFIED = 0

      # The SKU applies to online prediction.
      ONLINE_PREDICTION = 1

      # The SKU applies to batch prediction.
      BATCH_PREDICTION = 2
    end
  end

  # Details about a SKU pricing reservation of [AI Platform Provisioned
  # Throughput](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/provisioned-throughput).
  #
  # Customers may purchase provisioned throughput reservations for AI
  # Platform managed model products. This provides the customer with
  # provisioned throughput quota for a particular model and location. Model
  # usage below the provisioned throughput quota threshold is voided and is
  # not charged by the product's managed model usage fees.
  # @!attribute [r] term_duration_months
  #   @return [::Integer]
  #     Output only. The duration of the provisioned throughput reservation
  #     in months.
  # @!attribute [rw] gsu_price_per_unit
  #   @return [::Google::Type::Money]
  #     The price per [Generative AI Scale Unit
  #     (GSU)](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/provisioned-throughput/measure-provisioned-throughput)
  #     per `unit`.
  #     A provisioned throughput reservation reserves a certain number of
  #     GSUs, and the customer is billed for those GSUs on a continuous basis
  #     for the duration of the reservation.
  # @!attribute [r] location
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelEndpointLocation]
  #     Output only. The location where provisioned throughput is priced by
  #     this SKU.
  # @!attribute [r] unit
  #   @return [::String]
  #     Output only. The price unit of the SKU.
  #     See https://ucum.org/ucum.html for the format of the price unit.
  #     Since provisioned throughput reservations are billed by duration, this
  #     will always be a time unit. The price unit of a provisioned throughput
  #     SKU is not necessarily the same as the reservation term.
  #     This field is unrelated to the [Generative AI Scale Unit
  #     (GSU)](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/provisioned-throughput/measure-provisioned-throughput).
  #
  #     Currently the unit is always months ('mo').
  #     Additional time units may be supported in future.
  #
  #     The customary unit month ('mo') requires special handling to account
  #     for the variable duration of months. A price may be denominated in
  #     units of months, but the duration the reservation is active is measured
  #     in metric time and customers are billed on that basis. The exact hourly
  #     or per-second price can be calculated by dividing the monthly price
  #     by the number of hours or seconds in the desired month. A reservation
  #     active for N months is rarely billed exactly N times the monthly price.
  #     This is intended and is not a billing error.
  class AiPlatformProvisionedThroughputFee
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Details about a SKU pricing usage of an [AI Platform Self Deployed
  # Model](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/model-garden/self-deployed-models).
  # @!attribute [r] accelerator_type
  #   @return [::String]
  #     Output only. The SKU applies to a specific accelerator type.
  #     Contains the name of the matching [AI Platform AcceleratorType](
  #     https://docs.cloud.google.com/gemini-enterprise-agent-platform/reference/rest/v1/MachineSpec#AcceleratorType).
  #     The corresponding linear scaling value is the dimensionless
  #     [`accelerator_count`](https://docs.cloud.google.com/gemini-enterprise-agent-platform/reference/rest/v1/MachineSpec#FIELDS.accelerator_count).
  # @!attribute [r] price_per_unit
  #   @return [::Google::Type::Money]
  #     Output only. The price per unit of usage.
  #     The customer's usage charge is computed by measuring the customer's
  #     consumption denominated in price units and multiplying by this price.
  # @!attribute [r] unit
  #   @return [::String]
  #     Output only. The price unit of the SKU.
  #     See https://ucum.org/ucum.html for the format of the price unit.
  #     Currently the unit is always hours ('h'). This may change in future.
  # @!attribute [r] usage_calculation
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformDeployedModelUsageFee::UsageCalculation]
  #     Output only. Determines how the customer's usage is calculated.
  class AiPlatformDeployedModelUsageFee
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Determines how the customer's usage is calculated.
    module UsageCalculation
      # Unused.
      USAGE_CALCULATION_UNSPECIFIED = 0

      # Usage is calculated from deployment runtime and size.
      # Usage is calculated by measuring the deployment runtime in hours and
      # multiplying by the amount of the deployed model's hardware resource
      # matching the SKU's hardware resource type.
      # This results in a composite `unit` of hours ('h') multiplied by the
      # unit that denominates the hardware resource, though note that
      # multiplying by the dimensionless unit ("1") has no effect.
      LINEAR_RESOURCE_SCALED_DEPLOYMENT_RUNTIME = 2
    end
  end

  # Details about a SKU charging a flat subscription fee.
  # @!attribute [r] price_per_unit
  #   @return [::Google::Type::Money]
  #     Output only. The price per time unit the subscription is active.
  # @!attribute [r] unit
  #   @return [::String]
  #     Output only. The unit of the subscription SKU.
  #     See https://ucum.org/ucum.html for the format of the price unit.
  #     Since subscriptions are billed by duration, this will always be a time
  #     unit. The price unit of a subscription SKU is not necessarily the same
  #     as the subscription period of the corresponding StandardOffers.
  #
  #     Currently the unit is always months ('mo').
  #     Additional time units may be supported in future.
  #
  #     The unit month ('mo') is a customary time unit and requires special
  #     handling to account for the variable duration of months. A price may be
  #     denominated in units of months, but the duration the subscription is
  #     active is measured in metric time and customers are billed on that
  #     basis. The exact hourly or per-second price can be calculated by
  #     dividing the monthly price by the number of hours or seconds in the
  #     desired month. A subscription active for N months is rarely billed
  #     exactly N times the monthly price. This is intended and is not a
  #     billing error.
  class FlatSubscriptionFee
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Price structure for a SKU charging a [tiered
  # price](https://cloud.google.com/billing/docs/how-to/pricing-table#tiered-pricing).
  # @!attribute [r] unit
  #   @return [::String]
  #     Output only. Usage unit used for defining price tiers and for scaling
  #     with the price_unit_count to form the composite price unit.
  #
  #     See https://ucum.org/ucum.html for the format of the price unit.
  #     A unitless dimension, such as a count, is represented as `1`.
  # @!attribute [r] unit_description
  #   @return [::String]
  #     Output only. The display description of the unit, supplied at time of
  #     onboarding. This value is recommended to be set at least for
  #     dimensionless metrics, but may be empty if no description was provided
  #     at time of onboarding.
  # @!attribute [r] price_unit_count
  #   @return [::Google::Type::Decimal]
  #     Output only. Scaling  the `unit` by the `price_unit_count` forms the
  #     composite "price unit" which is priced by the price tiers.
  #
  #     This scaling factor is in addition to any numerical prefix symbol on
  #     the `unit`, so the same composite "price unit" can be represented in
  #     several ways, differing only in their presentation to users.
  #
  #     Examples:
  #
  #     * $1    per 1    bytes     : unit = By,  price_unit_count = 1
  #     * $1000 per 1    kilobytes : unit = kBy, price_unit_count = 1
  #     * $5000 per 5    kilobytes : unit = kBy, price_unit_count = 5
  # @!attribute [r] price_tiers
  #   @return [::Array<::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::TieredPrice::PriceTier>]
  #     Output only. The list of price tiers for the SKU, ordered by the
  #     start_amount.
  #
  #     The tiers are non-overlapping and are collectively bounded below by
  #     zero and unbounded above to cover the entire range of possible metric
  #     usage. Each tier is bounded below inclusively by its start_amount and
  #     bounded above exclusively by the start_amount of the next tier, or else
  #     unbounded above if there is no next tier.
  #
  #     Usage of the metric is aggregated by customer billing account on a
  #     monthly basis and billed in a graduated manner according to the price
  #     tiers, with each marginal unit of usage priced accoring to the tier in
  #     which it falls.
  class TieredPrice
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # A [price
    # tier](https://cloud.google.com/billing/docs/how-to/pricing-table#tiered-pricing)
    # pricing metric usage within a range.
    #
    # Each marginal unit of usage is priced according to the price tier in
    # which it falls.
    # @!attribute [r] start_amount
    #   @return [::Google::Type::Decimal]
    #     Output only. Inclusive lower bound of the tier interval, denominated
    #     in `unit`.
    # @!attribute [r] price
    #   @return [::Google::Type::Money]
    #     Output only. The price per `price_unit_count` of `unit` in the tier.
    #     The price is applied fractionally if the customer's usage within the
    #     tier is not an integer multiple of `price_unit_count`.
    class PriceTier
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end
  end

  # Location scope for a SKU that applies to an AI Platform Managed Model
  # endpoint.
  # @!attribute [r] region_id
  #   @return [::String]
  #     Output only. The SKU applies to a region.
  #
  #     Note: The following fields are mutually exclusive: `region_id`, `global_endpoint`, `multi_region_id`. If a field in that set is populated, all other fields in the set will automatically be cleared.
  # @!attribute [r] global_endpoint
  #   @return [::Boolean]
  #     Output only. The SKU applies to a [global
  #     endpoint](https://docs.cloud.google.com/gemini-enterprise-agent-platform/resources/locations).
  #     **Note**: This is distinct from the conventional meaning of "global"
  #     as a SKU that applies to all locations.
  #
  #     Note: The following fields are mutually exclusive: `global_endpoint`, `region_id`, `multi_region_id`. If a field in that set is populated, all other fields in the set will automatically be cleared.
  # @!attribute [r] multi_region_id
  #   @return [::String]
  #     Output only. The SKU applies to a multi-region.
  #
  #     Note: The following fields are mutually exclusive: `multi_region_id`, `region_id`, `global_endpoint`. If a field in that set is populated, all other fields in the set will automatically be cleared.
  class AiPlatformManagedModelEndpointLocation
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end
end

#gke_pod_usage_fee::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::KubernetesEnginePodUsageFee (readonly)

Returns Output only. The SKU prices usage of software deployed on Kubernetes Engine.

Note: The following fields are mutually exclusive: gke_pod_usage_fee, inactive, managed_service_metric_usage_fee, gce_license_usage_fee, ai_platform_managed_model_usage_fee, ai_platform_provisioned_throughput_fee, ai_platform_deployed_model_usage_fee, flat_subscription_fee. If a field in that set is populated, all other fields in the set will automatically be cleared.

Returns:

  • (::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::KubernetesEnginePodUsageFee)

    Output only. The SKU prices usage of software deployed on Kubernetes Engine.

    Note: The following fields are mutually exclusive: gke_pod_usage_fee, inactive, managed_service_metric_usage_fee, gce_license_usage_fee, ai_platform_managed_model_usage_fee, ai_platform_provisioned_throughput_fee, ai_platform_deployed_model_usage_fee, flat_subscription_fee. If a field in that set is populated, all other fields in the set will automatically be cleared.



125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
# File 'proto_docs/google/cloud/commerceproducer/v1beta/sku.rb', line 125

class SkuPrice
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # Representation for a SKU that is not active and has no price.
  class InactiveSkuPrice
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Details about a SKU pricing usage of a [partner-reported custom billing
  # metric](https://cloud.google.com/service-infrastructure/docs/reporting-billing-metrics)
  # defined by the partner in the Service Management API and reported using
  # the Service Control API.
  #
  # The customer's usage charge is computed by converting the customer's
  # reported consumption to the SKU's composite price unit and applying the
  # graduated price from the appropriate price tier.
  # @!attribute [r] tiered_price
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::TieredPrice]
  #     Output only. [Tiered
  #     pricing](https://cloud.google.com/billing/docs/how-to/pricing-table#tiered-pricing)
  #     of the SKU.
  # @!attribute [r] canonical_metric
  #   @return [::String]
  #     Output only. The name of the metric, in canonical format.
  #
  #     Note that in the canonical format the first character of the path
  #     component of the metric name is always uppercase, which may differ
  #     from the metric name in the service config. For example, a metric
  #     appearing in the service config as 'example.com/example_metric' will
  #     appear here in the SKU as 'example.com/Example_metric'. In the Service
  #     Management and Service Control APIs these two metric names are
  #     considered distinct, either or both may be defined, and usage must be
  #     reported using a name matching the name of a metric defined in the
  #     service config. But for billing purposes usage reported using either
  #     name will be aggregated under the canonical metric name.
  #
  #     Example: "example.com/Example_metric"
  class ManagedServiceMetricUsageFee
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Details about a SKU pricing usage of a [Compute Engine
  # License](https://cloud.google.com/compute/docs/licenses/about).
  #
  # The SKU applies to a single license, and may be further scoped to a
  # [Compute
  # Engine VM Instance](https://cloud.google.com/compute/docs/instances)
  # machine resource type (e.g. "vCPU") and size range for that machine
  # resource. Instances deployed from [Compute
  # Engine Images](https://cloud.google.com/compute/docs/images)
  # incorporating the target license and (if applicable) matching the machine
  # resource type size range will be charged by the SKU. A single license may
  # be priced by multiple SKUs covering different combinations of machine
  # resource type and size range, allowing a single running instance to be
  # charged by up to one SKU per machine resource type, with pricing tiered
  # according to machine shape.
  # @!attribute [rw] price_per_unit
  #   @return [::Google::Type::Money]
  #     The price per unit of usage.
  #     The customer's usage charge is computed by measuring the customer's
  #     consumption denominated in price units and multiplying by this price.
  # @!attribute [r] license_code
  #   @return [::String]
  #     Output only. The license code of the target Compute Engine License.
  #     Note that this is the numeric license code itself in uint64 format used
  #     to reference licenses attached to images, not the resource name of the
  #     related [Compute Engine LicenseCode
  #     resource](https://cloud.google.com/compute/docs/reference/rest/v1/licenseCodes).
  #
  #     Example: "1234567890123456789"
  # @!attribute [r] machine_resource
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::ComputeEngineLicenseUsageFee::MachineResource]
  #     Output only. The machine resource type that the SKU applies to, if any.
  #     SKUs with a non-default value are referred to as "resource-based" SKUs.
  # @!attribute [r] machine_resource_range
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::ComputeEngineLicenseUsageFee::MachineResourceRange]
  #     Output only. The range of machine resource values that the SKU applies
  #     to. Unset when the SKU is not scoped to a particular machine resource
  #     type. The collection of SKUs in effect at any given time targeting the
  #     same license and machine resource type will cover all possible values
  #     for that machine resource type without overlap. Such a collection of
  #     SKUs form a "tiered" price structure over the possible values of the
  #     machine resource, with each SKU acting as a "tier".
  #
  #     NOTE: This is distinct from a SKU with [tiered
  #     pricing](https://cloud.google.com/billing/docs/how-to/pricing-table#tiered-pricing).
  # @!attribute [r] usage_calculation
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::ComputeEngineLicenseUsageFee::UsageCalculation]
  #     Output only. Determines how the customer's usage is calculated.
  # @!attribute [r] unit
  #   @return [::String]
  #     Output only. The price unit of the SKU.
  #     See https://ucum.org/ucum.html for the format of the price unit.
  #     For linear-priced memory SKUs, the price unit is 'GiBy.h'.
  #     For all other SKUs, the price unit is 'h'. This includes linear-priced
  #     vCPU and GPU SKUs because these resources have unitless dimensions and
  #     the application of these scaling factors does not change the price
  #     unit.
  class ComputeEngineLicenseUsageFee
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # The range of machine resource values that the SKU applies to.
    # @!attribute [r] start_value
    #   @return [::Integer]
    #     Output only. The inclusive lower bound of the range.
    #     While the number zero may be the start of a range, it is not a
    #     possible machine resource value. An instance cannot exist with zero
    #     vCPU or memory, and an instance with no attached accelerators lacks a
    #     GPU dimension entirely rather than having a GPU count of zero.
    # @!attribute [r] end_value
    #   @return [::Integer]
    #     Output only. The exclusive upper bound of the range.
    #     If no end value is specified, the range is unbounded from above.
    class MachineResourceRange
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # The machine resource type that the SKU applies to, if any.
    module MachineResource
      # The SKU applies to all instances irrespective of machine shape.
      # This is referred to as "instance-based pricing" because the price
      # is the same for all instances.
      MACHINE_RESOURCE_UNSPECIFIED = 0

      # The SKU applies based on the instance's vCPU count.
      VCPU_COUNT = 1

      # The SKU applies based on the instance's memory size in bytes.
      MEMORY_BYTES = 2

      # The SKU applies based on the instance's GPU count.
      GPU_COUNT = 3
    end

    # Determines how the customer's usage is calculated.
    module UsageCalculation
      # Unused.
      USAGE_CALCULATION_UNSPECIFIED = 0

      # Usage is calculated from instance runtime.
      # The customer's usage is metered according to the [Compute Engine VM
      # instance pricing
      # model](https://cloud.google.com/compute/vm-instance-pricing),
      # measured on a per-instance basis in units of hours, with a minimum
      # duration of one minute and an increment of one second.
      #
      # A SKU using this usage calculation is referred to as "flat" because
      # the customer's usage charge is independent of the instance's machine
      # resource shape apart from determining whether the SKU applies to the
      # instance.
      INSTANCE_RUNTIME = 1

      # Usage is calculated from instance runtime and size.
      # This calculation mode is only applicable to resource-based SKUs.
      # Usage is calculated by measuring the instance runtime in the same
      # manner as for `INSTANCE_RUNTIME` and multiplying by the instance's
      # machine resource value matching the SKU's machine resource type.
      # This converts the price from per-instance-hour to
      # per-instance-hour-per-machine-resource, which changes the price unit
      # for memory SKUs to 'GiBy.h'. The price unit otherwise remains 'h'
      # because the other machine resources are dimensionless.
      #
      # A SKU using this usage calculation is referred to as "linear" because
      # the customer's usage charge is linearly proportional to the
      # instance's machine resource value.
      LINEAR_RESOURCE_SCALED_INSTANCE_RUNTIME = 2
    end
  end

  # Details about a SKU pricing usage of software running on a Kubernetes
  # Engine pod.
  #
  # The SKU applies to pods annotated with the SKU's parent service name, and
  # may be further scoped to a [k8s pod resource
  # type](https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/)
  # (e.g. "CPU") and size range for that resource type. Running pods
  # annotated with the parent service's service name and matching the pod
  # resource type size range will be charged by the SKU. A service may be
  # priced by multiple SKUs covering different combinations of pod resource
  # type and size range, allowing a single running pod to be charged by up to
  # one SKU per pod resource type, with pricing tiered according to pod
  # shape.
  # @!attribute [rw] price_per_unit
  #   @return [::Google::Type::Money]
  #     The price per unit of usage.
  #     The customer's usage charge is computed by measuring the customer's
  #     consumption denominated in price units and multiplying by this price.
  # @!attribute [r] pod_resource
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::KubernetesEnginePodUsageFee::PodResource]
  #     Output only. The pod resource type that the SKU applies to.
  #     SKUs with a non-default value are referred to as "resource-based" SKUs.
  # @!attribute [r] pod_resource_range
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::KubernetesEnginePodUsageFee::PodResourceRange]
  #     Output only. The range of pod resource values that the SKU applies to.
  #     The collection of SKUs in effect at any given time targeting the same
  #     service annotation and pod resource type will cover all possible values
  #     for that pod resource type without overlap. Such a collection of SKUs
  #     form a "tiered" price structure over the possible values of the pod
  #     resource, with each SKU acting as a "tier".
  #
  #     NOTE: This is distinct from a SKU with [tiered
  #     pricing](https://cloud.google.com/billing/docs/how-to/pricing-table#tiered-pricing).
  # @!attribute [r] usage_calculation
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::KubernetesEnginePodUsageFee::UsageCalculation]
  #     Output only. Determines how the customer's usage is calculated.
  # @!attribute [r] unit
  #   @return [::String]
  #     Output only. The price unit of the SKU.
  #     See https://ucum.org/ucum.html for the format of the price unit.
  #     For linear-priced memory SKUs, the price unit is 'GiBy.h'.
  #     For all other SKUs, the price unit is 'h'. This includes linear-priced
  #     VCPU, GPU, and TPU SKUs because these resources have unitless
  #     dimensions and the application of these scaling factors does not change
  #     the price unit.
  class KubernetesEnginePodUsageFee
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # The range of pod resource values that the SKU applies to.
    # @!attribute [r] start_value
    #   @return [::Integer]
    #     Output only. The inclusive lower bound of the range.
    # @!attribute [r] end_value
    #   @return [::Integer]
    #     Output only. The exclusive upper bound of the range.
    #     If no end value is specified, the range is unbounded from above.
    class PodResourceRange
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # The pod [resource
    # type](https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/)
    # that the SKU applies to.
    module PodResource
      # Unused.
      POD_RESOURCE_UNSPECIFIED = 0

      # The SKU applies based on the pod's [vCPU
      # count](https://kubernetes.io/docs/tasks/configure-pod-container/assign-cpu-resource/).
      VCPU_COUNT = 1

      # The SKU applies based on the pod's [memory
      # size](https://kubernetes.io/docs/tasks/configure-pod-container/assign-memory-resource/)
      # in bytes.
      MEMORY_BYTES = 2

      # The SKU applies based on the pod's GPU count.
      GPU_COUNT = 3

      # The SKU applies based on the pod's [TPU
      # count](https://cloud.google.com/kubernetes-engine/docs/concepts/tpus#how_tpus_work).
      TPU_COUNT = 4
    end

    # Determines how the customer's usage is calculated.
    module UsageCalculation
      # Unused.
      USAGE_CALCULATION_UNSPECIFIED = 0

      # Usage is calculated from pod runtime.
      # The customer's usage is metered in a manner similar to the [GKE
      # Autopilot mode for pods without specific hardware
      # requirements](https://cloud.google.com/kubernetes-engine/pricing),
      # priced on a per-pod basis in units of hours and measured in
      # one-second increments, with no minimum duration.
      #
      # A SKU using this usage calculation is referred to as "flat" because
      # the customer's usage charge is independent of the pod shape apart
      # from determining whether the SKU applies to the pod.
      POD_RUNTIME = 1

      # Usage is calculated from pod runtime and size.
      # This calculation mode is only applicable to resource-based SKUs.
      # Usage is calculated by measuring the pod runtime in the same manner
      # as for `POD_RUNTIME` and multiplying by the pod's resource value
      # matching the SKU's pod resource type.
      # This converts the price from per-pod-hour to
      # per-pod-hour-per-resource, which changes the price unit for memory
      # SKUs to 'GiBy.h'. The price unit otherwise remains 'h' because the
      # other resources are dimensionless.
      #
      # A SKU using this usage calculation is referred to as "linear" because
      # the customer's usage charge is linearly proportional to the
      # pod's resource value.
      LINEAR_RESOURCE_SCALED_POD_RUNTIME = 2
    end
  end

  # Details about a SKU pricing usage of an [AI Platform Managed Model
  # (MaaS)](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/partner-models/use-partner-models).
  # @!attribute [r] tiered_price
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::TieredPrice]
  #     Output only. [Tiered
  #     pricing](https://cloud.google.com/billing/docs/how-to/pricing-table#tiered-pricing)
  #     of the SKU.
  # @!attribute [r] usage_metric
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::AiPlatformManagedModelUsageMetric]
  #     Output only. The usage metric that the SKU applies to.
  # @!attribute [r] location
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelEndpointLocation]
  #     Output only. The model endpoint location where usage is priced by this
  #     SKU. If no location is specified, the SKU applies to usage in all
  #     locations.
  # @!attribute [r] prediction_mode
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::PredictionMode]
  #     Output only. The prediction mode of requests that the SKU applies to.
  # @!attribute [r] combined_request_input_tokens_range
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::CombinedRequestInputTokensRange]
  #     Output only. The range of aggregated input token values covered by the
  #     SKU. Unset if the SKU is not scoped to a particular range. A request is
  #     in scope for this SKU if its aggregated input token value falls within
  #     the range. The collection of SKUs in effect at any given time scoped to
  #     a particular aggregated input token value range will cover all possible
  #     values without overlap. Such a collection of SKUs form a "tiered" price
  #     structure over the possible value, with each SKU acting as a "tier".
  #
  #     NOTE: This is distinct from a SKU with [tiered
  #     pricing](https://cloud.google.com/billing/docs/how-to/pricing-table#tiered-pricing).
  # @!attribute [r] provisioned_throughput_overage
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::ProvisionedThroughputOverage]
  #     Output only. Set when the SKU is a historical provisioned throughput
  #     overage SKU. Starting 2025-08-26 such SKUs have no effect, and usage in
  #     excess of provisioned throughput quota is now metered as standard
  #     usage. This field is set only in historical SKU timeline entries for
  #     overage SKUs belonging to partners that offered provisioned throughput
  #     for AI Platform managed model products prior to the unification of
  #     standard usage and provisioned throughput overage metering.
  class AiPlatformManagedModelUsageFee
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # The usage metric that the SKU applies to.
    # @!attribute [r] input_tokens_metric
    #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::AiPlatformManagedModelUsageMetric::InputTokensMetric]
    #     Output only. Input tokens read from the prediction endpoint input.
    #
    #     Note: The following fields are mutually exclusive: `input_tokens_metric`, `cache_read_input_tokens_metric`, `cache_write_input_tokens_metric`, `output_tokens_metric`, `web_search_requests_metric`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] cache_read_input_tokens_metric
    #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::AiPlatformManagedModelUsageMetric::CacheReadInputTokensMetric]
    #     Output only. Input tokens read from the cache.
    #
    #     Note: The following fields are mutually exclusive: `cache_read_input_tokens_metric`, `input_tokens_metric`, `cache_write_input_tokens_metric`, `output_tokens_metric`, `web_search_requests_metric`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] cache_write_input_tokens_metric
    #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::AiPlatformManagedModelUsageMetric::CacheWriteInputTokensMetric]
    #     Output only. Input tokens written to the cache.
    #
    #     Note: The following fields are mutually exclusive: `cache_write_input_tokens_metric`, `input_tokens_metric`, `cache_read_input_tokens_metric`, `output_tokens_metric`, `web_search_requests_metric`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] output_tokens_metric
    #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::AiPlatformManagedModelUsageMetric::OutputTokensMetric]
    #     Output only. Output tokens returned from the prediction endpoint.
    #
    #     Note: The following fields are mutually exclusive: `output_tokens_metric`, `input_tokens_metric`, `cache_read_input_tokens_metric`, `cache_write_input_tokens_metric`, `web_search_requests_metric`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] web_search_requests_metric
    #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::AiPlatformManagedModelUsageMetric::WebSearchRequestsMetric]
    #     Output only. Web search requests executed by the model.
    #
    #     Note: The following fields are mutually exclusive: `web_search_requests_metric`, `input_tokens_metric`, `cache_read_input_tokens_metric`, `cache_write_input_tokens_metric`, `output_tokens_metric`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    class AiPlatformManagedModelUsageMetric
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # Input tokens read from the input to the prediction endpoint.
      # The unit for this metric is dimensionless.
      class InputTokensMetric
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end

      # Input tokens read from the cache.
      # The unit for this metric is dimensionless.
      class CacheReadInputTokensMetric
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end

      # Input tokens written to the cache.
      # The unit for this metric is dimensionless.
      # @!attribute [r] ttl
      #   @return [::Google::Protobuf::Duration]
      #     Output only. The duration the write is retained in the cache.
      class CacheWriteInputTokensMetric
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end

      # Output tokens returned from the prediction endpoint.
      # The unit for this metric is dimensionless.
      class OutputTokensMetric
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end

      # Web search requests executed by the model.
      # The unit for this metric is dimensionless.
      class WebSearchRequestsMetric
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end
    end

    # The range of aggregated input token values covered by the SKU.
    #
    # A request to a managed model has an aggregated input token value
    # determined by the sum of the metric values of the input token metrics.
    #
    # * input tokens
    # * cache read input tokens
    # * cache write input tokens
    # @!attribute [r] start_value
    #   @return [::Integer]
    #     Output only. The inclusive lower bound of the range.
    # @!attribute [r] end_value
    #   @return [::Integer]
    #     Output only. The exclusive upper bound of the range.
    #     If no end value is specified, the range is unbounded from above.
    class CombinedRequestInputTokensRange
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # Additional details present for historical provisioned throughput
    # "overage" SKUs that applied charges only to usage above the customer's
    # provisioned throughput quota threshold.
    # @!attribute [r] service
    #   @return [::String]
    #     Output only. The service whose usage the overage SKU applied to.
    class ProvisionedThroughputOverage
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # The prediction modes of requests that the SKU applies to.
    module PredictionMode
      # The SKU does not distinguish between prediction modes.
      PREDICTION_MODE_UNSPECIFIED = 0

      # The SKU applies to online prediction.
      ONLINE_PREDICTION = 1

      # The SKU applies to batch prediction.
      BATCH_PREDICTION = 2
    end
  end

  # Details about a SKU pricing reservation of [AI Platform Provisioned
  # Throughput](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/provisioned-throughput).
  #
  # Customers may purchase provisioned throughput reservations for AI
  # Platform managed model products. This provides the customer with
  # provisioned throughput quota for a particular model and location. Model
  # usage below the provisioned throughput quota threshold is voided and is
  # not charged by the product's managed model usage fees.
  # @!attribute [r] term_duration_months
  #   @return [::Integer]
  #     Output only. The duration of the provisioned throughput reservation
  #     in months.
  # @!attribute [rw] gsu_price_per_unit
  #   @return [::Google::Type::Money]
  #     The price per [Generative AI Scale Unit
  #     (GSU)](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/provisioned-throughput/measure-provisioned-throughput)
  #     per `unit`.
  #     A provisioned throughput reservation reserves a certain number of
  #     GSUs, and the customer is billed for those GSUs on a continuous basis
  #     for the duration of the reservation.
  # @!attribute [r] location
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelEndpointLocation]
  #     Output only. The location where provisioned throughput is priced by
  #     this SKU.
  # @!attribute [r] unit
  #   @return [::String]
  #     Output only. The price unit of the SKU.
  #     See https://ucum.org/ucum.html for the format of the price unit.
  #     Since provisioned throughput reservations are billed by duration, this
  #     will always be a time unit. The price unit of a provisioned throughput
  #     SKU is not necessarily the same as the reservation term.
  #     This field is unrelated to the [Generative AI Scale Unit
  #     (GSU)](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/provisioned-throughput/measure-provisioned-throughput).
  #
  #     Currently the unit is always months ('mo').
  #     Additional time units may be supported in future.
  #
  #     The customary unit month ('mo') requires special handling to account
  #     for the variable duration of months. A price may be denominated in
  #     units of months, but the duration the reservation is active is measured
  #     in metric time and customers are billed on that basis. The exact hourly
  #     or per-second price can be calculated by dividing the monthly price
  #     by the number of hours or seconds in the desired month. A reservation
  #     active for N months is rarely billed exactly N times the monthly price.
  #     This is intended and is not a billing error.
  class AiPlatformProvisionedThroughputFee
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Details about a SKU pricing usage of an [AI Platform Self Deployed
  # Model](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/model-garden/self-deployed-models).
  # @!attribute [r] accelerator_type
  #   @return [::String]
  #     Output only. The SKU applies to a specific accelerator type.
  #     Contains the name of the matching [AI Platform AcceleratorType](
  #     https://docs.cloud.google.com/gemini-enterprise-agent-platform/reference/rest/v1/MachineSpec#AcceleratorType).
  #     The corresponding linear scaling value is the dimensionless
  #     [`accelerator_count`](https://docs.cloud.google.com/gemini-enterprise-agent-platform/reference/rest/v1/MachineSpec#FIELDS.accelerator_count).
  # @!attribute [r] price_per_unit
  #   @return [::Google::Type::Money]
  #     Output only. The price per unit of usage.
  #     The customer's usage charge is computed by measuring the customer's
  #     consumption denominated in price units and multiplying by this price.
  # @!attribute [r] unit
  #   @return [::String]
  #     Output only. The price unit of the SKU.
  #     See https://ucum.org/ucum.html for the format of the price unit.
  #     Currently the unit is always hours ('h'). This may change in future.
  # @!attribute [r] usage_calculation
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformDeployedModelUsageFee::UsageCalculation]
  #     Output only. Determines how the customer's usage is calculated.
  class AiPlatformDeployedModelUsageFee
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Determines how the customer's usage is calculated.
    module UsageCalculation
      # Unused.
      USAGE_CALCULATION_UNSPECIFIED = 0

      # Usage is calculated from deployment runtime and size.
      # Usage is calculated by measuring the deployment runtime in hours and
      # multiplying by the amount of the deployed model's hardware resource
      # matching the SKU's hardware resource type.
      # This results in a composite `unit` of hours ('h') multiplied by the
      # unit that denominates the hardware resource, though note that
      # multiplying by the dimensionless unit ("1") has no effect.
      LINEAR_RESOURCE_SCALED_DEPLOYMENT_RUNTIME = 2
    end
  end

  # Details about a SKU charging a flat subscription fee.
  # @!attribute [r] price_per_unit
  #   @return [::Google::Type::Money]
  #     Output only. The price per time unit the subscription is active.
  # @!attribute [r] unit
  #   @return [::String]
  #     Output only. The unit of the subscription SKU.
  #     See https://ucum.org/ucum.html for the format of the price unit.
  #     Since subscriptions are billed by duration, this will always be a time
  #     unit. The price unit of a subscription SKU is not necessarily the same
  #     as the subscription period of the corresponding StandardOffers.
  #
  #     Currently the unit is always months ('mo').
  #     Additional time units may be supported in future.
  #
  #     The unit month ('mo') is a customary time unit and requires special
  #     handling to account for the variable duration of months. A price may be
  #     denominated in units of months, but the duration the subscription is
  #     active is measured in metric time and customers are billed on that
  #     basis. The exact hourly or per-second price can be calculated by
  #     dividing the monthly price by the number of hours or seconds in the
  #     desired month. A subscription active for N months is rarely billed
  #     exactly N times the monthly price. This is intended and is not a
  #     billing error.
  class FlatSubscriptionFee
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Price structure for a SKU charging a [tiered
  # price](https://cloud.google.com/billing/docs/how-to/pricing-table#tiered-pricing).
  # @!attribute [r] unit
  #   @return [::String]
  #     Output only. Usage unit used for defining price tiers and for scaling
  #     with the price_unit_count to form the composite price unit.
  #
  #     See https://ucum.org/ucum.html for the format of the price unit.
  #     A unitless dimension, such as a count, is represented as `1`.
  # @!attribute [r] unit_description
  #   @return [::String]
  #     Output only. The display description of the unit, supplied at time of
  #     onboarding. This value is recommended to be set at least for
  #     dimensionless metrics, but may be empty if no description was provided
  #     at time of onboarding.
  # @!attribute [r] price_unit_count
  #   @return [::Google::Type::Decimal]
  #     Output only. Scaling  the `unit` by the `price_unit_count` forms the
  #     composite "price unit" which is priced by the price tiers.
  #
  #     This scaling factor is in addition to any numerical prefix symbol on
  #     the `unit`, so the same composite "price unit" can be represented in
  #     several ways, differing only in their presentation to users.
  #
  #     Examples:
  #
  #     * $1    per 1    bytes     : unit = By,  price_unit_count = 1
  #     * $1000 per 1    kilobytes : unit = kBy, price_unit_count = 1
  #     * $5000 per 5    kilobytes : unit = kBy, price_unit_count = 5
  # @!attribute [r] price_tiers
  #   @return [::Array<::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::TieredPrice::PriceTier>]
  #     Output only. The list of price tiers for the SKU, ordered by the
  #     start_amount.
  #
  #     The tiers are non-overlapping and are collectively bounded below by
  #     zero and unbounded above to cover the entire range of possible metric
  #     usage. Each tier is bounded below inclusively by its start_amount and
  #     bounded above exclusively by the start_amount of the next tier, or else
  #     unbounded above if there is no next tier.
  #
  #     Usage of the metric is aggregated by customer billing account on a
  #     monthly basis and billed in a graduated manner according to the price
  #     tiers, with each marginal unit of usage priced accoring to the tier in
  #     which it falls.
  class TieredPrice
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # A [price
    # tier](https://cloud.google.com/billing/docs/how-to/pricing-table#tiered-pricing)
    # pricing metric usage within a range.
    #
    # Each marginal unit of usage is priced according to the price tier in
    # which it falls.
    # @!attribute [r] start_amount
    #   @return [::Google::Type::Decimal]
    #     Output only. Inclusive lower bound of the tier interval, denominated
    #     in `unit`.
    # @!attribute [r] price
    #   @return [::Google::Type::Money]
    #     Output only. The price per `price_unit_count` of `unit` in the tier.
    #     The price is applied fractionally if the customer's usage within the
    #     tier is not an integer multiple of `price_unit_count`.
    class PriceTier
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end
  end

  # Location scope for a SKU that applies to an AI Platform Managed Model
  # endpoint.
  # @!attribute [r] region_id
  #   @return [::String]
  #     Output only. The SKU applies to a region.
  #
  #     Note: The following fields are mutually exclusive: `region_id`, `global_endpoint`, `multi_region_id`. If a field in that set is populated, all other fields in the set will automatically be cleared.
  # @!attribute [r] global_endpoint
  #   @return [::Boolean]
  #     Output only. The SKU applies to a [global
  #     endpoint](https://docs.cloud.google.com/gemini-enterprise-agent-platform/resources/locations).
  #     **Note**: This is distinct from the conventional meaning of "global"
  #     as a SKU that applies to all locations.
  #
  #     Note: The following fields are mutually exclusive: `global_endpoint`, `region_id`, `multi_region_id`. If a field in that set is populated, all other fields in the set will automatically be cleared.
  # @!attribute [r] multi_region_id
  #   @return [::String]
  #     Output only. The SKU applies to a multi-region.
  #
  #     Note: The following fields are mutually exclusive: `multi_region_id`, `region_id`, `global_endpoint`. If a field in that set is populated, all other fields in the set will automatically be cleared.
  class AiPlatformManagedModelEndpointLocation
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end
end

#inactive::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::InactiveSkuPrice (readonly)

Returns Output only. The SKU has been disabled and has no price. SKUs, once created and allowed to go into effect, are never deleted. Disabled SKUs may accumulate over the lifetime of a product as the product's pricing evolves, and are retained for historical reference. A SKU in this state generally remains in this state indefinitely, but may be reactivated if needed. Clients must not depend on inactive SKUs remaining inactive.

Note: The following fields are mutually exclusive: inactive, managed_service_metric_usage_fee, gce_license_usage_fee, gke_pod_usage_fee, ai_platform_managed_model_usage_fee, ai_platform_provisioned_throughput_fee, ai_platform_deployed_model_usage_fee, flat_subscription_fee. If a field in that set is populated, all other fields in the set will automatically be cleared.

Returns:

  • (::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::InactiveSkuPrice)

    Output only. The SKU has been disabled and has no price. SKUs, once created and allowed to go into effect, are never deleted. Disabled SKUs may accumulate over the lifetime of a product as the product's pricing evolves, and are retained for historical reference. A SKU in this state generally remains in this state indefinitely, but may be reactivated if needed. Clients must not depend on inactive SKUs remaining inactive.

    Note: The following fields are mutually exclusive: inactive, managed_service_metric_usage_fee, gce_license_usage_fee, gke_pod_usage_fee, ai_platform_managed_model_usage_fee, ai_platform_provisioned_throughput_fee, ai_platform_deployed_model_usage_fee, flat_subscription_fee. If a field in that set is populated, all other fields in the set will automatically be cleared.



125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
# File 'proto_docs/google/cloud/commerceproducer/v1beta/sku.rb', line 125

class SkuPrice
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # Representation for a SKU that is not active and has no price.
  class InactiveSkuPrice
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Details about a SKU pricing usage of a [partner-reported custom billing
  # metric](https://cloud.google.com/service-infrastructure/docs/reporting-billing-metrics)
  # defined by the partner in the Service Management API and reported using
  # the Service Control API.
  #
  # The customer's usage charge is computed by converting the customer's
  # reported consumption to the SKU's composite price unit and applying the
  # graduated price from the appropriate price tier.
  # @!attribute [r] tiered_price
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::TieredPrice]
  #     Output only. [Tiered
  #     pricing](https://cloud.google.com/billing/docs/how-to/pricing-table#tiered-pricing)
  #     of the SKU.
  # @!attribute [r] canonical_metric
  #   @return [::String]
  #     Output only. The name of the metric, in canonical format.
  #
  #     Note that in the canonical format the first character of the path
  #     component of the metric name is always uppercase, which may differ
  #     from the metric name in the service config. For example, a metric
  #     appearing in the service config as 'example.com/example_metric' will
  #     appear here in the SKU as 'example.com/Example_metric'. In the Service
  #     Management and Service Control APIs these two metric names are
  #     considered distinct, either or both may be defined, and usage must be
  #     reported using a name matching the name of a metric defined in the
  #     service config. But for billing purposes usage reported using either
  #     name will be aggregated under the canonical metric name.
  #
  #     Example: "example.com/Example_metric"
  class ManagedServiceMetricUsageFee
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Details about a SKU pricing usage of a [Compute Engine
  # License](https://cloud.google.com/compute/docs/licenses/about).
  #
  # The SKU applies to a single license, and may be further scoped to a
  # [Compute
  # Engine VM Instance](https://cloud.google.com/compute/docs/instances)
  # machine resource type (e.g. "vCPU") and size range for that machine
  # resource. Instances deployed from [Compute
  # Engine Images](https://cloud.google.com/compute/docs/images)
  # incorporating the target license and (if applicable) matching the machine
  # resource type size range will be charged by the SKU. A single license may
  # be priced by multiple SKUs covering different combinations of machine
  # resource type and size range, allowing a single running instance to be
  # charged by up to one SKU per machine resource type, with pricing tiered
  # according to machine shape.
  # @!attribute [rw] price_per_unit
  #   @return [::Google::Type::Money]
  #     The price per unit of usage.
  #     The customer's usage charge is computed by measuring the customer's
  #     consumption denominated in price units and multiplying by this price.
  # @!attribute [r] license_code
  #   @return [::String]
  #     Output only. The license code of the target Compute Engine License.
  #     Note that this is the numeric license code itself in uint64 format used
  #     to reference licenses attached to images, not the resource name of the
  #     related [Compute Engine LicenseCode
  #     resource](https://cloud.google.com/compute/docs/reference/rest/v1/licenseCodes).
  #
  #     Example: "1234567890123456789"
  # @!attribute [r] machine_resource
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::ComputeEngineLicenseUsageFee::MachineResource]
  #     Output only. The machine resource type that the SKU applies to, if any.
  #     SKUs with a non-default value are referred to as "resource-based" SKUs.
  # @!attribute [r] machine_resource_range
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::ComputeEngineLicenseUsageFee::MachineResourceRange]
  #     Output only. The range of machine resource values that the SKU applies
  #     to. Unset when the SKU is not scoped to a particular machine resource
  #     type. The collection of SKUs in effect at any given time targeting the
  #     same license and machine resource type will cover all possible values
  #     for that machine resource type without overlap. Such a collection of
  #     SKUs form a "tiered" price structure over the possible values of the
  #     machine resource, with each SKU acting as a "tier".
  #
  #     NOTE: This is distinct from a SKU with [tiered
  #     pricing](https://cloud.google.com/billing/docs/how-to/pricing-table#tiered-pricing).
  # @!attribute [r] usage_calculation
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::ComputeEngineLicenseUsageFee::UsageCalculation]
  #     Output only. Determines how the customer's usage is calculated.
  # @!attribute [r] unit
  #   @return [::String]
  #     Output only. The price unit of the SKU.
  #     See https://ucum.org/ucum.html for the format of the price unit.
  #     For linear-priced memory SKUs, the price unit is 'GiBy.h'.
  #     For all other SKUs, the price unit is 'h'. This includes linear-priced
  #     vCPU and GPU SKUs because these resources have unitless dimensions and
  #     the application of these scaling factors does not change the price
  #     unit.
  class ComputeEngineLicenseUsageFee
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # The range of machine resource values that the SKU applies to.
    # @!attribute [r] start_value
    #   @return [::Integer]
    #     Output only. The inclusive lower bound of the range.
    #     While the number zero may be the start of a range, it is not a
    #     possible machine resource value. An instance cannot exist with zero
    #     vCPU or memory, and an instance with no attached accelerators lacks a
    #     GPU dimension entirely rather than having a GPU count of zero.
    # @!attribute [r] end_value
    #   @return [::Integer]
    #     Output only. The exclusive upper bound of the range.
    #     If no end value is specified, the range is unbounded from above.
    class MachineResourceRange
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # The machine resource type that the SKU applies to, if any.
    module MachineResource
      # The SKU applies to all instances irrespective of machine shape.
      # This is referred to as "instance-based pricing" because the price
      # is the same for all instances.
      MACHINE_RESOURCE_UNSPECIFIED = 0

      # The SKU applies based on the instance's vCPU count.
      VCPU_COUNT = 1

      # The SKU applies based on the instance's memory size in bytes.
      MEMORY_BYTES = 2

      # The SKU applies based on the instance's GPU count.
      GPU_COUNT = 3
    end

    # Determines how the customer's usage is calculated.
    module UsageCalculation
      # Unused.
      USAGE_CALCULATION_UNSPECIFIED = 0

      # Usage is calculated from instance runtime.
      # The customer's usage is metered according to the [Compute Engine VM
      # instance pricing
      # model](https://cloud.google.com/compute/vm-instance-pricing),
      # measured on a per-instance basis in units of hours, with a minimum
      # duration of one minute and an increment of one second.
      #
      # A SKU using this usage calculation is referred to as "flat" because
      # the customer's usage charge is independent of the instance's machine
      # resource shape apart from determining whether the SKU applies to the
      # instance.
      INSTANCE_RUNTIME = 1

      # Usage is calculated from instance runtime and size.
      # This calculation mode is only applicable to resource-based SKUs.
      # Usage is calculated by measuring the instance runtime in the same
      # manner as for `INSTANCE_RUNTIME` and multiplying by the instance's
      # machine resource value matching the SKU's machine resource type.
      # This converts the price from per-instance-hour to
      # per-instance-hour-per-machine-resource, which changes the price unit
      # for memory SKUs to 'GiBy.h'. The price unit otherwise remains 'h'
      # because the other machine resources are dimensionless.
      #
      # A SKU using this usage calculation is referred to as "linear" because
      # the customer's usage charge is linearly proportional to the
      # instance's machine resource value.
      LINEAR_RESOURCE_SCALED_INSTANCE_RUNTIME = 2
    end
  end

  # Details about a SKU pricing usage of software running on a Kubernetes
  # Engine pod.
  #
  # The SKU applies to pods annotated with the SKU's parent service name, and
  # may be further scoped to a [k8s pod resource
  # type](https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/)
  # (e.g. "CPU") and size range for that resource type. Running pods
  # annotated with the parent service's service name and matching the pod
  # resource type size range will be charged by the SKU. A service may be
  # priced by multiple SKUs covering different combinations of pod resource
  # type and size range, allowing a single running pod to be charged by up to
  # one SKU per pod resource type, with pricing tiered according to pod
  # shape.
  # @!attribute [rw] price_per_unit
  #   @return [::Google::Type::Money]
  #     The price per unit of usage.
  #     The customer's usage charge is computed by measuring the customer's
  #     consumption denominated in price units and multiplying by this price.
  # @!attribute [r] pod_resource
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::KubernetesEnginePodUsageFee::PodResource]
  #     Output only. The pod resource type that the SKU applies to.
  #     SKUs with a non-default value are referred to as "resource-based" SKUs.
  # @!attribute [r] pod_resource_range
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::KubernetesEnginePodUsageFee::PodResourceRange]
  #     Output only. The range of pod resource values that the SKU applies to.
  #     The collection of SKUs in effect at any given time targeting the same
  #     service annotation and pod resource type will cover all possible values
  #     for that pod resource type without overlap. Such a collection of SKUs
  #     form a "tiered" price structure over the possible values of the pod
  #     resource, with each SKU acting as a "tier".
  #
  #     NOTE: This is distinct from a SKU with [tiered
  #     pricing](https://cloud.google.com/billing/docs/how-to/pricing-table#tiered-pricing).
  # @!attribute [r] usage_calculation
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::KubernetesEnginePodUsageFee::UsageCalculation]
  #     Output only. Determines how the customer's usage is calculated.
  # @!attribute [r] unit
  #   @return [::String]
  #     Output only. The price unit of the SKU.
  #     See https://ucum.org/ucum.html for the format of the price unit.
  #     For linear-priced memory SKUs, the price unit is 'GiBy.h'.
  #     For all other SKUs, the price unit is 'h'. This includes linear-priced
  #     VCPU, GPU, and TPU SKUs because these resources have unitless
  #     dimensions and the application of these scaling factors does not change
  #     the price unit.
  class KubernetesEnginePodUsageFee
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # The range of pod resource values that the SKU applies to.
    # @!attribute [r] start_value
    #   @return [::Integer]
    #     Output only. The inclusive lower bound of the range.
    # @!attribute [r] end_value
    #   @return [::Integer]
    #     Output only. The exclusive upper bound of the range.
    #     If no end value is specified, the range is unbounded from above.
    class PodResourceRange
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # The pod [resource
    # type](https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/)
    # that the SKU applies to.
    module PodResource
      # Unused.
      POD_RESOURCE_UNSPECIFIED = 0

      # The SKU applies based on the pod's [vCPU
      # count](https://kubernetes.io/docs/tasks/configure-pod-container/assign-cpu-resource/).
      VCPU_COUNT = 1

      # The SKU applies based on the pod's [memory
      # size](https://kubernetes.io/docs/tasks/configure-pod-container/assign-memory-resource/)
      # in bytes.
      MEMORY_BYTES = 2

      # The SKU applies based on the pod's GPU count.
      GPU_COUNT = 3

      # The SKU applies based on the pod's [TPU
      # count](https://cloud.google.com/kubernetes-engine/docs/concepts/tpus#how_tpus_work).
      TPU_COUNT = 4
    end

    # Determines how the customer's usage is calculated.
    module UsageCalculation
      # Unused.
      USAGE_CALCULATION_UNSPECIFIED = 0

      # Usage is calculated from pod runtime.
      # The customer's usage is metered in a manner similar to the [GKE
      # Autopilot mode for pods without specific hardware
      # requirements](https://cloud.google.com/kubernetes-engine/pricing),
      # priced on a per-pod basis in units of hours and measured in
      # one-second increments, with no minimum duration.
      #
      # A SKU using this usage calculation is referred to as "flat" because
      # the customer's usage charge is independent of the pod shape apart
      # from determining whether the SKU applies to the pod.
      POD_RUNTIME = 1

      # Usage is calculated from pod runtime and size.
      # This calculation mode is only applicable to resource-based SKUs.
      # Usage is calculated by measuring the pod runtime in the same manner
      # as for `POD_RUNTIME` and multiplying by the pod's resource value
      # matching the SKU's pod resource type.
      # This converts the price from per-pod-hour to
      # per-pod-hour-per-resource, which changes the price unit for memory
      # SKUs to 'GiBy.h'. The price unit otherwise remains 'h' because the
      # other resources are dimensionless.
      #
      # A SKU using this usage calculation is referred to as "linear" because
      # the customer's usage charge is linearly proportional to the
      # pod's resource value.
      LINEAR_RESOURCE_SCALED_POD_RUNTIME = 2
    end
  end

  # Details about a SKU pricing usage of an [AI Platform Managed Model
  # (MaaS)](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/partner-models/use-partner-models).
  # @!attribute [r] tiered_price
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::TieredPrice]
  #     Output only. [Tiered
  #     pricing](https://cloud.google.com/billing/docs/how-to/pricing-table#tiered-pricing)
  #     of the SKU.
  # @!attribute [r] usage_metric
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::AiPlatformManagedModelUsageMetric]
  #     Output only. The usage metric that the SKU applies to.
  # @!attribute [r] location
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelEndpointLocation]
  #     Output only. The model endpoint location where usage is priced by this
  #     SKU. If no location is specified, the SKU applies to usage in all
  #     locations.
  # @!attribute [r] prediction_mode
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::PredictionMode]
  #     Output only. The prediction mode of requests that the SKU applies to.
  # @!attribute [r] combined_request_input_tokens_range
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::CombinedRequestInputTokensRange]
  #     Output only. The range of aggregated input token values covered by the
  #     SKU. Unset if the SKU is not scoped to a particular range. A request is
  #     in scope for this SKU if its aggregated input token value falls within
  #     the range. The collection of SKUs in effect at any given time scoped to
  #     a particular aggregated input token value range will cover all possible
  #     values without overlap. Such a collection of SKUs form a "tiered" price
  #     structure over the possible value, with each SKU acting as a "tier".
  #
  #     NOTE: This is distinct from a SKU with [tiered
  #     pricing](https://cloud.google.com/billing/docs/how-to/pricing-table#tiered-pricing).
  # @!attribute [r] provisioned_throughput_overage
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::ProvisionedThroughputOverage]
  #     Output only. Set when the SKU is a historical provisioned throughput
  #     overage SKU. Starting 2025-08-26 such SKUs have no effect, and usage in
  #     excess of provisioned throughput quota is now metered as standard
  #     usage. This field is set only in historical SKU timeline entries for
  #     overage SKUs belonging to partners that offered provisioned throughput
  #     for AI Platform managed model products prior to the unification of
  #     standard usage and provisioned throughput overage metering.
  class AiPlatformManagedModelUsageFee
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # The usage metric that the SKU applies to.
    # @!attribute [r] input_tokens_metric
    #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::AiPlatformManagedModelUsageMetric::InputTokensMetric]
    #     Output only. Input tokens read from the prediction endpoint input.
    #
    #     Note: The following fields are mutually exclusive: `input_tokens_metric`, `cache_read_input_tokens_metric`, `cache_write_input_tokens_metric`, `output_tokens_metric`, `web_search_requests_metric`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] cache_read_input_tokens_metric
    #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::AiPlatformManagedModelUsageMetric::CacheReadInputTokensMetric]
    #     Output only. Input tokens read from the cache.
    #
    #     Note: The following fields are mutually exclusive: `cache_read_input_tokens_metric`, `input_tokens_metric`, `cache_write_input_tokens_metric`, `output_tokens_metric`, `web_search_requests_metric`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] cache_write_input_tokens_metric
    #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::AiPlatformManagedModelUsageMetric::CacheWriteInputTokensMetric]
    #     Output only. Input tokens written to the cache.
    #
    #     Note: The following fields are mutually exclusive: `cache_write_input_tokens_metric`, `input_tokens_metric`, `cache_read_input_tokens_metric`, `output_tokens_metric`, `web_search_requests_metric`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] output_tokens_metric
    #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::AiPlatformManagedModelUsageMetric::OutputTokensMetric]
    #     Output only. Output tokens returned from the prediction endpoint.
    #
    #     Note: The following fields are mutually exclusive: `output_tokens_metric`, `input_tokens_metric`, `cache_read_input_tokens_metric`, `cache_write_input_tokens_metric`, `web_search_requests_metric`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] web_search_requests_metric
    #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::AiPlatformManagedModelUsageMetric::WebSearchRequestsMetric]
    #     Output only. Web search requests executed by the model.
    #
    #     Note: The following fields are mutually exclusive: `web_search_requests_metric`, `input_tokens_metric`, `cache_read_input_tokens_metric`, `cache_write_input_tokens_metric`, `output_tokens_metric`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    class AiPlatformManagedModelUsageMetric
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # Input tokens read from the input to the prediction endpoint.
      # The unit for this metric is dimensionless.
      class InputTokensMetric
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end

      # Input tokens read from the cache.
      # The unit for this metric is dimensionless.
      class CacheReadInputTokensMetric
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end

      # Input tokens written to the cache.
      # The unit for this metric is dimensionless.
      # @!attribute [r] ttl
      #   @return [::Google::Protobuf::Duration]
      #     Output only. The duration the write is retained in the cache.
      class CacheWriteInputTokensMetric
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end

      # Output tokens returned from the prediction endpoint.
      # The unit for this metric is dimensionless.
      class OutputTokensMetric
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end

      # Web search requests executed by the model.
      # The unit for this metric is dimensionless.
      class WebSearchRequestsMetric
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end
    end

    # The range of aggregated input token values covered by the SKU.
    #
    # A request to a managed model has an aggregated input token value
    # determined by the sum of the metric values of the input token metrics.
    #
    # * input tokens
    # * cache read input tokens
    # * cache write input tokens
    # @!attribute [r] start_value
    #   @return [::Integer]
    #     Output only. The inclusive lower bound of the range.
    # @!attribute [r] end_value
    #   @return [::Integer]
    #     Output only. The exclusive upper bound of the range.
    #     If no end value is specified, the range is unbounded from above.
    class CombinedRequestInputTokensRange
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # Additional details present for historical provisioned throughput
    # "overage" SKUs that applied charges only to usage above the customer's
    # provisioned throughput quota threshold.
    # @!attribute [r] service
    #   @return [::String]
    #     Output only. The service whose usage the overage SKU applied to.
    class ProvisionedThroughputOverage
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # The prediction modes of requests that the SKU applies to.
    module PredictionMode
      # The SKU does not distinguish between prediction modes.
      PREDICTION_MODE_UNSPECIFIED = 0

      # The SKU applies to online prediction.
      ONLINE_PREDICTION = 1

      # The SKU applies to batch prediction.
      BATCH_PREDICTION = 2
    end
  end

  # Details about a SKU pricing reservation of [AI Platform Provisioned
  # Throughput](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/provisioned-throughput).
  #
  # Customers may purchase provisioned throughput reservations for AI
  # Platform managed model products. This provides the customer with
  # provisioned throughput quota for a particular model and location. Model
  # usage below the provisioned throughput quota threshold is voided and is
  # not charged by the product's managed model usage fees.
  # @!attribute [r] term_duration_months
  #   @return [::Integer]
  #     Output only. The duration of the provisioned throughput reservation
  #     in months.
  # @!attribute [rw] gsu_price_per_unit
  #   @return [::Google::Type::Money]
  #     The price per [Generative AI Scale Unit
  #     (GSU)](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/provisioned-throughput/measure-provisioned-throughput)
  #     per `unit`.
  #     A provisioned throughput reservation reserves a certain number of
  #     GSUs, and the customer is billed for those GSUs on a continuous basis
  #     for the duration of the reservation.
  # @!attribute [r] location
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelEndpointLocation]
  #     Output only. The location where provisioned throughput is priced by
  #     this SKU.
  # @!attribute [r] unit
  #   @return [::String]
  #     Output only. The price unit of the SKU.
  #     See https://ucum.org/ucum.html for the format of the price unit.
  #     Since provisioned throughput reservations are billed by duration, this
  #     will always be a time unit. The price unit of a provisioned throughput
  #     SKU is not necessarily the same as the reservation term.
  #     This field is unrelated to the [Generative AI Scale Unit
  #     (GSU)](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/provisioned-throughput/measure-provisioned-throughput).
  #
  #     Currently the unit is always months ('mo').
  #     Additional time units may be supported in future.
  #
  #     The customary unit month ('mo') requires special handling to account
  #     for the variable duration of months. A price may be denominated in
  #     units of months, but the duration the reservation is active is measured
  #     in metric time and customers are billed on that basis. The exact hourly
  #     or per-second price can be calculated by dividing the monthly price
  #     by the number of hours or seconds in the desired month. A reservation
  #     active for N months is rarely billed exactly N times the monthly price.
  #     This is intended and is not a billing error.
  class AiPlatformProvisionedThroughputFee
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Details about a SKU pricing usage of an [AI Platform Self Deployed
  # Model](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/model-garden/self-deployed-models).
  # @!attribute [r] accelerator_type
  #   @return [::String]
  #     Output only. The SKU applies to a specific accelerator type.
  #     Contains the name of the matching [AI Platform AcceleratorType](
  #     https://docs.cloud.google.com/gemini-enterprise-agent-platform/reference/rest/v1/MachineSpec#AcceleratorType).
  #     The corresponding linear scaling value is the dimensionless
  #     [`accelerator_count`](https://docs.cloud.google.com/gemini-enterprise-agent-platform/reference/rest/v1/MachineSpec#FIELDS.accelerator_count).
  # @!attribute [r] price_per_unit
  #   @return [::Google::Type::Money]
  #     Output only. The price per unit of usage.
  #     The customer's usage charge is computed by measuring the customer's
  #     consumption denominated in price units and multiplying by this price.
  # @!attribute [r] unit
  #   @return [::String]
  #     Output only. The price unit of the SKU.
  #     See https://ucum.org/ucum.html for the format of the price unit.
  #     Currently the unit is always hours ('h'). This may change in future.
  # @!attribute [r] usage_calculation
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformDeployedModelUsageFee::UsageCalculation]
  #     Output only. Determines how the customer's usage is calculated.
  class AiPlatformDeployedModelUsageFee
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Determines how the customer's usage is calculated.
    module UsageCalculation
      # Unused.
      USAGE_CALCULATION_UNSPECIFIED = 0

      # Usage is calculated from deployment runtime and size.
      # Usage is calculated by measuring the deployment runtime in hours and
      # multiplying by the amount of the deployed model's hardware resource
      # matching the SKU's hardware resource type.
      # This results in a composite `unit` of hours ('h') multiplied by the
      # unit that denominates the hardware resource, though note that
      # multiplying by the dimensionless unit ("1") has no effect.
      LINEAR_RESOURCE_SCALED_DEPLOYMENT_RUNTIME = 2
    end
  end

  # Details about a SKU charging a flat subscription fee.
  # @!attribute [r] price_per_unit
  #   @return [::Google::Type::Money]
  #     Output only. The price per time unit the subscription is active.
  # @!attribute [r] unit
  #   @return [::String]
  #     Output only. The unit of the subscription SKU.
  #     See https://ucum.org/ucum.html for the format of the price unit.
  #     Since subscriptions are billed by duration, this will always be a time
  #     unit. The price unit of a subscription SKU is not necessarily the same
  #     as the subscription period of the corresponding StandardOffers.
  #
  #     Currently the unit is always months ('mo').
  #     Additional time units may be supported in future.
  #
  #     The unit month ('mo') is a customary time unit and requires special
  #     handling to account for the variable duration of months. A price may be
  #     denominated in units of months, but the duration the subscription is
  #     active is measured in metric time and customers are billed on that
  #     basis. The exact hourly or per-second price can be calculated by
  #     dividing the monthly price by the number of hours or seconds in the
  #     desired month. A subscription active for N months is rarely billed
  #     exactly N times the monthly price. This is intended and is not a
  #     billing error.
  class FlatSubscriptionFee
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Price structure for a SKU charging a [tiered
  # price](https://cloud.google.com/billing/docs/how-to/pricing-table#tiered-pricing).
  # @!attribute [r] unit
  #   @return [::String]
  #     Output only. Usage unit used for defining price tiers and for scaling
  #     with the price_unit_count to form the composite price unit.
  #
  #     See https://ucum.org/ucum.html for the format of the price unit.
  #     A unitless dimension, such as a count, is represented as `1`.
  # @!attribute [r] unit_description
  #   @return [::String]
  #     Output only. The display description of the unit, supplied at time of
  #     onboarding. This value is recommended to be set at least for
  #     dimensionless metrics, but may be empty if no description was provided
  #     at time of onboarding.
  # @!attribute [r] price_unit_count
  #   @return [::Google::Type::Decimal]
  #     Output only. Scaling  the `unit` by the `price_unit_count` forms the
  #     composite "price unit" which is priced by the price tiers.
  #
  #     This scaling factor is in addition to any numerical prefix symbol on
  #     the `unit`, so the same composite "price unit" can be represented in
  #     several ways, differing only in their presentation to users.
  #
  #     Examples:
  #
  #     * $1    per 1    bytes     : unit = By,  price_unit_count = 1
  #     * $1000 per 1    kilobytes : unit = kBy, price_unit_count = 1
  #     * $5000 per 5    kilobytes : unit = kBy, price_unit_count = 5
  # @!attribute [r] price_tiers
  #   @return [::Array<::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::TieredPrice::PriceTier>]
  #     Output only. The list of price tiers for the SKU, ordered by the
  #     start_amount.
  #
  #     The tiers are non-overlapping and are collectively bounded below by
  #     zero and unbounded above to cover the entire range of possible metric
  #     usage. Each tier is bounded below inclusively by its start_amount and
  #     bounded above exclusively by the start_amount of the next tier, or else
  #     unbounded above if there is no next tier.
  #
  #     Usage of the metric is aggregated by customer billing account on a
  #     monthly basis and billed in a graduated manner according to the price
  #     tiers, with each marginal unit of usage priced accoring to the tier in
  #     which it falls.
  class TieredPrice
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # A [price
    # tier](https://cloud.google.com/billing/docs/how-to/pricing-table#tiered-pricing)
    # pricing metric usage within a range.
    #
    # Each marginal unit of usage is priced according to the price tier in
    # which it falls.
    # @!attribute [r] start_amount
    #   @return [::Google::Type::Decimal]
    #     Output only. Inclusive lower bound of the tier interval, denominated
    #     in `unit`.
    # @!attribute [r] price
    #   @return [::Google::Type::Money]
    #     Output only. The price per `price_unit_count` of `unit` in the tier.
    #     The price is applied fractionally if the customer's usage within the
    #     tier is not an integer multiple of `price_unit_count`.
    class PriceTier
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end
  end

  # Location scope for a SKU that applies to an AI Platform Managed Model
  # endpoint.
  # @!attribute [r] region_id
  #   @return [::String]
  #     Output only. The SKU applies to a region.
  #
  #     Note: The following fields are mutually exclusive: `region_id`, `global_endpoint`, `multi_region_id`. If a field in that set is populated, all other fields in the set will automatically be cleared.
  # @!attribute [r] global_endpoint
  #   @return [::Boolean]
  #     Output only. The SKU applies to a [global
  #     endpoint](https://docs.cloud.google.com/gemini-enterprise-agent-platform/resources/locations).
  #     **Note**: This is distinct from the conventional meaning of "global"
  #     as a SKU that applies to all locations.
  #
  #     Note: The following fields are mutually exclusive: `global_endpoint`, `region_id`, `multi_region_id`. If a field in that set is populated, all other fields in the set will automatically be cleared.
  # @!attribute [r] multi_region_id
  #   @return [::String]
  #     Output only. The SKU applies to a multi-region.
  #
  #     Note: The following fields are mutually exclusive: `multi_region_id`, `region_id`, `global_endpoint`. If a field in that set is populated, all other fields in the set will automatically be cleared.
  class AiPlatformManagedModelEndpointLocation
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end
end

#managed_service_metric_usage_fee::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::ManagedServiceMetricUsageFee (readonly)

Returns Output only. The SKU prices usage reported by the partner for a partner-defined custom billing metric.

Note: The following fields are mutually exclusive: managed_service_metric_usage_fee, inactive, gce_license_usage_fee, gke_pod_usage_fee, ai_platform_managed_model_usage_fee, ai_platform_provisioned_throughput_fee, ai_platform_deployed_model_usage_fee, flat_subscription_fee. If a field in that set is populated, all other fields in the set will automatically be cleared.

Returns:

  • (::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::ManagedServiceMetricUsageFee)

    Output only. The SKU prices usage reported by the partner for a partner-defined custom billing metric.

    Note: The following fields are mutually exclusive: managed_service_metric_usage_fee, inactive, gce_license_usage_fee, gke_pod_usage_fee, ai_platform_managed_model_usage_fee, ai_platform_provisioned_throughput_fee, ai_platform_deployed_model_usage_fee, flat_subscription_fee. If a field in that set is populated, all other fields in the set will automatically be cleared.



125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
# File 'proto_docs/google/cloud/commerceproducer/v1beta/sku.rb', line 125

class SkuPrice
  include ::Google::Protobuf::MessageExts
  extend ::Google::Protobuf::MessageExts::ClassMethods

  # Representation for a SKU that is not active and has no price.
  class InactiveSkuPrice
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Details about a SKU pricing usage of a [partner-reported custom billing
  # metric](https://cloud.google.com/service-infrastructure/docs/reporting-billing-metrics)
  # defined by the partner in the Service Management API and reported using
  # the Service Control API.
  #
  # The customer's usage charge is computed by converting the customer's
  # reported consumption to the SKU's composite price unit and applying the
  # graduated price from the appropriate price tier.
  # @!attribute [r] tiered_price
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::TieredPrice]
  #     Output only. [Tiered
  #     pricing](https://cloud.google.com/billing/docs/how-to/pricing-table#tiered-pricing)
  #     of the SKU.
  # @!attribute [r] canonical_metric
  #   @return [::String]
  #     Output only. The name of the metric, in canonical format.
  #
  #     Note that in the canonical format the first character of the path
  #     component of the metric name is always uppercase, which may differ
  #     from the metric name in the service config. For example, a metric
  #     appearing in the service config as 'example.com/example_metric' will
  #     appear here in the SKU as 'example.com/Example_metric'. In the Service
  #     Management and Service Control APIs these two metric names are
  #     considered distinct, either or both may be defined, and usage must be
  #     reported using a name matching the name of a metric defined in the
  #     service config. But for billing purposes usage reported using either
  #     name will be aggregated under the canonical metric name.
  #
  #     Example: "example.com/Example_metric"
  class ManagedServiceMetricUsageFee
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Details about a SKU pricing usage of a [Compute Engine
  # License](https://cloud.google.com/compute/docs/licenses/about).
  #
  # The SKU applies to a single license, and may be further scoped to a
  # [Compute
  # Engine VM Instance](https://cloud.google.com/compute/docs/instances)
  # machine resource type (e.g. "vCPU") and size range for that machine
  # resource. Instances deployed from [Compute
  # Engine Images](https://cloud.google.com/compute/docs/images)
  # incorporating the target license and (if applicable) matching the machine
  # resource type size range will be charged by the SKU. A single license may
  # be priced by multiple SKUs covering different combinations of machine
  # resource type and size range, allowing a single running instance to be
  # charged by up to one SKU per machine resource type, with pricing tiered
  # according to machine shape.
  # @!attribute [rw] price_per_unit
  #   @return [::Google::Type::Money]
  #     The price per unit of usage.
  #     The customer's usage charge is computed by measuring the customer's
  #     consumption denominated in price units and multiplying by this price.
  # @!attribute [r] license_code
  #   @return [::String]
  #     Output only. The license code of the target Compute Engine License.
  #     Note that this is the numeric license code itself in uint64 format used
  #     to reference licenses attached to images, not the resource name of the
  #     related [Compute Engine LicenseCode
  #     resource](https://cloud.google.com/compute/docs/reference/rest/v1/licenseCodes).
  #
  #     Example: "1234567890123456789"
  # @!attribute [r] machine_resource
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::ComputeEngineLicenseUsageFee::MachineResource]
  #     Output only. The machine resource type that the SKU applies to, if any.
  #     SKUs with a non-default value are referred to as "resource-based" SKUs.
  # @!attribute [r] machine_resource_range
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::ComputeEngineLicenseUsageFee::MachineResourceRange]
  #     Output only. The range of machine resource values that the SKU applies
  #     to. Unset when the SKU is not scoped to a particular machine resource
  #     type. The collection of SKUs in effect at any given time targeting the
  #     same license and machine resource type will cover all possible values
  #     for that machine resource type without overlap. Such a collection of
  #     SKUs form a "tiered" price structure over the possible values of the
  #     machine resource, with each SKU acting as a "tier".
  #
  #     NOTE: This is distinct from a SKU with [tiered
  #     pricing](https://cloud.google.com/billing/docs/how-to/pricing-table#tiered-pricing).
  # @!attribute [r] usage_calculation
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::ComputeEngineLicenseUsageFee::UsageCalculation]
  #     Output only. Determines how the customer's usage is calculated.
  # @!attribute [r] unit
  #   @return [::String]
  #     Output only. The price unit of the SKU.
  #     See https://ucum.org/ucum.html for the format of the price unit.
  #     For linear-priced memory SKUs, the price unit is 'GiBy.h'.
  #     For all other SKUs, the price unit is 'h'. This includes linear-priced
  #     vCPU and GPU SKUs because these resources have unitless dimensions and
  #     the application of these scaling factors does not change the price
  #     unit.
  class ComputeEngineLicenseUsageFee
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # The range of machine resource values that the SKU applies to.
    # @!attribute [r] start_value
    #   @return [::Integer]
    #     Output only. The inclusive lower bound of the range.
    #     While the number zero may be the start of a range, it is not a
    #     possible machine resource value. An instance cannot exist with zero
    #     vCPU or memory, and an instance with no attached accelerators lacks a
    #     GPU dimension entirely rather than having a GPU count of zero.
    # @!attribute [r] end_value
    #   @return [::Integer]
    #     Output only. The exclusive upper bound of the range.
    #     If no end value is specified, the range is unbounded from above.
    class MachineResourceRange
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # The machine resource type that the SKU applies to, if any.
    module MachineResource
      # The SKU applies to all instances irrespective of machine shape.
      # This is referred to as "instance-based pricing" because the price
      # is the same for all instances.
      MACHINE_RESOURCE_UNSPECIFIED = 0

      # The SKU applies based on the instance's vCPU count.
      VCPU_COUNT = 1

      # The SKU applies based on the instance's memory size in bytes.
      MEMORY_BYTES = 2

      # The SKU applies based on the instance's GPU count.
      GPU_COUNT = 3
    end

    # Determines how the customer's usage is calculated.
    module UsageCalculation
      # Unused.
      USAGE_CALCULATION_UNSPECIFIED = 0

      # Usage is calculated from instance runtime.
      # The customer's usage is metered according to the [Compute Engine VM
      # instance pricing
      # model](https://cloud.google.com/compute/vm-instance-pricing),
      # measured on a per-instance basis in units of hours, with a minimum
      # duration of one minute and an increment of one second.
      #
      # A SKU using this usage calculation is referred to as "flat" because
      # the customer's usage charge is independent of the instance's machine
      # resource shape apart from determining whether the SKU applies to the
      # instance.
      INSTANCE_RUNTIME = 1

      # Usage is calculated from instance runtime and size.
      # This calculation mode is only applicable to resource-based SKUs.
      # Usage is calculated by measuring the instance runtime in the same
      # manner as for `INSTANCE_RUNTIME` and multiplying by the instance's
      # machine resource value matching the SKU's machine resource type.
      # This converts the price from per-instance-hour to
      # per-instance-hour-per-machine-resource, which changes the price unit
      # for memory SKUs to 'GiBy.h'. The price unit otherwise remains 'h'
      # because the other machine resources are dimensionless.
      #
      # A SKU using this usage calculation is referred to as "linear" because
      # the customer's usage charge is linearly proportional to the
      # instance's machine resource value.
      LINEAR_RESOURCE_SCALED_INSTANCE_RUNTIME = 2
    end
  end

  # Details about a SKU pricing usage of software running on a Kubernetes
  # Engine pod.
  #
  # The SKU applies to pods annotated with the SKU's parent service name, and
  # may be further scoped to a [k8s pod resource
  # type](https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/)
  # (e.g. "CPU") and size range for that resource type. Running pods
  # annotated with the parent service's service name and matching the pod
  # resource type size range will be charged by the SKU. A service may be
  # priced by multiple SKUs covering different combinations of pod resource
  # type and size range, allowing a single running pod to be charged by up to
  # one SKU per pod resource type, with pricing tiered according to pod
  # shape.
  # @!attribute [rw] price_per_unit
  #   @return [::Google::Type::Money]
  #     The price per unit of usage.
  #     The customer's usage charge is computed by measuring the customer's
  #     consumption denominated in price units and multiplying by this price.
  # @!attribute [r] pod_resource
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::KubernetesEnginePodUsageFee::PodResource]
  #     Output only. The pod resource type that the SKU applies to.
  #     SKUs with a non-default value are referred to as "resource-based" SKUs.
  # @!attribute [r] pod_resource_range
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::KubernetesEnginePodUsageFee::PodResourceRange]
  #     Output only. The range of pod resource values that the SKU applies to.
  #     The collection of SKUs in effect at any given time targeting the same
  #     service annotation and pod resource type will cover all possible values
  #     for that pod resource type without overlap. Such a collection of SKUs
  #     form a "tiered" price structure over the possible values of the pod
  #     resource, with each SKU acting as a "tier".
  #
  #     NOTE: This is distinct from a SKU with [tiered
  #     pricing](https://cloud.google.com/billing/docs/how-to/pricing-table#tiered-pricing).
  # @!attribute [r] usage_calculation
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::KubernetesEnginePodUsageFee::UsageCalculation]
  #     Output only. Determines how the customer's usage is calculated.
  # @!attribute [r] unit
  #   @return [::String]
  #     Output only. The price unit of the SKU.
  #     See https://ucum.org/ucum.html for the format of the price unit.
  #     For linear-priced memory SKUs, the price unit is 'GiBy.h'.
  #     For all other SKUs, the price unit is 'h'. This includes linear-priced
  #     VCPU, GPU, and TPU SKUs because these resources have unitless
  #     dimensions and the application of these scaling factors does not change
  #     the price unit.
  class KubernetesEnginePodUsageFee
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # The range of pod resource values that the SKU applies to.
    # @!attribute [r] start_value
    #   @return [::Integer]
    #     Output only. The inclusive lower bound of the range.
    # @!attribute [r] end_value
    #   @return [::Integer]
    #     Output only. The exclusive upper bound of the range.
    #     If no end value is specified, the range is unbounded from above.
    class PodResourceRange
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # The pod [resource
    # type](https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/)
    # that the SKU applies to.
    module PodResource
      # Unused.
      POD_RESOURCE_UNSPECIFIED = 0

      # The SKU applies based on the pod's [vCPU
      # count](https://kubernetes.io/docs/tasks/configure-pod-container/assign-cpu-resource/).
      VCPU_COUNT = 1

      # The SKU applies based on the pod's [memory
      # size](https://kubernetes.io/docs/tasks/configure-pod-container/assign-memory-resource/)
      # in bytes.
      MEMORY_BYTES = 2

      # The SKU applies based on the pod's GPU count.
      GPU_COUNT = 3

      # The SKU applies based on the pod's [TPU
      # count](https://cloud.google.com/kubernetes-engine/docs/concepts/tpus#how_tpus_work).
      TPU_COUNT = 4
    end

    # Determines how the customer's usage is calculated.
    module UsageCalculation
      # Unused.
      USAGE_CALCULATION_UNSPECIFIED = 0

      # Usage is calculated from pod runtime.
      # The customer's usage is metered in a manner similar to the [GKE
      # Autopilot mode for pods without specific hardware
      # requirements](https://cloud.google.com/kubernetes-engine/pricing),
      # priced on a per-pod basis in units of hours and measured in
      # one-second increments, with no minimum duration.
      #
      # A SKU using this usage calculation is referred to as "flat" because
      # the customer's usage charge is independent of the pod shape apart
      # from determining whether the SKU applies to the pod.
      POD_RUNTIME = 1

      # Usage is calculated from pod runtime and size.
      # This calculation mode is only applicable to resource-based SKUs.
      # Usage is calculated by measuring the pod runtime in the same manner
      # as for `POD_RUNTIME` and multiplying by the pod's resource value
      # matching the SKU's pod resource type.
      # This converts the price from per-pod-hour to
      # per-pod-hour-per-resource, which changes the price unit for memory
      # SKUs to 'GiBy.h'. The price unit otherwise remains 'h' because the
      # other resources are dimensionless.
      #
      # A SKU using this usage calculation is referred to as "linear" because
      # the customer's usage charge is linearly proportional to the
      # pod's resource value.
      LINEAR_RESOURCE_SCALED_POD_RUNTIME = 2
    end
  end

  # Details about a SKU pricing usage of an [AI Platform Managed Model
  # (MaaS)](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/partner-models/use-partner-models).
  # @!attribute [r] tiered_price
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::TieredPrice]
  #     Output only. [Tiered
  #     pricing](https://cloud.google.com/billing/docs/how-to/pricing-table#tiered-pricing)
  #     of the SKU.
  # @!attribute [r] usage_metric
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::AiPlatformManagedModelUsageMetric]
  #     Output only. The usage metric that the SKU applies to.
  # @!attribute [r] location
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelEndpointLocation]
  #     Output only. The model endpoint location where usage is priced by this
  #     SKU. If no location is specified, the SKU applies to usage in all
  #     locations.
  # @!attribute [r] prediction_mode
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::PredictionMode]
  #     Output only. The prediction mode of requests that the SKU applies to.
  # @!attribute [r] combined_request_input_tokens_range
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::CombinedRequestInputTokensRange]
  #     Output only. The range of aggregated input token values covered by the
  #     SKU. Unset if the SKU is not scoped to a particular range. A request is
  #     in scope for this SKU if its aggregated input token value falls within
  #     the range. The collection of SKUs in effect at any given time scoped to
  #     a particular aggregated input token value range will cover all possible
  #     values without overlap. Such a collection of SKUs form a "tiered" price
  #     structure over the possible value, with each SKU acting as a "tier".
  #
  #     NOTE: This is distinct from a SKU with [tiered
  #     pricing](https://cloud.google.com/billing/docs/how-to/pricing-table#tiered-pricing).
  # @!attribute [r] provisioned_throughput_overage
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::ProvisionedThroughputOverage]
  #     Output only. Set when the SKU is a historical provisioned throughput
  #     overage SKU. Starting 2025-08-26 such SKUs have no effect, and usage in
  #     excess of provisioned throughput quota is now metered as standard
  #     usage. This field is set only in historical SKU timeline entries for
  #     overage SKUs belonging to partners that offered provisioned throughput
  #     for AI Platform managed model products prior to the unification of
  #     standard usage and provisioned throughput overage metering.
  class AiPlatformManagedModelUsageFee
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # The usage metric that the SKU applies to.
    # @!attribute [r] input_tokens_metric
    #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::AiPlatformManagedModelUsageMetric::InputTokensMetric]
    #     Output only. Input tokens read from the prediction endpoint input.
    #
    #     Note: The following fields are mutually exclusive: `input_tokens_metric`, `cache_read_input_tokens_metric`, `cache_write_input_tokens_metric`, `output_tokens_metric`, `web_search_requests_metric`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] cache_read_input_tokens_metric
    #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::AiPlatformManagedModelUsageMetric::CacheReadInputTokensMetric]
    #     Output only. Input tokens read from the cache.
    #
    #     Note: The following fields are mutually exclusive: `cache_read_input_tokens_metric`, `input_tokens_metric`, `cache_write_input_tokens_metric`, `output_tokens_metric`, `web_search_requests_metric`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] cache_write_input_tokens_metric
    #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::AiPlatformManagedModelUsageMetric::CacheWriteInputTokensMetric]
    #     Output only. Input tokens written to the cache.
    #
    #     Note: The following fields are mutually exclusive: `cache_write_input_tokens_metric`, `input_tokens_metric`, `cache_read_input_tokens_metric`, `output_tokens_metric`, `web_search_requests_metric`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] output_tokens_metric
    #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::AiPlatformManagedModelUsageMetric::OutputTokensMetric]
    #     Output only. Output tokens returned from the prediction endpoint.
    #
    #     Note: The following fields are mutually exclusive: `output_tokens_metric`, `input_tokens_metric`, `cache_read_input_tokens_metric`, `cache_write_input_tokens_metric`, `web_search_requests_metric`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    # @!attribute [r] web_search_requests_metric
    #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelUsageFee::AiPlatformManagedModelUsageMetric::WebSearchRequestsMetric]
    #     Output only. Web search requests executed by the model.
    #
    #     Note: The following fields are mutually exclusive: `web_search_requests_metric`, `input_tokens_metric`, `cache_read_input_tokens_metric`, `cache_write_input_tokens_metric`, `output_tokens_metric`. If a field in that set is populated, all other fields in the set will automatically be cleared.
    class AiPlatformManagedModelUsageMetric
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods

      # Input tokens read from the input to the prediction endpoint.
      # The unit for this metric is dimensionless.
      class InputTokensMetric
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end

      # Input tokens read from the cache.
      # The unit for this metric is dimensionless.
      class CacheReadInputTokensMetric
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end

      # Input tokens written to the cache.
      # The unit for this metric is dimensionless.
      # @!attribute [r] ttl
      #   @return [::Google::Protobuf::Duration]
      #     Output only. The duration the write is retained in the cache.
      class CacheWriteInputTokensMetric
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end

      # Output tokens returned from the prediction endpoint.
      # The unit for this metric is dimensionless.
      class OutputTokensMetric
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end

      # Web search requests executed by the model.
      # The unit for this metric is dimensionless.
      class WebSearchRequestsMetric
        include ::Google::Protobuf::MessageExts
        extend ::Google::Protobuf::MessageExts::ClassMethods
      end
    end

    # The range of aggregated input token values covered by the SKU.
    #
    # A request to a managed model has an aggregated input token value
    # determined by the sum of the metric values of the input token metrics.
    #
    # * input tokens
    # * cache read input tokens
    # * cache write input tokens
    # @!attribute [r] start_value
    #   @return [::Integer]
    #     Output only. The inclusive lower bound of the range.
    # @!attribute [r] end_value
    #   @return [::Integer]
    #     Output only. The exclusive upper bound of the range.
    #     If no end value is specified, the range is unbounded from above.
    class CombinedRequestInputTokensRange
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # Additional details present for historical provisioned throughput
    # "overage" SKUs that applied charges only to usage above the customer's
    # provisioned throughput quota threshold.
    # @!attribute [r] service
    #   @return [::String]
    #     Output only. The service whose usage the overage SKU applied to.
    class ProvisionedThroughputOverage
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end

    # The prediction modes of requests that the SKU applies to.
    module PredictionMode
      # The SKU does not distinguish between prediction modes.
      PREDICTION_MODE_UNSPECIFIED = 0

      # The SKU applies to online prediction.
      ONLINE_PREDICTION = 1

      # The SKU applies to batch prediction.
      BATCH_PREDICTION = 2
    end
  end

  # Details about a SKU pricing reservation of [AI Platform Provisioned
  # Throughput](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/provisioned-throughput).
  #
  # Customers may purchase provisioned throughput reservations for AI
  # Platform managed model products. This provides the customer with
  # provisioned throughput quota for a particular model and location. Model
  # usage below the provisioned throughput quota threshold is voided and is
  # not charged by the product's managed model usage fees.
  # @!attribute [r] term_duration_months
  #   @return [::Integer]
  #     Output only. The duration of the provisioned throughput reservation
  #     in months.
  # @!attribute [rw] gsu_price_per_unit
  #   @return [::Google::Type::Money]
  #     The price per [Generative AI Scale Unit
  #     (GSU)](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/provisioned-throughput/measure-provisioned-throughput)
  #     per `unit`.
  #     A provisioned throughput reservation reserves a certain number of
  #     GSUs, and the customer is billed for those GSUs on a continuous basis
  #     for the duration of the reservation.
  # @!attribute [r] location
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformManagedModelEndpointLocation]
  #     Output only. The location where provisioned throughput is priced by
  #     this SKU.
  # @!attribute [r] unit
  #   @return [::String]
  #     Output only. The price unit of the SKU.
  #     See https://ucum.org/ucum.html for the format of the price unit.
  #     Since provisioned throughput reservations are billed by duration, this
  #     will always be a time unit. The price unit of a provisioned throughput
  #     SKU is not necessarily the same as the reservation term.
  #     This field is unrelated to the [Generative AI Scale Unit
  #     (GSU)](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/provisioned-throughput/measure-provisioned-throughput).
  #
  #     Currently the unit is always months ('mo').
  #     Additional time units may be supported in future.
  #
  #     The customary unit month ('mo') requires special handling to account
  #     for the variable duration of months. A price may be denominated in
  #     units of months, but the duration the reservation is active is measured
  #     in metric time and customers are billed on that basis. The exact hourly
  #     or per-second price can be calculated by dividing the monthly price
  #     by the number of hours or seconds in the desired month. A reservation
  #     active for N months is rarely billed exactly N times the monthly price.
  #     This is intended and is not a billing error.
  class AiPlatformProvisionedThroughputFee
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Details about a SKU pricing usage of an [AI Platform Self Deployed
  # Model](https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/model-garden/self-deployed-models).
  # @!attribute [r] accelerator_type
  #   @return [::String]
  #     Output only. The SKU applies to a specific accelerator type.
  #     Contains the name of the matching [AI Platform AcceleratorType](
  #     https://docs.cloud.google.com/gemini-enterprise-agent-platform/reference/rest/v1/MachineSpec#AcceleratorType).
  #     The corresponding linear scaling value is the dimensionless
  #     [`accelerator_count`](https://docs.cloud.google.com/gemini-enterprise-agent-platform/reference/rest/v1/MachineSpec#FIELDS.accelerator_count).
  # @!attribute [r] price_per_unit
  #   @return [::Google::Type::Money]
  #     Output only. The price per unit of usage.
  #     The customer's usage charge is computed by measuring the customer's
  #     consumption denominated in price units and multiplying by this price.
  # @!attribute [r] unit
  #   @return [::String]
  #     Output only. The price unit of the SKU.
  #     See https://ucum.org/ucum.html for the format of the price unit.
  #     Currently the unit is always hours ('h'). This may change in future.
  # @!attribute [r] usage_calculation
  #   @return [::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::AiPlatformDeployedModelUsageFee::UsageCalculation]
  #     Output only. Determines how the customer's usage is calculated.
  class AiPlatformDeployedModelUsageFee
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # Determines how the customer's usage is calculated.
    module UsageCalculation
      # Unused.
      USAGE_CALCULATION_UNSPECIFIED = 0

      # Usage is calculated from deployment runtime and size.
      # Usage is calculated by measuring the deployment runtime in hours and
      # multiplying by the amount of the deployed model's hardware resource
      # matching the SKU's hardware resource type.
      # This results in a composite `unit` of hours ('h') multiplied by the
      # unit that denominates the hardware resource, though note that
      # multiplying by the dimensionless unit ("1") has no effect.
      LINEAR_RESOURCE_SCALED_DEPLOYMENT_RUNTIME = 2
    end
  end

  # Details about a SKU charging a flat subscription fee.
  # @!attribute [r] price_per_unit
  #   @return [::Google::Type::Money]
  #     Output only. The price per time unit the subscription is active.
  # @!attribute [r] unit
  #   @return [::String]
  #     Output only. The unit of the subscription SKU.
  #     See https://ucum.org/ucum.html for the format of the price unit.
  #     Since subscriptions are billed by duration, this will always be a time
  #     unit. The price unit of a subscription SKU is not necessarily the same
  #     as the subscription period of the corresponding StandardOffers.
  #
  #     Currently the unit is always months ('mo').
  #     Additional time units may be supported in future.
  #
  #     The unit month ('mo') is a customary time unit and requires special
  #     handling to account for the variable duration of months. A price may be
  #     denominated in units of months, but the duration the subscription is
  #     active is measured in metric time and customers are billed on that
  #     basis. The exact hourly or per-second price can be calculated by
  #     dividing the monthly price by the number of hours or seconds in the
  #     desired month. A subscription active for N months is rarely billed
  #     exactly N times the monthly price. This is intended and is not a
  #     billing error.
  class FlatSubscriptionFee
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end

  # Price structure for a SKU charging a [tiered
  # price](https://cloud.google.com/billing/docs/how-to/pricing-table#tiered-pricing).
  # @!attribute [r] unit
  #   @return [::String]
  #     Output only. Usage unit used for defining price tiers and for scaling
  #     with the price_unit_count to form the composite price unit.
  #
  #     See https://ucum.org/ucum.html for the format of the price unit.
  #     A unitless dimension, such as a count, is represented as `1`.
  # @!attribute [r] unit_description
  #   @return [::String]
  #     Output only. The display description of the unit, supplied at time of
  #     onboarding. This value is recommended to be set at least for
  #     dimensionless metrics, but may be empty if no description was provided
  #     at time of onboarding.
  # @!attribute [r] price_unit_count
  #   @return [::Google::Type::Decimal]
  #     Output only. Scaling  the `unit` by the `price_unit_count` forms the
  #     composite "price unit" which is priced by the price tiers.
  #
  #     This scaling factor is in addition to any numerical prefix symbol on
  #     the `unit`, so the same composite "price unit" can be represented in
  #     several ways, differing only in their presentation to users.
  #
  #     Examples:
  #
  #     * $1    per 1    bytes     : unit = By,  price_unit_count = 1
  #     * $1000 per 1    kilobytes : unit = kBy, price_unit_count = 1
  #     * $5000 per 5    kilobytes : unit = kBy, price_unit_count = 5
  # @!attribute [r] price_tiers
  #   @return [::Array<::Google::Cloud::CommerceProducer::V1beta::Sku::SkuPrice::TieredPrice::PriceTier>]
  #     Output only. The list of price tiers for the SKU, ordered by the
  #     start_amount.
  #
  #     The tiers are non-overlapping and are collectively bounded below by
  #     zero and unbounded above to cover the entire range of possible metric
  #     usage. Each tier is bounded below inclusively by its start_amount and
  #     bounded above exclusively by the start_amount of the next tier, or else
  #     unbounded above if there is no next tier.
  #
  #     Usage of the metric is aggregated by customer billing account on a
  #     monthly basis and billed in a graduated manner according to the price
  #     tiers, with each marginal unit of usage priced accoring to the tier in
  #     which it falls.
  class TieredPrice
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods

    # A [price
    # tier](https://cloud.google.com/billing/docs/how-to/pricing-table#tiered-pricing)
    # pricing metric usage within a range.
    #
    # Each marginal unit of usage is priced according to the price tier in
    # which it falls.
    # @!attribute [r] start_amount
    #   @return [::Google::Type::Decimal]
    #     Output only. Inclusive lower bound of the tier interval, denominated
    #     in `unit`.
    # @!attribute [r] price
    #   @return [::Google::Type::Money]
    #     Output only. The price per `price_unit_count` of `unit` in the tier.
    #     The price is applied fractionally if the customer's usage within the
    #     tier is not an integer multiple of `price_unit_count`.
    class PriceTier
      include ::Google::Protobuf::MessageExts
      extend ::Google::Protobuf::MessageExts::ClassMethods
    end
  end

  # Location scope for a SKU that applies to an AI Platform Managed Model
  # endpoint.
  # @!attribute [r] region_id
  #   @return [::String]
  #     Output only. The SKU applies to a region.
  #
  #     Note: The following fields are mutually exclusive: `region_id`, `global_endpoint`, `multi_region_id`. If a field in that set is populated, all other fields in the set will automatically be cleared.
  # @!attribute [r] global_endpoint
  #   @return [::Boolean]
  #     Output only. The SKU applies to a [global
  #     endpoint](https://docs.cloud.google.com/gemini-enterprise-agent-platform/resources/locations).
  #     **Note**: This is distinct from the conventional meaning of "global"
  #     as a SKU that applies to all locations.
  #
  #     Note: The following fields are mutually exclusive: `global_endpoint`, `region_id`, `multi_region_id`. If a field in that set is populated, all other fields in the set will automatically be cleared.
  # @!attribute [r] multi_region_id
  #   @return [::String]
  #     Output only. The SKU applies to a multi-region.
  #
  #     Note: The following fields are mutually exclusive: `multi_region_id`, `region_id`, `global_endpoint`. If a field in that set is populated, all other fields in the set will automatically be cleared.
  class AiPlatformManagedModelEndpointLocation
    include ::Google::Protobuf::MessageExts
    extend ::Google::Protobuf::MessageExts::ClassMethods
  end
end