Gérer les abonnements

En tant qu'abonné Analytics Hub, vous pouvez effectuer les tâches suivantes :

  • S'abonner à une fiche.
  • Regrouper vos abonnements actuels dans un projet donné.
  • Supprimez un abonnement.

En tant qu'éditeur Analytics Hub, vous pouvez effectuer les tâches suivantes:

  • Afficher tous les abonnements de votre fiche.
  • Révoquer l'accès à un abonnement spécifique.

Un abonnement est une ressource régionalisée qui réside dans le projet de l'abonné. Les abonnements stockent des informations pertinentes sur l'abonné et représentent le contrat entre l'éditeur et l'abonné.

Avant de commencer

Pour commencer à utiliser Analytics Hub, vous devez activer l'API Analytics Hub dans votre projet Google Cloud.

Autorisations requises

Pour activer l'API Analytics Hub, vous devez disposer des autorisations IAM (Identity and Access Management) suivantes :

  • serviceUsage.services.get
  • serviceUsage.services.list
  • serviceUsage.services.enable

Le rôle IAM prédéfini suivant inclut les autorisations dont vous avez besoin pour activer l'API Analytics Hub :

  • roles/serviceusage.serviceUsageAdmin

Pour en savoir plus sur les rôles IAM dans BigQuery, consultez la page Rôles prédéfinis et autorisations.

Activer l'API Analytics Hub

Pour activer l'API Analytics Hub, procédez comme suit :

Console

Accédez à l'API Analytics Hub pour votre projet Google Cloud et activez-la.

Activer l'API Analytics Hub

gcloud

Exécutez la commande gcloud services enable :

gcloud services enable analyticshub.googleapis.com

Autorisations requises

Pour gérer les abonnements, vous devez disposer de l'un des rôles Analytics Hub suivants :

  • Le rôle "Propriétaire de l'abonnement Analytics Hub" (roles/analyticshub.subscriptionOwner), qui vous permet de gérer les abonnements que vous créez.

Pour en savoir plus, consultez la section Rôles utilisateur Analytics Hub.

Workflow pour les abonnés

Les abonnés peuvent effectuer les actions suivantes avec les abonnements.

S'abonner à des fiches

Pour vous abonner à des fiches, suivez les étapes décrites dans la section S'abonner à des fiches.

Répertorier les abonnements

Pour répertorier tous les abonnements, procédez comme suit :

API

Pour afficher vos abonnements actuels dans un projet donné, utilisez la méthode projects.locations.subscriptions.list.

GET https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/subscriptions

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projet contenant les abonnements que vous souhaitez regrouper.

  • LOCATION : emplacement pour lequel vous souhaitez regrouper les abonnements existants.

Workflow pour les éditeurs

Les éditeurs peuvent effectuer les actions suivantes avec les abonnements. Pour en savoir plus sur la gestion des abonnements associés aux fiches, consultez la section Gérer les fiches.

Répertorier les abonnements

Pour répertorier tous les abonnements, procédez comme suit :

Console

  1. Dans la console Google Cloud, accédez à la page Analytics Hub.

    Accéder à Analytics Hub

    Une page qui répertorie tous les échanges de données auxquels vous pouvez accéder s'affiche.

  2. Cliquez sur le nom de l'échange de données dans lequel vous souhaitez regrouper les abonnements.

  3. Cliquez sur l'onglet Abonnements pour afficher tous les abonnements associés aux fiches de l'échange de données.

API

Pour répertorier les abonnements de fiches dans un échange de données particulier, utilisez la méthode projects.locations.dataExchanges.listSubscriptions.

GET https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges/DATAEXCHANGE_ID:listSubscriptions

Remplacez les éléments suivants :

  • PROJECT_ID : ID de projet de l'échange de données pour lequel vous souhaitez répertorier les abonnements à supprimer.
  • LOCATION : emplacement de l'échange de données.
  • DATAEXCHANGE_ID : ID de l'échange de données pour lequel vous souhaitez répertorier les abonnements.

Supprimer un abonnement

Console

  1. Dans la console Google Cloud, accédez à la page Analytics Hub.

    Accéder à Analytics Hub

    Une page qui répertorie tous les échanges de données auxquels vous pouvez accéder s'affiche.

  2. Cliquez sur le nom de l'échange de données dans lequel vous souhaitez créer la fiche.

  3. Cliquez sur l'onglet Abonnements pour afficher tous les abonnements de l'échange de données.

  4. Cochez la case à côté des abonnements que vous souhaitez supprimer ou sélectionnez tous les abonnements.

  5. Cliquez sur Supprimer les abonnements.

API

Pour retirer un abonnement, utilisez la méthode projects.locations.subscriptions.revoke.

POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/subscriptions/SUBSCRIPTION_ID:revoke

Remplacez les éléments suivants :

  • PROJECT_ID : ID de projet de l'abonnement que vous souhaitez supprimer.
  • LOCATION : emplacement de l'abonnement.
  • SUBSCRIPTION_ID : ID de l'abonnement que vous souhaitez supprimer.

Limites

Les abonnements sont soumis aux limites suivantes :

  • Les ensembles de données associés ayant été créés avant le 25 juillet 2023 ne sont pas remplis. Seuls les abonnements créés après le 25 juillet 2023 sont compatibles avec les méthodes d'API.

Étapes suivantes