Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 7 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,13 @@ for details on updating existing applications using v1.x.y or v2.x.y.

- [Secret Manager](/google/cloud/secretmanager/README.md): In `google/cloud/secretmanager/v1`, the nested message `EnableManagedRotationRequest::CloudSQLSingleUserCredentials` was moved and renamed to `CloudSqlSingleUserCredentials`, and `EnableManagedRotationRequest`'s `oneof credentials` was renamed to `oneof credential`. This changes the signature of `SecretManagerServiceClient::EnableManagedRotation`.

### New Libraries

We are happy to announce the following GA libraries. Unless specifically noted,
the APIs in these libraries are stable, and are ready for production use.

- [App Lifecycle Manager API](/google/cloud/saasservicemgmt/README.md)

## v3.13.0 - 2026-11

### New Libraries
Expand Down
3 changes: 3 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -464,6 +464,9 @@ See each library's `README.md` file for more information about:
- [Cloud Run Admin API](google/cloud/run/README.md)
[[quickstart]](google/cloud/run/quickstart/README.md)
[[reference]](https://cloud.google.com/cpp/docs/reference/run/latest)
- [App Lifecycle Manager API](google/cloud/saasservicemgmt/README.md)
[[quickstart]](google/cloud/saasservicemgmt/quickstart/README.md)
[[reference]](https://cloud.google.com/cpp/docs/reference/saasservicemgmt/latest)
- [Cloud Scheduler API](google/cloud/scheduler/README.md)
[[quickstart]](google/cloud/scheduler/quickstart/README.md)
[[reference]](https://cloud.google.com/cpp/docs/reference/scheduler/latest)
Expand Down
Binary file not shown.
9 changes: 9 additions & 0 deletions ci/etc/expected_install_directories
Original file line number Diff line number Diff line change
Expand Up @@ -1153,6 +1153,13 @@
./include/google/cloud/run/v2
./include/google/cloud/run/v2/internal
./include/google/cloud/run/v2/mocks
./include/google/cloud/saasplatform
./include/google/cloud/saasplatform/saasservicemgmt
./include/google/cloud/saasplatform/saasservicemgmt/v1
./include/google/cloud/saasservicemgmt
./include/google/cloud/saasservicemgmt/v1
./include/google/cloud/saasservicemgmt/v1/internal
./include/google/cloud/saasservicemgmt/v1/mocks
./include/google/cloud/scheduler
./include/google/cloud/scheduler/v1
./include/google/cloud/scheduler/v1/internal
Expand Down Expand Up @@ -1648,6 +1655,8 @@
./lib64/cmake/google_cloud_cpp_retail_mocks
./lib64/cmake/google_cloud_cpp_run
./lib64/cmake/google_cloud_cpp_run_mocks
./lib64/cmake/google_cloud_cpp_saasservicemgmt
./lib64/cmake/google_cloud_cpp_saasservicemgmt_mocks
./lib64/cmake/google_cloud_cpp_scheduler
./lib64/cmake/google_cloud_cpp_scheduler_mocks
./lib64/cmake/google_cloud_cpp_secretmanager
Expand Down
1 change: 1 addition & 0 deletions cmake/GoogleCloudCppFeatures.cmake
Original file line number Diff line number Diff line change
Expand Up @@ -161,6 +161,7 @@ set(GOOGLE_CLOUD_CPP_GA_LIBRARIES
"resourcemanager"
"retail"
"run"
"saasservicemgmt"
"scheduler"
"secretmanager"
"securesourcemanager"
Expand Down
10 changes: 10 additions & 0 deletions external/googleapis/protodeps/saasservicemgmt.deps
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
@googleapis//google/api:annotations_proto
@googleapis//google/api:client_proto
@googleapis//google/api:field_behavior_proto
@googleapis//google/api:field_info_proto
@googleapis//google/api:http_proto
@googleapis//google/api:launch_stage_proto
@googleapis//google/api:resource_proto
@googleapis//google/longrunning:operations_proto
@googleapis//google/rpc:status_proto
@googleapis//google/type:decimal_proto
5 changes: 5 additions & 0 deletions external/googleapis/protolists/saasservicemgmt.list
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
@googleapis//google/cloud/saasplatform/saasservicemgmt/v1:common.proto
@googleapis//google/cloud/saasplatform/saasservicemgmt/v1:deployments_resources.proto
@googleapis//google/cloud/saasplatform/saasservicemgmt/v1:deployments_service.proto
@googleapis//google/cloud/saasplatform/saasservicemgmt/v1:rollouts_resources.proto
@googleapis//google/cloud/saasplatform/saasservicemgmt/v1:rollouts_service.proto
1 change: 1 addition & 0 deletions external/googleapis/update_libraries.sh
Original file line number Diff line number Diff line change
Expand Up @@ -275,6 +275,7 @@ declare -A -r LIBRARIES=(
["resourcemanager"]="@googleapis//google/cloud/resourcemanager/v3:resourcemanager_cc_grpc"
["retail"]="@googleapis//google/cloud/retail/v2:retail_cc_grpc"
["run"]="@googleapis//google/cloud/run/v2:run_cc_grpc"
["saasservicemgmt"]="@googleapis//google/cloud/saasplatform/saasservicemgmt/v1:saasservicemgmt_cc_grpc"
["scheduler"]="@googleapis//google/cloud/scheduler/v1:scheduler_cc_grpc"
["secretmanager"]="$(
printf ",%s" \
Expand Down
15 changes: 15 additions & 0 deletions generator/generator_config.textproto
Original file line number Diff line number Diff line change
Expand Up @@ -3807,6 +3807,21 @@ service {
retryable_status_codes: ["kUnavailable"]
}

# App Lifecycle Manager
service {
service_proto_path: "google/cloud/saasplatform/saasservicemgmt/v1/deployments_service.proto"
product_path: "google/cloud/saasservicemgmt/v1"
initial_copyright_year: "2026"
retryable_status_codes: ["kUnavailable"]
}

service {
service_proto_path: "google/cloud/saasplatform/saasservicemgmt/v1/rollouts_service.proto"
product_path: "google/cloud/saasservicemgmt/v1"
initial_copyright_year: "2026"
retryable_status_codes: ["kUnavailable"]
}

# Scheduler
service {
service_proto_path: "google/cloud/scheduler/v1/cloudscheduler.proto"
Expand Down
31 changes: 31 additions & 0 deletions google/cloud/saasservicemgmt/BUILD.bazel
Original file line number Diff line number Diff line change
@@ -0,0 +1,31 @@
# Copyright 2026 Google LLC
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# https://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

load("//bazel:gapic.bzl", "cc_gapic_library")

package(default_visibility = ["//visibility:private"])

licenses(["notice"]) # Apache 2.0

service_dirs = ["v1/"]

googleapis_deps = [
"@googleapis//google/cloud/saasplatform/saasservicemgmt/v1:saasservicemgmt_cc_grpc",
]

cc_gapic_library(
name = "saasservicemgmt",
googleapis_deps = googleapis_deps,
service_dirs = service_dirs,
)
37 changes: 37 additions & 0 deletions google/cloud/saasservicemgmt/CMakeLists.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,37 @@
# ~~~
# Copyright 2026 Google LLC
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# https://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
# ~~~

include(GoogleCloudCppLibrary)

google_cloud_cpp_add_gapic_library(saasservicemgmt "App Lifecycle Manager API"
SERVICE_DIRS "v1/")

if (BUILD_TESTING AND GOOGLE_CLOUD_CPP_ENABLE_CXX_EXCEPTIONS)
add_executable(saasservicemgmt_quickstart "quickstart/quickstart.cc")
target_link_libraries(saasservicemgmt_quickstart
PRIVATE google-cloud-cpp::saasservicemgmt)
google_cloud_cpp_add_common_options(saasservicemgmt_quickstart)
add_test(
NAME saasservicemgmt_quickstart
COMMAND
cmake -P "${PROJECT_SOURCE_DIR}/cmake/quickstart-runner.cmake"
$<TARGET_FILE:saasservicemgmt_quickstart> GOOGLE_CLOUD_PROJECT
GOOGLE_CLOUD_CPP_TEST_REGION)
set_tests_properties(
saasservicemgmt_quickstart
PROPERTIES LABELS "integration-test;quickstart" PASS_REGULAR_EXPRESSION
"Permanent error.*gcloud-cpp.retry.function=ListSaas")
endif ()
61 changes: 61 additions & 0 deletions google/cloud/saasservicemgmt/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,61 @@
# App Lifecycle Manager API C++ Client Library

This directory contains an idiomatic C++ client library for the
[App Lifecycle Manager API][cloud-service-docs].

Model, deploy, and operate your SaaS at scale.

While this library is **GA**, please note that the Google Cloud C++ client
libraries do **not** follow [Semantic Versioning](https://semver.org/).

## Quickstart

The [quickstart/](quickstart/README.md) directory contains a minimal environment
to get started using this client library in a larger project. The following
"Hello World" program is used in this quickstart, and should give you a taste of
this library.

<!-- inject-quickstart-start -->

```cc
#include "google/cloud/saasservicemgmt/v1/saas_deployments_client.h"
#include "google/cloud/location.h"
#include <iostream>

int main(int argc, char* argv[]) try {
if (argc != 3) {
std::cerr << "Usage: " << argv[0] << " project-id location-id\n";
return 1;
}

auto const location = google::cloud::Location(argv[1], argv[2]);

namespace saasservicemgmt = ::google::cloud::saasservicemgmt_v1;
auto client = saasservicemgmt::SaasDeploymentsClient(
saasservicemgmt::MakeSaasDeploymentsConnection());

for (auto r : client.ListSaas(location.FullName())) {
if (!r) throw std::move(r).status();
std::cout << r->DebugString() << "\n";
}
Comment thread
colinmoy marked this conversation as resolved.
Resolved

return 0;
} catch (google::cloud::Status const& status) {
std::cerr << "google::cloud::Status thrown: " << status << "\n";
return 1;
}
```

<!-- inject-quickstart-end -->

## More Information

- Official documentation about the
[App Lifecycle Manager API][cloud-service-docs] service
- [Reference doxygen documentation][doxygen-link] for each release of this
client library
- Detailed header comments in our [public `.h`][source-link] files

[cloud-service-docs]: https://docs.cloud.google.com/app-lifecycle-manager
[doxygen-link]: https://cloud.google.com/cpp/docs/reference/saasservicemgmt/latest/
[source-link]: https://github.com/googleapis/google-cloud-cpp/tree/main/google/cloud/saasservicemgmt
53 changes: 53 additions & 0 deletions google/cloud/saasservicemgmt/doc/environment-variables.dox
Original file line number Diff line number Diff line change
@@ -0,0 +1,53 @@
/*!
@page saasservicemgmt-env Environment Variables

A number of environment variables can be used to configure the behavior of
the library. There are also functions to configure this behavior in code. The
environment variables are convenient when troubleshooting problems.

@section saasservicemgmt-env-endpoint Endpoint Overrides

<!-- inject-endpoint-env-vars-start -->

- `GOOGLE_CLOUD_CPP_SAAS_DEPLOYMENTS_ENDPOINT=...` overrides the
`EndpointOption` (which defaults to "saasservicemgmt.googleapis.com")
used by `MakeSaasDeploymentsConnection()`.

- `GOOGLE_CLOUD_CPP_SAAS_ROLLOUTS_ENDPOINT=...` overrides the
`EndpointOption` (which defaults to "saasservicemgmt.googleapis.com")
used by `MakeSaasRolloutsConnection()`.

<!-- inject-endpoint-env-vars-end -->

@see google::cloud::EndpointOption

@section saasservicemgmt-env-logging Logging

`GOOGLE_CLOUD_CPP_ENABLE_TRACING=rpc`: turns on tracing for most gRPC
calls. The library injects an additional Stub decorator that prints each gRPC
request and response. Unless you have configured your own logging backend,
you should also set `GOOGLE_CLOUD_CPP_ENABLE_CLOG` to produce any output on
the program's console.

@see google::cloud::LoggingComponentsOption

`GOOGLE_CLOUD_CPP_TRACING_OPTIONS=...`: modifies the behavior of gRPC tracing,
including whether messages will be output on multiple lines, or whether
string/bytes fields will be truncated.

@see google::cloud::GrpcTracingOptionsOption

`GOOGLE_CLOUD_CPP_ENABLE_CLOG=yes`: turns on logging in the library, basically
the library always "logs" but the logging infrastructure has no backend to
actually print anything until the application sets a backend or they set this
environment variable.

@see google::cloud::LogBackend
@see google::cloud::LogSink

@section saasservicemgmt-env-project Setting the Default Project

`GOOGLE_CLOUD_PROJECT=...`: is used in examples and integration tests to
configure the GCP project. This has no effect in the library.

*/
54 changes: 54 additions & 0 deletions google/cloud/saasservicemgmt/doc/main.dox
Original file line number Diff line number Diff line change
@@ -0,0 +1,54 @@
/*!

@mainpage App Lifecycle Manager API C++ Client Library

An idiomatic C++ client library for the [App Lifecycle Manager API][cloud-service-docs].

Model, deploy, and operate your SaaS at scale.

While this library is **GA**, please note that the Google Cloud C++ client libraries do **not** follow
[Semantic Versioning](https://semver.org/).

@tableofcontents{HTML:2}

## Quickstart

The following shows the code that you'll run in the
`google/cloud/saasservicemgmt/quickstart/` directory,
which should give you a taste of the App Lifecycle Manager API C++ client library API.

@snippet quickstart.cc all

## Main classes

<!-- inject-client-list-start -->
This library offers multiple `*Client` classes, which are listed below. Each one
of these classes exposes all the RPCs for a service as member functions of the
class. This library groups multiple services because they are part of the same
product or are often used together. A typical example may be the administrative
and data plane operations for a single product.

The library also has other classes that provide helpers, configuration
parameters, and infrastructure to mock the `*Client` classes when testing your
application.

- [\c saasservicemgmt_v1::SaasDeploymentsClient](@ref google::cloud::saasservicemgmt_v1::SaasDeploymentsClient)
- [\c saasservicemgmt_v1::SaasRolloutsClient](@ref google::cloud::saasservicemgmt_v1::SaasRolloutsClient)
<!-- inject-client-list-end -->

## More Information

- @ref common-error-handling - describes how the library reports errors.
- @ref saasservicemgmt-override-endpoint - describes how to override the default
endpoint.
- @ref saasservicemgmt-override-authentication - describes how to change the
authentication credentials used by the library.
- @ref saasservicemgmt-override-retry - describes how to change the default retry
policies.
- @ref saasservicemgmt-env - describes environment variables that can configure the
behavior of the library.
- @ref saasservicemgmt-override-universe-domain - describes how to override the default universe domain.

[cloud-service-docs]: https://docs.cloud.google.com/app-lifecycle-manager

*/
10 changes: 10 additions & 0 deletions google/cloud/saasservicemgmt/doc/options.dox
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
/*!
@defgroup google-cloud-saasservicemgmt-options App Lifecycle Manager API Configuration Options

This library uses the same mechanism (`google::cloud::Options`) and the common
[options](@ref options) as all other C++ client libraries for its configuration.
Some `*Option` classes, which are only used in this library, are documented in
this page.

@see @ref options - for an overview of client library configuration.
*/
Loading
Loading