Method: organizations.reportPropertyUsage

Recupera i dati di utilizzo e fatturazione per le proprietà all'interno dell'organizzazione per il mese specificato.

Per ogni organizzazione cliente diretta, l'utente deve essere amministratore organizzazione/amministratore di fatturazione dell'organizzazione per visualizzare i dati di fatturazione e utilizzo.

Per ogni organizzazione cliente del partner di vendita, l'utente deve essere amministratore dell'organizzazione/amministratore di fatturazione dell'organizzazione del partner di vendita per visualizzare i dati di fatturazione e utilizzo oppure amministratore dell'organizzazione/amministratore di fatturazione dell'organizzazione cliente del partner di vendita per visualizzare solo i dati di utilizzo.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
organization

string

Obbligatorio. Specifica l'organizzazione il cui utilizzo delle proprietà verrà elencato.

Formato: organizations/{org_id}

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "month": string
}
Campi
month

string

Obbligatorio. Il mese di destinazione in cui elencare gli utilizzi della proprietà.

Formato: AAAA-MM. Ad esempio, "2025-05"

Corpo della risposta

Messaggio di risposta per l'RPC organizations.reportPropertyUsage.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "propertyUsages": [
    {
      object (PropertyUsage)
    }
  ],
  "billInfo": {
    object (BillInfo)
  }
}
Campi
propertyUsages[]

object (PropertyUsage)

Dati sull'utilizzo per tutte le proprietà dell'organizzazione e del mese specificati.
billInfo

object (BillInfo)

Importo della fattura nell'organizzazione e nel mese specificati.

Sarà vuoto se l'utente ha accesso solo ai dati di utilizzo.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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

PropertyUsage

Contiene il conteggio degli eventi ricevuti dalla proprietà, insieme ai metadati che influenzano il volume degli eventi billable.

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

string

Il nome della risorsa della proprietà dell'API Google Analytics Admin.

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

string

Il nome visualizzato della proprietà.
accountId

string (int64 format)

L'ID dell'account principale della proprietà.
serviceLevel

enum (AnalyticsServiceLevel)

Il livello di servizio della proprietà.
propertyType

enum (AnalyticsPropertyType)

Il sottotipo della proprietà Analytics. Questo influisce sul conteggio degli eventi fatturabili.
totalEventCount

string (int64 format)

Numero totale di eventi ricevuti dalla proprietà durante il mese richiesto.
billableEventCount

string (int64 format)

Il numero di eventi per i quali la proprietà viene fatturata nel mese richiesto.

AnalyticsPropertyType

Tipi di proprietà Google Analytics.

Enum
ANALYTICS_PROPERTY_TYPE_UNSPECIFIED Tipo di proprietà sconosciuto o non specificato
ANALYTICS_PROPERTY_TYPE_ORDINARY Proprietà Google Analytics standard
ANALYTICS_PROPERTY_TYPE_SUBPROPERTY Sottoproprietà Google Analytics
ANALYTICS_PROPERTY_TYPE_ROLLUP Proprietà rollup Google Analytics

BillInfo

Contiene l'importo della fattura.

Rappresentazione JSON 
{
  "baseFee": {
    object (Money)
  },
  "eventFee": {
    object (Money)
  },
  "priceProtectionCredit": {
    object (Money)
  },
  "total": {
    object (Money)
  }
}
Campi
baseFee

object (Money)

L'importo della tariffa base mensile.
eventFee

object (Money)

L'importo della tariffa per l'evento.
priceProtectionCredit

object (Money)

L'importo del credito per la protezione del prezzo, disponibile solo per i clienti idonei.
total

object (Money)

L'importo totale del conto.

Denaro

Rappresenta un importo di denaro con il relativo tipo di valuta.

Rappresentazione JSON 
{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}
Campi
currencyCode

string

Il codice valuta di tre lettere definito nello standard ISO 4217.
units

string (int64 format)

Le unità intere dell'importo. Ad esempio, se currencyCode è "USD", un'unità corrisponde a un dollaro statunitense.
nanos

integer

Numero di unità nano (10^-9) dell'importo. Il valore deve essere compreso tra -999.999.999 e +999.999.999 inclusi. Se units è positivo, nanos deve essere positivo o zero. Se units è zero, nanos può essere positivo, zero o negativo. Se units è negativo, nanos deve essere negativo o zero. Ad esempio, -1,75 $ è rappresentato come units=-1 e nanos=-750.000.000.