Method: organizations.reportPropertyUsage

Mendapatkan data penggunaan dan penagihan untuk properti dalam organisasi selama bulan yang ditentukan.

Untuk organisasi klien langsung, pengguna harus menjadi AdminOrg/AdminPenagihan di organisasi agar dapat melihat data penagihan dan penggunaan.

Untuk setiap organisasi klien partner penjualan, pengguna harus menjadi OrgAdmin/BillingAdmin di organisasi partner penjualan untuk melihat data penagihan dan penggunaan, atau OrgAdmin/BillingAdmin di organisasi klien partner penjualan untuk melihat data penggunaan saja.

Permintaan HTTP

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

URL ini menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
organization

string

Wajib. Menentukan organisasi yang penggunaan propertinya akan dicantumkan.

Format: organizations/{org_id}

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "month": string
}
Kolom
month

string

Wajib. Bulan target untuk mencantumkan penggunaan properti.

Format: YYYY-MM. Misalnya, "2025-05"

Isi respons

Pesan respons untuk RPC organizations.reportPropertyUsage.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "propertyUsages": [
    {
      object (PropertyUsage)
    }
  ],
  "billInfo": {
    object (BillInfo)
  }
}
Kolom
propertyUsages[]

object (PropertyUsage)

Data penggunaan untuk semua properti di organisasi dan bulan yang ditentukan.
billInfo

object (BillInfo)

Jumlah tagihan dalam organisasi dan bulan yang ditentukan.

Akan kosong jika pengguna hanya memiliki akses ke data penggunaan.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

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

PropertyUsage

Berisi jumlah peristiwa yang diterima oleh properti, beserta metadata yang memengaruhi volume peristiwa billable.

Representasi JSON 
{
  "property": string,
  "displayName": string,
  "accountId": string,
  "serviceLevel": enum (AnalyticsServiceLevel),
  "propertyType": enum (AnalyticsPropertyType),
  "totalEventCount": string,
  "billableEventCount": string
}
Kolom
property

string

Nama resource properti Google Analytics Admin API.

Format: analyticsadmin.googleapis.com/properties/{property_id}
displayName

string

Nama tampilan properti.
accountId

string (int64 format)

ID akun induk properti.
serviceLevel

enum (AnalyticsServiceLevel)

Tingkat layanan properti.
propertyType

enum (AnalyticsPropertyType)

Subjenis properti Analytics. Hal ini memengaruhi jumlah peristiwa yang dapat ditagih.
totalEventCount

string (int64 format)

Jumlah total peristiwa yang diterima properti selama bulan yang diminta.
billableEventCount

string (int64 format)

Jumlah peristiwa yang ditagih untuk properti pada bulan yang diminta.

AnalyticsPropertyType

Jenis Properti Google Analytics.

Enum
ANALYTICS_PROPERTY_TYPE_UNSPECIFIED Jenis properti tidak diketahui atau tidak ditentukan
ANALYTICS_PROPERTY_TYPE_ORDINARY Properti Google Analytics biasa
ANALYTICS_PROPERTY_TYPE_SUBPROPERTY Sub-properti Google Analytics
ANALYTICS_PROPERTY_TYPE_ROLLUP Properti gabungan Google Analytics

BillInfo

Berisi jumlah tagihan.

Representasi JSON 
{
  "baseFee": {
    object (Money)
  },
  "eventFee": {
    object (Money)
  },
  "priceProtectionCredit": {
    object (Money)
  },
  "total": {
    object (Money)
  }
}
Kolom
baseFee

object (Money)

Jumlah biaya dasar bulanan.
eventFee

object (Money)

Jumlah biaya acara.
priceProtectionCredit

object (Money)

Jumlah kredit perlindungan harga, ini hanya tersedia untuk pelanggan yang memenuhi syarat.
total

object (Money)

Jumlah total tagihan.

Uang

Mewakili jumlah uang dengan jenis mata uangnya.

Representasi JSON 
{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}
Kolom
currencyCode

string

Kode mata uang tiga huruf yang ditentukan dalam ISO 4217.
units

string (int64 format)

Seluruh unit jumlahnya. Misalnya, jika currencyCode adalah "USD", maka 1 unit adalah satu dolar AS.
nanos

integer

Jumlah unit nano (10^-9) dari jumlah. Nilainya harus antara -999.999.999 dan +999.999.999 inklusif. Jika units positif, nanos harus positif atau nol. Jika units nol, nanos dapat positif, nol, atau negatif. Jika units negatif, nanos harus negatif atau nol. Misalnya $-1,75 direpresentasikan sebagai units=-1 dan nanos=-750.000.000.