Skip to content

Commit 4e23220

Browse files
gcf-owl-bot[bot]gcf-owl-bot[bot]
authored
fix(deps): [datacatalog] Update the Java code generator (gapic-generator-java) to 2.31.0 (#10190)
* docs: Change field behavior of the property "name" to IDENTIFIER PiperOrigin-RevId: 596091522 Source-Link: googleapis/googleapis@4d7831d Source-Link: https://github.com/googleapis/googleapis-gen/commit/b6dfc3eb65c1a171e970efde5eb534b8a0709edd Copy-Tag: eyJwIjoiamF2YS1kYXRhY2F0YWxvZy8uT3dsQm90LnlhbWwiLCJoIjoiYjZkZmMzZWI2NWMxYTE3MWU5NzBlZmRlNWViNTM0YjhhMDcwOWVkZCJ9 * 🦉 Updates from OwlBot post-processor See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md * fix: Change field behavior of the property "name" to IDENTIFIER The solution follows guidelines from https://google.aip.dev/203#identifier and https://github.com/googleapis/googleapis/blob/master/google/api/field_behavior.proto#L91-L103. PiperOrigin-RevId: 596643040 Source-Link: googleapis/googleapis@3c84a3c Source-Link: https://github.com/googleapis/googleapis-gen/commit/4c4a9f43f4a4f7d87c931c121e0bd0fbd6392468 Copy-Tag: eyJwIjoiamF2YS1kYXRhY2F0YWxvZy8uT3dsQm90LnlhbWwiLCJoIjoiNGM0YTlmNDNmNGE0ZjdkODdjOTMxYzEyMWUwYmQwZmJkNjM5MjQ2OCJ9 * 🦉 Updates from OwlBot post-processor See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md * fix(deps): Update the Java code generator (gapic-generator-java) to 2.31.0 PiperOrigin-RevId: 596645164 Source-Link: googleapis/googleapis@4a0e62e Source-Link: https://github.com/googleapis/googleapis-gen/commit/a10ed6a77676c37e60799098d48d0afb16008613 Copy-Tag: eyJwIjoiamF2YS1kYXRhY2F0YWxvZy8uT3dsQm90LnlhbWwiLCJoIjoiYTEwZWQ2YTc3Njc2YzM3ZTYwNzk5MDk4ZDQ4ZDBhZmIxNjAwODYxMyJ9 * 🦉 Updates from OwlBot post-processor See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md --------- Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>
1 parent 0a11aac commit 4e23220

File tree

25 files changed

+1940
-163
lines changed

25 files changed

+1940
-163
lines changed

‎java-datacatalog/README.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -195,7 +195,7 @@ Java is a registered trademark of Oracle and/or its affiliates.
195195
[kokoro-badge-link-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/google-cloud-java/java11.html
196196
[stability-image]: https://img.shields.io/badge/stability-stable-green
197197
[maven-version-image]: https://img.shields.io/maven-central/v/com.google.cloud/google-cloud-datacatalog.svg
198-
[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-datacatalog/1.36.0
198+
[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-datacatalog/1.38.0
199199
[authentication]: https://github.com/googleapis/google-cloud-java#authentication
200200
[auth-scopes]: https://developers.google.com/identity/protocols/oauth2/scopes
201201
[predefined-iam-roles]: https://cloud.google.com/iam/docs/understanding-roles#predefined_roles

‎java-datacatalog/google-cloud-datacatalog/src/main/java/com/google/cloud/datacatalog/v1/DataCatalogClient.java‎

Lines changed: 696 additions & 13 deletions
Large diffs are not rendered by default.

‎java-datacatalog/google-cloud-datacatalog/src/main/java/com/google/cloud/datacatalog/v1/PolicyTagManagerClient.java‎

Lines changed: 245 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -66,19 +66,251 @@
6666
* such as threads. In the example above, try-with-resources is used, which automatically calls
6767
* close().
6868
*
69-
* <p>The surface of this class includes several types of Java methods for each of the API's
70-
* methods:
71-
*
72-
* <ol>
73-
* <li>A "flattened" method. With this type of method, the fields of the request type have been
74-
* converted into function parameters. It may be the case that not all fields are available as
75-
* parameters, and not every API method will have a flattened method entry point.
76-
* <li>A "request object" method. This type of method only takes one parameter, a request object,
77-
* which must be constructed before the call. Not every API method will have a request object
78-
* method.
79-
* <li>A "callable" method. This type of method takes no parameters and returns an immutable API
80-
* callable object, which can be used to initiate calls to the service.
81-
* </ol>
69+
* <table>
70+
* <tr>
71+
* <th>Method</th>
72+
* <th>Description</th>
73+
* <th>Method Variants</th>
74+
* <tr>
75+
* <td>CreateTaxonomy</td>
76+
* <td><p> Creates a taxonomy in a specified project.
77+
* <p> The taxonomy is initially empty, that is, it doesn't contain policy tags.</td>
78+
* <td>
79+
* <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
80+
* <ul>
81+
* <li>createTaxonomy(CreateTaxonomyRequest request)
82+
* </ul>
83+
* <p>"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.</p>
84+
* <ul>
85+
* <li>createTaxonomy(LocationName parent, Taxonomy taxonomy)
86+
* <li>createTaxonomy(String parent, Taxonomy taxonomy)
87+
* </ul>
88+
* <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
89+
* <ul>
90+
* <li>createTaxonomyCallable()
91+
* </ul>
92+
* </td>
93+
* </tr>
94+
* <tr>
95+
* <td>DeleteTaxonomy</td>
96+
* <td><p> Deletes a taxonomy, including all policy tags in this taxonomy, their associated policies, and the policy tags references from BigQuery columns.</td>
97+
* <td>
98+
* <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
99+
* <ul>
100+
* <li>deleteTaxonomy(DeleteTaxonomyRequest request)
101+
* </ul>
102+
* <p>"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.</p>
103+
* <ul>
104+
* <li>deleteTaxonomy(TaxonomyName name)
105+
* <li>deleteTaxonomy(String name)
106+
* </ul>
107+
* <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
108+
* <ul>
109+
* <li>deleteTaxonomyCallable()
110+
* </ul>
111+
* </td>
112+
* </tr>
113+
* <tr>
114+
* <td>UpdateTaxonomy</td>
115+
* <td><p> Updates a taxonomy, including its display name, description, and activated policy types.</td>
116+
* <td>
117+
* <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
118+
* <ul>
119+
* <li>updateTaxonomy(UpdateTaxonomyRequest request)
120+
* </ul>
121+
* <p>"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.</p>
122+
* <ul>
123+
* <li>updateTaxonomy(Taxonomy taxonomy)
124+
* </ul>
125+
* <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
126+
* <ul>
127+
* <li>updateTaxonomyCallable()
128+
* </ul>
129+
* </td>
130+
* </tr>
131+
* <tr>
132+
* <td>ListTaxonomies</td>
133+
* <td><p> Lists all taxonomies in a project in a particular location that you have a permission to view.</td>
134+
* <td>
135+
* <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
136+
* <ul>
137+
* <li>listTaxonomies(ListTaxonomiesRequest request)
138+
* </ul>
139+
* <p>"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.</p>
140+
* <ul>
141+
* <li>listTaxonomies(LocationName parent)
142+
* <li>listTaxonomies(String parent)
143+
* </ul>
144+
* <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
145+
* <ul>
146+
* <li>listTaxonomiesPagedCallable()
147+
* <li>listTaxonomiesCallable()
148+
* </ul>
149+
* </td>
150+
* </tr>
151+
* <tr>
152+
* <td>GetTaxonomy</td>
153+
* <td><p> Gets a taxonomy.</td>
154+
* <td>
155+
* <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
156+
* <ul>
157+
* <li>getTaxonomy(GetTaxonomyRequest request)
158+
* </ul>
159+
* <p>"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.</p>
160+
* <ul>
161+
* <li>getTaxonomy(TaxonomyName name)
162+
* <li>getTaxonomy(String name)
163+
* </ul>
164+
* <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
165+
* <ul>
166+
* <li>getTaxonomyCallable()
167+
* </ul>
168+
* </td>
169+
* </tr>
170+
* <tr>
171+
* <td>CreatePolicyTag</td>
172+
* <td><p> Creates a policy tag in a taxonomy.</td>
173+
* <td>
174+
* <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
175+
* <ul>
176+
* <li>createPolicyTag(CreatePolicyTagRequest request)
177+
* </ul>
178+
* <p>"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.</p>
179+
* <ul>
180+
* <li>createPolicyTag(TaxonomyName parent, PolicyTag policyTag)
181+
* <li>createPolicyTag(String parent, PolicyTag policyTag)
182+
* </ul>
183+
* <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
184+
* <ul>
185+
* <li>createPolicyTagCallable()
186+
* </ul>
187+
* </td>
188+
* </tr>
189+
* <tr>
190+
* <td>DeletePolicyTag</td>
191+
* <td><p> Deletes a policy tag together with the following:
192+
* <ul>
193+
* <li> All of its descendant policy tags, if any
194+
* <li> Policies associated with the policy tag and its descendants
195+
* <li> References from BigQuery table schema of the policy tag and its descendants
196+
* </ul></td>
197+
* <td>
198+
* <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
199+
* <ul>
200+
* <li>deletePolicyTag(DeletePolicyTagRequest request)
201+
* </ul>
202+
* <p>"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.</p>
203+
* <ul>
204+
* <li>deletePolicyTag(PolicyTagName name)
205+
* <li>deletePolicyTag(String name)
206+
* </ul>
207+
* <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
208+
* <ul>
209+
* <li>deletePolicyTagCallable()
210+
* </ul>
211+
* </td>
212+
* </tr>
213+
* <tr>
214+
* <td>UpdatePolicyTag</td>
215+
* <td><p> Updates a policy tag, including its display name, description, and parent policy tag.</td>
216+
* <td>
217+
* <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
218+
* <ul>
219+
* <li>updatePolicyTag(UpdatePolicyTagRequest request)
220+
* </ul>
221+
* <p>"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.</p>
222+
* <ul>
223+
* <li>updatePolicyTag(PolicyTag policyTag)
224+
* </ul>
225+
* <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
226+
* <ul>
227+
* <li>updatePolicyTagCallable()
228+
* </ul>
229+
* </td>
230+
* </tr>
231+
* <tr>
232+
* <td>ListPolicyTags</td>
233+
* <td><p> Lists all policy tags in a taxonomy.</td>
234+
* <td>
235+
* <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
236+
* <ul>
237+
* <li>listPolicyTags(ListPolicyTagsRequest request)
238+
* </ul>
239+
* <p>"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.</p>
240+
* <ul>
241+
* <li>listPolicyTags(TaxonomyName parent)
242+
* <li>listPolicyTags(String parent)
243+
* </ul>
244+
* <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
245+
* <ul>
246+
* <li>listPolicyTagsPagedCallable()
247+
* <li>listPolicyTagsCallable()
248+
* </ul>
249+
* </td>
250+
* </tr>
251+
* <tr>
252+
* <td>GetPolicyTag</td>
253+
* <td><p> Gets a policy tag.</td>
254+
* <td>
255+
* <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
256+
* <ul>
257+
* <li>getPolicyTag(GetPolicyTagRequest request)
258+
* </ul>
259+
* <p>"Flattened" method variants have converted the fields of the request object into function parameters to enable multiple ways to call the same method.</p>
260+
* <ul>
261+
* <li>getPolicyTag(PolicyTagName name)
262+
* <li>getPolicyTag(String name)
263+
* </ul>
264+
* <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
265+
* <ul>
266+
* <li>getPolicyTagCallable()
267+
* </ul>
268+
* </td>
269+
* </tr>
270+
* <tr>
271+
* <td>GetIamPolicy</td>
272+
* <td><p> Gets the IAM policy for a policy tag or a taxonomy.</td>
273+
* <td>
274+
* <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
275+
* <ul>
276+
* <li>getIamPolicy(GetIamPolicyRequest request)
277+
* </ul>
278+
* <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
279+
* <ul>
280+
* <li>getIamPolicyCallable()
281+
* </ul>
282+
* </td>
283+
* </tr>
284+
* <tr>
285+
* <td>SetIamPolicy</td>
286+
* <td><p> Sets the IAM policy for a policy tag or a taxonomy.</td>
287+
* <td>
288+
* <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
289+
* <ul>
290+
* <li>setIamPolicy(SetIamPolicyRequest request)
291+
* </ul>
292+
* <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
293+
* <ul>
294+
* <li>setIamPolicyCallable()
295+
* </ul>
296+
* </td>
297+
* </tr>
298+
* <tr>
299+
* <td>TestIamPermissions</td>
300+
* <td><p> Returns your permissions on a specified policy tag or taxonomy.</td>
301+
* <td>
302+
* <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
303+
* <ul>
304+
* <li>testIamPermissions(TestIamPermissionsRequest request)
305+
* </ul>
306+
* <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
307+
* <ul>
308+
* <li>testIamPermissionsCallable()
309+
* </ul>
310+
* </td>
311+
* </tr>
312+
* </tr>
313+
* </table>
82314
*
83315
* <p>See the individual methods for example code.
84316
*

‎java-datacatalog/google-cloud-datacatalog/src/main/java/com/google/cloud/datacatalog/v1/PolicyTagManagerSerializationClient.java‎

Lines changed: 55 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -55,19 +55,61 @@
5555
* resources such as threads. In the example above, try-with-resources is used, which automatically
5656
* calls close().
5757
*
58-
* <p>The surface of this class includes several types of Java methods for each of the API's
59-
* methods:
60-
*
61-
* <ol>
62-
* <li>A "flattened" method. With this type of method, the fields of the request type have been
63-
* converted into function parameters. It may be the case that not all fields are available as
64-
* parameters, and not every API method will have a flattened method entry point.
65-
* <li>A "request object" method. This type of method only takes one parameter, a request object,
66-
* which must be constructed before the call. Not every API method will have a request object
67-
* method.
68-
* <li>A "callable" method. This type of method takes no parameters and returns an immutable API
69-
* callable object, which can be used to initiate calls to the service.
70-
* </ol>
58+
* <table>
59+
* <tr>
60+
* <th>Method</th>
61+
* <th>Description</th>
62+
* <th>Method Variants</th>
63+
* <tr>
64+
* <td>ReplaceTaxonomy</td>
65+
* <td><p> Replaces (updates) a taxonomy and all its policy tags.
66+
* <p> The taxonomy and its entire hierarchy of policy tags must be represented literally by `SerializedTaxonomy` and the nested `SerializedPolicyTag` messages.
67+
* <p> This operation automatically does the following:
68+
* <p> - Deletes the existing policy tags that are missing from the `SerializedPolicyTag`. - Creates policy tags that don't have resource names. They are considered new. - Updates policy tags with valid resources names accordingly.</td>
69+
* <td>
70+
* <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
71+
* <ul>
72+
* <li>replaceTaxonomy(ReplaceTaxonomyRequest request)
73+
* </ul>
74+
* <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
75+
* <ul>
76+
* <li>replaceTaxonomyCallable()
77+
* </ul>
78+
* </td>
79+
* </tr>
80+
* <tr>
81+
* <td>ImportTaxonomies</td>
82+
* <td><p> Creates new taxonomies (including their policy tags) in a given project by importing from inlined or cross-regional sources.
83+
* <p> For a cross-regional source, new taxonomies are created by copying from a source in another region.
84+
* <p> For an inlined source, taxonomies and policy tags are created in bulk using nested protocol buffer structures.</td>
85+
* <td>
86+
* <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
87+
* <ul>
88+
* <li>importTaxonomies(ImportTaxonomiesRequest request)
89+
* </ul>
90+
* <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
91+
* <ul>
92+
* <li>importTaxonomiesCallable()
93+
* </ul>
94+
* </td>
95+
* </tr>
96+
* <tr>
97+
* <td>ExportTaxonomies</td>
98+
* <td><p> Exports taxonomies in the requested type and returns them, including their policy tags. The requested taxonomies must belong to the same project.
99+
* <p> This method generates `SerializedTaxonomy` protocol buffers with nested policy tags that can be used as input for `ImportTaxonomies` calls.</td>
100+
* <td>
101+
* <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
102+
* <ul>
103+
* <li>exportTaxonomies(ExportTaxonomiesRequest request)
104+
* </ul>
105+
* <p>Callable method variants take no parameters and return an immutable API callable object, which can be used to initiate calls to the service.</p>
106+
* <ul>
107+
* <li>exportTaxonomiesCallable()
108+
* </ul>
109+
* </td>
110+
* </tr>
111+
* </tr>
112+
* </table>
71113
*
72114
* <p>See the individual methods for example code.
73115
*

‎java-datacatalog/google-cloud-datacatalog/src/main/java/com/google/cloud/datacatalog/v1/stub/DataCatalogStubSettings.java‎

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -638,6 +638,12 @@ public DataCatalogStub createStub() throws IOException {
638638
"Transport not supported: %s", getTransportChannelProvider().getTransportName()));
639639
}
640640

641+
/** Returns the default service name. */
642+
@Override
643+
public String getServiceName() {
644+
return "datacatalog";
645+
}
646+
641647
/** Returns a builder for the default ExecutorProvider for this service. */
642648
public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() {
643649
return InstantiatingExecutorProvider.newBuilder();

‎java-datacatalog/google-cloud-datacatalog/src/main/java/com/google/cloud/datacatalog/v1/stub/PolicyTagManagerSerializationStubSettings.java‎

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -133,6 +133,12 @@ public PolicyTagManagerSerializationStub createStub() throws IOException {
133133
"Transport not supported: %s", getTransportChannelProvider().getTransportName()));
134134
}
135135

136+
/** Returns the default service name. */
137+
@Override
138+
public String getServiceName() {
139+
return "datacatalog";
140+
}
141+
136142
/** Returns a builder for the default ExecutorProvider for this service. */
137143
public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() {
138144
return InstantiatingExecutorProvider.newBuilder();

‎java-datacatalog/google-cloud-datacatalog/src/main/java/com/google/cloud/datacatalog/v1/stub/PolicyTagManagerStubSettings.java‎

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -329,6 +329,12 @@ public PolicyTagManagerStub createStub() throws IOException {
329329
"Transport not supported: %s", getTransportChannelProvider().getTransportName()));
330330
}
331331

332+
/** Returns the default service name. */
333+
@Override
334+
public String getServiceName() {
335+
return "datacatalog";
336+
}
337+
332338
/** Returns a builder for the default ExecutorProvider for this service. */
333339
public static InstantiatingExecutorProvider.Builder defaultExecutorProviderBuilder() {
334340
return InstantiatingExecutorProvider.newBuilder();

0 commit comments

Comments
 (0)