APIHub
Back to Explore

Analytics Hub API

The Analytics Hub API lets you create, list, retrieve, update, and delete Data Exchanges and their Listings, subscribe to a Listing (which creates a linked BigQuery dataset for the subscriber), and manage IAM policies for these resources.

Analytics
OAuth
HTTPS
CORS: Unknown
Description enriched
Visit official documentation

Latency

24ms p95

Uptime

100.0% 30d

Playground

Verified

live

Endpoints

REST · JSON
POST

/v1/{parent}/dataExchanges

Creates a new data exchange.

  • parent (path, required) — Required. The parent resource path of the data exchange. e.g. `projects/myproject/locations/US`.
  • dataExchangeId (query) — Required. The ID of the data exchange. Must contain only Unicode letters, numbers (0-9), underscores (_). Should not use characters that require URL-escaping, or characters outside of ASCII, spaces. Max length: 100 bytes.
DELETE

/v1/{name}

Deletes a listing.

  • name (path, required) — Required. Resource name of the listing to delete. e.g. `projects/myproject/locations/US/dataExchanges/123/listings/456`.
GET

/v1/{name}

Gets the details of a listing.

  • name (path, required) — Required. The resource name of the listing. e.g. `projects/myproject/locations/US/dataExchanges/123/listings/456`.
PATCH

/v1/{name}

Updates an existing listing.

  • name (path, required) — Output only. The resource name of the listing. e.g. `projects/myproject/locations/US/dataExchanges/123/listings/456`
  • updateMask (query) — Required. Field mask specifies the fields to update in the listing resource. The fields specified in the `updateMask` are relative to the resource and are not a full request.
POST

/v1/{name}:subscribe

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.

  • name (path, required) — Required. Resource name of the listing that you want to subscribe to. e.g. `projects/myproject/locations/US/dataExchanges/123/listings/456`.
GET

/v1/{organization}/dataExchanges

Lists all data exchanges from projects in a given organization and location.

  • organization (path, required) — Required. The organization resource path of the projects containing DataExchanges. e.g. `organizations/myorg/locations/US`.
  • pageSize (query, limit) — The maximum number of results to return in a single response page. Leverage the page tokens to iterate through the entire collection.
  • pageToken (query) — Page token, returned by a previous call, to request the next page of results.
GET

/v1/{parent}/dataExchanges

Lists all data exchanges in a given project and location.

  • parent (path, required) — Required. The parent resource path of the data exchanges. e.g. `projects/myproject/locations/US`.
  • pageSize (query, limit) — The maximum number of results to return in a single response page. Leverage the page tokens to iterate through the entire collection.
  • pageToken (query) — Page token, returned by a previous call, to request the next page of results.
GET

/v1/{parent}/listings

Lists all listings in a given project and location.

  • parent (path, required) — Required. The parent resource path of the listing. e.g. `projects/myproject/locations/US/dataExchanges/123`.
  • pageSize (query, limit) — The maximum number of results to return in a single response page. Leverage the page tokens to iterate through the entire collection.
  • pageToken (query) — Page token, returned by a previous call, to request the next page of results.
POST

/v1/{parent}/listings

Creates a new listing.

  • parent (path, required) — Required. The parent resource path of the listing. e.g. `projects/myproject/locations/US/dataExchanges/123`.
  • listingId (query) — Required. The ID of the listing to create. Must contain only Unicode letters, numbers (0-9), underscores (_). Should not use characters that require URL-escaping, or characters outside of ASCII, spaces. Max length: 100 bytes.
POST

/v1/{resource}:getIamPolicy

Gets the IAM policy.

  • resource (path, required) — REQUIRED: The resource for which the policy is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.
POST

/v1/{resource}:setIamPolicy

Sets the IAM policy.

  • resource (path, required) — REQUIRED: The resource for which the policy is being specified. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.
POST

/v1/{resource}:testIamPermissions

Returns the permissions that a caller has.

  • resource (path, required) — REQUIRED: The resource for which the policy detail is being requested. See [Resource names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this field.

12 endpoints auto-detected

Authentication

This API requires authentication: OAuth.

curl -X POST \
  "https://analyticshub.googleapis.com/v1/{parent}/dataExchanges"

analyticshub.googleapis.com · HTTPS only