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.
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"