Commercialize listings on Google Cloud Marketplace

BigQuery sharing (formerly Analytics Hub) lets you offer and purchase data products through Google Cloud Marketplace. As a publisher, you can share BigQuery datasets on Cloud Marketplace at scale and configure paid, free, or trial subscription plans and durations without managing individual transactions.

As a subscriber, you can discover and consume Google and third-party commercial datasets through Cloud Marketplace. Before you continue, familiarize yourself with BigQuery sharing data exchanges.

Before you begin

  1. Grant Identity and Access Management (IAM) roles that give users the necessary permissions to perform each task in this document.
  2. Enable the Analytics Hub API.

Required roles

To get the permissions that you need to use Cloud Marketplace-integrated listings, ask your administrator to grant you the following IAM roles:

For more information about granting roles, see Manage access to projects, folders, and organizations.

You might also be able to get the required permissions through custom roles or other predefined roles.

Enable the Analytics Hub API

To enable the Analytics Hub API, select one of the following options:

Console

Go to the Analytics Hub API page and enable the Analytics Hub API for your Google Cloud project.

Enable the API

gcloud

Enable the Analytics Hub API by using the gcloud services enable command:

gcloud services enable analyticshub.googleapis.com

After you enable the Analytics Hub API, you can view the Sharing (Analytics Hub) page in the Google Cloud console.

Limitations

Cloud Marketplace-integrated listings have the following limitations:

Architecture and terminology

The following diagram shows the interaction between Cloud Marketplace and BigQuery sharing for commercial listings:

A subscriber purchases a BigQuery sharing listing on Cloud Marketplace to create a linked dataset.

Data product on Cloud Marketplace

To create a Cloud Marketplace data product listing, you select a BigQuery sharing listing, choose a pricing model, and submit the product to Cloud Marketplace for review.

Cloud Marketplace-integrated listing on BigQuery sharing

When Cloud Marketplace approves and publishes the data product listing, your BigQuery sharing listing becomes a Cloud Marketplace-integrated listing. Approval creates an integration link between BigQuery sharing and Cloud Marketplace and makes the listing eligible for purchase. This type of BigQuery sharing listing supports shared datasets.

Linked resource

When you subscribe to a Cloud Marketplace-integrated listing, BigQuery sharing creates a linked resource in your subscriber project. Active Cloud Marketplace orders manage access to the linked resource. Cloud Marketplace-integrated listings support linked datasets.

Create a Cloud Marketplace-integrated listing

To create a BigQuery sharing listing and publish it on Cloud Marketplace, do the following:

  1. In the Google Cloud console, go to the Sharing (Analytics Hub) page.

    Go to Sharing (Analytics Hub)

  2. Create a BigQuery sharing data exchange. Alternatively, to retain existing subscriptions, select an existing data exchange.

  3. Create listings in the data exchange. Alternatively, to retain existing subscriptions, select existing listings.

  4. In the row of your listing, click More actions > List on Marketplace. You're redirected to the Cloud Marketplace Producer Portal.

  5. To onboard your BigQuery sharing listing as a data product, follow the instructions in the Cloud Marketplace Producer Portal.

  6. Return to the Sharing (Analytics Hub) page. In the row of your listing, Not Published appears in the Marketplace column, indicating that you created and submitted your data product for approval. To check the approval status in the Cloud Marketplace Producer Portal, click Not Published.

  7. After your data product is approved, Published appears in the Marketplace column. To view the listing in Cloud Marketplace, click Published.

For additional requirements, see Offer software on Cloud Marketplace.

Update a Cloud Marketplace-integrated listing

Updating a Cloud Marketplace-integrated listing follows the same process as updating a standard listing in a data exchange. You might also need to update the data product listing in the Cloud Marketplace Producer Portal, which might require another review and approval.

Manage subscriptions for a Cloud Marketplace-integrated listing

Cloud Marketplace orders manage commercial subscriptions to Cloud Marketplace-integrated listings. You can still manually add and update BigQuery sharing subscribers by following the standard process for granting users access to a data exchange. However, the associated Cloud Marketplace transactions don't take place.

You can also manually revoke subscriptions by following the standard process for revoking a subscription and entering your Cloud Marketplace service ID to accept the warning notification. However, revoking commercial subscriptions might affect your customers and violate the Cloud Marketplace Terms of Service. Additionally, revoking subscriptions doesn't remove the listing from BigQuery sharing or Cloud Marketplace.

Offboard a Cloud Marketplace-integrated listing

To offboard a commercial Cloud Marketplace-integrated listing, you must manage the lifecycle of the associated product in the Cloud Marketplace Producer Portal.

Offboarding removes the commercial traits from a listing and converts it to a standard, non-commercial listing. This process helps ensure that you meet existing contractual obligations to subscribers before commercialization ends.

To offboard a Cloud Marketplace-integrated listing, do the following:

  1. In the Producer Portal, request deprecation of your listing.

  2. Wait for the deprecation date to pass. After the deprecation date passes, the Cloud Marketplace listing is permanently deleted.

  3. Delete the product from the Producer Portal.

After a BigQuery sharing listing is fully offboarded, it functions as a standard, non-commercial listing. You can keep the listing for internal or free sharing, or delete the listing.

Delete a Cloud Marketplace-integrated listing

To delete a Cloud Marketplace-integrated listing from BigQuery sharing and Cloud Marketplace, do the following:

  1. Revoke all commercial subscriptions for your Cloud Marketplace-integrated listing by following the standard process for revoking a subscription. You can't delete Cloud Marketplace-integrated listings with active commercial subscriptions.
  2. Follow the standard process to delete a listing.
  3. When you're prompted with a warning notification, enter your Cloud Marketplace service ID to accept, and then click Confirm.

Subscribe to a Cloud Marketplace-integrated listing

To subscribe to a BigQuery sharing listing on Cloud Marketplace, do the following:

  1. In the Google Cloud console, go to the Sharing (Analytics Hub) page.

    Go to Sharing (Analytics Hub)

  2. Click Search listings.

  3. Search for the listing that you want to subscribe to. To discover commercial listings on Cloud Marketplace, apply the Listings > Marketplace filter.

  4. Click the listing.

  5. If your organization has already purchased the listing, which means that the Subscribe button and purchase date are visible, do the following:

    1. Click Subscribe.
    2. Specify the project and linked dataset name.
    3. Click Save.

    If you don't have permission to subscribe to listings, click Request access and submit the request form.

  6. If your organization hasn't purchased the listing, which means that the Purchase via Marketplace button is visible, do the following:

    1. Click Purchase via Marketplace.
    2. Click Subscribe.
    3. On the Order summary page, specify your subscription plan and purchase details, and if you agree to the terms, accept them.
    4. Click Subscribe, and then click Go to product page.
    5. Wait a few minutes. After your order is activated, click Manage on BigQuery sharing (Analytics Hub). You're redirected back to the Sharing (Analytics Hub) page.
    6. On the BigQuery sharing listing page, click Subscribe.
    7. Specify the project and linked dataset name.
    8. Click Save.

    To get a quote for some listings, you might have to contact the sales team by submitting a form.

Any project with the same billing account can also subscribe to the listing.

Pricing

Standard BigQuery sharing pricing applies. Additionally, the Cloud Marketplace revenue sharing requirement applies for Cloud Marketplace-integrated listings. For more information about how publishers charge BigQuery sharing subscribers for using data products, see Managing billing for Cloud Marketplace products.

What's next