Class Listing (0.2.0)

Listing(mapping=None, *, ignore_unknown_fields=False, **kwargs)

A listing is what gets published into a data exchange that a subscriber can subscribe to. It contains a reference to the data source along with descriptive information that will help subscribers find and subscribe the data.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

Attributes

Name	Description
name	`str` Output only. The resource name of the listing. e.g. ``projects/myproject/locations/US/dataExchanges/123/listings/456``
display_name	`str` Required. Human-readable display name of the listing. The display name must contain only Unicode letters, numbers (0-9), underscores (_), dashes (-), spaces ( ), and can't start or end with spaces. Default value is an empty string. Max length: 63 bytes.
description	`str` Optional. Short description of the listing that can consist of sentences or paragraphs. 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.
primary_contact	`str` Optional. Email or URL of the primary point of contact of the listing. Max Length: 1000 bytes.
documentation	`str` Optional. Documentation describing the listing.
bigquery_dataset	`google.cloud.bigquery_data_exchange_v1beta1.types.Listing.BigQueryDatasetSource` Required. Shared dataset i.e. BigQuery dataset source. This field is a member of `oneof`_ ``source``.
state	`google.cloud.bigquery_data_exchange_v1beta1.types.Listing.State` Output only. Current state of the Listing.
icon	`bytes` Optional. Base64 encoded image representing the listing. 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 contents of the field are base64-encoded (which increases the size of the data by 33-36%) when using JSON on the wire.
data_provider	`google.cloud.bigquery_data_exchange_v1beta1.types.DataProvider` Optional. The details of the Data Provider who owns the source data.
categories	`Sequence[google.cloud.bigquery_data_exchange_v1beta1.common.Category]` Optional. Categories of the Listing. Up to two categories are allowed.
publisher	`google.cloud.bigquery_data_exchange_v1beta1.types.Publisher` Optional. The details of the Publisher who owns the listing and has rights to share the source data.
request_access	`str` Optional. Email or URL of the request access of the listing. Subscribers can use this reference to request access. Max Length: 1000 bytes.

Inheritance

builtins.object > proto.message.Message > Listing

Classes

BigQueryDatasetSource

BigQueryDatasetSource(mapping=None, *, ignore_unknown_fields=False, **kwargs)

A reference to a Shared dataset. It's an existing BigQuery dataset with a collection of objects, such as tables and views, that you want to share with subscribers. Upon subscription to a Listing, Data Exchange creates a Linked dataset in the subscriber's project. A Linked dataset is an opaque, read-only BigQuery dataset that serves as a "symbolic link" to a shared dataset.

State

State(value)

State of the Listing