feat: update Go Datastore import path (#7839)

feat: update Go Bigtable import path
feat: release MetadataJob APIs and related resources in GA
feat: expose create time in DataScanJobAPI
docs: correct API documentation
feat: release metadata export in private preview
feat: Add data_version field to AspectSource
docs: add info about schema changes for BigQuery metadata in Dataplex Catalog
docs: Add Identifier for `name` in message `.google.cloud.dataplex.v1.MetadataJob` per https://google.aip.dev/cloud/2510
docs: Add comment for field `type` in message `.google.cloud.dataplex.v1.MetadataJob` per https://linter.aip.dev/192/has-comments
docs: Add comment for field `status` in message `.google.cloud.dataplex.v1.MetadataJob` per https://linter.aip.dev/192/has-comments
docs: Add link to fully qualified names documentation
feat: add annotations in CreateMetadataJob, GetMetadataJob, ListMetaDataJobs and CancelMetadataJob for cloud audit logging
feat: Add new Data Discovery scan type in Datascan
docs: Scrub descriptions for standalone discovery scans
docs: correct the dimensions for data quality rules
feat: A new field `suspended` is added to DataScans
feat: expose create time to customers
feat: Add a TABLE_PUBLISHED field in DiscoveryEvent
feat: Add a TABLE_UPDATED field in DiscoveryEvent
feat: Add a TABLE_IGNORED field in DiscoveryEvent
feat: Add a TABLE_DELETED field in DiscoveryEvent
feat: Add a DATA_DISCOVERY enum type in DataScanEvent
feat: Add a DataDiscoveryAppliedConfigs message
docs: A comment for message `DataScanEvent` is changed
feat: Add an Issue field to DiscoveryEvent.ActionDetails to output the action message in Cloud Logs
feat: A new enum `TableType` is added
feat: A new message `TableDetails` is added
feat: A new field `datascan_id` is added to message `.google.cloud.dataplex.v1.DiscoveryEvent`
feat: A new field `table` is added to message `.google.cloud.dataplex.v1.DiscoveryEvent`
docs: Dataplex Tasks do not support Dataplex Content path as a direct input anymore
PiperOrigin-RevId: 696600248
Source-Link: googleapis/googleapis@43e5337
Source-Link: googleapis/googleapis-gen@1f67afb
Copy-Tag: eyJwIjoiRGF0YXBsZXgvLk93bEJvdC55YW1sIiwiaCI6IjFmNjdhZmI0OTcwZWE0YzNmZTUzNTAyMWE1ZmM4YmExNjk2OGEwMjYifQ==

Dataplex/samples/V1/CatalogServiceClient/cancel_metadata_job.php

@@ -0,0 +1,75 @@
+<?php
+/*
+ * Copyright 2024 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.
+ */
+
+/*
+ * GENERATED CODE WARNING
+ * This file was automatically generated - do not edit!
+ */
+
+require_once __DIR__ . '/../../../vendor/autoload.php';
+
+// [START dataplex_v1_generated_CatalogService_CancelMetadataJob_sync]
+use Google\ApiCore\ApiException;
+use Google\Cloud\Dataplex\V1\CancelMetadataJobRequest;
+use Google\Cloud\Dataplex\V1\Client\CatalogServiceClient;
+
+/**
+ * Cancels a metadata job.
+ *
+ * If you cancel a metadata import job that is in progress, the changes in the
+ * job might be partially applied. We recommend that you reset the state of
+ * the entry groups in your project by running another metadata job that
+ * reverts the changes from the canceled job.
+ *
+ * @param string $formattedName The resource name of the job, in the format
+ *                              `projects/{project_id_or_number}/locations/{location_id}/metadataJobs/{metadata_job_id}`
+ *                              Please see {@see CatalogServiceClient::metadataJobName()} for help formatting this field.
+ */
+function cancel_metadata_job_sample(string $formattedName): void
+{
+    // Create a client.
+    $catalogServiceClient = new CatalogServiceClient();
+
+    // Prepare the request message.
+    $request = (new CancelMetadataJobRequest())
+        ->setName($formattedName);
+
+    // Call the API and handle any network failures.
+    try {
+        $catalogServiceClient->cancelMetadataJob($request);
+        printf('Call completed successfully.' . PHP_EOL);
+    } catch (ApiException $ex) {
+        printf('Call failed with message: %s' . PHP_EOL, $ex->getMessage());
+    }
+}
+
+/**
+ * Helper to execute the sample.
+ *
+ * This sample has been automatically generated and should be regarded as a code
+ * template only. It will require modifications to work:
+ *  - It may require correct/in-range values for request initialization.
+ *  - It may require specifying regional endpoints when creating the service client,
+ *    please see the apiEndpoint client configuration option for more details.
+ */
+function callSample(): void
+{
+    $formattedName = CatalogServiceClient::metadataJobName('[PROJECT]', '[LOCATION]', '[METADATAJOB]');
+
+    cancel_metadata_job_sample($formattedName);
+}
+// [END dataplex_v1_generated_CatalogService_CancelMetadataJob_sync]

Dataplex/samples/V1/CatalogServiceClient/create_aspect_type.php

@@ -32,19 +32,31 @@
 use Google\Rpc\Status;
 
 /**
- * Creates an AspectType
+ * Creates an AspectType.
  *
  * @param string $formattedParent                The resource name of the AspectType, of the form:
  *                                               projects/{project_number}/locations/{location_id}
- *                                               where `location_id` refers to a GCP region. Please see
+ *                                               where `location_id` refers to a Google Cloud region. Please see
  *                                               {@see CatalogServiceClient::locationName()} for help formatting this field.
  * @param string $aspectTypeId                   AspectType identifier.
  * @param string $aspectTypeMetadataTemplateName The name of the field.
  * @param string $aspectTypeMetadataTemplateType The datatype of this field. The following values are supported:
- *                                               Primitive types (string, integer, boolean, double, datetime); datetime
- *                                               must be of the format RFC3339 UTC "Zulu" (Examples:
- *                                               "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z"). Complex
- *                                               types (enum, array, map, record).
+ *
+ *                                               Primitive types:
+ *
+ *                                               * string
+ *                                               * integer
+ *                                               * boolean
+ *                                               * double
+ *                                               * datetime. Must be of the format RFC3339 UTC "Zulu" (Examples:
+ *                                               "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z").
+ *
+ *                                               Complex types:
+ *
+ *                                               * enum
+ *                                               * array
+ *                                               * map
+ *                                               * record
  */
 function create_aspect_type_sample(
     string $formattedParent,

Dataplex/samples/V1/CatalogServiceClient/create_entry.php

@@ -36,25 +36,27 @@
  *                                {@see CatalogServiceClient::entryGroupName()} for help formatting this field.
  * @param string $entryId         Entry identifier. It has to be unique within an Entry Group.
  *
- *                                Entries corresponding to Google Cloud resources use Entry ID format based
- *                                on Full Resource Names
- *                                (https://cloud.google.com/apis/design/resource_names#full_resource_name).
- *                                The format is a Full Resource Name of the resource without the
- *                                prefix double slashes in the API Service Name part of Full Resource Name.
- *                                This allows retrieval of entries using their associated resource name.
+ *                                Entries corresponding to Google Cloud resources use an Entry ID format
+ *                                based on [full resource
+ *                                names](https://cloud.google.com/apis/design/resource_names#full_resource_name).
+ *                                The format is a full resource name of the resource without the
+ *                                prefix double slashes in the API service name part of the full resource
+ *                                name. This allows retrieval of entries using their associated resource
+ *                                name.
  *
- *                                For example if the Full Resource Name of a resource is
+ *                                For example, if the full resource name of a resource is
  *                                `//library.googleapis.com/shelves/shelf1/books/book2`,
  *                                then the suggested entry_id is
  *                                `library.googleapis.com/shelves/shelf1/books/book2`.
  *
  *                                It is also suggested to follow the same convention for entries
- *                                corresponding to resources from other providers or systems than Google
+ *                                corresponding to resources from providers or systems other than Google
  *                                Cloud.
  *
  *                                The maximum size of the field is 4000 characters.
- * @param string $entryEntryType  Immutable. The resource name of the EntryType used to create this
- *                                Entry.
+ * @param string $entryEntryType  Immutable. The relative resource name of the entry type that was
+ *                                used to create this entry, in the format
+ *                                `projects/{project_id_or_number}/locations/{location_id}/entryTypes/{entry_type_id}`.
  */
 function create_entry_sample(
     string $formattedParent,

Dataplex/samples/V1/CatalogServiceClient/create_entry_group.php

@@ -31,7 +31,7 @@
 use Google\Rpc\Status;
 
 /**
- * Creates an EntryGroup
+ * Creates an EntryGroup.
  *
  * @param string $formattedParent The resource name of the entryGroup, of the form:
  *                                projects/{project_number}/locations/{location_id}

Dataplex/samples/V1/CatalogServiceClient/create_entry_type.php

@@ -31,11 +31,11 @@
 use Google\Rpc\Status;
 
 /**
- * Creates an EntryType
+ * Creates an EntryType.
  *
  * @param string $formattedParent The resource name of the EntryType, of the form:
  *                                projects/{project_number}/locations/{location_id}
- *                                where `location_id` refers to a GCP region. Please see
+ *                                where `location_id` refers to a Google Cloud region. Please see
  *                                {@see CatalogServiceClient::locationName()} for help formatting this field.
  * @param string $entryTypeId     EntryType identifier.
  */