API를 사용하여 탄소 발자국 내보내기 및 읽기

탄소 발자국에는 전용 공개 API가 없습니다. 그러나 BigQuery Data Transfer Service API를 통해 탄소 발자국을 내보내고 BigQuery API를 사용하여 데이터를 쿼리할 수 있습니다.

BigQuery Data Transfer Service API 사용

BigQuery Data Transfer Service API를 호출하려면 제공된 클라이언트 라이브러리 또는 REST API를 직접 호출할 수 있습니다.

아래 문서에서는 REST API를 사용하여 탄소 발자국 전송 구성 및 백필을 만드는 방법을 설명합니다. 그러나 편의를 위해 원하는 언어의 클라이언트 라이브러리를 사용해서 상응하는 API 호출을 수행할 수도 있습니다.

REST API를 통해 내보내기 만들기

다음 페이로드를 사용해서 BigQuery Data Transfer Service API의 transferConfigs.create 엔드포인트를 호출하여 전송을 만듭니다.

{
  "dataSourceId": "61cede5a-0000-2440-ad42-883d24f8f7b8",
  "displayName": "NAME",
  "params": {
    "billing_accounts": "BILLING_ACCOUNT_IDS"
  },
  "destinationDatasetId": "DATASET"
}

다음과 같이 바꿉니다.

  • NAME을 전송 구성 이름으로 바꿉니다. 예를 들면 '회사 탄소 보고서'입니다.
  • BILLING_ACCOUNT_IDS를 청구 계정 ID로 바꿉니다. 이 값은 쉼표로 구분된 청구 계정 ID 목록일 수 있습니다. 예를 들면 XXXXXX-XXXXXX-XXXXXX,XXXXXX-XXXXXX-XXXXXX입니다.
  • DATASET를 현재 프로젝트의 대상 BigQuery 데이터 세트 ID로 바꿉니다. 예를 들면 company_carbon_report입니다.

전송 구성이 생성되면 이후 모든 달에 대해 익월 15일에 탄소 데이터를 자동으로 내보냅니다. 이전 데이터를 내보내려면 아래를 참조하세요.

REST API를 사용하여 이전 데이터 백필 실행

기존 전송 구성(위 참조)에 대해 기존 탄소 데이터를 내보내려면 전송 구성에 대해 백필을 요청해야 합니다.

백필을 만들려면 이전 단계에서 만든 전송에 대한 식별자(예: projects/0000000000000/locations/us/transferConfigs/00000000-0000-0000-0000-000000000000) 및 다음 페이로드를 사용해서 transferConfigs.startManualRuns 엔드포인트에 POST 요청을 전송해야 합니다.

{
  "requestedTimeRange": {
    "startTime": "<var>START_TIME</var>",
    "endTime": "<var>END_TIME</var>"
  }
}

각 항목의 의미는 다음과 같습니다.

  • START_TIME은 백필 범위의 시작 시간을 지정하는 타임스탬프입니다. 예를 들면 2021-02-15T00:00:00Z입니다. 2021년 2월 15일은 2021년 1월 데이터를 포함하므로 여기에서 지정할 수 있는 가장 이른 날짜입니다.
  • END_TIME은 백필 범위의 종료 시간을 지정하는 타임스탬프입니다. 예를 들면 2022-09-15T00:00:00Z입니다. 현재 날짜를 사용할 수 있습니다.

API를 통해 기존 내보내기 쿼리

API를 쿼리하기 전 내보낸 데이터 세트에서 원하는 데이터를 반환하는 SQL 쿼리를 작성합니다. BigQuery 콘솔에서 SQL 쿼리를 테스트할 수 있습니다.

BigQuery로 내보내기를 구성한 다음 BigQuery API 또는 BigQuery 라이브러리를 사용해서 쿼리를 실행합니다.

다음 단계