xref: /aosp_15_r20/external/googleapis/google/api/serviceusage/v1/serviceusage_v1.yaml (revision d5c09012810ac0c9f33fe448fb6da8260d444cc9)
1type: google.api.Service
2config_version: 3
3name: serviceusage.googleapis.com
4title: Service Usage API
5
6apis:
7- name: google.api.serviceusage.v1.ServiceUsage
8- name: google.longrunning.Operations
9
10types:
11- name: google.api.serviceusage.v1.BatchEnableServicesResponse
12- name: google.api.serviceusage.v1.BatchEnableServicesResponse.EnableFailure
13- name: google.api.serviceusage.v1.DisableServiceResponse
14- name: google.api.serviceusage.v1.EnableServiceResponse
15- name: google.api.serviceusage.v1.OperationMetadata
16
17documentation:
18  summary: |-
19    Enables services that service consumers want to use on Google Cloud
20    Platform, lists the available or enabled services, or disables services
21    that service consumers no longer use.
22  overview: |-
23    The Service Usage API allows *service consumers* to manage the set
24    of *services* they interact with. Consumers can use the Service Usage API
25    or the [Google Cloud Console](https://console.cloud.google.com) to enable
26    services in their [Google
27    developer
28    project](https://developers.google.com/console/help/new/). After a service
29    is enabled, its APIs become available.
30
31    ## Service consumers
32
33    A service consumer is a Google developer project that has enabled and can
34    invoke APIs on a service. A service can have many service consumers.
35
36backend:
37  rules:
38  - selector: 'google.api.serviceusage.v1.ServiceUsage.*'
39    deadline: 20.0
40  - selector: 'google.longrunning.Operations.*'
41    deadline: 20.0
42
43http:
44  rules:
45  - selector: google.longrunning.Operations.GetOperation
46    get: '/v1/{name=operations/*}'
47  - selector: google.longrunning.Operations.ListOperations
48    get: /v1/operations
49
50authentication:
51  rules:
52  - selector: 'google.api.serviceusage.v1.ServiceUsage.*'
53    oauth:
54      canonical_scopes: |-
55        https://www.googleapis.com/auth/cloud-platform,
56        https://www.googleapis.com/auth/service.management
57  - selector: google.api.serviceusage.v1.ServiceUsage.BatchGetServices
58    oauth:
59      canonical_scopes: |-
60        https://www.googleapis.com/auth/cloud-platform,
61        https://www.googleapis.com/auth/cloud-platform.read-only
62  - selector: google.api.serviceusage.v1.ServiceUsage.GetService
63    oauth:
64      canonical_scopes: |-
65        https://www.googleapis.com/auth/cloud-platform,
66        https://www.googleapis.com/auth/cloud-platform.read-only
67  - selector: google.api.serviceusage.v1.ServiceUsage.ListServices
68    oauth:
69      canonical_scopes: |-
70        https://www.googleapis.com/auth/cloud-platform,
71        https://www.googleapis.com/auth/cloud-platform.read-only
72  - selector: 'google.longrunning.Operations.*'
73    oauth:
74      canonical_scopes: |-
75        https://www.googleapis.com/auth/cloud-platform,
76        https://www.googleapis.com/auth/service.management
77