# Google Cloud Analytics Hub
{% hint style="info" %}
**Note**
This document covers the use case of sharing data you have housed within Google BigQuery with Clario.
{% endhint %}
## What is Analytics Hub
Google [Analytics Hub](https://cloud.google.com/bigquery/docs/analytics-hub-introduction) allows you to efficiently and securely exchange data artifacts across organizations to address challenges of data reliability, governance, and cost.
### Benefits
#### Save costs and efficiently share and exchange data
Analytics Hub builds on the scalability and flexibility of BigQuery to streamline how you consume data provided by Clario. Data can be quickly incorporated into an existing Google Cloud project; data is only stored once. Clario is billed directly for its analysis against your shared data.
#### Centralized management of data and analytics assets
Analytics Hub streamlines the accessibility of data and analytics assets. Permissions are simple and straightforward.
#### Private and secure sharing with governance
Data shared within Analytics Hub automatically includes in-depth governance, encryption, and security from BigQuery.
### Limitations
Technology is about measured tradeoffs to meet the set of features you endeavor to deliver.
Google provides excellent [documentation](https://cloud.google.com/bigquery/docs/analytics-hub-introduction#limitations) detailing limitations for publishers and interoperability limitations for subscribers.
## Getting Started
To get started, open the GCP console and navigate to *BigQuery -> Analytics Hub*. You may need to enable the Analytics Hub API.
If you see me, click Enable
{% hint style="info" %}
**Don't panic**
When you open Analytics Hub, you will see all data exchanges active in your organization. This is expected -- the important detail is the project associated with each exchange.
{% endhint %}
## Permission Model
Analytics Hub supports five standard roles:
| Name | Description |
| --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| Analytics Hub Admin | Grants users permission to manage data exchanges and listings. |
| Analytics Hub Listing Admin | Grants full control over listings for a data exchange, including updating, deleting, and setting ACLs. |
| Analytics Hub Publisher | Grants users permission to publish and manager their own listings. |
| Analytics Hub Subscriber | Grants users the permission to subscribe to a given listing. This is the most common role to assign external partners whom you are sharing data with. |
| Analytics Hub Viewer | Grants users permission to view listings and exchange permissions. |
## Creating an Analytics Hub
1. In the GCP Console, open the desired project and navigate to *BigQuery -> Analytics Hub*.
2. Click *Create Exchange*.
3. Complete the Exchange Configuration (sample below).
4. Click *Create Exchange*.
5. Set desired Exchange Permissions.
{% hint style="info" %}
**Note**
Permissions granted at the data exchange level will be inherited by all listings within it.
{% endhint %}
| Field | Sample Value |
| --------------- | --------------------------------------------------------------------- |
| Project | Should be automatically filled with the project you are currently in. |
| Region | Set as appropriate for your business needs. |
| Display Name | We suggest a meaningful name to keep intent clear. |
| Primary Contact | Should be a valid and monitored email address. |
| Description | Optional |
## Adding a Listing
1. Navigate into the Data Exchange you want to add a listing to.
2. Click *Create Listing.*
3. Complete the listing configuration (sample below).
4. Click *Save*.
## Controlling Access
Access is controlled at both the Exchange and Listing level. [Permissions](#permission-model) at each level are consistent, however, grants at the Exchange level are inherited by all listings within.
## Auditing Usage
Google provides visibility into listing subscriptions within a data exchange. From the GCP Console, navigate to *BigQuery -> Analytics Hub*. Click the vertical ellipsis to expose the listing context menu and select *Manage subscriptions*.
A list of subscriptions will be displayed showing subscriber project number, subscriber project, and subscriber dataset. If desired, subscriptions can be removed individually or en masse.
{% hint style="info" %}
**Know this**
When you remove a subscription from your listings, the [linked dataset](https://cloud.google.com/bigquery/docs/analytics-hub-introduction#listings) is unlinked from the [shared dataset](https://cloud.google.com/bigquery/docs/analytics-hub-introduction#shared_datasets). Subscribers can still see the datasets in their projects but they are no longer linked with the shared dataset. Users cannot query an unlinked dataset.
{% endhint %}
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.clar.io/connecting-your-data/first-party/google-cloud-analytics-hub.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.