Skip to content

Commit 9396cfb

Browse files
cloud-java-botcloud-java-bot
authored
feat: [geminidataanalytics] new module for geminidataanalytics (#11731)
Generated by @lqiu96 via [generate_new_client_hermetic_build.yaml](https://github.com/googleapis/google-cloud-java/actions/workflows/generate_new_client_hermetic_build.yaml) Command used: ``` python generation/new_client_hermetic_build/add-new-client-config.py add-new-library --api-shortname "geminidataanalytics" --name-pretty "Data Analytics API with Gemini" --api-description "Use Conversational Analytics API to build an artificial intelligence (AI)-powered chat interface, or data agent, that answers questions about structured data using natural language." --proto-path "google/cloud/geminidataanalytics/v1beta" --product-docs "https://cloud.google.com/gemini/docs/conversational-analytics-api/overview" --rpc-docs "https://cloud.google.com/gemini/docs/conversational-analytics-api/reference" ```
1 parent 3e90a3e commit 9396cfb

File tree

325 files changed

+150769
-16
lines changed

Some content is hidden

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

325 files changed

+150769
-16
lines changed

‎gapic-libraries-bom/pom.xml‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -628,6 +628,13 @@
628628
<type>pom</type>
629629
<scope>import</scope>
630630
</dependency>
631+
<dependency>
632+
<groupId>com.google.cloud</groupId>
633+
<artifactId>google-cloud-geminidataanalytics-bom</artifactId>
634+
<version>0.0.1-SNAPSHOT</version><!-- {x-version-update:google-cloud-geminidataanalytics:current} -->
635+
<type>pom</type>
636+
<scope>import</scope>
637+
</dependency>
631638
<dependency>
632639
<groupId>com.google.cloud</groupId>
633640
<artifactId>google-cloud-gke-backup-bom</artifactId>

‎generation_config.yaml‎

Lines changed: 34 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -1072,6 +1072,24 @@ libraries:
10721072
requires_billing: true
10731073
rpc_documentation:
10741074
https://cloud.google.com/distributed-cloud/edge/latest/docs/reference/hardware/rpc
1075+
- api_shortname: geminidataanalytics
1076+
name_pretty: Data Analytics API with Gemini
1077+
product_documentation: https://cloud.google.com/gemini/docs/conversational-analytics-api/overview
1078+
api_description: Use Conversational Analytics API to build an artificial intelligence
1079+
(AI)-powered chat interface, or data agent, that answers questions about structured
1080+
data using natural language.
1081+
client_documentation:
1082+
https://cloud.google.com/java/docs/reference/google-cloud-geminidataanalytics/latest/overview
1083+
release_level: preview
1084+
distribution_name: com.google.cloud:google-cloud-geminidataanalytics
1085+
api_id: geminidataanalytics.googleapis.com
1086+
library_type: GAPIC_AUTO
1087+
group_id: com.google.cloud
1088+
cloud_api: true
1089+
GAPICs:
1090+
- proto_path: google/cloud/geminidataanalytics/v1beta
1091+
requires_billing: true
1092+
rpc_documentation: https://cloud.google.com/gemini/docs/conversational-analytics-api/reference
10751093
- api_shortname: gke-backup
10761094
name_pretty: Backup for GKE
10771095
product_documentation: 'https://cloud.google.com/kubernetes-engine/docs/add-on/backup-for-gke/concepts/backup-for-gke '
@@ -2299,22 +2317,6 @@ libraries:
22992317
GAPICs:
23002318
- proto_path: google/shopping/merchant/inventories/v1
23012319
- proto_path: google/shopping/merchant/inventories/v1beta
2302-
- api_shortname: shopping-merchant-notifications
2303-
name_pretty: Merchant Notifications API
2304-
product_documentation: https://developers.google.com/merchant/api
2305-
api_description: Programmatically manage your Merchant Center accounts.
2306-
client_documentation:
2307-
https://cloud.google.com/java/docs/reference/google-shopping-merchant-notifications/latest/overview
2308-
release_level: stable
2309-
distribution_name: com.google.shopping:google-shopping-merchant-notifications
2310-
api_id: shopping-merchant-notifications.googleapis.com
2311-
library_type: GAPIC_AUTO
2312-
group_id: com.google.shopping
2313-
cloud_api: false
2314-
GAPICs:
2315-
- proto_path: google/shopping/merchant/notifications/v1
2316-
- proto_path: google/shopping/merchant/notifications/v1beta
2317-
requires_billing: true
23182320
- api_shortname: shopping-merchant-lfp
23192321
name_pretty: Merchant LFP API
23202322
product_documentation: https://developers.google.com/merchant/api
@@ -2332,6 +2334,22 @@ libraries:
23322334
- proto_path: google/shopping/merchant/lfp/v1beta
23332335
requires_billing: true
23342336

2337+
- api_shortname: shopping-merchant-notifications
2338+
name_pretty: Merchant Notifications API
2339+
product_documentation: https://developers.google.com/merchant/api
2340+
api_description: Programmatically manage your Merchant Center accounts.
2341+
client_documentation:
2342+
https://cloud.google.com/java/docs/reference/google-shopping-merchant-notifications/latest/overview
2343+
release_level: stable
2344+
distribution_name: com.google.shopping:google-shopping-merchant-notifications
2345+
api_id: shopping-merchant-notifications.googleapis.com
2346+
library_type: GAPIC_AUTO
2347+
group_id: com.google.shopping
2348+
cloud_api: false
2349+
GAPICs:
2350+
- proto_path: google/shopping/merchant/notifications/v1
2351+
- proto_path: google/shopping/merchant/notifications/v1beta
2352+
requires_billing: true
23352353
- api_shortname: merchantapi
23362354
name_pretty: Merchant API
23372355
product_documentation: https://developers.google.com/merchant/api

‎java-geminidataanalytics/.OwlBot-hermetic.yaml‎

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,35 @@
1+
# Copyright 2024 Google LLC
2+
#
3+
# Licensed under the Apache License, Version 2.0 (the "License");
4+
# you may not use this file except in compliance with the License.
5+
# You may obtain a copy of the License at
6+
#
7+
# http://www.apache.org/licenses/LICENSE-2.0
8+
#
9+
# Unless required by applicable law or agreed to in writing, software
10+
# distributed under the License is distributed on an "AS IS" BASIS,
11+
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12+
# See the License for the specific language governing permissions and
13+
# limitations under the License.
14+
15+
16+
deep-remove-regex:
17+
- "/java-geminidataanalytics/grpc-google-.*/src"
18+
- "/java-geminidataanalytics/proto-google-.*/src"
19+
- "/java-geminidataanalytics/google-.*/src"
20+
- "/java-geminidataanalytics/samples/snippets/generated"
21+
22+
deep-preserve-regex:
23+
- "/java-geminidataanalytics/google-.*/src/test/java/com/google/cloud/.*/v.*/it/IT.*Test.java"
24+
25+
deep-copy-regex:
26+
- source: "/google/cloud/geminidataanalytics/(v.*)/.*-java/proto-google-.*/src"
27+
dest: "/owl-bot-staging/java-geminidataanalytics/$1/proto-google-cloud-geminidataanalytics-$1/src"
28+
- source: "/google/cloud/geminidataanalytics/(v.*)/.*-java/grpc-google-.*/src"
29+
dest: "/owl-bot-staging/java-geminidataanalytics/$1/grpc-google-cloud-geminidataanalytics-$1/src"
30+
- source: "/google/cloud/geminidataanalytics/(v.*)/.*-java/gapic-google-.*/src"
31+
dest: "/owl-bot-staging/java-geminidataanalytics/$1/google-cloud-geminidataanalytics/src"
32+
- source: "/google/cloud/geminidataanalytics/(v.*)/.*-java/samples/snippets/generated"
33+
dest: "/owl-bot-staging/java-geminidataanalytics/$1/samples/snippets/generated"
34+
35+
api-name: geminidataanalytics

‎java-geminidataanalytics/.repo-metadata.json‎

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
{
2+
"api_shortname": "geminidataanalytics",
3+
"name_pretty": "Data Analytics API with Gemini",
4+
"product_documentation": "https://cloud.google.com/gemini/docs/conversational-analytics-api/overview",
5+
"api_description": "Use Conversational Analytics API to build an artificial intelligence (AI)-powered chat interface, or data agent, that answers questions about structured data using natural language.",
6+
"client_documentation": "https://cloud.google.com/java/docs/reference/google-cloud-geminidataanalytics/latest/overview",
7+
"release_level": "preview",
8+
"transport": "both",
9+
"language": "java",
10+
"repo": "googleapis/google-cloud-java",
11+
"repo_short": "java-geminidataanalytics",
12+
"distribution_name": "com.google.cloud:google-cloud-geminidataanalytics",
13+
"api_id": "geminidataanalytics.googleapis.com",
14+
"library_type": "GAPIC_AUTO",
15+
"requires_billing": true,
16+
"rpc_documentation": "https://cloud.google.com/gemini/docs/conversational-analytics-api/reference"
17+
}

‎java-geminidataanalytics/README.md‎

Lines changed: 224 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,224 @@
1+
# Google Data Analytics API with Gemini Client for Java
2+
3+
Java idiomatic client for [Data Analytics API with Gemini][product-docs].
4+
5+
[![Maven][maven-version-image]][maven-version-link]
6+
![Stability][stability-image]
7+
8+
- [Product Documentation][product-docs]
9+
- [Client Library Documentation][javadocs]
10+
11+
> Note: This client is a work-in-progress, and may occasionally
12+
> make backwards-incompatible changes.
13+
14+
15+
## Quickstart
16+
17+
18+
If you are using Maven with [BOM][libraries-bom], add this to your pom.xml file:
19+
20+
```xml
21+
<dependencyManagement>
22+
<dependencies>
23+
<dependency>
24+
<groupId>com.google.cloud</groupId>
25+
<artifactId>libraries-bom</artifactId>
26+
<version>26.66.0</version>
27+
<type>pom</type>
28+
<scope>import</scope>
29+
</dependency>
30+
</dependencies>
31+
</dependencyManagement>
32+
33+
<dependencies>
34+
<dependency>
35+
<groupId>com.google.cloud</groupId>
36+
<artifactId>google-cloud-geminidataanalytics</artifactId>
37+
</dependency>
38+
</dependencies>
39+
```
40+
41+
If you are using Maven without the BOM, add this to your dependencies:
42+
43+
44+
```xml
45+
<dependency>
46+
<groupId>com.google.cloud</groupId>
47+
<artifactId>google-cloud-geminidataanalytics</artifactId>
48+
<version>0.0.0</version>
49+
</dependency>
50+
```
51+
52+
If you are using Gradle without BOM, add this to your dependencies:
53+
54+
```Groovy
55+
implementation 'com.google.cloud:google-cloud-geminidataanalytics:0.0.0'
56+
```
57+
58+
If you are using SBT, add this to your dependencies:
59+
60+
```Scala
61+
libraryDependencies += "com.google.cloud" % "google-cloud-geminidataanalytics" % "0.0.0"
62+
```
63+
64+
## Authentication
65+
66+
See the [Authentication][authentication] section in the base directory's README.
67+
68+
## Authorization
69+
70+
The client application making API calls must be granted [authorization scopes][auth-scopes] required for the desired Data Analytics API with Gemini APIs, and the authenticated principal must have the [IAM role(s)][predefined-iam-roles] required to access GCP resources using the Data Analytics API with Gemini API calls.
71+
72+
## Getting Started
73+
74+
### Prerequisites
75+
76+
You will need a [Google Cloud Platform Console][developer-console] project with the Data Analytics API with Gemini [API enabled][enable-api].
77+
You will need to [enable billing][enable-billing] to use Google Data Analytics API with Gemini.
78+
[Follow these instructions][create-project] to get your project set up. You will also need to set up the local development environment by
79+
[installing the Google Cloud Command Line Interface][cloud-cli] and running the following commands in command line:
80+
`gcloud auth login` and `gcloud config set project [YOUR PROJECT ID]`.
81+
82+
### Installation and setup
83+
84+
You'll need to obtain the `google-cloud-geminidataanalytics` library. See the [Quickstart](#quickstart) section
85+
to add `google-cloud-geminidataanalytics` as a dependency in your code.
86+
87+
## About Data Analytics API with Gemini
88+
89+
90+
[Data Analytics API with Gemini][product-docs] Use Conversational Analytics API to build an artificial intelligence (AI)-powered chat interface, or data agent, that answers questions about structured data using natural language.
91+
92+
See the [Data Analytics API with Gemini client library docs][javadocs] to learn how to
93+
use this Data Analytics API with Gemini Client Library.
94+
95+
96+
97+
98+
99+
100+
## Troubleshooting
101+
102+
To get help, follow the instructions in the [shared Troubleshooting document][troubleshooting].
103+
104+
## Transport
105+
106+
Data Analytics API with Gemini uses both gRPC and HTTP/JSON for the transport layer.
107+
108+
## Supported Java Versions
109+
110+
Java 8 or above is required for using this client.
111+
112+
Google's Java client libraries,
113+
[Google Cloud Client Libraries][cloudlibs]
114+
and
115+
[Google Cloud API Libraries][apilibs],
116+
follow the
117+
[Oracle Java SE support roadmap][oracle]
118+
(see the Oracle Java SE Product Releases section).
119+
120+
### For new development
121+
122+
In general, new feature development occurs with support for the lowest Java
123+
LTS version covered by Oracle's Premier Support (which typically lasts 5 years
124+
from initial General Availability). If the minimum required JVM for a given
125+
library is changed, it is accompanied by a [semver][semver] major release.
126+
127+
Java 11 and (in September 2021) Java 17 are the best choices for new
128+
development.
129+
130+
### Keeping production systems current
131+
132+
Google tests its client libraries with all current LTS versions covered by
133+
Oracle's Extended Support (which typically lasts 8 years from initial
134+
General Availability).
135+
136+
#### Legacy support
137+
138+
Google's client libraries support legacy versions of Java runtimes with long
139+
term stable libraries that don't receive feature updates on a best efforts basis
140+
as it may not be possible to backport all patches.
141+
142+
Google provides updates on a best efforts basis to apps that continue to use
143+
Java 7, though apps might need to upgrade to current versions of the library
144+
that supports their JVM.
145+
146+
#### Where to find specific information
147+
148+
The latest versions and the supported Java versions are identified on
149+
the individual GitHub repository `github.com/GoogleAPIs/java-SERVICENAME`
150+
and on [google-cloud-java][g-c-j].
151+
152+
## Versioning
153+
154+
155+
This library follows [Semantic Versioning](http://semver.org/).
156+
157+
158+
It is currently in major version zero (``0.y.z``), which means that anything may change at any time
159+
and the public API should not be considered stable.
160+
161+
162+
## Contributing
163+
164+
165+
Contributions to this library are always welcome and highly encouraged.
166+
167+
See [CONTRIBUTING][contributing] for more information how to get started.
168+
169+
Please note that this project is released with a Contributor Code of Conduct. By participating in
170+
this project you agree to abide by its terms. See [Code of Conduct][code-of-conduct] for more
171+
information.
172+
173+
174+
## License
175+
176+
Apache 2.0 - See [LICENSE][license] for more information.
177+
178+
## CI Status
179+
180+
Java Version | Status
181+
------------ | ------
182+
Java 8 | [![Kokoro CI][kokoro-badge-image-2]][kokoro-badge-link-2]
183+
Java 8 OSX | [![Kokoro CI][kokoro-badge-image-3]][kokoro-badge-link-3]
184+
Java 8 Windows | [![Kokoro CI][kokoro-badge-image-4]][kokoro-badge-link-4]
185+
Java 11 | [![Kokoro CI][kokoro-badge-image-5]][kokoro-badge-link-5]
186+
187+
Java is a registered trademark of Oracle and/or its affiliates.
188+
189+
[product-docs]: https://cloud.google.com/gemini/docs/conversational-analytics-api/overview
190+
[javadocs]: https://cloud.google.com/java/docs/reference/google-cloud-geminidataanalytics/latest/overview
191+
[kokoro-badge-image-1]: http://storage.googleapis.com/cloud-devrel-public/java/badges/google-cloud-java/java7.svg
192+
[kokoro-badge-link-1]: http://storage.googleapis.com/cloud-devrel-public/java/badges/google-cloud-java/java7.html
193+
[kokoro-badge-image-2]: http://storage.googleapis.com/cloud-devrel-public/java/badges/google-cloud-java/java8.svg
194+
[kokoro-badge-link-2]: http://storage.googleapis.com/cloud-devrel-public/java/badges/google-cloud-java/java8.html
195+
[kokoro-badge-image-3]: http://storage.googleapis.com/cloud-devrel-public/java/badges/google-cloud-java/java8-osx.svg
196+
[kokoro-badge-link-3]: http://storage.googleapis.com/cloud-devrel-public/java/badges/google-cloud-java/java8-osx.html
197+
[kokoro-badge-image-4]: http://storage.googleapis.com/cloud-devrel-public/java/badges/google-cloud-java/java8-win.svg
198+
[kokoro-badge-link-4]: http://storage.googleapis.com/cloud-devrel-public/java/badges/google-cloud-java/java8-win.html
199+
[kokoro-badge-image-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/google-cloud-java/java11.svg
200+
[kokoro-badge-link-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/google-cloud-java/java11.html
201+
[stability-image]: https://img.shields.io/badge/stability-preview-yellow
202+
[maven-version-image]: https://img.shields.io/maven-central/v/com.google.cloud/google-cloud-geminidataanalytics.svg
203+
[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-geminidataanalytics/0.0.0
204+
[authentication]: https://github.com/googleapis/google-cloud-java#authentication
205+
[auth-scopes]: https://developers.google.com/identity/protocols/oauth2/scopes
206+
[predefined-iam-roles]: https://cloud.google.com/iam/docs/understanding-roles#predefined_roles
207+
[iam-policy]: https://cloud.google.com/iam/docs/overview#cloud-iam-policy
208+
[developer-console]: https://console.developers.google.com/
209+
[create-project]: https://cloud.google.com/resource-manager/docs/creating-managing-projects
210+
[cloud-cli]: https://cloud.google.com/cli
211+
[troubleshooting]: https://github.com/googleapis/google-cloud-java/blob/main/TROUBLESHOOTING.md
212+
[contributing]: https://github.com/googleapis/google-cloud-java/blob/main/CONTRIBUTING.md
213+
[code-of-conduct]: https://github.com/googleapis/google-cloud-java/blob/main/CODE_OF_CONDUCT.md#contributor-code-of-conduct
214+
[license]: https://github.com/googleapis/google-cloud-java/blob/main/LICENSE
215+
[enable-billing]: https://cloud.google.com/apis/docs/getting-started#enabling_billing
216+
[enable-api]: https://console.cloud.google.com/flows/enableapi?apiid=geminidataanalytics.googleapis.com
217+
[libraries-bom]: https://github.com/GoogleCloudPlatform/cloud-opensource-java/wiki/The-Google-Cloud-Platform-Libraries-BOM
218+
[shell_img]: https://gstatic.com/cloudssh/images/open-btn.png
219+
220+
[semver]: https://semver.org/
221+
[cloudlibs]: https://cloud.google.com/apis/docs/client-libraries-explained
222+
[apilibs]: https://cloud.google.com/apis/docs/client-libraries-explained#google_api_client_libraries
223+
[oracle]: https://www.oracle.com/java/technologies/java-se-support-roadmap.html
224+
[g-c-j]: http://github.com/googleapis/google-cloud-java

0 commit comments

Comments
 (0)