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: googleapis/googleapis-gen@36bf228
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiMzZiZjIyOGFhNzAxNmQ3YjUxMzk5MGU4NGQ2Njc2MmE4ODlmMmYwOSJ9

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

@@ -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"]
+            }
+          }
+        }
+      }
+    }
+  }
+}

owl-bot-staging/v1/google-cloud-domains/src/main/java/com/google/cloud/domains/v1/package-info.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/stub/DomainsStub.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();
+}