listings

Overview

Name	listings
Type	Resource
Id	google.analyticshub.listings

Fields

Name	Datatype	Description
name	string	Output only. The resource name of the listing. e.g. projects/myproject/locations/US/dataExchanges/123/listings/456
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.
bigqueryDataset	object	A reference to a shared dataset. It is an existing BigQuery dataset with a collection of objects such as tables and views that you want to share with subscribers. When subscriber's subscribe to a listing, Analytics Hub 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.
categories	array	Optional. Categories of the listing. Up to two categories are allowed.
dataProvider	object	Contains details of the data provider.
displayName	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.
documentation	string	Optional. Documentation describing 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.
primaryContact	string	Optional. Email or URL of the primary point of contact of the listing. Max Length: 1000 bytes.
publisher	object	Contains details of the listing publisher.
requestAccess	string	Optional. Email or URL of the request access of the listing. Subscribers can use this reference to request access. Max Length: 1000 bytes.
restrictedExportConfig	object	Restricted export config, used to configure restricted export on linked dataset.
state	string	Output only. Current state of the listing.

Methods

Name	Accessible by	Required Params	Description
projects_locations_data_exchanges_listings_get	SELECT	dataExchangesId, listingsId, locationsId, projectsId	Gets the details of a listing.
projects_locations_data_exchanges_listings_list	SELECT	dataExchangesId, locationsId, projectsId	Lists all listings in a given project and location.
projects_locations_data_exchanges_listings_create	INSERT	dataExchangesId, locationsId, projectsId	Creates a new listing.
projects_locations_data_exchanges_listings_delete	DELETE	dataExchangesId, listingsId, locationsId, projectsId	Deletes a listing.
_projects_locations_data_exchanges_listings_list	EXEC	dataExchangesId, locationsId, projectsId	Lists all listings in a given project and location.
projects_locations_data_exchanges_listings_patch	EXEC	dataExchangesId, listingsId, locationsId, projectsId	Updates an existing listing.
projects_locations_data_exchanges_listings_subscribe	EXEC	dataExchangesId, listingsId, locationsId, projectsId	Subscribes to a listing. Currently, with Analytics Hub, you can create listings that reference only BigQuery datasets. Upon subscription to a listing for a BigQuery dataset, Analytics Hub creates a linked dataset in the subscriber's project.