v1

latestOpenAPI 3.0.0Creative Commons Attribution 3.02026-07-132073100.2 KB
projects

Creates a new data exchange.

post/v1/{+parent}/dataExchanges

Path parameters

parentstring required

Required. The parent resource path of the data exchange. e.g. projects/myproject/locations/us.

Query parameters

dataExchangeIdstring

Required. The ID of the data exchange. Must contain only Unicode letters, numbers (0-9), underscores (_). Max length: 100 bytes.

Request body

documentationstring

Optional. Documentation describing the data exchange.

iconstring byte

Optional. Base64 encoded image representing the data exchange. Max Size: 3.0MiB Expected image dimensions are 512x512 pixels, however the API only performs validation on size of the encoded data. Note: For byte fields, the content of the fields are base64-encoded (which increases the size of the data by 33-36%) when using JSON on the wire.

logLinkedDatasetQueryUserEmailboolean

Optional. By default, false. If true, the DataExchange has an email sharing mandate enabled.

displayNamestring

Required. Human-readable display name of the data exchange. The display name must contain only Unicode letters, numbers (0-9), underscores (_), dashes (-), spaces ( ), ampersands (&) and must not start or end with spaces. Default value is an empty string. Max length: 63 bytes.

namestring

Output only. The resource name of the data exchange. e.g. projects/myproject/locations/us/dataExchanges/123.

primaryContactstring

Optional. Email or URL of the primary point of contact of the data exchange. Max Length: 1000 bytes.

listingCountinteger

Output only. Number of listings contained in the data exchange.

descriptionstring

Optional. Description of the data exchange. The description must not contain Unicode non-characters as well as C0 and C1 control codes except tabs (HT), new lines (LF), carriage returns (CR), and page breaks (FF). Default value is an empty string. Max length: 2000 bytes.

discoveryType'DISCOVERY_TYPE_UNSPECIFIED' | 'DISCOVERY_TYPE_PRIVATE' | 'DISCOVERY_TYPE_PUBLIC'

Optional. Type of discovery on the discovery page for all the listings under this exchange. Updating this field also updates (overwrites) the discovery_type field for all the listings under this exchange.

Response

Successful response