Google Cloud BigQuery Analytics Hub V1 Client - Class Listing (1.2.1)

Reference documentation and code samples for the Google Cloud BigQuery Analytics Hub V1 Client class Listing.

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.

Generated from protobuf message google.cloud.bigquery.analyticshub.v1.Listing

Namespace

Google \ Cloud \ BigQuery \ AnalyticsHub \ V1

Methods

__construct

Constructor.

Parameters
Name
Description
data
array

Optional. Data for populating the Message object.

↳ bigquery_dataset
Listing\BigQueryDatasetSource

Shared dataset i.e. BigQuery dataset source.

↳ pubsub_topic
Listing\PubSubTopicSource

Pub/Sub topic source.

↳ name
string

Output only. The resource name of the listing. e.g. projects/myproject/locations/us/dataExchanges/123/listings/456

↳ display_name
string

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

↳ description
string

Optional. Short description of the listing. The description must not contain Unicode non-characters and 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
string

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

↳ documentation
string

Optional. Documentation describing the listing.

↳ state
int

Output only. Current state of the listing.

↳ icon
string

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
DataProvider

Optional. Details of the data provider who owns the source data.

↳ categories
array

Optional. Categories of the listing. Up to two categories are allowed.

↳ publisher
Publisher

Optional. Details of the publisher who owns the listing and who can share the source data.

↳ request_access
string

Optional. Email or URL of the request access of the listing. Subscribers can use this reference to request access. Max Length: 1000 bytes.

↳ restricted_export_config
Listing\RestrictedExportConfig

Optional. If set, restricted export configuration will be propagated and enforced on the linked dataset.

↳ discovery_type
int

Optional. Type of discovery of the listing on the discovery page.

↳ resource_type
int

Output only. Listing shared asset type.

↳ commercial_info
Listing\CommercialInfo

Output only. Commercial info contains the information about the commercial data products associated with the listing.

↳ log_linked_dataset_query_user_email
bool

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

↳ allow_only_metadata_sharing
bool

Optional. If true, the listing is only available to get the resource metadata. Listing is non subscribable.

getBigqueryDataset

Shared dataset i.e. BigQuery dataset source.

Returns
Type
Description

hasBigqueryDataset

setBigqueryDataset

Shared dataset i.e. BigQuery dataset source.

Parameter
Name
Description
Returns
Type
Description
$this

getPubsubTopic

Pub/Sub topic source.

Returns
Type
Description

hasPubsubTopic

setPubsubTopic

Pub/Sub topic source.

Parameter
Name
Description
Returns
Type
Description
$this

getName

Output only. The resource name of the listing.

e.g. projects/myproject/locations/us/dataExchanges/123/listings/456

Returns
Type
Description
string

setName

Output only. The resource name of the listing.

e.g. projects/myproject/locations/us/dataExchanges/123/listings/456

Parameter
Name
Description
var
string
Returns
Type
Description
$this

getDisplayName

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

Returns
Type
Description
string

setDisplayName

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

Parameter
Name
Description
var
string
Returns
Type
Description
$this

getDescription

Optional. Short description of the listing. The description must not contain Unicode non-characters and 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.

Returns
Type
Description
string

setDescription

Optional. Short description of the listing. The description must not contain Unicode non-characters and 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.

Parameter
Name
Description
var
string
Returns
Type
Description
$this

getPrimaryContact

Optional. Email or URL of the primary point of contact of the listing.

Max Length: 1000 bytes.

Returns
Type
Description
string

setPrimaryContact

Optional. Email or URL of the primary point of contact of the listing.

Max Length: 1000 bytes.

Parameter
Name
Description
var
string
Returns
Type
Description
$this

getDocumentation

Optional. Documentation describing the listing.

Returns
Type
Description
string

setDocumentation

Optional. Documentation describing the listing.

Parameter
Name
Description
var
string
Returns
Type
Description
$this

getState

Output only. Current state of the listing.

Returns
Type
Description
int

setState

Output only. Current state of the listing.

Parameter
Name
Description
var
int
Returns
Type
Description
$this

getIcon

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.

Returns
Type
Description
string

setIcon

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.

Parameter
Name
Description
var
string
Returns
Type
Description
$this

getDataProvider

Optional. Details of the data provider who owns the source data.

Returns
Type
Description
DataProvider |null

hasDataProvider

clearDataProvider

setDataProvider

Optional. Details of the data provider who owns the source data.

Parameter
Name
Description
Returns
Type
Description
$this

getCategories

Optional. Categories of the listing. Up to two categories are allowed.

Returns
Type
Description

setCategories

Optional. Categories of the listing. Up to two categories are allowed.

Parameter
Name
Description
var
int[]
Returns
Type
Description
$this

getPublisher

Optional. Details of the publisher who owns the listing and who can share the source data.

Returns
Type
Description
Publisher |null

hasPublisher

clearPublisher

setPublisher

Optional. Details of the publisher who owns the listing and who can share the source data.

Parameter
Name
Description
var
Returns
Type
Description
$this

getRequestAccess

Optional. Email or URL of the request access of the listing.

Subscribers can use this reference to request access. Max Length: 1000 bytes.

Returns
Type
Description
string

setRequestAccess

Optional. Email or URL of the request access of the listing.

Subscribers can use this reference to request access. Max Length: 1000 bytes.

Parameter
Name
Description
var
string
Returns
Type
Description
$this

getRestrictedExportConfig

Optional. If set, restricted export configuration will be propagated and enforced on the linked dataset.

Returns
Type
Description

hasRestrictedExportConfig

clearRestrictedExportConfig

setRestrictedExportConfig

Optional. If set, restricted export configuration will be propagated and enforced on the linked dataset.

Parameter
Name
Description
Returns
Type
Description
$this

getDiscoveryType

Optional. Type of discovery of the listing on the discovery page.

Returns
Type
Description
int

hasDiscoveryType

clearDiscoveryType

setDiscoveryType

Optional. Type of discovery of the listing on the discovery page.

Parameter
Name
Description
var
int
Returns
Type
Description
$this

getResourceType

Output only. Listing shared asset type.

Returns
Type
Description
int

setResourceType

Output only. Listing shared asset type.

Parameter
Name
Description
var
int
Returns
Type
Description
$this

getCommercialInfo

Output only. Commercial info contains the information about the commercial data products associated with the listing.

Returns
Type
Description

hasCommercialInfo

clearCommercialInfo

setCommercialInfo

Output only. Commercial info contains the information about the commercial data products associated with the listing.

Parameter
Name
Description
Returns
Type
Description
$this

getLogLinkedDatasetQueryUserEmail

Optional. By default, false.

If true, the Listing has an email sharing mandate enabled.

Returns
Type
Description
bool

hasLogLinkedDatasetQueryUserEmail

clearLogLinkedDatasetQueryUserEmail

setLogLinkedDatasetQueryUserEmail

Optional. By default, false.

If true, the Listing has an email sharing mandate enabled.

Parameter
Name
Description
var
bool
Returns
Type
Description
$this

getAllowOnlyMetadataSharing

Optional. If true, the listing is only available to get the resource metadata. Listing is non subscribable.

Returns
Type
Description
bool

hasAllowOnlyMetadataSharing

clearAllowOnlyMetadataSharing

setAllowOnlyMetadataSharing

Optional. If true, the listing is only available to get the resource metadata. Listing is non subscribable.

Parameter
Name
Description
var
bool
Returns
Type
Description
$this

getSource

Returns
Type
Description
string
Design a Mobile Site
View Site in Mobile | Classic
Share by: