Method: organizations.reportPropertyUsage

Pobierz dane o użyciu i rozliczeniach usług w usługach w organizacji za wybrany miesiąc.

Aby wyświetlać dane rozliczeniowe i dane o użytkowaniu, użytkownik musi mieć w organizacji klienta bezpośredniego rolę administratora organizacji lub administratora rozliczeniowego.

Aby wyświetlać dane dotyczące płatności i wykorzystania, użytkownik musi mieć rolę administratora organizacji lub administratora rozliczeniowego w organizacji partnera handlowego. Aby wyświetlać tylko dane o wykorzystaniu, użytkownik musi mieć rolę administratora organizacji lub administratora rozliczeniowego w organizacji klienta partnera handlowego.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
organization

string

Wymagane. Określa organizację, której wykorzystanie usługi będzie wyświetlane.

Format: organizations/{org_id}

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "month": string
}
Pola
month

string

Wymagane. Miesiąc docelowy, w którym mają być wyświetlane informacje o użyciu usługi.

Format: RRRR-MM. Na przykład „2025-05”.

Treść odpowiedzi

Wiadomość odpowiedzi dla wywołania RPC organizations.reportPropertyUsage.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "propertyUsages": [
    {
      object (PropertyUsage)
    }
  ],
  "billInfo": {
    object (BillInfo)
  }
}
Pola
propertyUsages[]

object (PropertyUsage)

Dane o użytkowaniu wszystkich usług w określonej organizacji i w danym miesiącu.
billInfo

object (BillInfo)

Kwota rachunku w określonej organizacji i miesiącu.

Jeśli użytkownik ma dostęp tylko do danych o użytkowaniu, to pole będzie puste.

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

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

PropertyUsage

Zawiera liczbę zdarzeń odebranych przez usługę wraz z metadanymi, które wpływają na liczbę zdarzeń billable.

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

string

Nazwa zasobu usługi w interfejsie Google Analytics Admin API.

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

string

Wyświetlana nazwa usługi.
accountId

string (int64 format)

Identyfikator konta nadrzędnego usługi.
serviceLevel

enum (AnalyticsServiceLevel)

Poziom usługi w usłudze.
propertyType

enum (AnalyticsPropertyType)

Podtyp usługi analitycznej. Ma to wpływ na liczbę zdarzeń podlegających rozliczeniu.
totalEventCount

string (int64 format)

Łączna liczba zdarzeń, które usługa otrzymała w danym miesiącu.
billableEventCount

string (int64 format)

Liczba zdarzeń, za które usługa jest obciążana w danym miesiącu.

AnalyticsPropertyType

Rodzaje usługi w Google Analytics.

Wartości w polu enum
ANALYTICS_PROPERTY_TYPE_UNSPECIFIED Nieznany lub nieokreślony typ usługi
ANALYTICS_PROPERTY_TYPE_ORDINARY Zwykła usługa w Google Analytics
ANALYTICS_PROPERTY_TYPE_SUBPROPERTY Usługa podrzędna w Google Analytics
ANALYTICS_PROPERTY_TYPE_ROLLUP Usługa o pełnym zakresie w Google Analytics

BillInfo

Zawiera kwotę rachunku.

Zapis JSON 
{
  "baseFee": {
    object (Money)
  },
  "eventFee": {
    object (Money)
  },
  "priceProtectionCredit": {
    object (Money)
  },
  "total": {
    object (Money)
  }
}
Pola
baseFee

object (Money)

Kwota miesięcznej opłaty podstawowej.
eventFee

object (Money)

Wysokość opłaty za wydarzenie.
priceProtectionCredit

object (Money)

Kwota kredytu w ramach ochrony ceny. Jest ona dostępna tylko dla kwalifikujących się klientów.
total

object (Money)

Łączna kwota rachunku.

Pieniądze

Reprezentuje kwotę pieniędzy z określeniem typu waluty.

Zapis JSON 
{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}
Pola
currencyCode

string

Trzyliterowy kod waluty zdefiniowany w normie ISO 4217.
units

string (int64 format)

Całe jednostki kwoty. Jeśli na przykład currencyCode to "USD", to 1 jednostka to 1 dolar amerykański.
nanos

integer

Liczba nanounitów (10^-9) kwoty. Wartość musi mieścić się w przedziale od -999 999 999 do +999 999 999 (włącznie). Jeśli wartość units jest dodatnia, wartość nanos musi być dodatnia lub wynosić zero. Jeśli units wynosi zero, nanos może być dodatnia, ujemna lub wynosić zero. Jeśli wartość units jest ujemna, wartość nanos musi być ujemna lub równa zero. Na przykład wartość $-1,75 jest przedstawiana jako units=-1 i nanos=-750 000 000.