google-api-python-client 2.196.0__py3-none-any.whl → 2.197.0__py3-none-any.whl

googleapiclient/discovery_cache/documents/datalineage.v1.json

@@ -556,6 +556,34 @@
 "https://www.googleapis.com/auth/cloud-platform"
 ]
 },
+"searchLineageStreaming": {
+"description": "Retrieves a streaming response of lineage links connected to the requested assets by performing a breadth-first search in the given direction. Links represent the data flow between **source** (upstream) and **target** (downstream) assets in transformation pipelines. Links are stored in the same project as the Lineage Events that create them. This method retrieves links from all valid locations provided in the request. This method supports Column-Level Lineage (CLL) along with wildcard support to retrieve all CLL for an Entity FQN. Following permissions are required to retrieve links: * `datalineage.events.get` permission for the project where the link is stored for entity-level lineage. * `datalineage.events.getFields` permission for the project where the link is stored for column-level lineage. This method also returns processes that created the links if explicitly requested by setting [max_process_per_link](google.cloud.datacatalog.lineage.v1.SearchLineageStreamingRequest.limits.max_process_per_link) is non-zero and full process details are requested via `links.processes.process` in the [FieldMask](https://developers.google.com/workspace/docs/api/how-tos/field-masks#read_with_a_field_mask). Permission required to retrieve processes: * `datalineage.processes.get` permission for the project where the process is stored.",
+"flatPath": "v1/projects/{projectsId}/locations/{locationsId}:searchLineageStreaming",
+"httpMethod": "POST",
+"id": "datalineage.projects.locations.searchLineageStreaming",
+"parameterOrder": [
+"parent"
+],
+"parameters": {
+"parent": {
+"description": "Required. The project and location to initiate the search from.",
+"location": "path",
+"pattern": "^projects/[^/]+/locations/[^/]+$",
+"required": true,
+"type": "string"
+}
+},
+"path": "v1/{+parent}:searchLineageStreaming",
+"request": {
+"$ref": "GoogleCloudDatacatalogLineageV1SearchLineageStreamingRequest"
+},
+"response": {
+"$ref": "GoogleCloudDatacatalogLineageV1SearchLineageStreamingResponse"
+},
+"scopes": [
+"https://www.googleapis.com/auth/cloud-platform"
+]
+},
 "searchLinks": {
 "description": "Retrieve a list of links connected to a specific asset. Links represent the data flow between **source** (upstream) and **target** (downstream) assets in transformation pipelines. Links are stored in the same project as the Lineage Events that create them. You can retrieve links in every project where you have the `datalineage.events.get` permission. The project provided in the URL is used for Billing and Quota.",
 "flatPath": "v1/projects/{projectsId}/locations/{locationsId}:searchLinks",
@@ -1247,7 +1275,7 @@
 }
 }
 },
-"revision": "20260410",
+"revision": "20260511",
 "rootUrl": "https://datalineage.googleapis.com/",
 "schemas": {
 "GoogleCloudDatacatalogLineageConfigmanagementV1Config": {
@@ -1342,12 +1370,12 @@
 "type": "array"
 },
 "pageSize": {
-"description": "The maximum number of processes to return in a single page of the response. A page may contain fewer results than this value.",
+"description": "Optional. The maximum number of processes to return in a single page of the response. A page may contain fewer results than this value.",
 "format": "int32",
 "type": "integer"
 },
 "pageToken": {
-"description": "The page token received from a previous `BatchSearchLinkProcesses` call. Use it to get the next page. When requesting subsequent pages of a response, remember that all parameters must match the values you provided in the original request.",
+"description": "Optional. The page token received from a previous `BatchSearchLinkProcesses` call. Use it to get the next page. When requesting subsequent pages of a response, remember that all parameters must match the values you provided in the original request.",
 "type": "string"
 }
 },
@@ -1371,10 +1399,38 @@
 },
 "type": "object"
 },
+"GoogleCloudDatacatalogLineageV1DependencyInfo": {
+"description": "Dependency info describes how one entity depends on another.",
+"id": "GoogleCloudDatacatalogLineageV1DependencyInfo",
+"properties": {
+"dependencyType": {
+"description": "Required. Type of dependency.",
+"enum": [
+"DEPENDENCY_TYPE_UNSPECIFIED",
+"EXACT_COPY",
+"OTHER"
+],
+"enumDescriptions": [
+"Dependency type unspecified.",
+"Exact data copy without any change.",
+"Other types of dependencies like filtering or grouping."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleCloudDatacatalogLineageV1EntityReference": {
 "description": "The soft reference to everything you can attach a lineage event to.",
 "id": "GoogleCloudDatacatalogLineageV1EntityReference",
 "properties": {
+"field": {
+"description": "Optional. Field path within the entity. Each nesting level should be a separate value in the repeated field. The order matters. Must be empty for asset level lineage For example to address \"salary.net\" subfield where \"salary\" is a column and \"net\" is a proto field two values in the `field` should be reported, the first is \"salary\" and the second is \"net\". Each field length is limited to 500 characters. Maximum supported nesting level is 20.",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
 "fullyQualifiedName": {
 "description": "Required. [Fully Qualified Name (FQN)](https://cloud.google.com/dataplex/docs/fully-qualified-names) of the entity.",
 "type": "string"
@@ -1386,6 +1442,10 @@
 "description": "A lineage between source and target entities.",
 "id": "GoogleCloudDatacatalogLineageV1EventLink",
 "properties": {
+"dependencyInfo": {
+"$ref": "GoogleCloudDatacatalogLineageV1DependencyInfo",
+"description": "Optional. Describes how the target depends on the source."
+},
 "source": {
 "$ref": "GoogleCloudDatacatalogLineageV1EntityReference",
 "description": "Required. Reference to the source entity"
@@ -1425,10 +1485,87 @@
 },
 "type": "object"
 },
+"GoogleCloudDatacatalogLineageV1LineageLink": {
+"description": "Lineage link between two entities.",
+"id": "GoogleCloudDatacatalogLineageV1LineageLink",
+"properties": {
+"dependencyInfo": {
+"description": "Describes how the target entity is dependent on the source entity.",
+"items": {
+"$ref": "GoogleCloudDatacatalogLineageV1LineageLinkDependencyInfo"
+},
+"type": "array"
+},
+"depth": {
+"description": "Depth of the current link in the graph starting from 1.",
+"format": "int32",
+"type": "integer"
+},
+"location": {
+"description": "The location where the LineageEvent that created the link is stored.",
+"type": "string"
+},
+"processes": {
+"description": "Processes metadata associated with the link.",
+"items": {
+"$ref": "GoogleCloudDatacatalogLineageV1LineageLinkLineageProcess"
+},
+"type": "array"
+},
+"source": {
+"$ref": "GoogleCloudDatacatalogLineageV1EntityReference",
+"description": "The entity that is the **source** of this link."
+},
+"target": {
+"$ref": "GoogleCloudDatacatalogLineageV1EntityReference",
+"description": "The entity that is the **target** of this link."
+}
+},
+"type": "object"
+},
+"GoogleCloudDatacatalogLineageV1LineageLinkDependencyInfo": {
+"description": "Dependency info describes how one entity is dependent on another.",
+"id": "GoogleCloudDatacatalogLineageV1LineageLinkDependencyInfo",
+"properties": {
+"dependencyType": {
+"description": "The type of dependency.",
+"enum": [
+"DEPENDENCY_TYPE_UNSPECIFIED",
+"EXACT_COPY",
+"OTHER"
+],
+"enumDescriptions": [
+"Dependency type unspecified.",
+"Exact data copy without any change.",
+"Other types of dependencies like filtering or grouping."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
+"GoogleCloudDatacatalogLineageV1LineageLinkLineageProcess": {
+"description": "Process metadata for the link.",
+"id": "GoogleCloudDatacatalogLineageV1LineageLinkLineageProcess",
+"properties": {
+"process": {
+"$ref": "GoogleCloudDatacatalogLineageV1Process",
+"description": "Process that created the link."
+}
+},
+"type": "object"
+},
 "GoogleCloudDatacatalogLineageV1Link": {
 "description": "Links represent the data flow between **source** (upstream) and **target** (downstream) assets in transformation pipelines. Links are created when LineageEvents record data transformation between related assets.",
 "id": "GoogleCloudDatacatalogLineageV1Link",
 "properties": {
+"dependencyInfo": {
+"description": "Optional. The dependency info of the link (applies only to column level links).",
+"items": {
+"$ref": "GoogleCloudDatacatalogLineageV1LinkDependencyInfo"
+},
+"type": "array"
+},
 "endTime": {
 "description": "The end of the last event establishing this link.",
 "format": "google-datetime",
@@ -1455,6 +1592,27 @@
 },
 "type": "object"
 },
+"GoogleCloudDatacatalogLineageV1LinkDependencyInfo": {
+"description": "Dependency info describes how one entity depends on another.",
+"id": "GoogleCloudDatacatalogLineageV1LinkDependencyInfo",
+"properties": {
+"dependencyType": {
+"description": "The type of dependency.",
+"enum": [
+"DEPENDENCY_TYPE_UNSPECIFIED",
+"EXACT_COPY",
+"OTHER"
+],
+"enumDescriptions": [
+"Dependency type unspecified.",
+"Exact data copy without any change.",
+"Other types of dependencies like filtering or grouping."
+],
+"type": "string"
+}
+},
+"type": "object"
+},
 "GoogleCloudDatacatalogLineageV1ListLineageEventsResponse": {
 "description": "Response message for ListLineageEvents.",
 "id": "GoogleCloudDatacatalogLineageV1ListLineageEventsResponse",
@@ -1509,6 +1667,20 @@
 },
 "type": "object"
 },
+"GoogleCloudDatacatalogLineageV1MultipleEntityReference": {
+"description": "Multiple entity reference for SearchLinksRequest.",
+"id": "GoogleCloudDatacatalogLineageV1MultipleEntityReference",
+"properties": {
+"entities": {
+"description": "Optional. The list of entities to search for links. The maximum number of entities is 20.",
+"items": {
+"$ref": "GoogleCloudDatacatalogLineageV1EntityReference"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
 "GoogleCloudDatacatalogLineageV1OperationMetadata": {
 "description": "Metadata describing the operation.",
 "id": "GoogleCloudDatacatalogLineageV1OperationMetadata",
@@ -1710,7 +1882,7 @@
 "type": "object"
 },
 "displayName": {
-"description": "Optional. A human-readable name you can set to display in a user interface. Must be not longer than 1024 characters and only contain UTF-8 letters or numbers, spaces or characters like `_-:&.`",
+"description": "Optional. A human-readable name you can set to display in a user interface. Must be not longer than 200 characters and only contain UTF-8 letters or numbers, spaces or characters like `_-:&.`",
 "type": "string"
 },
 "endTime": {
@@ -1748,6 +1920,141 @@
 },
 "type": "object"
 },
+"GoogleCloudDatacatalogLineageV1SearchLineageStreamingRequest": {
+"description": "Request message for SearchLineageStreaming.",
+"id": "GoogleCloudDatacatalogLineageV1SearchLineageStreamingRequest",
+"properties": {
+"direction": {
+"description": "Required. Direction of the search.",
+"enum": [
+"SEARCH_DIRECTION_UNSPECIFIED",
+"DOWNSTREAM",
+"UPSTREAM"
+],
+"enumDescriptions": [
+"Direction is unspecified.",
+"Retrieve links that lead from the specified asset to downstream assets.",
+"Retrieve links that lead from upstream assets to the specified asset."
+],
+"type": "string"
+},
+"filters": {
+"$ref": "GoogleCloudDatacatalogLineageV1SearchLineageStreamingRequestSearchFilters",
+"description": "Optional. Filters for the search."
+},
+"limits": {
+"$ref": "GoogleCloudDatacatalogLineageV1SearchLineageStreamingRequestSearchLimits",
+"description": "Optional. Limits for the search."
+},
+"locations": {
+"description": "Required. The locations to search in.",
+"items": {
+"type": "string"
+},
+"type": "array"
+},
+"rootCriteria": {
+"$ref": "GoogleCloudDatacatalogLineageV1SearchLineageStreamingRequestRootCriteria",
+"description": "Required. Criteria for the root of the search."
+}
+},
+"type": "object"
+},
+"GoogleCloudDatacatalogLineageV1SearchLineageStreamingRequestRootCriteria": {
+"description": "Criteria for the root of the search.",
+"id": "GoogleCloudDatacatalogLineageV1SearchLineageStreamingRequestRootCriteria",
+"properties": {
+"entities": {
+"$ref": "GoogleCloudDatacatalogLineageV1MultipleEntityReference",
+"description": "Optional. The entities to initiate the search from. Entities can be specified by FQN only, or by FQN and field. To search by FQN and all available fields for that FQN, use the wildcard `*` as the field value."
+}
+},
+"type": "object"
+},
+"GoogleCloudDatacatalogLineageV1SearchLineageStreamingRequestSearchFilters": {
+"description": "Filters for the search.",
+"id": "GoogleCloudDatacatalogLineageV1SearchLineageStreamingRequestSearchFilters",
+"properties": {
+"dependencyTypes": {
+"description": "Optional. Types of dependencies between entities to retrieve. If unspecified, all dependency types are returned.",
+"items": {
+"enum": [
+"DEPENDENCY_TYPE_UNSPECIFIED",
+"EXACT_COPY",
+"OTHER"
+],
+"enumDescriptions": [
+"Dependency type unspecified.",
+"Exact data copy without any change.",
+"Other types of dependencies like filtering or grouping."
+],
+"type": "string"
+},
+"type": "array"
+},
+"entitySet": {
+"description": "Optional. Entity set restriction. If unspecified, the method returns all entities.",
+"enum": [
+"ENTITY_SET_UNSPECIFIED",
+"ENTITIES"
+],
+"enumDescriptions": [
+"The entity set is unspecified. Returns all the data.",
+"Returns entities with only FQN specified. For example, entities with the `field` field set are not returned."
+],
+"type": "string"
+},
+"timeRange": {
+"$ref": "GoogleTypeInterval",
+"description": "Optional. Time interval to search for lineage. If unspecified, all lineage is returned. Currently, at most one of `start_time` and `end_time` can be set."
+}
+},
+"type": "object"
+},
+"GoogleCloudDatacatalogLineageV1SearchLineageStreamingRequestSearchLimits": {
+"description": "Limits for the search results.",
+"id": "GoogleCloudDatacatalogLineageV1SearchLineageStreamingRequestSearchLimits",
+"properties": {
+"maxDepth": {
+"description": "Optional. The maximum depth of the search. The default value is 5 and maximum value is 100.",
+"format": "int32",
+"type": "integer"
+},
+"maxProcessPerLink": {
+"description": "Optional. The maximum number of processes to return per link. The default value is 0 and the maximum value is 100. If this value is non-zero, the response will contain process names for the links. To retrieve full process details in the response, include `links.processes.process` in the [FieldMask](https://developers.google.com/workspace/docs/api/how-tos/field-masks#read_with_a_field_mask).",
+"format": "int32",
+"type": "integer"
+},
+"maxResults": {
+"description": "Optional. The maximum number of links to return in the response. The default value is 1_000 and the maximum value is 10_000.",
+"format": "int32",
+"type": "integer"
+}
+},
+"type": "object"
+},
+"GoogleCloudDatacatalogLineageV1SearchLineageStreamingResponse": {
+"description": "Response message for SearchLineageStreaming.",
+"id": "GoogleCloudDatacatalogLineageV1SearchLineageStreamingResponse",
+"properties": {
+"links": {
+"description": "Output only. The lineage links that match the search criteria. Can be empty if no links match.",
+"items": {
+"$ref": "GoogleCloudDatacatalogLineageV1LineageLink"
+},
+"readOnly": true,
+"type": "array"
+},
+"unreachable": {
+"description": "Unordered list. Unreachable resources. If non-empty, the result set might be incomplete. Currently, only locations are supported. Format: `projects/[PROJECT_NUMBER]/locations/[LOCATION]` Example: projects/123456789/locations/us-east1",
+"items": {
+"type": "string"
+},
+"type": "array"
+}
+},
+"type": "object"
+},
 "GoogleCloudDatacatalogLineageV1SearchLinksRequest": {
 "description": "Request message for SearchLinks.",
 "id": "GoogleCloudDatacatalogLineageV1SearchLinksRequest",
@@ -1765,9 +2072,17 @@
 "$ref": "GoogleCloudDatacatalogLineageV1EntityReference",
 "description": "Optional. Send asset information in the **source** field to retrieve all links that lead from the specified asset to downstream assets."
 },
+"sources": {
+"$ref": "GoogleCloudDatacatalogLineageV1MultipleEntityReference",
+"description": "Optional. Send a list of asset information in the **sources** field to retrieve all links that lead from the specified assets to downstream assets. This field is similar to the `source` source field but allows providing multiple entities. All entities within the `MultipleEntityReference` must have the same `fully_qualified_name`."
+},
 "target": {
 "$ref": "GoogleCloudDatacatalogLineageV1EntityReference",
 "description": "Optional. Send asset information in the **target** field to retrieve all links that lead from upstream assets to the specified asset."
+},
+"targets": {
+"$ref": "GoogleCloudDatacatalogLineageV1MultipleEntityReference",
+"description": "Optional. Send a list of asset information in the **targets** field to retrieve all links that lead from upstream assets to the specified assets. This field is similar to the `target` target field but allows providing multiple entities. All entities within the `MultipleEntityReference` must have the same `fully_qualified_name`."
 }
 },
 "type": "object"
@@ -1888,6 +2203,23 @@
 }
 },
 "type": "object"
+},
+"GoogleTypeInterval": {
+"description": "Represents a time interval, encoded as a Timestamp start (inclusive) and a Timestamp end (exclusive). The start must be less than or equal to the end. When the start equals the end, the interval is empty (matches no time). When both start and end are unspecified, the interval matches any time.",
+"id": "GoogleTypeInterval",
+"properties": {
+"endTime": {
+"description": "Optional. Exclusive end of the interval. If specified, a Timestamp matching this interval will have to be before the end.",
+"format": "google-datetime",
+"type": "string"
+},
+"startTime": {
+"description": "Optional. Inclusive start of the interval. If specified, a Timestamp matching this interval will have to be the same or after the start.",
+"format": "google-datetime",
+"type": "string"
+}
+},
+"type": "object"
 }
 },
 "servicePath": "",