Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Abos verwalten
Als Analytics Hub-Abonnent können Sie die folgenden Aufgaben ausführen:
Eintrag abonnieren
Aktuelle Abos in einem bestimmten Projekt auflisten
Ein Abo löschen
Als Analytics Hub-Publisher können Sie die folgenden Aufgaben ausführen:
Alle Abos Ihres Eintrags ansehen
Zugriff auf ein bestimmtes Abo widerrufen
Ein Abo ist eine regionalisierte Ressource, die sich im Projekt des Abonnenten befindet. Abos speichern relevante Informationen zum Abonnenten und stellen den Vertrag zwischen Publisher und Abonnent dar.
Hinweise
Damit Sie BigQuery Sharing (früher Analytics Hub) verwenden können, müssen Sie die Analytics Hub API in Ihrem Projekt aktivieren. Google Cloud
Erforderliche Berechtigungen
Zum Aktivieren der Analytics Hub API benötigen Sie die folgenden IAM-Berechtigungen (Identity and Access Management):
serviceUsage.services.get
serviceUsage.services.list
serviceUsage.services.enable
Die folgende vordefinierte IAM-Rolle enthält die Berechtigungen, die Sie zum Aktivieren der Analytics Hub API benötigen:
GET https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/subscriptions
Ersetzen Sie Folgendes:
PROJECT_ID: die Projekt-ID, die die Abos enthält, die Sie auflisten möchten.
LOCATION: der Standort, für den Sie die vorhandenen Abos auflisten möchten.
Publisher-Workflow
Publisher können für Abos die folgenden Aktionen ausführen. Weitere Informationen zum Verwalten von Abos für Einträge finden Sie unter Einträge verwalten.
Abos auflisten
Führen Sie zum Auflisten aller Abos die folgenen Schritte aus.
Console
Rufen Sie in der Google Cloud Console die Seite Freigabe (Analytics Hub) auf.
POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/subscriptions/SUBSCRIPTION_ID:revoke
Ersetzen Sie Folgendes:
PROJECT_ID: die Projekt-ID des Abos, das Sie entfernen möchten.
LOCATION: der Standort des Abos.
SUBSCRIPTION_ID: die ID des Abos, das Sie entfernen möchten.
Beschränkungen
Abos unterliegen den folgenden Beschränkungen:
Verknüpfte Datasets, die vor dem 25. Juli 2023 erstellt wurden, werden nicht per Backfill ausgefüllt. Nur Abos, die nach dem 25. Juli 2023 erstellt wurden, funktionieren mit den API-Methoden.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Schwer verständlich","hardToUnderstand","thumb-down"],["Informationen oder Beispielcode falsch","incorrectInformationOrSampleCode","thumb-down"],["Benötigte Informationen/Beispiele nicht gefunden","missingTheInformationSamplesINeed","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-08-17 (UTC)."],[[["\u003cp\u003eAnalytics Hub subscribers can subscribe to listings, list their current subscriptions, and delete subscriptions within a project.\u003c/p\u003e\n"],["\u003cp\u003eAnalytics Hub publishers can view all subscriptions to their listings and revoke access to specific subscriptions.\u003c/p\u003e\n"],["\u003cp\u003eEnabling the Analytics Hub API in your Google Cloud project requires specific Identity and Access Management (IAM) permissions or the \u003ccode\u003eroles/serviceusage.serviceUsageAdmin\u003c/code\u003e role.\u003c/p\u003e\n"],["\u003cp\u003eManaging subscriptions requires the Analytics Hub Subscription Owner role (\u003ccode\u003eroles/analyticshub.subscriptionOwner\u003c/code\u003e).\u003c/p\u003e\n"],["\u003cp\u003eSubscriptions are regionalized resources that store subscriber information and represent the contract between the publisher and subscriber.\u003c/p\u003e\n"]]],[],null,["# Manage subscriptions\n====================\n\nAs an *Analytics Hub subscriber*, you can perform the following\ntasks:\n\n- Subscribe to a listing.\n- List your current subscriptions in a given project.\n- Delete a subscription.\n\nAs an *Analytics Hub publisher*, you can perform the following\ntasks:\n\n- View all subscriptions to your listing.\n- Revoke access to a specific subscription.\n\nA subscription is a regionalized resource which resides in the subscriber's\nproject. Subscriptions store relevant information about the subscriber and\nrepresents the contract between publisher and subscriber.\n\nBefore you begin\n----------------\n\nTo get started with BigQuery sharing (formerly Analytics Hub), you need to\nenable the Analytics Hub API inside your Google Cloud project.\n\n### Required permissions\n\nTo enable the Analytics Hub API, you need the following\nIdentity and Access Management (IAM) permissions:\n\n- `serviceUsage.services.get`\n- `serviceUsage.services.list`\n- `serviceUsage.services.enable`\n\nThe following predefined IAM role includes the\npermissions that you need to enable the Analytics Hub API:\n\n- `roles/serviceusage.serviceUsageAdmin`\n\nFor more information about IAM roles in BigQuery,\nsee [Predefined roles and permissions](https://cloud.google.com/bigquery/docs/access-control).\n\n### Enable the Analytics Hub API\n\nTo enable the Analytics Hub API, do the following: \n\n### Console\n\nGo to the **Analytics Hub API** page and enable the Analytics Hub API for\nyour Google Cloud project.\n\n[Enable the Analytics Hub API](https://console.cloud.google.com/apis/library/analyticshub.googleapis.com)\n\n### gcloud\n\nRun the [gcloud services enable](/sdk/gcloud/reference/services/enable)\ncommand: \n\n```\ngcloud services enable analyticshub.googleapis.com\n```\n\nRequired permissions\n--------------------\n\nTo manage subscriptions, you must have one of the following\nBigQuery sharing (formerly Analytics Hub) roles:\n\n- Analytics Hub Subscription Owner role (`roles/analyticshub.subscriptionOwner`), which lets you manage subscriptions that you create.\n\nFor more information, see [Analytics Hub user roles](/bigquery/docs/analytics-hub-grant-roles#user_roles).\n\nSubscriber workflow\n-------------------\n\nSubscribers can perform the following actions with subscriptions.\n\n### Subscribe to listings\n\nTo subscribe to listings, follow the steps in [Subscribe to listings](/bigquery/docs/analytics-hub-view-subscribe-listings#subscribe-listings).\n\n### List subscriptions\n\nTo list all subscriptions, follow these steps. \n\n### API\n\nTo view your current subscriptions in a given project, use the\n[`projects.locations.subscriptions.list`](/bigquery/docs/reference/analytics-hub/rest/v1/projects.locations.subscriptions/list)\nmethod. \n\n```\nGET https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/subscriptions\n```\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e: the project ID that contains the\n subscriptions that you want to list.\n\n- \u003cvar translate=\"no\"\u003eLOCATION\u003c/var\u003e: the location for which you want to list\n the existing subscriptions.\n\nPublisher workflow\n------------------\n\nPublishers can perform the following actions with subscriptions. For more\ninformation about managing subscriptions to listings, see [Manage\nlistings](/bigquery/docs/analytics-hub-manage-listings).\n\n### List subscriptions\n\nTo list all subscriptions, follow these steps. \n\n### Console\n\n1. In the Google Cloud console, go to the **Sharing (Analytics Hub)** page.\n\n [Go to Sharing (Analytics Hub)](https://console.cloud.google.com/bigquery/analytics-hub)\n\n A page appears that lists all the\n [data exchanges](/bigquery/docs/analytics-hub-introduction#data_exchanges)\n that you can access.\n2. Click the data exchange name in which you want to list the subscriptions.\n\n3. Click the **Subscriptions** tab to view all the subscriptions to listings\n within the data exchange.\n\n### API\n\nTo list subscriptions of Listings in a particular Data Exchange, use the\n[`projects.locations.dataExchanges.listSubscriptions`](/bigquery/docs/reference/analytics-hub/rest/v1/projects.locations.dataExchanges/listSubscriptions)\nmethod. \n\n```\nGET https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges/DATAEXCHANGE_ID:listSubscriptions\n```\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e: the project ID of the Data Exchange for which you want to list the subscriptions want to remove.\n- \u003cvar translate=\"no\"\u003eLOCATION\u003c/var\u003e: the location of the Data Exchange.\n- \u003cvar translate=\"no\"\u003eDATAEXCHANGE_ID\u003c/var\u003e: the ID of the Data Exchange for which you want to list the subscriptions.\n\n### Remove a subscription\n\n**Note:** Revoking [Cloud Marketplace-integrated commercial subscriptions](/bigquery/docs/analytics-hub-cloud-marketplace) might impact your customers and violate the [Cloud Marketplace Terms of Service](/terms/marketplace/launcher). \n\n### Console\n\n1. In the Google Cloud console, go to the **Sharing (Analytics Hub)** page.\n\n [Go to Sharing (Analytics Hub)](https://console.cloud.google.com/bigquery/analytics-hub)\n\n A page appears that lists all data exchanges that you can access.\n2. Click the data exchange name in which you want to create the listing.\n\n3. Click the **Subscriptions** tab to view all the subscriptions to the data\n exchange.\n\n4. Select the checkbox next to the subscriptions you wish to remove, or select\n all subscriptions.\n\n5. Click **Remove subscriptions**.\n\n### API\n\nTo remove a subscription, use the [`projects.locations.subscriptions.revoke`](/bigquery/docs/reference/analytics-hub/rest/v1/projects.locations.subscriptions/revoke)\nmethod. \n\n```\nPOST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/subscriptions/SUBSCRIPTION_ID:revoke\n```\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e: the project ID of the subscription that you want to remove.\n- \u003cvar translate=\"no\"\u003eLOCATION\u003c/var\u003e: the location of the subscription.\n- \u003cvar translate=\"no\"\u003eSUBSCRIPTION_ID\u003c/var\u003e: the ID of the subscription that you want to remove.\n\nLimitations\n-----------\n\nSubscriptions are subject to the following limitations:\n\n- Linked datasets created before July 25, 2023 are not backfilled. Only subscriptions created after July 25, 2023 work with the API methods.\n\nWhat's next\n-----------\n\n- Read about [Sharing architecture](/bigquery/docs/analytics-hub-introduction#architecture)\n- Learn how to [view and subscribe to listings](/bigquery/docs/analytics-hub-view-subscribe-listings).\n- Learn about [Analytics Hub user roles](/bigquery/docs/analytics-hub-grant-roles#user_roles).\n- Learn about [creating datasets](/bigquery/docs/datasets).\n- Learn about [Sharing audit logging](/bigquery/docs/analytics-hub-audit-logging)."]]
