BigQuery로 채널 서비스 데이터 내보내기

이 페이지에서는 채널 서비스 내보내기를 구성하는 방법뿐 아니라 내보내기에 사용 가능한 스키마에 대해서도 설명합니다.

BigQuery를 사용하면, 지정된 BigQuery 데이터 세트로 채널 서비스 결제 데이터를 내보낼 수 있습니다. 이러한 데이터는 리셀러의 고객 또는 채널 파트너가 리셀러 제공 서비스를 사용하는 방법을 상세히 분석하는 데 도움이 됩니다.

채널 서비스에서 내보내기에는 Cloud Billing 내보내기에 포함되지 않은 리셀러별 데이터가 포함됩니다. 여기에는 비용, 크레딧, 설정된 가격 재조정 규칙이 적용된 사용 데이터가 포함됩니다. 이러한 내보내기는 또한 고객의 상위 결제 계정에 대한 모든 정보도 단일 데이터 세트로 집계합니다.

그러나 채널 서비스 내보내기의 데이터는 Cloud Billing 내보내기와 호환되므로 쿼리를 사용하여 두 데이터 세트를 조인하여 분석할 수 있습니다.

리셀러 이외의 Cloud Billing 내보내기에 대한 자세한 내용은 BigQuery로 Cloud Billing 내보내기 설정을 참조하세요.

시작하기 전에

채널 서비스 결제 데이터를 내보내려면 먼저 다음 요건을 충족해야 합니다.

  • BigQuery 데이터 세트를 호스팅할 프로젝트를 설정해야 합니다. 프로젝트에 결제가 사용 설정되어 있는지 확인하세요.
  • 프로젝트에서 BigQuery Data Transfer Service API를 사용 설정해야 합니다.
  • 내보낸 데이터에 대한 데이터 세트를 만들어야 합니다.

이미 Cloud Billing 데이터 내보내기를 위한 프로젝트 및 BigQuery 데이터 세트가 있는 경우, 해당 프로젝트 및 데이터 세트를 채널 서비스 내보내기에 재사용할 수 있습니다.

프로젝트 및 데이터 세트 설정에 대한 자세한 내용은 BigQuery로 Cloud Billing 데이터 내보내기 설정을 참조하세요.

내보내기에 필요한 권한

채널 서비스 내보내기를 사용 설정 및 구성하려면 다음 역할이 필요합니다.

프로젝트 및 데이터 세트 선택하기

Partner Sales Console에서 채널 서비스 데이터를 저장할 BigQuery 프로젝트 및 데이터 세트를 선택합니다. 프로젝트에서 아직 결제를 사용 설정하지 않은 경우 결제를 사용 설정합니다.

BigQuery 데이터 세트를 만들거나 선택할 때 지원되는 BigQuery 데이터 세트 위치 중 하나를 선택할 수 있습니다. 각 데이터 소스(Google Cloud 또는 Google Workspace)에 대해 처음으로 채널 서비스 데이터 내보내기를 사용 설정하는 경우:

  • 멀티 리전 위치를 사용하도록 BigQuery 데이터 세트를 구성하면 선택한 각 데이터 소스에 대해 이전 달 초부터 BigQuery Export 데이터가 제공됩니다. 예를 들어 9월 23일에 BigQuery Export를 사용 설정하는 경우 8월 1일 시작 데이터가 내보내기에 포함됩니다.

  • 리전 위치(멀티 리전 미국 또는 EU 제외)를 사용하도록 BigQuery 데이터 세트를 구성하면 선택한 각 데이터 소스에 대해 내보내기를 사용 설정한 날짜부터 BigQuery Export 데이터가 제공됩니다. 즉, BigQuery Export 데이터는 멀티 리전이 아닌 데이터 세트 위치에 대해 소급적으로 추가되지 않으므로 내보내기를 사용 설정하기 전의 BigQuery Export 데이터는 표시되지 않습니다.

여러 Partner Sales Console 계정의 결제 데이터를 내보내려면 다음 단계를 따르세요.

  1. 데이터를 내보내려는 BigQuery 데이터 세트에서 각 Partner Sales Console 계정의 결제 관리자에게 데이터 세트를 볼 수 있는 권한이 있는지 확인합니다.
  2. 각 Partner Sales Console 계정에서 결제 데이터 내보내기를 설정할 때 통합 데이터 세트를 선택합니다.

지원되는 BigQuery 위치

멀티 리전

다음 표에는 채널 서비스 BigQuery 데이터 내보내기가 지원되는 멀티 리전이 나와 있습니다.

멀티 리전 설명 멀티 리전 이름
유럽 연합 회원국의 데이터 센터1 EU
미국의 데이터 센터 US

리전

다음 표에는 채널 서비스 BigQuery 데이터 내보내기가 지원되는 미주의 리전이 나열되어 있습니다.

리전 설명 리전 이름
아이오와 us-central1
라스베이거스 us-west4
로스앤젤레스 us-west2
몬트리올 northamerica-northeast1
북 버지니아 us-east4
오리건 us-west1
솔트레이크시티 us-west3
상파울루 southamerica-east1
사우스캐롤라이나 us-east1

다음 표에는 채널 서비스 BigQuery 데이터 내보내기가 지원되는 아시아 태평양의 리전이 나열되어 있습니다.

리전 설명 리전 이름
홍콩 asia-east2
자카르타 asia-southeast2
뭄바이 asia-south1
오사카 asia-northeast2
서울 asia-northeast3
싱가포르 asia-southeast1
시드니 australia-southeast1
타이완 asia-east1
도쿄 asia-northeast1

다음 표에는 채널 서비스 BigQuery 데이터 내보내기가 지원되는 유럽의 리전이 나열되어 있습니다.

리전 설명 리전 이름
벨기에 europe-west1
핀란드 europe-north1
프랑크푸르트 europe-west3
런던 europe-west2
네덜란드 europe-west4
바르샤바 europe-central2
취리히 europe-west6

내보내기 사용 설정하기

데이터 내보내기를 활성화하기 전에 정규화된 데이터 세트 ID(형식: PROJECT_ID:DATASET_NAME)를 기록해 두세요.

채널 서비스 내보내기를 사용 설정하려면 다음 단계를 따르세요.

  1. Partner Sales Console에서 결제 페이지를 엽니다.
  2. 결제 내보내기를 선택합니다.
  3. 재결제 데이터 세트 필드에 정규화된 데이터 세트 ID를 입력합니다.
  4. 데이터를 내보낼 데이터 소스를 선택합니다.
  5. 업데이트를 클릭합니다. 데이터 세트 권한을 업데이트하라는 메시지가 표시되면 업데이트를 클릭하세요.

재결제 내보내기를 활성화하기 위한 UI

설정을 완료한 결제 내보내기는 일별 증분 사용 데이터를 제공합니다. 내보내기 테이블은 계정의 결제 내보내기를 처음 실행한 후에 표시됩니다. 데이터 세트에는 데이터를 보관하도록 처음 구성한 시점의 데이터가 포함되어 있습니다.

데이터 세트로의 재결제 비용 데이터 내보내기를 중지하려면 고객 재결제 페이지에서 결제 데이터 내보내기 사용 중지를 클릭합니다. 내보내기를 다시 활성화하려면 이전 단계에 따라 데이터 세트 ID를 지정하세요.

재결제 비용 데이터는 사용 중지된 기간에는 제공되지 않을 수 있습니다. 해당 기간 동안 내보낸 데이터를 삭제한 경우, 삭제된 레코드를 백필할 수 없습니다.

필요한 서비스 계정 권한

채널 서비스 데이터 내보내기는 Google에서 소유하고 관리하며 결제 레코드를 테이블에 쓸 권한이 있는 서비스 계정을 사용합니다. 서비스 계정은 다음과 같습니다.

cloud-channel-billing-reporting-rebilling@system.gserviceaccount.com

이 서비스 계정에는 내보내기를 허용하도록 사전 정의된 역할 roles/bigquery.dataEditor가 필요합니다. 내보내기를 활성화하는 단계에 따라 권한을 구성할 수 있습니다.

효율적인 데이터 쿼리

BigQuery 테이블은 기본적으로 export_time 기준 파티셔닝되고 payer_billing_account_id 기준 클러스터링됩니다. 즉, 테이블이 더 작은 파티션으로 나뉘고 각 파티션은 다시 더 작은 클러스터로 나뉩니다. 쿼리에서 파티셔닝 및 클러스터링 키를 사용하면 BigQuery가 관련 데이터를 빠르게 찾을 수 있으므로 쿼리 비용이 크게 절감됩니다.

예를 들어 아래 쿼리는 파티셔닝 및 클러스터링 키가 없는 쿼리와 비교할 때 효율적입니다.

SELECT
  billing_account_id
  currency,
  invoice.month,
  -- Divide by currency_conversion_rate if converting non-USD to USD.
  SUM(cost)
    + SUM(
      IFNULL(
        (SELECT SUM(c.amount) FROM UNNEST(credits) AS c), 0))
    AS total
FROM PROJECT_ID.DATASET_NAME.reseller_billing_detailed_export_v1
WHERE
  export_time BETWEEN TIMESTAMP(START_DATE)
    AND TIMESTAMP(END_DATE)
  AND payer_billing_account_id IN (PAYER_BILLING_ACCOUNT_IDS)
GROUP BY
  billing_account_id,
  currency,
  invoice.month
ORDER BY
  billing_account_id,
  currency,
  invoice.month;

파티셔닝, 클러스터링, 권장사항에 대한 자세한 내용은 다음 링크를 참조하세요.

  1. 파티셔닝된 테이블 쿼리
  2. 클러스터링된 테이블 쿼리
  3. 쿼리 계산 최적화
  4. BigQuery의 비용 관리 권장사항

지급자 결제 계정 ID 찾기

지급자의 결제 계정 ID를 찾으려면 Partner Sales Console의 결제 계정 페이지를 열고 파트너 결제 탭을 클릭합니다.

모든 결제 계정과 지급자 결제 계정 ID를 확인할 수 있습니다.

지급자 결제 계정 ID

내보내기 데이터 세트에서 다른 사용자에 대한 액세스 제어 설정하기

BigQuery Export의 데이터에 대한 액세스 제어를 설정하는 방법에는 여러 가지가 있습니다. 자세한 내용은 BigQuery 액세스 제어를 참조하세요.

사용자가 보기 권한이 있는 데이터에만 액세스할 수 있도록 하려면 내보낸 데이터 세트의 데이터를 공유하도록 승인된 뷰를 설정하는 것이 좋습니다.

사용자의 권한을 설정하는 동안 서비스 계정 cloud-channel-billing-reporting-rebilling@system.gserviceaccount.com에 항상 지속적 데이터 내보내기를 위해 내보내기 데이터 세트에 대한 전체 편집자 액세스 권한이 있는지 확인합니다.

테이블 스키마

다음 스키마는 BigQuery 테이블의 데이터를 설명합니다.

BigQuery 데이터 세트에서 자세한 재결제 내보내기는 reseller_billing_detailed_export_v1(이)라는 데이터 테이블에 로드됩니다.

필드 유형 설명
billing_account_id 문자열 사용량에 연결된 계정 ID로, 고객 또는 리셀러의 ID일 수 있습니다. 제품군에 따라 결제 계정 ID 또는 Cloud ID일 수 있습니다.
payer_billing_account_id 문자열 상위 결제 계정의 ID입니다.
invoice.month 문자열 비용 항목이 포함된 인보이스의 연도 및 월(YYYYMM)입니다. 예: '202101' 2021년 1월과 동일합니다
cost_type 문자열 정기 비용, 세금, 조정 또는 반올림 오류 등 이 항목이 나타내는 비용 유형입니다.
service.id 문자열 사용량에 연결된 서비스의 ID입니다.
service.description 문자열 결제 데이터를 보고한 Google 서비스입니다.
sku.id 문자열 서비스에서 사용한 리소스의 SKU ID입니다.
sku.description 문자열 서비스에서 사용한 리소스 유형에 대한 설명입니다. 예를 들어 Cloud Storage는 Standard Storage Standard Storage US 유형입니다.
usage_start_time 타임스탬프 계산된 비용의 시간당 사용 기간의 시작 시간입니다. 모든 서비스의 사용량 및 비용이 시간 단위로 상세하게 표시됩니다. 장기 실행 서비스 사용량은 여러 개의 시간 단위 기간에 걸쳐 표시됩니다. 구독 제품의 경우 이때 결제 월이 시작됩니다.
usage_end_time 타임스탬프 계산된 비용의 시간당 사용 기간의 종료 시간입니다. 모든 서비스의 사용량 및 비용이 시간 단위로 상세하게 표시됩니다. 장기 실행 서비스 사용량은 여러 개의 시간 단위 기간에 걸쳐 표시됩니다. 구독 제품의 경우 이때 결제 월이 끝납니다.
project 구조체 Cloud Billing 데이터를 생성한 Google Cloud 프로젝트에 대한 정보입니다.
project.number 문자열 Cloud Billing 데이터를 생성한 Google Cloud 프로젝트의 내부적으로 생성되고 익명처리된 고유 식별자입니다.
project.id 문자열 Cloud Billing 데이터를 생성한 Google Cloud 프로젝트의 ID입니다.
project.name 문자열 Cloud Billing 데이터를 생성한 Google Cloud 프로젝트의 이름입니다.
project.labels 구조체(반복됨)
project.labels.key 문자열 라벨이 있는 경우 키:값 쌍의 부분입니다.
project.labels.value 문자열 라벨이 있는 경우 키:값 쌍의 부분입니다.
project.ancestry_numbers 문자열 project.id(으)로 식별된 프로젝트의 리소스 계층 구조 상위 항목입니다.
labels 구조체(반복됨)
labels.key 문자열 라벨이 있는 경우 키:값 쌍의 부분입니다.
labels.value 문자열 라벨이 있는 경우 키:값 쌍의 부분입니다.
system_labels 구조체(반복됨)
system_labels.key 문자열 시스템 라벨이 있는 경우 키:값 쌍의 부분입니다.
system_labels.value 문자열 시스템 라벨이 있는 경우 키:값 쌍의 부분입니다.
location.location 문자열 국가, 리전 또는 영역 수준의 사용량 위치 특정 위치가 없는 리소스의 경우 global이(가) 표시됩니다. 자세한 내용은 리전 및 영역을 참조하세요.
location.country 문자열 location.location이(가) 국가, 리전 또는 영역인 경우 이 필드는 사용량이 발생한 국가입니다. 예를 들면 US입니다. 자세한 내용은 리전 및 영역을 참조하세요.
location.region 문자열 location.location이(가) 국가 또는 리전인 경우 이 필드는 사용량이 발생한 리전입니다. 예를 들면 us-central1입니다. 자세한 내용은 리전 및 영역을 참조하세요.
location.zone 문자열 location.location이(가) 영역인 경우 이 필드는 사용 영역입니다. 예를 들면 us-central1-a입니다. 자세한 내용은 리전 및 영역을 참조하세요.
resource 구조체 서비스 사용량을 생성하는 서비스 리소스(예: 가상 머신 또는 SSD)와 관련된 정보의 구조와 값을 설명합니다.
resource.name 문자열 관련 사용량을 생성한 리소스의 서비스별 식별자입니다. 사용자가 생성할 수 있습니다.
resource.global_name 문자열 관련 사용량을 생성한 리소스의 전역적으로 고유한 서비스 식별자입니다.
cost 숫자 적용된 크레딧 전의 사용 비용입니다. 크레딧을 포함한 총 비용을 계산하려면 credits.amount을(를) cost에 추가합니다.
currency 문자열 비용의 결제 통화입니다. 자세한 내용은 현지 통화로 청구 및 결제를 참고하세요.
currency_conversion_rate 부동 소수점 미국 달러와 현지 통화의 환율입니다. 즉, cost/currency_conversion_rate는 미국 달러로 계산한 비용입니다.
usage.amount 숫자 사용한 usage.unit의 양입니다.
usage.unit 문자열 리소스 사용량 측정을 위한 기본 단위입니다. 예를 들어 표준 스토리지의 기본 단위는 byte-seconds입니다.
usage.amount_in_pricing_unit 숫자 usage.pricing_unit 사용량입니다.
usage.pricing_unit 문자열 리소스 사용량을 측정하는 단위입니다.
credits 구조체(반복됨) 크레딧의 구조와 값을 설명하는 필드가 포함됩니다.
credits.id 문자열 채워지는 경우 크레딧이 제품 SKU와 연결되어 있음을 나타냅니다.
credits.full_name 문자열 제품 SKU와 연결된 크레딧의 이름입니다.
credits.type 문자열 이 필드는 credits.id의 목적 또는 원본을 설명합니다.
credits.name 문자열 사용량에 적용된 크레딧에 대한 설명입니다.
credits.amount 숫자 사용량에 적용된 크레딧 금액이며
credits.channel_partner_amount 숫자 재결제 가격 인상 및 할인 후 사용량에 적용된 크레딧 금액입니다. channel_partner_name 및 연결된 ChannelPartnerRepricingConfig을(를) 기반으로 합니다. credits.type이(가) RESELLER_MARGIN인 경우 이 금액은 0이 됩니다.
credits.customer_amount 숫자 재결제 가격 인상 및 할인 후 사용량에 적용된 크레딧 금액입니다. customer_name 및 연결된 CustomerRepricingConfig을(를) 기반으로 합니다. credits.type이(가) RESELLER_MARGIN인 경우 이 금액은 0이 됩니다.
adjustmentsInfo 구조체(반복됨) 비용 항목에 대한 조정의 구조와 값을 설명하는 필드가 포함됩니다.
adjustmentsInfo.adjustment_id 문자열 채워지면 조정이 비용 항목에 연결된 것입니다. adjustmentsInfo.adjustments_id은(는) 문제로 인해 생긴 모든 조정의 고유 ID입니다.
adjustmentsInfo.adjustment_description 문자열 조정 및 조정의 이유에 대한 설명입니다.
adjustmentsInfo.adjustment_type 문자열 조정 유형입니다.
adjustmentsInfo.adjustment_mode 문자열 조정이 수행된 방법입니다.
export_time 타임스탬프 결제 데이터 추가와 연결된 처리 시간입니다. 새로 내보낼 때마다 항상 늘어나게 됩니다. export_time 열을 사용하면 내보낸 결제 데이터가 마지막으로 업데이트된 시간을 확인할 수 있습니다.
entitlement_name 문자열 Cloud Channel API 사용 권한의 리소스 이름입니다. accounts/{account}/customers/{customer}/entitlements/{entitlement} 형식을 사용합니다.
channel_partner_name 문자열 (유통업체만 해당) 최종 고객에게 판매하는 채널 파트너의 리소스 이름입니다. accounts/{account}/channelPartnerLinks/{channelPartner} 형식을 사용합니다.
channel_partner_cost 숫자 (유통업체만 해당) 기존 ChannelPartnerRepricingConfig을(를) 적용한 후 channel_partner_name(으)로 식별되는 채널 파트너 비용입니다.
customer_name 문자열 이 사용량을 소비한 리셀러 고객의 리소스 이름으로, accounts/{account}/customers/{customer} 형식입니다.
customer_cost 숫자 CustomerRepricingConfig가 적용된 후 customer_name 열로 식별된 리셀러 고객의 비용입니다(있는 경우).
cost_at_list 숫자 공개 가격으로 청구되는 비용입니다.
customer_repricing_config_name 문자열 Cloud Channel API CustomerRepricingConfig의 리소스 이름입니다. accounts/{account}/customers/{customer}/customerRepricingConfigs/{id} 형식을 사용합니다.
channel_partner_repricing_config_name 문자열 (유통업체만 해당) Cloud Channel API ChannelPartnerRepricingConfig의 리소스 이름입니다. accounts/{account}/channelPartnerLinks/{channelPartner}/channelPartnerRepricingConfigs/{id} 형식을 사용합니다.
tags 구조체 키, 값, 네임스페이스 등 태그를 설명하는 필드
tags.key 문자열 이 특정 태그와 연결된 키의 짧은 이름 또는 표시 이름입니다.
tags.value 문자열 태그 키에 연결된 리소스입니다. 특정 시점에 주어진 키의 리소스에는 정확히 하나의 값만 연결할 수 있습니다.
tags.inherited 불리언 태그 바인딩이 상속되었는지(태그 상속됨 = True) 또는 직접/상속되지 않았는지(태그 상속됨 = False) 여부를 나타냅니다.
tags.namespace 문자열 태그 키 및 값을 정의하는 리소스 계층 구조를 나타냅니다. 네임스페이스를 태그 키 및 태그 값 짧은 이름과 결합하여 태그 키 또는 태그 값에 대해 전역적으로 고유한 정규화된 이름을 만들 수 있습니다.
customer_correlation_id 문자열 고객의 외부 CRM ID입니다. 이 고객의 CRM ID가 있는 경우에만 채워집니다.
price 구조체 사용량에 청구된 가격과 관련된 구조와 값을 설명하는 필드입니다.
price.effective_price 숫자 사용량에 대해 청구된 가격입니다.
price.tier_start_amount 숫자 SKU 가격 등급의 단위 하한 수입니다. 예를 들어 0~100 단위, 101~1000 단위, 1001+ 단위의 세 가지 가격 등급을 사용하는 SKU의 경우 SKU의 가격 책정 등급에 대한 시작 단위 수량을 나타내는 price.tier_start_amount 필드에서 SKU에 대한 3개의 가격 행이 0, 101 및 1001로 표시됩니다. Google Cloud 가격 등급 자세히 알아보기
price.unit 문자열 가격이 지정되고 리소스 사용량이 측정되는 사용량 단위입니다(예: 기비바이트, 테비바이트, 월, 연도, 기비바이트 시간, 기비바이트 월, 수). price.unit 필드의 값이 usage.pricing_unit 필드의 값과 일치합니다.
price.pricing_unit_quantity 숫자 SKU의 가격 등급 단위 수량입니다. 예를 들어 등급 가격이 1,000,000바이트당 $1이면 이 열에 1,000,000이 표시됩니다.
transaction_type 문자열 판매자의 거래 유형입니다. 거래 유형은 다음 중 하나일 수 있습니다.
  • GOOGLE = 1: Google Cloud에서 판매하는 서비스입니다.
  • THIRD_PARTY_RESELLER = 2: Google Cloud에서 재판매하는 서드 파티 서비스입니다.
  • THIRD_PARTY_AGENCY = 3: 파트너가 판매하는 서드 파티 서비스로, Google Cloud가 에이전트 역할을 합니다.
seller_name 문자열 판매자의 법적 이름입니다.
subscription 구조체 지출 기반 또는 리소스 기반 약정을 설명하는 필드입니다. 이러한 필드를 사용하여 특정 약정의 요금을 분석할 수 있습니다.
subscription.instance_id 문자열 약정에 연결된 구독 ID입니다.

스키마에 대한 추가 참고사항

Google Workspace에 적용되지 않는 열

열 또는 필드가 제품군에 적용되지 않는 경우 이 제품군의 내보낸 데이터에서 이 열/필드에는 null이(가) 포함됩니다. 다음 열/필드는 Google Workspace 내보내기에 적용되지 않습니다:

  • project
  • labels
  • resource
  • credits
  • adjustmentsInfo
  • cost_at_list
  • customer_repricing_config_name
  • channel_partner_repricing_config_name
  • tags
  • price.effective_price
  • price.tier_start_amount
  • transaction_type
  • seller_name

Google Workspace 내보내기에 관한 기타 참고사항

Google Workspace 내보내기에는 다음과 같은 몇 가지 특수한 동작이 있습니다.

  • Google Workspace 데이터에는 리셀러의 자체 사용량이 포함되지 않습니다.
  • cost_typetaxadjustment이면 usage.amount_in_pricing_units은 항상 1입니다.
  • Google Workspace 인보이스에 세금은 하나의 항목으로 표시됩니다. 내보내기에서 세금은 고객별로 구분됩니다. 총 세금은 인보이스와 일치하지만 개별 세금은 반올림으로 인해 약간 부정확할 수 있습니다.

billing_account_id

  • Google Cloud의 경우 이 계정은 사용량이 연결된 Cloud Billing 계정입니다.
  • Google Workspace의 경우 고객의 Cloud ID입니다.

servicesku

Google Workspace의 경우 이러한 열은 사용과 관련된 '제품' 및 'SKU'를 나타냅니다. 제품 및 SKU ID에 대해 자세히 알아보세요.

usage_start_timeusage_end_time

Google Workspace 인보이스 CSV에서 이는 날짜로 표시됩니다. 내보내기에서는 타임스탬프로 표시됩니다.

  • usage_start_time의 경우 시작일 0:00 PST인 구독 시작 시간입니다(포함).
  • usage_end_time의 경우 종료일 다음 날 0:00 PST인 구독 종료 시간입니다(제외).

project.labels

Google Cloud의 경우, 사용량이 발생한 Google Cloud 프로젝트의 키-값 쌍입니다. 자세한 내용은 라벨 사용을 참조하세요.

labels

Google Cloud의 경우, 사용량이 발생한 Google Cloud 리소스의 키-값 쌍입니다. 자세한 내용은 라벨 사용을 참조하세요.

system_labels

  • Google Cloud의 경우, 사용량이 발생한 Google Cloud 리소스의 키-값 쌍입니다. 자세한 내용은 사용 가능한 시스템 레벨을 참조하세요.

  • Google Workspace의 경우 비용과 관련된 추가 메타데이터가 있습니다.

    • workspace.googleapis.com/domain_name: 고객의 도메인 이름
    • workspace.googleapis.com/order_id: 주문 ID
    • workspace.googleapis.com/purchase_order_id: 구매주문서(PO) ID
    • workspace.googleapis.com/subscription_id: 구독 ID
    • workspace.googleapis.com/usage_type: 사용 유형. cost_typeregular가 아니면 적용되지 않습니다.

Google Workspace 사용 유형은 다음과 같습니다.

  • COMMITMENT_TERM_START_ITEM: 정기 결제의 시작. 일반적으로 월 단위로 청구되는 약정 구독과 선불 구독의 결제/계약 기간에 대해 당월의 실제 가입 기간(일수)과 연결됩니다.
  • COMMITMENT_TERM_END_ITEM: 정기 결제 종료. 일반적으로 월 단위로 청구되는 약정 구독의 마지막 달 요금과 연결됩니다.
  • COMMITMENT_TERM_RENEWAL_ITEM: 후속 정기 결제 기간의 시작
  • COMMITMENT_MONTHLY_ITEM: 매월 초에 존재하는 약정에 대한 기록된 사용량. 대부분의 경우 요금에 전체 월이 포함됩니다.
  • COMMITMENT_SEATS_CHANGE_ITEM: 약정 수준이 변경될 때 기록됩니다(증가 또는 감소). 대개 월 중간에 시작하여 월 단위 청구 약정 구독의 경우 월말까지, 선불 구독의 경우 결제/계약 기간이 종료될 때까지 연장됩니다.
  • COMMITMENT_CANCEL_ITEM: 정기 결제가 취소될 때 기록됩니다. 조기 해지와 관련된 요금이 포함됩니다. 계약이 중도 해지된 경우 남은 계약 기간에 대한 요금 또는 계약이 중도 변경 또는 취소된 경우 남은 결제 기간에 대해 발행된 크레딧을 나타냅니다.
  • FLEXIBLE_SEATS_ITEM: 일정 일수 동안 연속된 블록에 대해 일정 수의 사용자별 사용량을 기록합니다. 현재는 약정이 없는 사용자만 이용할 수 있습니다.
  • COUPON_DISCOUNT_ITEM: 쿠폰과 연결된 할인 금액
  • MIGRATED_CREDIT_ITEM: postini 마이그레이션의 크레딧
  • COMMITMENT_PREPAY_BILLING_PERIOD_ITEM: 약정 선불 구독의 전체 주기에 대한 결제 주기가 시작될 때 생성되는 사용량 정보

usage.amount

Google Workspace 사용 가능한 라이선스 수 기반 사용량의 경우, 사용 가능한 유료 라이선스 수(예: 약정 요금제의 약정된 라이선스 수 또는 탄력 요금제의 유료 라이선스 수)를 나타냅니다.

usage.pricing_unit

  • Google Cloud의 경우 Cloud Billing Catalog API에 대해 자세히 알아보세요.
  • Google Workspace에서는 count입니다.

credits.id

Google Cloud에서는 영숫자로 된 고유 식별자(12-b34-c56-d78) 또는 크레딧 유형(약정 사용 할인: CPU)에 대한 설명입니다. 만약 credits.id 필드가 비어 있으면 제품 SKU가 크레딧과 연결되지 않은 것입니다.

credits.full_name

Google Cloud에서 인간이 읽을 수 있는 영숫자 credits.id에 대한 설명입니다. 예를 들어 무료 체험 크레딧 또는 지출 기반 약정 사용 할인이 있습니다. credits.full_name 값은 영숫자 credits.id인 SKU에만 채워집니다. credits.id 값이 크레딧 유형(예: 약정 사용 할인: CPU)에 대한 설명인 경우 credits.full_name 필드는 빕니다.

credits.type

Google Cloud의 크레딧 유형은 다음과 같습니다.

  • COMMITTED_USAGE_DISCOUNT: Compute Engine용 리소스 기반 약정 사용 계약을 구매하면 VM 사용 요금이 대폭 할인됩니다.
  • COMMITTED_USAGE_DISCOUNT_DOLLAR_BASE: 최소 금액을 지출하겠다는 약정 하에 서비스를 위해 구매한 지출 기반 약정 사용 계약입니다.
  • DISCOUNT: 할인 크레딧 유형은 계약상의 지출 기준액에 도달한 후 받은 크레딧에 사용됩니다. Partner Sales Console에서 사용할 수 있는 Cloud Billing 보고서에는 할인 크레딧 유형이 지출 기반 할인(약정)으로 표시됩니다.
  • FREE_TIER: 일부 서비스는 지정된 한도까지 리소스 사용량을 무료로 제공합니다. 이러한 서비스의 경우 무료 등급 사용을 구현하기 위해 크레딧이 적용됩니다.
  • PROMOTION: 프로모션 크레딧 유형에는 Google Cloud 무료 체험 및 마케팅 캠페인 크레딧 또는 Google Cloud 사용을 위한 기타 지원금이 포함됩니다. 가능한 경우, 프로모션 크레딧은 결제 수단으로 간주되어 자동으로 적용되며 총 청구액이 줄어듭니다.
  • RESELLER_MARGIN: 리셀러인 경우 리셀러 마진 크레딧 유형은 적합한 모든 항목에서 얻은 리셀러 프로그램 할인을 나타냅니다.
  • SUBSCRIPTION_BENEFIT: 할인을 받기 위해 서비스 장기 구독을 구매하여 얻은 크레딧입니다.
  • SUSTAINED_USAGE_DISCOUNT : 지속 사용 할인 크레딧 유형은 결제 월의 상당 부분에서 특정 Compute Engine 리소스를 실행할 때 자동으로 받는 할인입니다.

adjustmentsInfo

Google Cloud의 경우 이러한 값은 Cloud Billing 수정을 위해 비용 항목이 생성된 경우에만 채워집니다. adjustmentsInfo 유형에는 해당 조정이 오류 정정을 위한 것이든 다른 사유로 인한 것이든 조정에 대한 세부정보가 포함됩니다.

adjustmentsInfo.adjustment_type

Google Cloud의 경우 다음이 포함됩니다.

  • USAGE_CORRECTION: 잘못 보고된 사용량으로 인한 정정입니다.
  • PRICE_CORRECTION: 잘못된 가격 책정 규칙으로 인한 정정입니다.
  • METADATA_CORRECTION: 비용을 변경하지 않고 메타데이터를 변경하는 정정입니다.
  • GOODWILL: 고객에게 호의로 발급하는 크레딧입니다.
  • SALES_BASED_GOODWILL: 계약에 따라 고객에게 호의로 발급하는 크레딧입니다.
  • SLA_VIOLATION: 서비스 수준 목표(SLO) 위반으로 인해 고객에게 발급된 크레딧입니다.
  • BALANCE_TRANSFER: 결제 계정 간의 이체에 대한 조정입니다.
  • ACCOUNT_CLOSURE: 폐쇄된 계정의 잔액을 0으로 전환하기 위한 조정입니다.
  • GENERAL_ADJUSTMENT: 일반적인 결제 계정 수정입니다.

adjustmentsInfo.adjustment_mode

Google Cloud의 경우 다음이 포함됩니다.

  • PARTIAL_CORRECTION: 이 정정 사항은 원래의 사용량과 비용을 일부 무효화합니다.
  • COMPLETE_NEGATION_WITH_REMONETIZATION: 이 정정 사항은 원래의 사용량과 비용을 완전히 무효화하고 업데이트된 사용량과 비용을 포함하여 정정된 항목을 발행합니다.
  • COMPLETE_NEGATION: 이 정정 사항은 원래의 사용량과 비용을 완전히 무효화하며 추가 사용량에 대해서는 다시 과금하지 않습니다.
  • MANUAL_ADJUSTMENT: 조정이 비용 및 사용량에 수동으로 할당됩니다.

price.effective_price

Google Cloud의 경우 Google Cloud 또는 Google Maps Platform SKU 사용 및 SKU 가격 등급에 대해 청구되는 가격입니다. Cloud Billing 계정에 커스텀 계약 가격이 있는 경우, 이 가격은 결제 계정별 가격이고, 그렇지 않은 경우 SKU 또는 SKU 등급의 정가입니다.