feat: added library for Cloud Domains v1 API. Also added methods for the transfer-in flow docs: improved API comments

Added Cloud Domains v1 API. Also added support for transferring already registered domains from 3rd party domain registrars to Cloud Domains. PiperOrigin-RevId: 404189502 Source-Link: googleapis/googleapis@6990d97 Source-Link: https://github.com/googleapis/googleapis-gen/commit/36bf228aa7016d7b513990e84d66762a889f2f09 Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiMzZiZjIyOGFhNzAxNmQ3YjUxMzk5MGU4NGQ2Njc2MmE4ODlmMmYwOSJ9

Author: gcf-owl-bot[bot]

grpc-google-cloud-domains-v1alpha2/src/main/java/com/google/cloud/domains/v1alpha2/DomainsGrpc.java

@@ -0,0 +1,63 @@
+{
+ "schema": "1.0",
+ "comment": "This file maps proto services/RPCs to the corresponding library clients/methods",
+ "language": "java",
+ "protoPackage": "google.cloud.domains.v1",
+ "libraryPackage": "com.google.cloud.domains.v1",
+ "services": {
+ "Domains": {
+ "clients": {
+ "grpc": {
+ "libraryClient": "DomainsClient",
+ "rpcs": {
+ "ConfigureContactSettings": {
+ "methods": ["configureContactSettingsAsync", "configureContactSettingsAsync", "configureContactSettingsAsync", "configureContactSettingsOperationCallable", "configureContactSettingsCallable"]
+ },
+ "ConfigureDnsSettings": {
+ "methods": ["configureDnsSettingsAsync", "configureDnsSettingsAsync", "configureDnsSettingsAsync", "configureDnsSettingsOperationCallable", "configureDnsSettingsCallable"]
+ },
+ "ConfigureManagementSettings": {
+ "methods": ["configureManagementSettingsAsync", "configureManagementSettingsAsync", "configureManagementSettingsAsync", "configureManagementSettingsOperationCallable", "configureManagementSettingsCallable"]
+ },
+ "DeleteRegistration": {
+ "methods": ["deleteRegistrationAsync", "deleteRegistrationAsync", "deleteRegistrationAsync", "deleteRegistrationOperationCallable", "deleteRegistrationCallable"]
+ },
+ "ExportRegistration": {
+ "methods": ["exportRegistrationAsync", "exportRegistrationAsync", "exportRegistrationAsync", "exportRegistrationOperationCallable", "exportRegistrationCallable"]
+ },
+ "GetRegistration": {
+ "methods": ["getRegistration", "getRegistration", "getRegistration", "getRegistrationCallable"]
+ },
+ "ListRegistrations": {
+ "methods": ["listRegistrations", "listRegistrations", "listRegistrations", "listRegistrationsPagedCallable", "listRegistrationsCallable"]
+ },
+ "RegisterDomain": {
+ "methods": ["registerDomainAsync", "registerDomainAsync", "registerDomainAsync", "registerDomainOperationCallable", "registerDomainCallable"]
+ },
+ "ResetAuthorizationCode": {
+ "methods": ["resetAuthorizationCode", "resetAuthorizationCode", "resetAuthorizationCode", "resetAuthorizationCodeCallable"]
+ },
+ "RetrieveAuthorizationCode": {
+ "methods": ["retrieveAuthorizationCode", "retrieveAuthorizationCode", "retrieveAuthorizationCode", "retrieveAuthorizationCodeCallable"]
+ },
+ "RetrieveRegisterParameters": {
+ "methods": ["retrieveRegisterParameters", "retrieveRegisterParameters", "retrieveRegisterParameters", "retrieveRegisterParametersCallable"]
+ },
+ "RetrieveTransferParameters": {
+ "methods": ["retrieveTransferParameters", "retrieveTransferParameters", "retrieveTransferParameters", "retrieveTransferParametersCallable"]
+ },
+ "SearchDomains": {
+ "methods": ["searchDomains", "searchDomains", "searchDomains", "searchDomainsCallable"]
+ },
+ "TransferDomain": {
+ "methods": ["transferDomainAsync", "transferDomainAsync", "transferDomainAsync", "transferDomainOperationCallable", "transferDomainCallable"]
+ },
+ "UpdateRegistration": {
+ "methods": ["updateRegistrationAsync", "updateRegistrationAsync", "updateRegistrationOperationCallable", "updateRegistrationCallable"]
+ }
+ }
+ }
+ }
+ }
+ }
+}

grpc-google-cloud-domains-v1beta1/src/main/java/com/google/cloud/domains/v1beta1/DomainsGrpc.java

@@ -0,0 +1,40 @@
+/*
+ * Copyright 2021 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/**
+ * A client to Cloud Domains API
+ *
+ * <p>The interfaces provided are listed below, along with usage samples.
+ *
+ * <p>======================= DomainsClient =======================
+ *
+ * <p>Service Description: The Cloud Domains API enables management and configuration of domain
+ * names.
+ *
+ * <p>Sample for DomainsClient:
+ *
+ * <pre>{@code
+ * try (DomainsClient domainsClient = DomainsClient.create()) {
+ * LocationName location = LocationName.of("[PROJECT]", "[LOCATION]");
+ * String query = "query107944136";
+ * SearchDomainsResponse response = domainsClient.searchDomains(location, query);
+ * }
+ * }</pre>
+ */
+@Generated("by gapic-generator-java")
+package com.google.cloud.domains.v1;
+
+import javax.annotation.Generated;

owl-bot-staging/v1/google-cloud-domains/src/main/java/com/google/cloud/domains/v1/DomainsClient.java

@@ -0,0 +1,187 @@
+/*
+ * Copyright 2021 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.google.cloud.domains.v1.stub;
+
+import static com.google.cloud.domains.v1.DomainsClient.ListRegistrationsPagedResponse;
+
+import com.google.api.gax.core.BackgroundResource;
+import com.google.api.gax.rpc.OperationCallable;
+import com.google.api.gax.rpc.UnaryCallable;
+import com.google.cloud.domains.v1.AuthorizationCode;
+import com.google.cloud.domains.v1.ConfigureContactSettingsRequest;
+import com.google.cloud.domains.v1.ConfigureDnsSettingsRequest;
+import com.google.cloud.domains.v1.ConfigureManagementSettingsRequest;
+import com.google.cloud.domains.v1.DeleteRegistrationRequest;
+import com.google.cloud.domains.v1.ExportRegistrationRequest;
+import com.google.cloud.domains.v1.GetRegistrationRequest;
+import com.google.cloud.domains.v1.ListRegistrationsRequest;
+import com.google.cloud.domains.v1.ListRegistrationsResponse;
+import com.google.cloud.domains.v1.OperationMetadata;
+import com.google.cloud.domains.v1.RegisterDomainRequest;
+import com.google.cloud.domains.v1.Registration;
+import com.google.cloud.domains.v1.ResetAuthorizationCodeRequest;
+import com.google.cloud.domains.v1.RetrieveAuthorizationCodeRequest;
+import com.google.cloud.domains.v1.RetrieveRegisterParametersRequest;
+import com.google.cloud.domains.v1.RetrieveRegisterParametersResponse;
+import com.google.cloud.domains.v1.RetrieveTransferParametersRequest;
+import com.google.cloud.domains.v1.RetrieveTransferParametersResponse;
+import com.google.cloud.domains.v1.SearchDomainsRequest;
+import com.google.cloud.domains.v1.SearchDomainsResponse;
+import com.google.cloud.domains.v1.TransferDomainRequest;
+import com.google.cloud.domains.v1.UpdateRegistrationRequest;
+import com.google.longrunning.Operation;
+import com.google.longrunning.stub.OperationsStub;
+import com.google.protobuf.Empty;
+import javax.annotation.Generated;
+
+// AUTO-GENERATED DOCUMENTATION AND CLASS.
+/**
+ * Base stub class for the Domains service API.
+ *
+ * <p>This class is for advanced usage and reflects the underlying API directly.
+ */
+@Generated("by gapic-generator-java")
+public abstract class DomainsStub implements BackgroundResource {
+
+ public OperationsStub getOperationsStub() {
+ throw new UnsupportedOperationException("Not implemented: getOperationsStub()");
+ }
+
+ public UnaryCallable<SearchDomainsRequest, SearchDomainsResponse> searchDomainsCallable() {
+ throw new UnsupportedOperationException("Not implemented: searchDomainsCallable()");
+ }
+
+ public UnaryCallable<RetrieveRegisterParametersRequest, RetrieveRegisterParametersResponse>
+ retrieveRegisterParametersCallable() {
+ throw new UnsupportedOperationException(
+ "Not implemented: retrieveRegisterParametersCallable()");
+ }
+
+ public OperationCallable<RegisterDomainRequest, Registration, OperationMetadata>
+ registerDomainOperationCallable() {
+ throw new UnsupportedOperationException("Not implemented: registerDomainOperationCallable()");
+ }
+
+ public UnaryCallable<RegisterDomainRequest, Operation> registerDomainCallable() {
+ throw new UnsupportedOperationException("Not implemented: registerDomainCallable()");
+ }
+
+ public UnaryCallable<RetrieveTransferParametersRequest, RetrieveTransferParametersResponse>
+ retrieveTransferParametersCallable() {
+ throw new UnsupportedOperationException(
+ "Not implemented: retrieveTransferParametersCallable()");
+ }
+
+ public OperationCallable<TransferDomainRequest, Registration, OperationMetadata>
+ transferDomainOperationCallable() {
+ throw new UnsupportedOperationException("Not implemented: transferDomainOperationCallable()");
+ }
+
+ public UnaryCallable<TransferDomainRequest, Operation> transferDomainCallable() {
+ throw new UnsupportedOperationException("Not implemented: transferDomainCallable()");
+ }
+
+ public UnaryCallable<ListRegistrationsRequest, ListRegistrationsPagedResponse>
+ listRegistrationsPagedCallable() {
+ throw new UnsupportedOperationException("Not implemented: listRegistrationsPagedCallable()");
+ }
+
+ public UnaryCallable<ListRegistrationsRequest, ListRegistrationsResponse>
+ listRegistrationsCallable() {
+ throw new UnsupportedOperationException("Not implemented: listRegistrationsCallable()");
+ }
+
+ public UnaryCallable<GetRegistrationRequest, Registration> getRegistrationCallable() {
+ throw new UnsupportedOperationException("Not implemented: getRegistrationCallable()");
+ }
+
+ public OperationCallable<UpdateRegistrationRequest, Registration, OperationMetadata>
+ updateRegistrationOperationCallable() {
+ throw new UnsupportedOperationException(
+ "Not implemented: updateRegistrationOperationCallable()");
+ }
+
+ public UnaryCallable<UpdateRegistrationRequest, Operation> updateRegistrationCallable() {
+ throw new UnsupportedOperationException("Not implemented: updateRegistrationCallable()");
+ }
+
+ public OperationCallable<ConfigureManagementSettingsRequest, Registration, OperationMetadata>
+ configureManagementSettingsOperationCallable() {
+ throw new UnsupportedOperationException(
+ "Not implemented: configureManagementSettingsOperationCallable()");
+ }
+
+ public UnaryCallable<ConfigureManagementSettingsRequest, Operation>
+ configureManagementSettingsCallable() {
+ throw new UnsupportedOperationException(
+ "Not implemented: configureManagementSettingsCallable()");
+ }
+
+ public OperationCallable<ConfigureDnsSettingsRequest, Registration, OperationMetadata>
+ configureDnsSettingsOperationCallable() {
+ throw new UnsupportedOperationException(
+ "Not implemented: configureDnsSettingsOperationCallable()");
+ }
+
+ public UnaryCallable<ConfigureDnsSettingsRequest, Operation> configureDnsSettingsCallable() {
+ throw new UnsupportedOperationException("Not implemented: configureDnsSettingsCallable()");
+ }
+
+ public OperationCallable<ConfigureContactSettingsRequest, Registration, OperationMetadata>
+ configureContactSettingsOperationCallable() {
+ throw new UnsupportedOperationException(
+ "Not implemented: configureContactSettingsOperationCallable()");
+ }
+
+ public UnaryCallable<ConfigureContactSettingsRequest, Operation>
+ configureContactSettingsCallable() {
+ throw new UnsupportedOperationException("Not implemented: configureContactSettingsCallable()");
+ }
+
+ public OperationCallable<ExportRegistrationRequest, Registration, OperationMetadata>
+ exportRegistrationOperationCallable() {
+ throw new UnsupportedOperationException(
+ "Not implemented: exportRegistrationOperationCallable()");
+ }
+
+ public UnaryCallable<ExportRegistrationRequest, Operation> exportRegistrationCallable() {
+ throw new UnsupportedOperationException("Not implemented: exportRegistrationCallable()");
+ }
+
+ public OperationCallable<DeleteRegistrationRequest, Empty, OperationMetadata>
+ deleteRegistrationOperationCallable() {
+ throw new UnsupportedOperationException(
+ "Not implemented: deleteRegistrationOperationCallable()");
+ }
+
+ public UnaryCallable<DeleteRegistrationRequest, Operation> deleteRegistrationCallable() {
+ throw new UnsupportedOperationException("Not implemented: deleteRegistrationCallable()");
+ }
+
+ public UnaryCallable<RetrieveAuthorizationCodeRequest, AuthorizationCode>
+ retrieveAuthorizationCodeCallable() {
+ throw new UnsupportedOperationException("Not implemented: retrieveAuthorizationCodeCallable()");
+ }
+
+ public UnaryCallable<ResetAuthorizationCodeRequest, AuthorizationCode>
+ resetAuthorizationCodeCallable() {
+ throw new UnsupportedOperationException("Not implemented: resetAuthorizationCodeCallable()");
+ }
+
+ @Override
+ public abstract void close();
+}