Method: organizations.reportPropertyUsage

지정된 월에 조직 내 속성의 사용량 및 청구 데이터를 가져옵니다.

직접 고객 조직의 경우 결제 및 사용량 데이터를 보려면 조직의 조직 관리자/결제 관리자여야 합니다.

영업 파트너 고객 조직별로 사용자가 결제 및 사용 데이터를 보려면 영업 파트너 조직의 조직 관리자/결제 관리자여야 하고, 사용 데이터만 보려면 영업 파트너 고객 조직의 조직 관리자/결제 관리자여야 합니다.

HTTP 요청

POST https://marketingplatformadmin.googleapis.com/v1alpha/{organization=organizations/*}:reportPropertyUsage

URL은 gRPC 트랜스코딩 문법을 사용합니다.

경로 매개변수

매개변수
organization

string

필수 항목입니다. 속성 사용량이 나열될 조직을 지정합니다.

형식: organizations/{org_id}

요청 본문

요청 본문에는 다음과 같은 구조의 데이터가 포함됩니다.

JSON 표현 
{
  "month": string
}
필드
month

string

필수 항목입니다. 숙박 시설 사용량을 나열할 타겟 월입니다.

형식: YYYY-MM(예: '2025-05')

응답 본문

organizations.reportPropertyUsage RPC의 응답 메시지입니다.

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현 
{
  "propertyUsages": [
    {
      object (PropertyUsage)
    }
  ],
  "billInfo": {
    object (BillInfo)
  }
}
필드
propertyUsages[]

object (PropertyUsage)

지정된 조직 및 월의 모든 속성에 대한 사용 데이터입니다.
billInfo

object (BillInfo)

지정된 조직 및 월의 청구 금액입니다.

사용자가 사용 데이터에만 액세스할 수 있는 경우 비어 있습니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/marketingplatformadmin.analytics.read
  • https://www.googleapis.com/auth/marketingplatformadmin.analytics.update

PropertyUsage

속성에서 수신한 이벤트 수와 billable 이벤트 수에 영향을 미치는 메타데이터가 포함됩니다.

JSON 표현 
{
  "property": string,
  "displayName": string,
  "accountId": string,
  "serviceLevel": enum (AnalyticsServiceLevel),
  "propertyType": enum (AnalyticsPropertyType),
  "totalEventCount": string,
  "billableEventCount": string
}
필드
property

string

Google 애널리틱스 Admin API 속성 리소스의 이름입니다.

형식: analyticsadmin.googleapis.com/properties/{property_id}
displayName

string

속성의 표시 이름입니다.
accountId

string (int64 format)

속성의 상위 계정 ID입니다.
serviceLevel

enum (AnalyticsServiceLevel)

속성의 서비스 수준입니다.
propertyType

enum (AnalyticsPropertyType)

분석 속성의 하위 유형입니다. 이는 청구 가능한 이벤트 수에 영향을 미칩니다.
totalEventCount

string (int64 format)

요청된 달에 속성에서 수신한 총 이벤트 수입니다.
billableEventCount

string (int64 format)

요청한 월에 속성에 대해 청구된 이벤트 수입니다.

AnalyticsPropertyType

Google 애널리틱스 속성의 유형입니다.

열거형
ANALYTICS_PROPERTY_TYPE_UNSPECIFIED 알 수 없거나 지정되지 않은 속성 유형
ANALYTICS_PROPERTY_TYPE_ORDINARY 일반 Google 애널리틱스 속성
ANALYTICS_PROPERTY_TYPE_SUBPROPERTY Google 애널리틱스 하위 속성
ANALYTICS_PROPERTY_TYPE_ROLLUP Google 애널리틱스 롤업 속성

BillInfo

청구 금액을 포함합니다.

JSON 표현 
{
  "baseFee": {
    object (Money)
  },
  "eventFee": {
    object (Money)
  },
  "priceProtectionCredit": {
    object (Money)
  },
  "total": {
    object (Money)
  }
}
필드
baseFee

object (Money)

월별 기본 수수료 금액입니다.
eventFee

object (Money)

이벤트 수수료 금액입니다.
priceProtectionCredit

object (Money)

가격 보호 크레딧 금액입니다. 자격 요건을 충족하는 고객에게만 제공됩니다.
total

object (Money)

청구서의 총 금액입니다.

Money

금액과 통화 유형을 나타냅니다.

JSON 표현 
{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}
필드
currencyCode

string

ISO 4217에 정의된 3자리 통화 코드입니다.
units

string (int64 format)

금액의 전체 단위입니다. 예를 들어 currencyCode가 "USD"이면 1단위는 1달러(USD)입니다.
nanos

integer

금액의 나노 (10^-9) 단위 수입니다. 이 값은 -999,999,999~+999,999,999(끝값 포함) 사이여야 합니다. units가 양수이면 nanos는 양수 또는 0이어야 합니다. units가 0이면 nanos는 양수, 0 또는 음수일 수 있습니다. units가 음수이면 nanos는 음수 또는 0이어야 합니다. 예를 들어 $-1.75는 units=-1 및 nanos=-750,000,000으로 나타냅니다.