Method: organizations.reportPropertyUsage

Nutzungs- und Abrechnungsdaten für Properties in der Organisation für den angegebenen Monat abrufen.

Pro direkter Kundenorganisation muss der Nutzer Organisationsadministrator oder Abrechnungsadministrator der Organisation sein, um die Abrechnungs- und Nutzungsdaten aufzurufen.

Pro Kundenorganisation des Vertriebspartners muss der Nutzer Administrator oder Abrechnungsadministrator der Vertriebspartnerorganisation sein, um die Abrechnungs- und Nutzungsdaten aufzurufen. Alternativ muss er Administrator oder Abrechnungsadministrator der Kundenorganisation des Vertriebspartners sein, um nur die Nutzungsdaten aufzurufen.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
organization

string

Erforderlich. Gibt die Organisation an, deren Attributnutzung aufgeführt wird.

Format: organizations/{org_id}

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "month": string
}
Felder
month

string

Erforderlich. Der Zielmonat, in dem die Property-Nutzung aufgeführt werden soll.

Format: JJJJ-MM, z. B. „2025-05“

Antworttext

Antwortnachricht für den RPC „organizations.reportPropertyUsage“.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "propertyUsages": [
    {
      object (PropertyUsage)
    }
  ],
  "billInfo": {
    object (BillInfo)
  }
}
Felder
propertyUsages[]

object (PropertyUsage)

Nutzungsdaten für alle Properties in der angegebenen Organisation und im angegebenen Monat.
billInfo

object (BillInfo)

Rechnungsbetrag in der angegebenen Organisation und im angegebenen Monat.

Ist leer, wenn der Nutzer nur Zugriff auf Nutzungsdaten hat.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

PropertyUsage

Enthält die Anzahl der Ereignisse, die für die Property empfangen wurden, sowie Metadaten, die das Volumen der billable-Ereignisse beeinflussen.

JSON-Darstellung 
{
  "property": string,
  "displayName": string,
  "accountId": string,
  "serviceLevel": enum (AnalyticsServiceLevel),
  "propertyType": enum (AnalyticsPropertyType),
  "totalEventCount": string,
  "billableEventCount": string
}
Felder
property

string

Der Name der Property-Ressource der Google Analytics Admin API.

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

string

Der Anzeigename der Eigenschaft.
accountId

string (int64 format)

Die ID des übergeordneten Kontos der Property.
serviceLevel

enum (AnalyticsServiceLevel)

Die Serviceebene der Property.
propertyType

enum (AnalyticsPropertyType)

Der Untertyp der Analytics-Property. Das wirkt sich auf die Anzahl der abrechenbaren Ereignisse aus.
totalEventCount

string (int64 format)

Die Gesamtzahl der Ereignisse, die für die Property im angeforderten Monat erfasst wurden.
billableEventCount

string (int64 format)

Die Anzahl der Ereignisse, für die die Property im angeforderten Monat abgerechnet wird.

AnalyticsPropertyType

Typen der Google Analytics-Property.

Enums
ANALYTICS_PROPERTY_TYPE_UNSPECIFIED Unbekannter oder nicht angegebener Eigenschaftstyp
ANALYTICS_PROPERTY_TYPE_ORDINARY Normale Google Analytics-Property
ANALYTICS_PROPERTY_TYPE_SUBPROPERTY Google Analytics-Unterproperty
ANALYTICS_PROPERTY_TYPE_ROLLUP Google Analytics-Roll-up-Property

BillInfo

Enthält den Rechnungsbetrag.

JSON-Darstellung 
{
  "baseFee": {
    object (Money)
  },
  "eventFee": {
    object (Money)
  },
  "priceProtectionCredit": {
    object (Money)
  },
  "total": {
    object (Money)
  }
}
Felder
baseFee

object (Money)

Der Betrag der monatlichen Grundgebühr.
eventFee

object (Money)

Die Höhe der Veranstaltungsgebühr.
priceProtectionCredit

object (Money)

Der Betrag der Gutschrift für die Preisgarantie. Diese ist nur für berechtigte Kunden verfügbar.
total

object (Money)

Der Gesamtbetrag der Rechnung.

Geld

Stellt einen Geldbetrag mit Währungstyp dar.

JSON-Darstellung 
{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}
Felder
currencyCode

string

Der aus drei Buchstaben bestehende Währungscode gemäß ISO 4217
units

string (int64 format)

Die ganzen Einheiten des Betrags. Beispiel: Wenn currencyCode "USD" ist, dann entspricht eine Einheit 1 US-Dollar.
nanos

integer

Anzahl der Nanoeinheiten (10^-9) des Betrags. Der Wert muss im Bereich von -999.999.999 bis +999.999.999 liegen. Wenn units positiv ist, muss nanos positiv oder null sein. Wenn units null ist, kann nanos positiv, null oder negativ sein. Wenn units negativ ist, muss nanos negativ oder null sein. -1,75 $ wird z. B. als units = −1 und nanos = −750.000.000 dargestellt.