Method: organizations.reportPropertyUsage

Obtiene los datos de uso y facturación de las propiedades de la organización para el mes especificado.

Por cada organización de cliente directo, el usuario debe ser administrador de la organización o administrador de facturación para ver los datos de facturación y uso.

Por cada organización cliente del socio de ventas, el usuario debe ser administrador de la organización o administrador de facturación en la organización del socio de ventas para ver los datos de facturación y uso, o bien administrador de la organización o administrador de facturación en la organización cliente del socio de ventas para ver solo los datos de uso.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
organization

string

Obligatorio. Especifica la organización cuyo uso de la propiedad se mostrará.

Formato: organizations/{org_id}

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON 
{
  "month": string
}
Campos
month

string

Obligatorio. Es el mes objetivo para enumerar los usos de la propiedad.

Formato: AAAA-MM. Por ejemplo, "2025-05"

Cuerpo de la respuesta

Es el mensaje de respuesta para la RPC de organizations.reportPropertyUsage.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON 
{
  "propertyUsages": [
    {
      object (PropertyUsage)
    }
  ],
  "billInfo": {
    object (BillInfo)
  }
}
Campos
propertyUsages[]

object (PropertyUsage)

Son los datos de uso de todas las propiedades de la organización y el mes especificados.
billInfo

object (BillInfo)

Es el importe de la factura en la organización y el mes especificados.

Estará vacío si el usuario solo tiene acceso a los datos de uso.

Permisos de autorización

Se necesita uno de los siguientes permisos de OAuth:

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

PropertyUsage

Contiene el recuento de eventos que recibió la propiedad, junto con metadatos que influyen en la cantidad de eventos de billable.

Representación JSON 
{
  "property": string,
  "displayName": string,
  "accountId": string,
  "serviceLevel": enum (AnalyticsServiceLevel),
  "propertyType": enum (AnalyticsPropertyType),
  "totalEventCount": string,
  "billableEventCount": string
}
Campos
property

string

Es el nombre del recurso de propiedad de la API de Google Analytics Admin.

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

string

Es el nombre visible de la propiedad.
accountId

string (int64 format)

Es el ID de la cuenta principal de la propiedad.
serviceLevel

enum (AnalyticsServiceLevel)

Es el nivel de servicio de la propiedad.
propertyType

enum (AnalyticsPropertyType)

Es el subtipo de la propiedad de Analytics. Esto afecta el recuento de eventos facturables.
totalEventCount

string (int64 format)

Es el recuento total de eventos que recibió la propiedad durante el mes solicitado.
billableEventCount

string (int64 format)

Es la cantidad de eventos por los que se factura la propiedad en el mes solicitado.

AnalyticsPropertyType

Son los tipos de propiedad de Google Analytics.

Enums
ANALYTICS_PROPERTY_TYPE_UNSPECIFIED Tipo de propiedad desconocido o no especificado
ANALYTICS_PROPERTY_TYPE_ORDINARY Propiedad estándar de Google Analytics
ANALYTICS_PROPERTY_TYPE_SUBPROPERTY Subpropiedad de Google Analytics
ANALYTICS_PROPERTY_TYPE_ROLLUP Propiedad de datos integrados de Google Analytics

BillInfo

Contiene el importe de la factura.

Representación JSON 
{
  "baseFee": {
    object (Money)
  },
  "eventFee": {
    object (Money)
  },
  "priceProtectionCredit": {
    object (Money)
  },
  "total": {
    object (Money)
  }
}
Campos
baseFee

object (Money)

Es el importe de la tarifa base mensual.
eventFee

object (Money)

Es el importe de la comisión del evento.
priceProtectionCredit

object (Money)

Es el importe del crédito de protección de precios, que solo está disponible para los clientes que cumplen con los requisitos.
total

object (Money)

Es el importe total de la factura.

Dinero

Representa un importe de dinero con su tipo de moneda.

Representación JSON 
{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}
Campos
currencyCode

string

Es el código de moneda de tres letras definido en la norma ISO 4217.
units

string (int64 format)

La unidad entera del importe. Por ejemplo, si currencyCode es "USD", 1 unidad es un dólar estadounidense.
nanos

integer

Número de unidades nano (10^-9) del importe. Debe ser un valor entre -999,999,999 y +999,999,999. Si units es positivo, nanos debe ser positivo o cero. Si units es cero, nanos puede ser positivo, cero o negativo. Si units es negativo, nanos debe ser negativo o cero. Por ejemplo, –$1.75 se representa como units=-1 y nanos=-750,000,000.