Skip to content

Commit 2ac7566

Browse files
chore: Update generation configuration at Sat Feb 21 02:52:06 UTC 2026 (#11962)
This pull request is generated with proto changes between [googleapis/googleapis@ce8678a](googleapis/googleapis@ce8678a) (exclusive) and [googleapis/googleapis@47e44e0](googleapis/googleapis@47e44e0) (inclusive). BEGIN_COMMIT_OVERRIDE BEGIN_NESTED_COMMIT feat: [datamanager] add `UserListService` for creating and managing user lists feat: [datamanager] add `UserListDirectLicenseService` for creating and managing direct user list licenses feat: [datamanager] add `UserListGlobalLicenseService` for creating and managing global user list licenses feat: [datamanager] add `MarketingDataInsightsService` for retrieving marketing data insights for a given user list feat: [datamanager] add `PartnerLinkService` for creating and managing links between advertiser and data partner accounts feat: [datamanager] add `UserList` resource feat: [datamanager] add `UserListDirectLicense` resource feat: [datamanager] add `UserListGlobalLicense` resource feat: [datamanager] add `UserListGlobalLicenseCustomerInfo` resource feat: [datamanager] add `PartnerLink` resource feat: [datamanager] add `UserIdData` to `AudienceMember` to support User ID in audience member ingestion feat: [datamanager] add `PpidData` to `AudienceMember` to support Publisher Provided ID (PPID) in audience member ingestion feat: [datamanager] add `IngestUserIdDataStatus` to `IngestAudienceMembersStatus` to report the status of user ID data ingestion feat: [datamanager] add `IngestPpidDataStatus` to `IngestAudienceMembersStatus` to report the status of PPID data ingestion feat: [datamanager] add `RemoveUserIdDataStatus` to `RemoveAudienceMembersStatus` to report the status of user ID data removal feat: [datamanager] add `RemovePpidDataStatus` to `RemoveAudienceMembersStatus` to report the status of PPID data removal feat: [datamanager] add `GOOGLE_AD_MANAGER_AUDIENCE_LINK` to the `AccountType` enum feat: [datamanager] add `AgeRange` and `Gender` enums to support demographic breakdown in marketing insights feat: [datamanager] add new `ErrorReason` values for licensing, user list operations, and permission checks fix!: [datamanager] changed `conversion_value` field to be optional in message `Event` docs: [datamanager] add comments to resources and methods to clarify which are available only to data partners docs: [datamanager] a comment for enum `ErrorReason` is changed to clarify that it is subject to future additions docs: [datamanager] a comment for field `pair_data` in message `AudienceMember` is changed to clarify it is only available to data partners docs: [datamanager] a comment for message `PairData` is changed to clarify it is only available to data partners PiperOrigin-RevId: 873059573 Source Link: [googleapis/googleapis@1e6955c](googleapis/googleapis@1e6955c) END_NESTED_COMMIT END_COMMIT_OVERRIDE
1 parent 6d03337 commit 2ac7566

File tree

313 files changed

+110728
-1898
lines changed

Some content is hidden

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

313 files changed

+110728
-1898
lines changed

generation_config.yaml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
gapic_generator_version: 2.67.0
2-
googleapis_commitish: ce8678a96c8e1fc0d870d80fcf062e5be2b12877
2+
googleapis_commitish: 47e44e0ff4b6aeecd2f2661c14c55e62c42d5ed8
33
libraries_bom_version: 26.76.0
44
libraries:
55
- api_shortname: accessapproval
Lines changed: 324 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,324 @@
1+
/*
2+
* Copyright 2026 Google LLC
3+
*
4+
* Licensed under the Apache License, Version 2.0 (the "License");
5+
* you may not use this file except in compliance with the License.
6+
* You may obtain a copy of the License at
7+
*
8+
* https://www.apache.org/licenses/LICENSE-2.0
9+
*
10+
* Unless required by applicable law or agreed to in writing, software
11+
* distributed under the License is distributed on an "AS IS" BASIS,
12+
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13+
* See the License for the specific language governing permissions and
14+
* limitations under the License.
15+
*/
16+
17+
package com.google.ads.datamanager.v1;
18+
19+
import com.google.ads.datamanager.v1.stub.MarketingDataInsightsServiceStub;
20+
import com.google.ads.datamanager.v1.stub.MarketingDataInsightsServiceStubSettings;
21+
import com.google.api.gax.core.BackgroundResource;
22+
import com.google.api.gax.rpc.UnaryCallable;
23+
import java.io.IOException;
24+
import java.util.concurrent.TimeUnit;
25+
import javax.annotation.Generated;
26+
27+
// AUTO-GENERATED DOCUMENTATION AND CLASS.
28+
/**
29+
* Service Description: Service to return insights on marketing data.
30+
*
31+
* <p>This feature is only available to data partners.
32+
*
33+
* <p>This class provides the ability to make remote calls to the backing service through method
34+
* calls that map to API methods. Sample code to get started:
35+
*
36+
* <pre>{@code
37+
* // This snippet has been automatically generated and should be regarded as a code template only.
38+
* // It will require modifications to work:
39+
* // - It may require correct/in-range values for request initialization.
40+
* // - It may require specifying regional endpoints when creating the service client as shown in
41+
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
42+
* try (MarketingDataInsightsServiceClient marketingDataInsightsServiceClient =
43+
* MarketingDataInsightsServiceClient.create()) {
44+
* RetrieveInsightsRequest request =
45+
* RetrieveInsightsRequest.newBuilder()
46+
* .setParent("parent-995424086")
47+
* .setBaseline(Baseline.newBuilder().build())
48+
* .setUserListId("userListId1381604868")
49+
* .build();
50+
* RetrieveInsightsResponse response =
51+
* marketingDataInsightsServiceClient.retrieveInsights(request);
52+
* }
53+
* }</pre>
54+
*
55+
* <p>Note: close() needs to be called on the MarketingDataInsightsServiceClient object to clean up
56+
* resources such as threads. In the example above, try-with-resources is used, which automatically
57+
* calls close().
58+
*
59+
* <table>
60+
* <caption>Methods</caption>
61+
* <tr>
62+
* <th>Method</th>
63+
* <th>Description</th>
64+
* <th>Method Variants</th>
65+
* </tr>
66+
* <tr>
67+
* <td><p> RetrieveInsights</td>
68+
* <td><p> Retrieves marketing data insights for a given user list.
69+
* <p> This feature is only available to data partners.
70+
* <p> Authorization Headers:
71+
* <p> This method supports the following optional headers to define how the API authorizes access for the request:
72+
* <ul>
73+
* <li> `login-account`: (Optional) The resource name of the account where the Google Account of the credentials is a user. If not set, defaults to the account of the request. Format: `accountTypes/{loginAccountType}/accounts/{loginAccountId}`
74+
* <li> `linked-account`: (Optional) The resource name of the account with an established product link to the `login-account`. Format: `accountTypes/{linkedAccountType}/accounts/{linkedAccountId}`
75+
* </ul></td>
76+
* <td>
77+
* <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
78+
* <ul>
79+
* <li><p> retrieveInsights(RetrieveInsightsRequest request)
80+
* </ul>
81+
* <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>
82+
* <ul>
83+
* <li><p> retrieveInsightsCallable()
84+
* </ul>
85+
* </td>
86+
* </tr>
87+
* </table>
88+
*
89+
* <p>See the individual methods for example code.
90+
*
91+
* <p>Many parameters require resource names to be formatted in a particular way. To assist with
92+
* these names, this class includes a format method for each type of name, and additionally a parse
93+
* method to extract the individual identifiers contained within names that are returned.
94+
*
95+
* <p>This class can be customized by passing in a custom instance of
96+
* MarketingDataInsightsServiceSettings to create(). For example:
97+
*
98+
* <p>To customize credentials:
99+
*
100+
* <pre>{@code
101+
* // This snippet has been automatically generated and should be regarded as a code template only.
102+
* // It will require modifications to work:
103+
* // - It may require correct/in-range values for request initialization.
104+
* // - It may require specifying regional endpoints when creating the service client as shown in
105+
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
106+
* MarketingDataInsightsServiceSettings marketingDataInsightsServiceSettings =
107+
* MarketingDataInsightsServiceSettings.newBuilder()
108+
* .setCredentialsProvider(FixedCredentialsProvider.create(myCredentials))
109+
* .build();
110+
* MarketingDataInsightsServiceClient marketingDataInsightsServiceClient =
111+
* MarketingDataInsightsServiceClient.create(marketingDataInsightsServiceSettings);
112+
* }</pre>
113+
*
114+
* <p>To customize the endpoint:
115+
*
116+
* <pre>{@code
117+
* // This snippet has been automatically generated and should be regarded as a code template only.
118+
* // It will require modifications to work:
119+
* // - It may require correct/in-range values for request initialization.
120+
* // - It may require specifying regional endpoints when creating the service client as shown in
121+
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
122+
* MarketingDataInsightsServiceSettings marketingDataInsightsServiceSettings =
123+
* MarketingDataInsightsServiceSettings.newBuilder().setEndpoint(myEndpoint).build();
124+
* MarketingDataInsightsServiceClient marketingDataInsightsServiceClient =
125+
* MarketingDataInsightsServiceClient.create(marketingDataInsightsServiceSettings);
126+
* }</pre>
127+
*
128+
* <p>To use REST (HTTP1.1/JSON) transport (instead of gRPC) for sending and receiving requests over
129+
* the wire:
130+
*
131+
* <pre>{@code
132+
* // This snippet has been automatically generated and should be regarded as a code template only.
133+
* // It will require modifications to work:
134+
* // - It may require correct/in-range values for request initialization.
135+
* // - It may require specifying regional endpoints when creating the service client as shown in
136+
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
137+
* MarketingDataInsightsServiceSettings marketingDataInsightsServiceSettings =
138+
* MarketingDataInsightsServiceSettings.newHttpJsonBuilder().build();
139+
* MarketingDataInsightsServiceClient marketingDataInsightsServiceClient =
140+
* MarketingDataInsightsServiceClient.create(marketingDataInsightsServiceSettings);
141+
* }</pre>
142+
*
143+
* <p>Please refer to the GitHub repository's samples for more quickstart code snippets.
144+
*/
145+
@Generated("by gapic-generator-java")
146+
public class MarketingDataInsightsServiceClient implements BackgroundResource {
147+
private final MarketingDataInsightsServiceSettings settings;
148+
private final MarketingDataInsightsServiceStub stub;
149+
150+
/** Constructs an instance of MarketingDataInsightsServiceClient with default settings. */
151+
public static final MarketingDataInsightsServiceClient create() throws IOException {
152+
return create(MarketingDataInsightsServiceSettings.newBuilder().build());
153+
}
154+
155+
/**
156+
* Constructs an instance of MarketingDataInsightsServiceClient, using the given settings. The
157+
* channels are created based on the settings passed in, or defaults for any settings that are not
158+
* set.
159+
*/
160+
public static final MarketingDataInsightsServiceClient create(
161+
MarketingDataInsightsServiceSettings settings) throws IOException {
162+
return new MarketingDataInsightsServiceClient(settings);
163+
}
164+
165+
/**
166+
* Constructs an instance of MarketingDataInsightsServiceClient, using the given stub for making
167+
* calls. This is for advanced usage - prefer using create(MarketingDataInsightsServiceSettings).
168+
*/
169+
public static final MarketingDataInsightsServiceClient create(
170+
MarketingDataInsightsServiceStub stub) {
171+
return new MarketingDataInsightsServiceClient(stub);
172+
}
173+
174+
/**
175+
* Constructs an instance of MarketingDataInsightsServiceClient, using the given settings. This is
176+
* protected so that it is easy to make a subclass, but otherwise, the static factory methods
177+
* should be preferred.
178+
*/
179+
protected MarketingDataInsightsServiceClient(MarketingDataInsightsServiceSettings settings)
180+
throws IOException {
181+
this.settings = settings;
182+
this.stub =
183+
((MarketingDataInsightsServiceStubSettings) settings.getStubSettings()).createStub();
184+
}
185+
186+
protected MarketingDataInsightsServiceClient(MarketingDataInsightsServiceStub stub) {
187+
this.settings = null;
188+
this.stub = stub;
189+
}
190+
191+
public final MarketingDataInsightsServiceSettings getSettings() {
192+
return settings;
193+
}
194+
195+
public MarketingDataInsightsServiceStub getStub() {
196+
return stub;
197+
}
198+
199+
// AUTO-GENERATED DOCUMENTATION AND METHOD.
200+
/**
201+
* Retrieves marketing data insights for a given user list.
202+
*
203+
* <p>This feature is only available to data partners.
204+
*
205+
* <p>Authorization Headers:
206+
*
207+
* <p>This method supports the following optional headers to define how the API authorizes access
208+
* for the request:
209+
*
210+
* <ul>
211+
* <li>`login-account`: (Optional) The resource name of the account where the Google Account of
212+
* the credentials is a user. If not set, defaults to the account of the request. Format:
213+
* `accountTypes/{loginAccountType}/accounts/{loginAccountId}`
214+
* <li>`linked-account`: (Optional) The resource name of the account with an established product
215+
* link to the `login-account`. Format:
216+
* `accountTypes/{linkedAccountType}/accounts/{linkedAccountId}`
217+
* </ul>
218+
*
219+
* <p>Sample code:
220+
*
221+
* <pre>{@code
222+
* // This snippet has been automatically generated and should be regarded as a code template only.
223+
* // It will require modifications to work:
224+
* // - It may require correct/in-range values for request initialization.
225+
* // - It may require specifying regional endpoints when creating the service client as shown in
226+
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
227+
* try (MarketingDataInsightsServiceClient marketingDataInsightsServiceClient =
228+
* MarketingDataInsightsServiceClient.create()) {
229+
* RetrieveInsightsRequest request =
230+
* RetrieveInsightsRequest.newBuilder()
231+
* .setParent("parent-995424086")
232+
* .setBaseline(Baseline.newBuilder().build())
233+
* .setUserListId("userListId1381604868")
234+
* .build();
235+
* RetrieveInsightsResponse response =
236+
* marketingDataInsightsServiceClient.retrieveInsights(request);
237+
* }
238+
* }</pre>
239+
*
240+
* @param request The request object containing all of the parameters for the API call.
241+
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
242+
*/
243+
public final RetrieveInsightsResponse retrieveInsights(RetrieveInsightsRequest request) {
244+
return retrieveInsightsCallable().call(request);
245+
}
246+
247+
// AUTO-GENERATED DOCUMENTATION AND METHOD.
248+
/**
249+
* Retrieves marketing data insights for a given user list.
250+
*
251+
* <p>This feature is only available to data partners.
252+
*
253+
* <p>Authorization Headers:
254+
*
255+
* <p>This method supports the following optional headers to define how the API authorizes access
256+
* for the request:
257+
*
258+
* <ul>
259+
* <li>`login-account`: (Optional) The resource name of the account where the Google Account of
260+
* the credentials is a user. If not set, defaults to the account of the request. Format:
261+
* `accountTypes/{loginAccountType}/accounts/{loginAccountId}`
262+
* <li>`linked-account`: (Optional) The resource name of the account with an established product
263+
* link to the `login-account`. Format:
264+
* `accountTypes/{linkedAccountType}/accounts/{linkedAccountId}`
265+
* </ul>
266+
*
267+
* <p>Sample code:
268+
*
269+
* <pre>{@code
270+
* // This snippet has been automatically generated and should be regarded as a code template only.
271+
* // It will require modifications to work:
272+
* // - It may require correct/in-range values for request initialization.
273+
* // - It may require specifying regional endpoints when creating the service client as shown in
274+
* // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
275+
* try (MarketingDataInsightsServiceClient marketingDataInsightsServiceClient =
276+
* MarketingDataInsightsServiceClient.create()) {
277+
* RetrieveInsightsRequest request =
278+
* RetrieveInsightsRequest.newBuilder()
279+
* .setParent("parent-995424086")
280+
* .setBaseline(Baseline.newBuilder().build())
281+
* .setUserListId("userListId1381604868")
282+
* .build();
283+
* ApiFuture<RetrieveInsightsResponse> future =
284+
* marketingDataInsightsServiceClient.retrieveInsightsCallable().futureCall(request);
285+
* // Do something.
286+
* RetrieveInsightsResponse response = future.get();
287+
* }
288+
* }</pre>
289+
*/
290+
public final UnaryCallable<RetrieveInsightsRequest, RetrieveInsightsResponse>
291+
retrieveInsightsCallable() {
292+
return stub.retrieveInsightsCallable();
293+
}
294+
295+
@Override
296+
public final void close() {
297+
stub.close();
298+
}
299+
300+
@Override
301+
public void shutdown() {
302+
stub.shutdown();
303+
}
304+
305+
@Override
306+
public boolean isShutdown() {
307+
return stub.isShutdown();
308+
}
309+
310+
@Override
311+
public boolean isTerminated() {
312+
return stub.isTerminated();
313+
}
314+
315+
@Override
316+
public void shutdownNow() {
317+
stub.shutdownNow();
318+
}
319+
320+
@Override
321+
public boolean awaitTermination(long duration, TimeUnit unit) throws InterruptedException {
322+
return stub.awaitTermination(duration, unit);
323+
}
324+
}

0 commit comments

Comments
 (0)