Exporter et consulter votre empreinte carbone à l'aide d'une API
Empreinte carbone ne dispose pas d'API publique dédiée. Toutefois, vous pouvez exporter votre empreinte carbone via l'API Data Transfer Service de BigQuery, puis interroger les données à l'aide de l'API BigQuery.
Utiliser l'API du service de transfert de données BigQuery
Pour appeler l'API du service de transfert de données BigQuery, vous pouvez utiliser les bibliothèques clientes fournies ou appeler directement l'API REST.
La documentation ci-dessous explique comment créer des configurations de transfert et des remplissages pour l'empreinte carbone à l'aide de l'API REST. Toutefois, pour plus de commodité, vous pouvez effectuer les appels d'API équivalents à l'aide de la bibliothèque cliente dans le langage de votre choix.
Créer une exportation via l'API REST
Appelez le point de terminaison transferConfigs.create
de l'API du service de transfert de données BigQuery pour créer un transfert, en utilisant la charge utile suivante:
{
"dataSourceId": "61cede5a-0000-2440-ad42-883d24f8f7b8",
"displayName": "NAME",
"params": {
"billing_accounts": "BILLING_ACCOUNT_IDS"
},
"destinationDatasetId": "DATASET"
}
Remplacez :
- NAME par le nom de votre configuration de transfert. Par exemple: "Rapport carbone de l'entreprise".
- BILLING_ACCOUNT_IDS par votre ID de compte de facturation. Cette valeur peut être une liste d'ID de compte de facturation séparés par une virgule. Exemple :
XXXXXX-XXXXXX-XXXXXX,XXXXXX-XXXXXX-XXXXXX
. - DATASET par l'ID de l'ensemble de données BigQuery de destination dans le projet actuel. Par exemple :
company_carbon_report
Une fois la configuration de transfert créée, les données carbone sont automatiquement exportées le 15 du mois pour tous les mois à venir. Pour exporter des données historiques, consultez les informations ci-dessous.
Exécuter un remplissage de données historiques via l'API REST
Pour exporter des données carbone historiques pour une configuration de transfert existante (voir ci-dessus), vous devez demander un remplissage sur votre configuration de transfert.
Pour créer un remplissage, envoyez une requête POST
au point de terminaison transferConfigs.startManualRuns
, en utilisant l'identifiant du transfert créé à l'étape précédente (par exemple, projects/0000000000000/locations/us/transferConfigs/00000000-0000-0000-0000-000000000000
) et la charge utile suivante:
{
"requestedTimeRange": {
"startTime": "<var>START_TIME</var>",
"endTime": "<var>END_TIME</var>"
}
}
Où :
- START_TIME est un horodatage qui spécifie l'heure de début de la plage à remplir.
Par exemple :
2021-02-15T00:00:00Z
. Notez que le 15 février 2021 est la date la plus proche que vous pouvez spécifier ici, car elle contient les données de janvier 2021. - END_TIME est un horodatage qui spécifie l'heure de fin de la plage à remplir.
Par exemple :
2022-09-15T00:00:00Z
. Vous pouvez utiliser la date actuelle.
Interroger une exportation existante via l'API
Avant d'interroger l'API, écrivez une requête SQL qui renvoie les données souhaitées de l'ensemble de données exporté. Vous pouvez tester la requête SQL dans la console BigQuery.
Après avoir configuré une exportation vers BigQuery, exécutez la requête à l'aide de l'API BigQuery ou des bibliothèques BigQuery.
Étape suivante
- Consultez la présentation des API et bibliothèques BigQuery.
- Découvrez comment exécuter des requêtes interactives et par lot.