Skip to content

Commit 826450c

Browse files
coryancoryan
authored
doc: update GA library list (#8607)
1 parent c126d1d commit 826450c

48 files changed

Lines changed: 164 additions & 150 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎BUILD.bazel‎

Lines changed: 10 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -21,23 +21,25 @@ exports_files([
2121
])
2222

2323
EXPERIMENTAL_LIBRARIES = [
24+
"logging",
25+
"osconfig",
26+
"speech",
27+
# This is WIP, it needs a number of hand-crafted APIs.
28+
"pubsublite",
29+
]
30+
31+
TRANSITION_LIBRARIES = [
32+
# 2022-03-28
2433
"apigeeconnect",
2534
"contactcenterinsights",
2635
"datacatalog",
2736
"dataproc",
2837
"documentai",
2938
"language",
30-
"logging",
3139
"managedidentities",
32-
"osconfig",
3340
"profiler",
3441
"resourcesettings",
35-
"speech",
36-
# This is WIP, it needs a number of hand-crafted APIs.
37-
"pubsublite",
38-
]
39-
40-
TRANSITION_LIBRARIES = [
42+
# 2022-02-28
4143
"accessapproval",
4244
"accesscontextmanager",
4345
"apigateway",

‎README.md‎

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -32,6 +32,7 @@ This repository contains idiomatic C++ client libraries for the following
3232
* [Access Approval API](google/cloud/accessapproval/README.md) [[quickstart]](google/cloud/accessapproval/quickstart/README.md)
3333
* [Access Context Manager API](google/cloud/accesscontextmanager/README.md) [[quickstart]](google/cloud/accesscontextmanager/quickstart/README.md)
3434
* [API Gateway API](google/cloud/apigateway/README.md) [[quickstart]](google/cloud/apigateway/quickstart/README.md)
35+
* [Apigee Connect API](google/cloud/apigeeconnect/README.md) [[quickstart]](google/cloud/apigeeconnect/quickstart/README.md)
3536
* [App Engine Admin API](google/cloud/appengine/README.md) [[quickstart]](google/cloud/appengine/quickstart/README.md)
3637
* [Artifact Registry API](google/cloud/artifactregistry/README.md) [[quickstart]](google/cloud/artifactregistry/quickstart/README.md)
3738
* [Cloud Asset API](google/cloud/asset/README.md) [[quickstart]](google/cloud/asset/quickstart/README.md)
@@ -44,11 +45,15 @@ This repository contains idiomatic C++ client libraries for the following
4445
* [Cloud Channel API](google/cloud/channel/README.md) [[quickstart]](google/cloud/channel/quickstart/README.md)
4546
* [Cloud Build API](google/cloud/cloudbuild/README.md) [[quickstart]](google/cloud/cloudbuild/quickstart/README.md)
4647
* [Cloud Composer](google/cloud/composer/README.md) [[quickstart]](google/cloud/composer/quickstart/README.md)
48+
* [Contact Center AI Insights API](google/cloud/contactcenterinsights/README.md) [[quickstart]](google/cloud/contactcenterinsights/quickstart/README.md)
4749
* [Kubernetes Engine API](google/cloud/container/README.md) [[quickstart]](google/cloud/container/quickstart/README.md)
4850
* [Container Analysis API](google/cloud/containeranalysis/README.md) [[quickstart]](google/cloud/containeranalysis/quickstart/README.md)
51+
* [Google Cloud Data Catalog API](google/cloud/datacatalog/README.md) [[quickstart]](google/cloud/datacatalog/quickstart/README.md)
4952
* [Database Migration API](google/cloud/datamigration/README.md) [[quickstart]](google/cloud/datamigration/quickstart/README.md)
53+
* [Cloud Dataproc API](google/cloud/dataproc/README.md) [[quickstart]](google/cloud/dataproc/quickstart/README.md)
5054
* [Stackdriver Debugger API](google/cloud/debugger/README.md) [[quickstart]](google/cloud/debugger/quickstart/README.md)
5155
* [Cloud Data Loss Prevention (DLP) API](google/cloud/dlp/README.md) [[quickstart]](google/cloud/dlp/quickstart/README.md)
56+
* [Cloud Document AI API](google/cloud/documentai/README.md) [[quickstart]](google/cloud/documentai/quickstart/README.md)
5257
* [Eventarc API](google/cloud/eventarc/README.md) [[quickstart]](google/cloud/eventarc/quickstart/README.md)
5358
* [Cloud Filestore API](google/cloud/filestore/README.md) [[quickstart]](google/cloud/filestore/quickstart/README.md)
5459
* [Cloud Functions API](google/cloud/functions/README.md) [[quickstart]](google/cloud/functions/quickstart/README.md)
@@ -59,6 +64,8 @@ This repository contains idiomatic C++ client libraries for the following
5964
* [Cloud IDS API](google/cloud/ids/README.md) [[quickstart]](google/cloud/ids/quickstart/README.md)
6065
* [Cloud IoT API](google/cloud/iot/README.md) [[quickstart]](google/cloud/iot/quickstart/README.md)
6166
* [Cloud Key Management Service (KMS) API](google/cloud/kms/README.md) [[quickstart]](google/cloud/kms/quickstart/README.md)
67+
* [Cloud Natural Language API](google/cloud/language/README.md) [[quickstart]](google/cloud/language/quickstart/README.md)
68+
* [Managed Service for Microsoft Active Directory API](google/cloud/managedidentities/README.md) [[quickstart]](google/cloud/managedidentities/quickstart/README.md)
6269
* [Cloud Memorystore for Memcached API](google/cloud/memcache/README.md) [[quickstart]](google/cloud/memcache/quickstart/README.md)
6370
* [Cloud Monitoring API](google/cloud/monitoring/README.md) [[quickstart]](google/cloud/monitoring/quickstart/README.md)
6471
* [Network Management API](google/cloud/networkmanagement/README.md) [[quickstart]](google/cloud/networkmanagement/quickstart/README.md)
@@ -67,10 +74,12 @@ This repository contains idiomatic C++ client libraries for the following
6774
* [Cloud OS Login API](google/cloud/oslogin/README.md) [[quickstart]](google/cloud/oslogin/quickstart/README.md)
6875
* [Policy Troubleshooter API](google/cloud/policytroubleshooter/README.md) [[quickstart]](google/cloud/policytroubleshooter/quickstart/README.md)
6976
* [Certificate Authority API](google/cloud/privateca/README.md) [[quickstart]](google/cloud/privateca/quickstart/README.md)
77+
* [Cloud Profiler API](google/cloud/profiler/README.md) [[quickstart]](google/cloud/profiler/quickstart/README.md)
7078
* [Google Cloud Pub/Sub](google/cloud/pubsub/README.md) [[quickstart]](google/cloud/pubsub/quickstart/README.md)
7179
* [Recommender](google/cloud/recommender/README.md) [[quickstart]](google/cloud/recommender/quickstart/README.md)
7280
* [Google Cloud Memorystore for Redis API](google/cloud/redis/README.md) [[quickstart]](google/cloud/redis/quickstart/README.md)
7381
* [Cloud Resource Manager API](google/cloud/resourcemanager/README.md) [[quickstart]](google/cloud/resourcemanager/quickstart/README.md)
82+
* [Resource Settings API](google/cloud/resourcesettings/README.md) [[quickstart]](google/cloud/resourcesettings/quickstart/README.md)
7483
* [Retail API](google/cloud/retail/README.md) [[quickstart]](google/cloud/retail/quickstart/README.md)
7584
* [Cloud Scheduler API](google/cloud/scheduler/README.md) [[quickstart]](google/cloud/scheduler/quickstart/README.md)
7685
* [Secret Manager API](google/cloud/secretmanager/README.md) [[quickstart]](google/cloud/secretmanager/quickstart/README.md)

‎doc/contributor/howto-guide-declare-a-library-ga.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -47,7 +47,7 @@ automate the following steps.
4747
mapfile -t ga < <(bazel --batch query \
4848
--noshow_progress --noshow_loading_progress \
4949
'kind(cc_library, //:all) except filter("experimental|mocks", kind(cc_library, //:all))' |
50-
sed -e 's;//:;;' | grep -E -v 'storage|bigtable|spanner|pubsub')
50+
sed -e 's;//:;;' | grep -E -v 'storage|bigtable|spanner|pubsub|common|grpc_utils')
5151
```
5252

5353
### `CHANGELOG.md`

‎google/cloud/apigeeconnect/CMakeLists.txt‎

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@
1717
include(GoogleapisConfig)
1818
set(DOXYGEN_PROJECT_NAME "Apigee Connect API C++ Client")
1919
set(DOXYGEN_PROJECT_BRIEF "A C++ Client Library for the Apigee Connect API")
20-
set(DOXYGEN_PROJECT_NUMBER "${PROJECT_VERSION} (Experimental)")
20+
set(DOXYGEN_PROJECT_NUMBER "${PROJECT_VERSION}")
2121
set(DOXYGEN_EXCLUDE_SYMBOLS "internal" "apigeeconnect_internal"
2222
"apigeeconnect_testing" "examples")
2323
set(DOXYGEN_EXAMPLE_PATH ${CMAKE_CURRENT_SOURCE_DIR}/quickstart)
@@ -72,13 +72,13 @@ target_link_libraries(
7272
google_cloud_cpp_add_common_options(google_cloud_cpp_apigeeconnect)
7373
set_target_properties(
7474
google_cloud_cpp_apigeeconnect
75-
PROPERTIES EXPORT_NAME google-cloud-cpp::experimental-apigeeconnect
76-
VERSION "${PROJECT_VERSION}" SOVERSION
77-
"${PROJECT_VERSION_MAJOR}")
75+
PROPERTIES EXPORT_NAME google-cloud-cpp::apigeeconnect VERSION
76+
"${PROJECT_VERSION}"
77+
SOVERSION "${PROJECT_VERSION_MAJOR}")
7878
target_compile_options(google_cloud_cpp_apigeeconnect
7979
PUBLIC ${GOOGLE_CLOUD_CPP_EXCEPTIONS_FLAG})
8080

81-
add_library(google-cloud-cpp::experimental-apigeeconnect ALIAS
81+
add_library(google-cloud-cpp::apigeeconnect ALIAS
8282
google_cloud_cpp_apigeeconnect)
8383

8484
# Create a header-only library for the mocks. We use a CMake `INTERFACE` library
@@ -98,11 +98,11 @@ add_library(google_cloud_cpp_apigeeconnect_mocks INTERFACE)
9898
target_sources(google_cloud_cpp_apigeeconnect_mocks INTERFACE ${mock_files})
9999
target_link_libraries(
100100
google_cloud_cpp_apigeeconnect_mocks
101-
INTERFACE google-cloud-cpp::experimental-apigeeconnect GTest::gmock_main
102-
GTest::gmock GTest::gtest)
101+
INTERFACE google-cloud-cpp::apigeeconnect GTest::gmock_main GTest::gmock
102+
GTest::gtest)
103103
set_target_properties(
104104
google_cloud_cpp_apigeeconnect_mocks
105-
PROPERTIES EXPORT_NAME google-cloud-cpp::experimental-apigeeconnect_mocks)
105+
PROPERTIES EXPORT_NAME google-cloud-cpp::apigeeconnect_mocks)
106106
target_include_directories(
107107
google_cloud_cpp_apigeeconnect_mocks
108108
INTERFACE $<BUILD_INTERFACE:${PROJECT_SOURCE_DIR}>
@@ -115,7 +115,7 @@ include(CTest)
115115
if (BUILD_TESTING)
116116
add_executable(apigeeconnect_quickstart "quickstart/quickstart.cc")
117117
target_link_libraries(apigeeconnect_quickstart
118-
PRIVATE google-cloud-cpp::experimental-apigeeconnect)
118+
PRIVATE google-cloud-cpp::apigeeconnect)
119119
google_cloud_cpp_add_common_options(apigeeconnect_quickstart)
120120
add_test(
121121
NAME apigeeconnect_quickstart

‎google/cloud/apigeeconnect/README.md‎

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,5 @@
11
# Apigee Connect API C++ Client Library
22

3-
:construction:
4-
53
This directory contains an idiomatic C++ client library for the
64
[Apigee Hybrid][cloud-service-docs] management APIs. Apigee Hybrid is a platform
75
for developing and managing API proxies that features a hybrid deployment model.
@@ -12,7 +10,7 @@ a runtime plane that you install and manage on one of the
1210
<!-- TODO(#7900) - consider the lack of quickstart testing before GA -->
1311
This library is **experimental**. Its APIs are subject to change without notice.
1412

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

1816
## Supported Platforms

‎google/cloud/apigeeconnect/config.cmake.in‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -20,3 +20,7 @@ find_dependency(google_cloud_cpp_grpc_utils)
2020
find_dependency(absl)
2121

2222
include("${CMAKE_CURRENT_LIST_DIR}/google_cloud_cpp_apigeeconnect-targets.cmake")
23+
24+
if (NOT TARGET google-cloud-cpp::experimental-apigeeconnect)
25+
add_library(google-cloud-cpp::experimental-apigeeconnect ALIAS google-cloud-cpp::apigeeconnect)
26+
endif ()

‎google/cloud/apigeeconnect/doc/main.dox‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ The hybrid model includes a management plane hosted by Apigee in the Cloud and
99
a runtime plane that you install and manage on one of the
1010
[supported Kubernetes platforms](https://cloud.google.com/apigee/docs/hybrid/supported-platforms).
1111

12-
This library is **experimental**. Its APIs are subject to change without notice.
12+
While this library is **GA**, please note Google Cloud C++ client libraries do **not** follow [Semantic Versioning](https://semver.org/).
1313

1414
This library requires a C++11 compiler. It is supported (and tested) on multiple
1515
Linux distributions, as well as Windows and macOS. The [README][github-readme]

‎google/cloud/apigeeconnect/quickstart/BUILD.bazel‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -20,6 +20,6 @@ cc_binary(
2020
"quickstart.cc",
2121
],
2222
deps = [
23-
"@com_github_googleapis_google_cloud_cpp//:experimental-apigeeconnect",
23+
"@com_github_googleapis_google_cloud_cpp//:apigeeconnect",
2424
],
2525
)

‎google/cloud/contactcenterinsights/CMakeLists.txt‎

Lines changed: 8 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ include(GoogleapisConfig)
1818
set(DOXYGEN_PROJECT_NAME "Contact Center AI Insights API C++ Client")
1919
set(DOXYGEN_PROJECT_BRIEF
2020
"A C++ Client Library for the Contact Center AI Insights API")
21-
set(DOXYGEN_PROJECT_NUMBER "${PROJECT_VERSION} (Experimental)")
21+
set(DOXYGEN_PROJECT_NUMBER "${PROJECT_VERSION}")
2222
set(DOXYGEN_EXCLUDE_SYMBOLS "internal" "contactcenterinsights_internal"
2323
"contactcenterinsights_testing" "examples")
2424
set(DOXYGEN_EXAMPLE_PATH ${CMAKE_CURRENT_SOURCE_DIR}/quickstart)
@@ -75,13 +75,13 @@ target_link_libraries(
7575
google_cloud_cpp_add_common_options(google_cloud_cpp_contactcenterinsights)
7676
set_target_properties(
7777
google_cloud_cpp_contactcenterinsights
78-
PROPERTIES EXPORT_NAME google-cloud-cpp::experimental-contactcenterinsights
78+
PROPERTIES EXPORT_NAME google-cloud-cpp::contactcenterinsights
7979
VERSION "${PROJECT_VERSION}" SOVERSION
8080
"${PROJECT_VERSION_MAJOR}")
8181
target_compile_options(google_cloud_cpp_contactcenterinsights
8282
PUBLIC ${GOOGLE_CLOUD_CPP_EXCEPTIONS_FLAG})
8383

84-
add_library(google-cloud-cpp::experimental-contactcenterinsights ALIAS
84+
add_library(google-cloud-cpp::contactcenterinsights ALIAS
8585
google_cloud_cpp_contactcenterinsights)
8686

8787
# Create a header-only library for the mocks. We use a CMake `INTERFACE` library
@@ -102,12 +102,11 @@ target_sources(google_cloud_cpp_contactcenterinsights_mocks
102102
INTERFACE ${mock_files})
103103
target_link_libraries(
104104
google_cloud_cpp_contactcenterinsights_mocks
105-
INTERFACE google-cloud-cpp::experimental-contactcenterinsights
106-
GTest::gmock_main GTest::gmock GTest::gtest)
105+
INTERFACE google-cloud-cpp::contactcenterinsights GTest::gmock_main
106+
GTest::gmock GTest::gtest)
107107
set_target_properties(
108108
google_cloud_cpp_contactcenterinsights_mocks
109-
PROPERTIES EXPORT_NAME
110-
google-cloud-cpp::experimental-contactcenterinsights_mocks)
109+
PROPERTIES EXPORT_NAME google-cloud-cpp::contactcenterinsights_mocks)
111110
target_include_directories(
112111
google_cloud_cpp_contactcenterinsights_mocks
113112
INTERFACE $<BUILD_INTERFACE:${PROJECT_SOURCE_DIR}>
@@ -119,9 +118,8 @@ target_compile_options(google_cloud_cpp_contactcenterinsights_mocks
119118
include(CTest)
120119
if (BUILD_TESTING)
121120
add_executable(contactcenterinsights_quickstart "quickstart/quickstart.cc")
122-
target_link_libraries(
123-
contactcenterinsights_quickstart
124-
PRIVATE google-cloud-cpp::experimental-contactcenterinsights)
121+
target_link_libraries(contactcenterinsights_quickstart
122+
PRIVATE google-cloud-cpp::contactcenterinsights)
125123
google_cloud_cpp_add_common_options(contactcenterinsights_quickstart)
126124
add_test(
127125
NAME contactcenterinsights_quickstart

‎google/cloud/contactcenterinsights/README.md‎

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,12 @@
11
# Contact Center AI Insights API C++ Client Library
22

3-
:construction:
4-
53
This directory contains an idiomatic C++ client library for the
64
[Contact Center AI Insights API][cloud-service-docs], a service that helps users
75
detect and visualize patterns in their contact center data.
86

97
This library is **experimental**. Its APIs are subject to change without notice.
108

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

1412
## Supported Platforms

0 commit comments

Comments
 (0)