Method: organizations.reportPropertyUsage

Belirtilen ayda kuruluş içindeki mülklerin kullanım ve faturalandırma verilerini alın.

Doğrudan müşteri kuruluş başına, faturalandırma ve kullanım verilerini görüntülemek için kullanıcının kuruluşta kuruluş yöneticisi/faturalandırma yöneticisi olması gerekir.

Satış ortağı müşteri kuruluşu başına, faturalandırma ve kullanım verilerini görüntülemek için kullanıcının satış ortağı kuruluşunda Kuruluş Yöneticisi/Faturalandırma Yöneticisi olması gerekir. Yalnızca kullanım verilerini görüntülemek için ise kullanıcının satış ortağı müşteri kuruluşunda Kuruluş Yöneticisi/Faturalandırma Yöneticisi olması gerekir.

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
organization

string

Zorunlu. Mülk kullanımı listelenecek kuruluşu belirtir.

Biçim: organizations/{org_id}

İstek içeriği

İstek içeriği aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "month": string
}
Alanlar
month

string

Zorunlu. Tesis kullanımlarını listelemek için hedef ay.

Biçim: YYYY-AA. Örneğin, "2025-05"

Yanıt gövdesi

organizations.reportPropertyUsage RPC için yanıt mesajı.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "propertyUsages": [
    {
      object (PropertyUsage)
    }
  ],
  "billInfo": {
    object (BillInfo)
  }
}
Alanlar
propertyUsages[]

object (PropertyUsage)

Belirtilen kuruluş ve ayda tüm mülklerin kullanım verileri.
billInfo

object (BillInfo)

Belirtilen kuruluştaki ve aydaki fatura tutarı.

Kullanıcının yalnızca kullanım verilerine erişimi varsa boş olur.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

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

PropertyUsage

Mülk tarafından alınan etkinliklerin sayısını ve billable etkinliklerinin hacmini etkileyen meta verileri içerir.

JSON gösterimi 
{
  "property": string,
  "displayName": string,
  "accountId": string,
  "serviceLevel": enum (AnalyticsServiceLevel),
  "propertyType": enum (AnalyticsPropertyType),
  "totalEventCount": string,
  "billableEventCount": string
}
Alanlar
property

string

Google Analytics Admin API mülk kaynağının adı.

Biçim: analyticsadmin.googleapis.com/properties/{property_id}
displayName

string

Tesisin görünen adı.
accountId

string (int64 format)

Mülkün üst hesabının kimliği.
serviceLevel

enum (AnalyticsServiceLevel)

Mülkün hizmet düzeyi.
propertyType

enum (AnalyticsPropertyType)

Analytics mülkünün alt türü. Bu, faturalandırılabilir etkinlik sayısını etkiler.
totalEventCount

string (int64 format)

Mülkün istenen ay boyunca aldığı toplam etkinlik sayısı.
billableEventCount

string (int64 format)

İstenen ayda tesisin faturalandırıldığı etkinliklerin sayısı.

AnalyticsPropertyType

Google Analytics mülkünün türleri.

Sıralamalar
ANALYTICS_PROPERTY_TYPE_UNSPECIFIED Bilinmeyen veya belirtilmemiş mülk türü
ANALYTICS_PROPERTY_TYPE_ORDINARY Sıradan Google Analytics mülkü
ANALYTICS_PROPERTY_TYPE_SUBPROPERTY Google Analytics alt mülkü
ANALYTICS_PROPERTY_TYPE_ROLLUP Google Analytics toplayıcı mülkü

BillInfo

Fatura tutarını içerir.

JSON gösterimi 
{
  "baseFee": {
    object (Money)
  },
  "eventFee": {
    object (Money)
  },
  "priceProtectionCredit": {
    object (Money)
  },
  "total": {
    object (Money)
  }
}
Alanlar
baseFee

object (Money)

Aylık temel ücretin tutarı.
eventFee

object (Money)

Etkinlik ücretinin tutarı.
priceProtectionCredit

object (Money)

Fiyat koruma kredisinin tutarı (yalnızca uygun müşteriler tarafından kullanılabilir).
total

object (Money)

Faturanın toplam tutarı.

Para

Para birimi türüyle birlikte bir para tutarını gösterir.

JSON gösterimi 
{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}
Alanlar
currencyCode

string

ISO 4217'de tanımlanan üç harfli para birimi kodu.
units

string (int64 format)

Tutarın tam birimleri. Örneğin, currencyCode "USD" ise 1 birim, bir ABD dolarıdır.
nanos

integer

Tutarın nano (10^-9) birim sayısı. Değer, -999.999.999 ile +999.999.999 arasında (değerler dahil) olmalıdır. units pozitifse nanos pozitif veya sıfır olmalıdır. units sıfırsa nanos pozitif, sıfır veya negatif olabilir. units negatifse nanos negatif veya sıfır olmalıdır. Örneğin -1,75 ABD doları,units=-1 ve nanos=-750.000.000 olarak gösterilir.