Skip to content
This repository was archived by the owner on Sep 16, 2023. It is now read-only.

Commit a7cc927

Browse files
yoshi-automationyoshi-automation
authored
feat: Add/Update API definitions for Cloud Channel API (#112)
This PR was generated using Autosynth. 🌈 Synth log will be available here: https://source.cloud.google.com/results/invocations/80dfe4c9-7eb0-4ba3-b23c-eb532cbee786/targets - [ ] To automatically regenerate this PR, check this box. (May take up to 24 hours.) PiperOrigin-RevId: 378177991 Source-Link: googleapis/googleapis@97d42c6 feat: Update descriptions of APIs feat: Add additional_bindings to HTTP annotations of Customer related APIs (list/create/get/update/delete) feat: Add a new LookupOffer RPC and LookupOfferRequest proto feat: Add a new enum value LICENSE_CAP_CHANGED to enum EntitlementEvent.Type
1 parent 1db06f0 commit a7cc927

File tree

22 files changed

+1742
-618
lines changed

22 files changed

+1742
-618
lines changed

‎google-cloud-channel/src/main/java/com/google/cloud/channel/v1/CloudChannelServiceClient.java

Lines changed: 81 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -306,7 +306,7 @@ public final UnaryCallable<ListCustomersRequest, ListCustomersResponse> listCust
306306

307307
// AUTO-GENERATED DOCUMENTATION AND METHOD.
308308
/**
309-
* Returns a requested [Customer][google.cloud.channel.v1.Customer] resource.
309+
* Returns the requested [Customer][google.cloud.channel.v1.Customer] resource.
310310
*
311311
* <p>Possible error codes:
312312
*
@@ -341,7 +341,7 @@ public final Customer getCustomer(CustomerName name) {
341341

342342
// AUTO-GENERATED DOCUMENTATION AND METHOD.
343343
/**
344-
* Returns a requested [Customer][google.cloud.channel.v1.Customer] resource.
344+
* Returns the requested [Customer][google.cloud.channel.v1.Customer] resource.
345345
*
346346
* <p>Possible error codes:
347347
*
@@ -375,7 +375,7 @@ public final Customer getCustomer(String name) {
375375

376376
// AUTO-GENERATED DOCUMENTATION AND METHOD.
377377
/**
378-
* Returns a requested [Customer][google.cloud.channel.v1.Customer] resource.
378+
* Returns the requested [Customer][google.cloud.channel.v1.Customer] resource.
379379
*
380380
* <p>Possible error codes:
381381
*
@@ -410,7 +410,7 @@ public final Customer getCustomer(GetCustomerRequest request) {
410410

411411
// AUTO-GENERATED DOCUMENTATION AND METHOD.
412412
/**
413-
* Returns a requested [Customer][google.cloud.channel.v1.Customer] resource.
413+
* Returns the requested [Customer][google.cloud.channel.v1.Customer] resource.
414414
*
415415
* <p>Possible error codes:
416416
*
@@ -679,7 +679,7 @@ public final UnaryCallable<UpdateCustomerRequest, Customer> updateCustomerCallab
679679

680680
// AUTO-GENERATED DOCUMENTATION AND METHOD.
681681
/**
682-
* Deletes the given [Customer][google.cloud.channel.v1.Customer] permanently and irreversibly.
682+
* Deletes the given [Customer][google.cloud.channel.v1.Customer] permanently.
683683
*
684684
* <p>Possible error codes:
685685
*
@@ -711,7 +711,7 @@ public final void deleteCustomer(CustomerName name) {
711711

712712
// AUTO-GENERATED DOCUMENTATION AND METHOD.
713713
/**
714-
* Deletes the given [Customer][google.cloud.channel.v1.Customer] permanently and irreversibly.
714+
* Deletes the given [Customer][google.cloud.channel.v1.Customer] permanently.
715715
*
716716
* <p>Possible error codes:
717717
*
@@ -742,7 +742,7 @@ public final void deleteCustomer(String name) {
742742

743743
// AUTO-GENERATED DOCUMENTATION AND METHOD.
744744
/**
745-
* Deletes the given [Customer][google.cloud.channel.v1.Customer] permanently and irreversibly.
745+
* Deletes the given [Customer][google.cloud.channel.v1.Customer] permanently.
746746
*
747747
* <p>Possible error codes:
748748
*
@@ -775,7 +775,7 @@ public final void deleteCustomer(DeleteCustomerRequest request) {
775775

776776
// AUTO-GENERATED DOCUMENTATION AND METHOD.
777777
/**
778-
* Deletes the given [Customer][google.cloud.channel.v1.Customer] permanently and irreversibly.
778+
* Deletes the given [Customer][google.cloud.channel.v1.Customer] permanently.
779779
*
780780
* <p>Possible error codes:
781781
*
@@ -1361,7 +1361,7 @@ public final ListTransferableOffersPagedResponse listTransferableOffers(
13611361

13621362
// AUTO-GENERATED DOCUMENTATION AND METHOD.
13631363
/**
1364-
* Returns a requested [Entitlement][google.cloud.channel.v1.Entitlement] resource.
1364+
* Returns the requested [Entitlement][google.cloud.channel.v1.Entitlement] resource.
13651365
*
13661366
* <p>Possible error codes:
13671367
*
@@ -1394,7 +1394,7 @@ public final Entitlement getEntitlement(GetEntitlementRequest request) {
13941394

13951395
// AUTO-GENERATED DOCUMENTATION AND METHOD.
13961396
/**
1397-
* Returns a requested [Entitlement][google.cloud.channel.v1.Entitlement] resource.
1397+
* Returns the requested [Entitlement][google.cloud.channel.v1.Entitlement] resource.
13981398
*
13991399
* <p>Possible error codes:
14001400
*
@@ -3064,8 +3064,8 @@ public final ListChannelPartnerLinksPagedResponse listChannelPartnerLinks(
30643064

30653065
// AUTO-GENERATED DOCUMENTATION AND METHOD.
30663066
/**
3067-
* Returns a requested [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resource.
3068-
* You must be a distributor to call this method.
3067+
* Returns the requested [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink]
3068+
* resource. You must be a distributor to call this method.
30693069
*
30703070
* <p>Possible error codes:
30713071
*
@@ -3101,8 +3101,8 @@ public final ChannelPartnerLink getChannelPartnerLink(GetChannelPartnerLinkReque
31013101

31023102
// AUTO-GENERATED DOCUMENTATION AND METHOD.
31033103
/**
3104-
* Returns a requested [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink] resource.
3105-
* You must be a distributor to call this method.
3104+
* Returns the requested [ChannelPartnerLink][google.cloud.channel.v1.ChannelPartnerLink]
3105+
* resource. You must be a distributor to call this method.
31063106
*
31073107
* <p>Possible error codes:
31083108
*
@@ -3317,6 +3317,73 @@ public final ChannelPartnerLink updateChannelPartnerLink(
33173317
return stub.updateChannelPartnerLinkCallable();
33183318
}
33193319

3320+
// AUTO-GENERATED DOCUMENTATION AND METHOD.
3321+
/**
3322+
* Returns the requested [Offer][google.cloud.channel.v1.Offer] resource.
3323+
*
3324+
* <p>Possible error codes:
3325+
*
3326+
* <ul>
3327+
* <li>PERMISSION_DENIED: The entitlement doesn't belong to the reseller.
3328+
* <li>INVALID_ARGUMENT: Required request parameters are missing or invalid.
3329+
* <li>NOT_FOUND: Entitlement or offer was not found.
3330+
* </ul>
3331+
*
3332+
* <p>Return value: The [Offer][google.cloud.channel.v1.Offer] resource.
3333+
*
3334+
* <p>Sample code:
3335+
*
3336+
* <pre>{@code
3337+
* try (CloudChannelServiceClient cloudChannelServiceClient = CloudChannelServiceClient.create()) {
3338+
* LookupOfferRequest request =
3339+
* LookupOfferRequest.newBuilder()
3340+
* .setEntitlement(
3341+
* EntitlementName.of("[ACCOUNT]", "[CUSTOMER]", "[ENTITLEMENT]").toString())
3342+
* .build();
3343+
* Offer response = cloudChannelServiceClient.lookupOffer(request);
3344+
* }
3345+
* }</pre>
3346+
*
3347+
* @param request The request object containing all of the parameters for the API call.
3348+
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
3349+
*/
3350+
public final Offer lookupOffer(LookupOfferRequest request) {
3351+
return lookupOfferCallable().call(request);
3352+
}
3353+
3354+
// AUTO-GENERATED DOCUMENTATION AND METHOD.
3355+
/**
3356+
* Returns the requested [Offer][google.cloud.channel.v1.Offer] resource.
3357+
*
3358+
* <p>Possible error codes:
3359+
*
3360+
* <ul>
3361+
* <li>PERMISSION_DENIED: The entitlement doesn't belong to the reseller.
3362+
* <li>INVALID_ARGUMENT: Required request parameters are missing or invalid.
3363+
* <li>NOT_FOUND: Entitlement or offer was not found.
3364+
* </ul>
3365+
*
3366+
* <p>Return value: The [Offer][google.cloud.channel.v1.Offer] resource.
3367+
*
3368+
* <p>Sample code:
3369+
*
3370+
* <pre>{@code
3371+
* try (CloudChannelServiceClient cloudChannelServiceClient = CloudChannelServiceClient.create()) {
3372+
* LookupOfferRequest request =
3373+
* LookupOfferRequest.newBuilder()
3374+
* .setEntitlement(
3375+
* EntitlementName.of("[ACCOUNT]", "[CUSTOMER]", "[ENTITLEMENT]").toString())
3376+
* .build();
3377+
* ApiFuture<Offer> future = cloudChannelServiceClient.lookupOfferCallable().futureCall(request);
3378+
* // Do something.
3379+
* Offer response = future.get();
3380+
* }
3381+
* }</pre>
3382+
*/
3383+
public final UnaryCallable<LookupOfferRequest, Offer> lookupOfferCallable() {
3384+
return stub.lookupOfferCallable();
3385+
}
3386+
33203387
// AUTO-GENERATED DOCUMENTATION AND METHOD.
33213388
/**
33223389
* Lists the Products the reseller is authorized to sell.

‎google-cloud-channel/src/main/java/com/google/cloud/channel/v1/CloudChannelServiceSettings.java

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -310,6 +310,11 @@ public UnaryCallSettings<TransferEntitlementsRequest, Operation> transferEntitle
310310
return ((CloudChannelServiceStubSettings) getStubSettings()).updateChannelPartnerLinkSettings();
311311
}
312312

313+
/** Returns the object with the settings used for calls to lookupOffer. */
314+
public UnaryCallSettings<LookupOfferRequest, Offer> lookupOfferSettings() {
315+
return ((CloudChannelServiceStubSettings) getStubSettings()).lookupOfferSettings();
316+
}
317+
313318
/** Returns the object with the settings used for calls to listProducts. */
314319
public PagedCallSettings<ListProductsRequest, ListProductsResponse, ListProductsPagedResponse>
315320
listProductsSettings() {
@@ -686,6 +691,11 @@ public UnaryCallSettings.Builder<ChangeOfferRequest, Operation> changeOfferSetti
686691
return getStubSettingsBuilder().updateChannelPartnerLinkSettings();
687692
}
688693

694+
/** Returns the builder for the settings used for calls to lookupOffer. */
695+
public UnaryCallSettings.Builder<LookupOfferRequest, Offer> lookupOfferSettings() {
696+
return getStubSettingsBuilder().lookupOfferSettings();
697+
}
698+
689699
/** Returns the builder for the settings used for calls to listProducts. */
690700
public PagedCallSettings.Builder<
691701
ListProductsRequest, ListProductsResponse, ListProductsPagedResponse>

‎google-cloud-channel/src/main/java/com/google/cloud/channel/v1/gapic_metadata.json

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -82,6 +82,9 @@
8282
"ListTransferableSkus": {
8383
"methods": ["listTransferableSkus", "listTransferableSkusPagedCallable", "listTransferableSkusCallable"]
8484
},
85+
"LookupOffer": {
86+
"methods": ["lookupOffer", "lookupOfferCallable"]
87+
},
8588
"ProvisionCloudIdentity": {
8689
"methods": ["provisionCloudIdentityAsync", "provisionCloudIdentityOperationCallable", "provisionCloudIdentityCallable"]
8790
},

‎google-cloud-channel/src/main/java/com/google/cloud/channel/v1/stub/CloudChannelServiceStub.java

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -70,6 +70,8 @@
7070
import com.google.cloud.channel.v1.ListTransferableOffersResponse;
7171
import com.google.cloud.channel.v1.ListTransferableSkusRequest;
7272
import com.google.cloud.channel.v1.ListTransferableSkusResponse;
73+
import com.google.cloud.channel.v1.LookupOfferRequest;
74+
import com.google.cloud.channel.v1.Offer;
7375
import com.google.cloud.channel.v1.OperationMetadata;
7476
import com.google.cloud.channel.v1.ProvisionCloudIdentityRequest;
7577
import com.google.cloud.channel.v1.RegisterSubscriberRequest;
@@ -304,6 +306,10 @@ public UnaryCallable<TransferEntitlementsRequest, Operation> transferEntitlement
304306
throw new UnsupportedOperationException("Not implemented: updateChannelPartnerLinkCallable()");
305307
}
306308

309+
public UnaryCallable<LookupOfferRequest, Offer> lookupOfferCallable() {
310+
throw new UnsupportedOperationException("Not implemented: lookupOfferCallable()");
311+
}
312+
307313
public UnaryCallable<ListProductsRequest, ListProductsPagedResponse> listProductsPagedCallable() {
308314
throw new UnsupportedOperationException("Not implemented: listProductsPagedCallable()");
309315
}

‎google-cloud-channel/src/main/java/com/google/cloud/channel/v1/stub/CloudChannelServiceStubSettings.java

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -93,6 +93,7 @@
9393
import com.google.cloud.channel.v1.ListTransferableOffersResponse;
9494
import com.google.cloud.channel.v1.ListTransferableSkusRequest;
9595
import com.google.cloud.channel.v1.ListTransferableSkusResponse;
96+
import com.google.cloud.channel.v1.LookupOfferRequest;
9697
import com.google.cloud.channel.v1.Offer;
9798
import com.google.cloud.channel.v1.OperationMetadata;
9899
import com.google.cloud.channel.v1.Product;
@@ -237,6 +238,7 @@ public class CloudChannelServiceStubSettings extends StubSettings<CloudChannelSe
237238
createChannelPartnerLinkSettings;
238239
private final UnaryCallSettings<UpdateChannelPartnerLinkRequest, ChannelPartnerLink>
239240
updateChannelPartnerLinkSettings;
241+
private final UnaryCallSettings<LookupOfferRequest, Offer> lookupOfferSettings;
240242
private final PagedCallSettings<
241243
ListProductsRequest, ListProductsResponse, ListProductsPagedResponse>
242244
listProductsSettings;
@@ -1133,6 +1135,11 @@ public UnaryCallSettings<TransferEntitlementsRequest, Operation> transferEntitle
11331135
return updateChannelPartnerLinkSettings;
11341136
}
11351137

1138+
/** Returns the object with the settings used for calls to lookupOffer. */
1139+
public UnaryCallSettings<LookupOfferRequest, Offer> lookupOfferSettings() {
1140+
return lookupOfferSettings;
1141+
}
1142+
11361143
/** Returns the object with the settings used for calls to listProducts. */
11371144
public PagedCallSettings<ListProductsRequest, ListProductsResponse, ListProductsPagedResponse>
11381145
listProductsSettings() {
@@ -1301,6 +1308,7 @@ protected CloudChannelServiceStubSettings(Builder settingsBuilder) throws IOExce
13011308
getChannelPartnerLinkSettings = settingsBuilder.getChannelPartnerLinkSettings().build();
13021309
createChannelPartnerLinkSettings = settingsBuilder.createChannelPartnerLinkSettings().build();
13031310
updateChannelPartnerLinkSettings = settingsBuilder.updateChannelPartnerLinkSettings().build();
1311+
lookupOfferSettings = settingsBuilder.lookupOfferSettings().build();
13041312
listProductsSettings = settingsBuilder.listProductsSettings().build();
13051313
listSkusSettings = settingsBuilder.listSkusSettings().build();
13061314
listOffersSettings = settingsBuilder.listOffersSettings().build();
@@ -1403,6 +1411,7 @@ public static class Builder
14031411
createChannelPartnerLinkSettings;
14041412
private final UnaryCallSettings.Builder<UpdateChannelPartnerLinkRequest, ChannelPartnerLink>
14051413
updateChannelPartnerLinkSettings;
1414+
private final UnaryCallSettings.Builder<LookupOfferRequest, Offer> lookupOfferSettings;
14061415
private final PagedCallSettings.Builder<
14071416
ListProductsRequest, ListProductsResponse, ListProductsPagedResponse>
14081417
listProductsSettings;
@@ -1517,6 +1526,7 @@ protected Builder(ClientContext clientContext) {
15171526
getChannelPartnerLinkSettings = UnaryCallSettings.newUnaryCallSettingsBuilder();
15181527
createChannelPartnerLinkSettings = UnaryCallSettings.newUnaryCallSettingsBuilder();
15191528
updateChannelPartnerLinkSettings = UnaryCallSettings.newUnaryCallSettingsBuilder();
1529+
lookupOfferSettings = UnaryCallSettings.newUnaryCallSettingsBuilder();
15201530
listProductsSettings = PagedCallSettings.newBuilder(LIST_PRODUCTS_PAGE_STR_FACT);
15211531
listSkusSettings = PagedCallSettings.newBuilder(LIST_SKUS_PAGE_STR_FACT);
15221532
listOffersSettings = PagedCallSettings.newBuilder(LIST_OFFERS_PAGE_STR_FACT);
@@ -1555,6 +1565,7 @@ protected Builder(ClientContext clientContext) {
15551565
getChannelPartnerLinkSettings,
15561566
createChannelPartnerLinkSettings,
15571567
updateChannelPartnerLinkSettings,
1568+
lookupOfferSettings,
15581569
listProductsSettings,
15591570
listSkusSettings,
15601571
listOffersSettings,
@@ -1613,6 +1624,7 @@ protected Builder(CloudChannelServiceStubSettings settings) {
16131624
getChannelPartnerLinkSettings = settings.getChannelPartnerLinkSettings.toBuilder();
16141625
createChannelPartnerLinkSettings = settings.createChannelPartnerLinkSettings.toBuilder();
16151626
updateChannelPartnerLinkSettings = settings.updateChannelPartnerLinkSettings.toBuilder();
1627+
lookupOfferSettings = settings.lookupOfferSettings.toBuilder();
16161628
listProductsSettings = settings.listProductsSettings.toBuilder();
16171629
listSkusSettings = settings.listSkusSettings.toBuilder();
16181630
listOffersSettings = settings.listOffersSettings.toBuilder();
@@ -1649,6 +1661,7 @@ protected Builder(CloudChannelServiceStubSettings settings) {
16491661
getChannelPartnerLinkSettings,
16501662
createChannelPartnerLinkSettings,
16511663
updateChannelPartnerLinkSettings,
1664+
lookupOfferSettings,
16521665
listProductsSettings,
16531666
listSkusSettings,
16541667
listOffersSettings,
@@ -1796,6 +1809,11 @@ private static Builder initDefaults(Builder builder) {
17961809
.setRetryableCodes(RETRYABLE_CODE_DEFINITIONS.get("retry_policy_0_codes"))
17971810
.setRetrySettings(RETRY_PARAM_DEFINITIONS.get("retry_policy_0_params"));
17981811

1812+
builder
1813+
.lookupOfferSettings()
1814+
.setRetryableCodes(RETRYABLE_CODE_DEFINITIONS.get("retry_policy_0_codes"))
1815+
.setRetrySettings(RETRY_PARAM_DEFINITIONS.get("retry_policy_0_params"));
1816+
17991817
builder
18001818
.listProductsSettings()
18011819
.setRetryableCodes(RETRYABLE_CODE_DEFINITIONS.get("retry_policy_0_codes"))
@@ -2367,6 +2385,11 @@ public UnaryCallSettings.Builder<ChangeOfferRequest, Operation> changeOfferSetti
23672385
return updateChannelPartnerLinkSettings;
23682386
}
23692387

2388+
/** Returns the builder for the settings used for calls to lookupOffer. */
2389+
public UnaryCallSettings.Builder<LookupOfferRequest, Offer> lookupOfferSettings() {
2390+
return lookupOfferSettings;
2391+
}
2392+
23702393
/** Returns the builder for the settings used for calls to listProducts. */
23712394
public PagedCallSettings.Builder<
23722395
ListProductsRequest, ListProductsResponse, ListProductsPagedResponse>

0 commit comments

Comments
 (0)