googleapis
@@ -6,6 +6,13 @@ breaking changes in the upcoming 3.x release. This release is scheduled for
 
 ## v2.30.0 - TBD
 
+### 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.
+
+- [Gemini API](/google/cloud/generativelanguage/README.md)
+
 ## v2.29.0 - 2024-09
 
 ### New Libraries

@@ -260,6 +260,9 @@ See each library's `README.md` file for more information about:
 - [Cloud Functions API](google/cloud/functions/README.md)
   [\[quickstart\]](google/cloud/functions/quickstart/README.md)
   [\[reference\]](https://cloud.google.com/cpp/docs/reference/functions/latest)
+- [Generative Language API](google/cloud/generativelanguage/README.md)
+  [\[quickstart\]](google/cloud/generativelanguage/quickstart/README.md)
+  [\[reference\]](https://cloud.google.com/cpp/docs/reference/generativelanguage/latest)
 - [Backup for GKE API](google/cloud/gkebackup/README.md)
   [\[quickstart\]](google/cloud/gkebackup/quickstart/README.md)
   [\[reference\]](https://cloud.google.com/cpp/docs/reference/gkebackup/latest)

@@ -1,6 +1,9 @@
 .
 ./include
 ./include/google
+./include/google/ai
+./include/google/ai/generativelanguage
+./include/google/ai/generativelanguage/v1
 ./include/google/api
 ./include/google/api/apikeys
 ./include/google/api/apikeys/v2
@@ -761,6 +764,10 @@
 ./include/google/cloud/functions/v2
 ./include/google/cloud/functions/v2/internal
 ./include/google/cloud/functions/v2/mocks
+./include/google/cloud/generativelanguage
+./include/google/cloud/generativelanguage/v1
+./include/google/cloud/generativelanguage/v1/internal
+./include/google/cloud/generativelanguage/v1/mocks
 ./include/google/cloud/gkebackup
 ./include/google/cloud/gkebackup/v1
 ./include/google/cloud/gkebackup/v1/internal
@@ -1381,6 +1388,8 @@
 ./lib64/cmake/google_cloud_cpp_filestore_mocks
 ./lib64/cmake/google_cloud_cpp_functions
 ./lib64/cmake/google_cloud_cpp_functions_mocks
+./lib64/cmake/google_cloud_cpp_generativelanguage
+./lib64/cmake/google_cloud_cpp_generativelanguage_mocks
 ./lib64/cmake/google_cloud_cpp_gkebackup
 ./lib64/cmake/google_cloud_cpp_gkebackup_mocks
 ./lib64/cmake/google_cloud_cpp_gkeconnect

@@ -100,6 +100,7 @@ set(GOOGLE_CLOUD_CPP_GA_LIBRARIES
     "eventarc"
     "filestore"
     "functions"
+    "generativelanguage"
     "gkebackup"
     "gkeconnect"
     "gkehub"

@@ -0,0 +1,8 @@
+@com_google_googleapis//google/api:annotations_proto
+@com_google_googleapis//google/api:client_proto
+@com_google_googleapis//google/api:field_behavior_proto
+@com_google_googleapis//google/api:http_proto
+@com_google_googleapis//google/api:launch_stage_proto
+@com_google_googleapis//google/api:resource_proto
+@com_google_googleapis//google/longrunning:operations_proto
+@com_google_googleapis//google/rpc:status_proto
@@ -0,0 +1,6 @@
+@com_google_googleapis//google/ai/generativelanguage/v1:citation.proto
+@com_google_googleapis//google/ai/generativelanguage/v1:content.proto
+@com_google_googleapis//google/ai/generativelanguage/v1:generative_service.proto
+@com_google_googleapis//google/ai/generativelanguage/v1:model.proto
+@com_google_googleapis//google/ai/generativelanguage/v1:model_service.proto
+@com_google_googleapis//google/ai/generativelanguage/v1:safety.proto
@@ -149,6 +149,7 @@ declare -A -r LIBRARIES=(
       "@com_google_googleapis//google/cloud/functions/v1:functions_cc_grpc" \
       "@com_google_googleapis//google/cloud/functions/v2:functions_cc_grpc"
   )"
+  ["generativelanguage"]="@com_google_googleapis//google/ai/generativelanguage/v1:generativelanguage_cc_grpc"
   ["gkebackup"]="$(
     printf ",%s" \
       "@com_google_googleapis//google/cloud/gkebackup/logging/v1:logging_cc_grpc" \

@@ -2471,6 +2471,21 @@ service {
   retryable_status_codes: ["kUnavailable"]
 }
 
+# Generative Language
+service {
+  service_proto_path: "google/ai/generativelanguage/v1/generative_service.proto"
+  product_path: "google/cloud/generativelanguage/v1"
+  initial_copyright_year: "2024"
+  retryable_status_codes: ["kUnavailable"]
+}
+
+service {
+  service_proto_path: "google/ai/generativelanguage/v1/model_service.proto"
+  product_path: "google/cloud/generativelanguage/v1"
+  initial_copyright_year: "2024"
+  retryable_status_codes: ["kUnavailable"]
+}
+
 # GKE Backup
 service {
   service_proto_path: "google/cloud/gkebackup/v1/gkebackup.proto"

@@ -0,0 +1,31 @@
+# Copyright 2024 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 = [
+    "@com_google_googleapis//google/ai/generativelanguage/v1:generativelanguage_cc_grpc",
+]
+
+cc_gapic_library(
+    name = "generativelanguage",
+    googleapis_deps = googleapis_deps,
+    service_dirs = service_dirs,
+)
@@ -0,0 +1,35 @@
+# ~~~
+# Copyright 2024 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(generativelanguage "Generative Language API"
+                                   SERVICE_DIRS "v1/")
+
+if (BUILD_TESTING AND GOOGLE_CLOUD_CPP_ENABLE_CXX_EXCEPTIONS)
+    add_executable(generativelanguage_quickstart "quickstart/quickstart.cc")
+    target_link_libraries(generativelanguage_quickstart
+                          PRIVATE google-cloud-cpp::generativelanguage)
+    google_cloud_cpp_add_common_options(generativelanguage_quickstart)
+    add_test(
+        NAME generativelanguage_quickstart
+        COMMAND cmake -P "${PROJECT_SOURCE_DIR}/cmake/quickstart-runner.cmake"
+                $<TARGET_FILE:generativelanguage_quickstart>)
+    set_tests_properties(
+        generativelanguage_quickstart
+        PROPERTIES LABELS "integration-test;quickstart" PASS_REGULAR_EXPRESSION
+                   "Request had insufficient authentication scopes")
+endif ()
@@ -0,0 +1,65 @@
+# Generative Language API C++ Client Library
+
+This directory contains an idiomatic C++ client library for the
+[Generative Language API][cloud-service-docs].
+
+The Gemini API allows developers to build generative AI applications using
+Gemini models. Gemini is our most capable model, built from the ground up to be
+multimodal. It can generalize and seamlessly understand, operate across, and
+combine different types of information including language, images, audio, video,
+and code. You can use the Gemini API for use cases like reasoning across text
+and images, content generation, dialogue agents, summarization and
+classification systems, and more.
+
+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/generativelanguage/v1/model_client.h"
+#include "google/cloud/location.h"
+#include <iostream>
+
+int main(int argc, char* argv[]) try {
+  if (argc != 1) {
+    std::cerr << "Usage: " << argv[0] << "\n";
+    return 1;
+  }
+
+  namespace generativelanguage = ::google::cloud::generativelanguage_v1;
+  auto client = generativelanguage::ModelServiceClient(
+      generativelanguage::MakeModelServiceConnection());
+
+  for (auto r : client.ListModels({})) {
+    if (!r) throw std::move(r).status();
+    std::cout << r->DebugString() << "\n";
+  }
+
+  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 [Generative Language 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://ai.google.dev/docs
+[doxygen-link]: https://cloud.google.com/cpp/docs/reference/generativelanguage/latest/
+[source-link]: https://github.com/googleapis/google-cloud-cpp/tree/main/google/cloud/generativelanguage
@@ -0,0 +1,54 @@
+/*!
+
+@page generativelanguage-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 generativelanguage-env-endpoint Endpoint Overrides
+
+<!-- inject-endpoint-env-vars-start -->
+
+- `GOOGLE_CLOUD_CPP_GENERATIVE_SERVICE_ENDPOINT=...` overrides the
+  `EndpointOption` (which defaults to "generativelanguage.googleapis.com")
+  used by `MakeGenerativeServiceConnection()`.
+
+- `GOOGLE_CLOUD_CPP_MODEL_SERVICE_ENDPOINT=...` overrides the
+  `EndpointOption` (which defaults to "generativelanguage.googleapis.com")
+  used by `MakeModelServiceConnection()`.
+
+<!-- inject-endpoint-env-vars-end -->
+
+@see google::cloud::EndpointOption
+
+@section generativelanguage-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 generativelanguage-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.
+
+*/
@@ -0,0 +1,53 @@
+/*!
+
+@mainpage Generative Language API C++ Client Library
+
+An idiomatic C++ client library for the [Generative Language API][cloud-service-docs].
+
+The Gemini API allows developers to build generative AI applications using Gemini models. Gemini is our most capable model, built from the ground up to be multimodal. It can generalize and seamlessly understand, operate across, and combine different types of information including language, images, audio, video, and code. You can use the Gemini API for use cases like reasoning across text and images, content generation, dialogue agents, summarization and classification systems, and more.
+
+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/generativelanguage/quickstart/` directory,
+which should give you a taste of the Generative Language 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 generativelanguage_v1::GenerativeServiceClient](@ref google::cloud::generativelanguage_v1::GenerativeServiceClient)
+- [\c generativelanguage_v1::ModelServiceClient](@ref google::cloud::generativelanguage_v1::ModelServiceClient)
+<!-- inject-client-list-end -->
+
+## More Information
+
+- @ref common-error-handling - describes how the library reports errors.
+- @ref generativelanguage-override-endpoint - describes how to override the default
+  endpoint.
+- @ref generativelanguage-override-authentication - describes how to change the
+  authentication credentials used by the library.
+- @ref generativelanguage-override-retry - describes how to change the default retry
+  policies.
+- @ref generativelanguage-env - describes environment variables that can configure the
+  behavior of the library.
+
+[cloud-service-docs]: https://ai.google.dev/docs
+
+*/
@@ -0,0 +1,10 @@
+/*!
+@defgroup google-cloud-generativelanguage-options Generative Language 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.
+*/