Esportare i dati di Channel Services in BigQuery

Questa pagina mostra come configurare un'esportazione di Channel Services e descrive anche lo schema disponibile per un'esportazione.

Con BigQuery, puoi esportare i dati di fatturazione di Channel Services in un set di dati BigQuery specificato. Questi dati possono aiutarti a eseguire un'analisi dettagliata del modo in cui i tuoi clienti o partner di canale utilizzano i servizi che offri.

Le esportazioni da Channel Services contengono dati specifici del rivenditore non inclusi nelle esportazioni di Fatturazione Cloud. compresi i costi, i crediti e i dati sull'utilizzo con le regole di ricalcolo dei prezzi configurate. Queste esportazioni aggregano anche tutte le informazioni relative agli account di fatturazione principali dei tuoi clienti in un unico set di dati.

Tuttavia, i dati di un'esportazione di Channel Services sono compatibili con quelli delle esportazioni della fatturazione Cloud e puoi utilizzare le query per unire entrambi i set di dati per l'analisi.

Per informazioni sulle esportazioni di fatturazione Cloud per i non rivenditori, consulta la sezione sulla configurazione delle esportazioni di fatturazione Cloud in BigQuery.

Prima di iniziare

Prima di iniziare a esportare i dati di fatturazione di Channel Services, devi:

  • Configura un progetto per l'hosting del set di dati BigQuery Assicurati che la fatturazione sia abilitata per il progetto.
  • Abilita l'API BigQuery Data Transfer Service nel progetto.
  • Crea un set di dati per i dati esportati.

Se hai già un progetto e un set di dati BigQuery per le esportazioni dei dati di fatturazione Cloud, puoi riutilizzarli per l'esportazione di Channel Services.

Per informazioni dettagliate sulla configurazione di un progetto e di un set di dati, consulta Configurare l'esportazione dei dati di fatturazione Cloud in BigQuery.

Autorizzazioni richieste per le esportazioni

Per attivare e configurare le esportazioni di Channel Services, devi disporre dei seguenti ruoli:

Seleziona un progetto e un set di dati

Nella Partner Sales Console, seleziona un progetto e un set di dati in BigQuery per archiviare i dati di Channel Services. Abilita la fatturazione nel progetto, se non è già attivata.

Quando selezioni o crei un set di dati BigQuery, puoi scegliere una delle località BigQuery supportate per il set di dati. Quando attivi l'esportazione dei dati di Channel Services per la prima volta per ogni origine dati (Google Cloud o Google Workspace):

  • Se configuri il tuo [BigQuery

    set di dati](/bigquery/docs/datasets-intro) per utilizzare una località multi-regione, i dati di esportazione di BigQuery sono disponibili per ogni origine dati selezionata dall'inizio del mese precedente. Ad esempio, se attivi BigQuery Export il 23 settembre, l'esportazione includerà i dati a partire dal 1° agosto.

  • Se configuri il tuo [BigQuery

    set di dati](/bigquery/docs/datasets-intro) per utilizzare una località di regione (diversa da multi-regione US o EU), i dati di BigQuery Export sono disponibili per ogni origine dati selezionata a partire dalla data di attivazione dell'esportazione e successivamente. In altre parole, i dati di BigQuery Export non vengono aggiunti in modo retroattivo per le posizioni dei set di dati non multiregione, pertanto non vedrai i dati di BigQuery Export precedenti all'attivazione dell'esportazione.

Per esportare i dati di fatturazione per più account Partner Sales Console, segui questi passaggi:

  1. Nel set di dati BigQuery in cui vuoi esportare i dati, assicurati che gli amministratori della fatturazione di ogni account Partner Sales Console abbiano le autorizzazioni per visualizzare il set di dati.
  2. Quando configuri l'esportazione dei dati di fatturazione in ogni account Partner Sales Console, seleziona il set di dati unificato.

Località BigQuery supportate

BigQuery supporta due tipi di regioni.

Più regioni

La tabella seguente elenca le regioni multiple in cui è supportata l'esportazione dei dati di BigQuery di Channel Services.

Descrizione multiregionale Nome multiregione
Data center all'interno degli stati membri (link esterno) dell'Unione Europea EU
Data center negli Stati Uniti US

Regioni

La tabella seguente elenca le regioni delle Americhe in cui è supportata l'esportazione dei dati di BigQuery di Channel Services.

Descrizione della regione Nome della regione
Iowa us-central1
Las Vegas us-west4
Los Angeles us-west2
Montréal northamerica-northeast1
Virginia del Nord us-east4
Oregon us-west1
Salt Lake City us-west3
San Paolo southamerica-east1
Carolina del Sud us-east1

La tabella seguente elenca le regioni dell'Asia-Pacifico in cui è supportata l'esportazione dei dati di BigQuery di Channel Services.

Descrizione della regione Nome della regione
Hong Kong asia-east2
Giacarta asia-southeast2
Mumbai asia-south1
Osaka asia-northeast2
Seul asia-northeast3
Singapore asia-southeast1
Sydney australia-southeast1
Taiwan asia-east1
Tokyo asia-northeast1

La tabella seguente elenca le regioni in Europa in cui è supportata l'esportazione dei dati di BigQuery di Channel Services.

Descrizione della regione Nome della regione
Belgio europe-west1
Finlandia europe-north1
Francoforte europe-west3
Londra europe-west2
Paesi Bassi europe-west4
Varsavia europe-central2
Zurigo europe-west6

Abilita l'esportazione

Prima di attivare l'esportazione dei dati, prendi nota dell'ID set di dati completo, che è nel formato PROJECT_ID:DATASET_NAME.

Per attivare l'esportazione di Channel Services:

  1. In Partner Sales Console, apri la pagina Fatturazione.
  2. Seleziona Esportazione della fatturazione.
  3. Inserisci l'ID completo del set di dati nel campo Set di dati di rifatturazione.
  4. Seleziona le Origini dati per cui esportare i dati.
  5. Fai clic su Aggiorna. *Se ti viene richiesto di aggiornare le autorizzazioni del set di dati, fai clic su Aggiorna*.

Interfaccia utente per l'attivazione delle esportazioni di rifatturazione

Una volta configurata, l'esportazione della fatturazione fornisce ogni giorno i dati incrementali sull'utilizzo. La tabella di esportazione non viene visualizzata finché l'esportazione della fatturazione non viene eseguita per il tuo account per la prima volta. Il set di dati contiene i dati dal momento in cui è stato configurato per la prima volta per conservare i dati.

Per interrompere l'esportazione dei dati di costo della rifatturazione verso il set di dati, fai clic su Disattiva esportazione dati di fatturazione nella pagina Rifatturazione dei clienti. Per riattivare l'esportazione, segui i passaggi precedenti per specificare un ID set di dati.

I dati di costo relativi alla rifatturazione potrebbero non essere disponibili per la durata in cui l'esportazione è stata disattivata. Se hai eliminato dati esportati durante questo periodo, non possiamo eseguire il backfill dei record eliminati.

Autorizzazioni degli account di servizio richieste

L'esportazione dei dati di Channel Services utilizza un account di servizio di proprietà e gestito da Google e autorizzato a scrivere record di fatturazione in una tabella. L'account di servizio è:

cloud-channel-billing-reporting-rebilling@system.gserviceaccount.com

Questo account di servizio richiede il ruolo predefinito: roles/bigquery.dataEditor per consentire le esportazioni. Per configurare le autorizzazioni, segui i passaggi per attivare l'esportazione.

Esegui query sui dati in modo efficiente

Per impostazione predefinita, la tabella BigQuery è partizionata per export_time e raggruppata per payer_billing_account_id. Ciò significa che la tabella è suddivisa in partizioni più piccole, ognuna delle quali è ulteriormente suddivisa in cluster più piccoli. L'utilizzo delle chiavi di partizione e cluster in una query aiuterà BigQuery a individuare rapidamente i dati pertinenti, il che può ridurre notevolmente il costo della query.

Ad esempio, questa query è efficiente rispetto a una query senza partizione e chiavi di clustering:

SELECT
  billing_account_id
  currency,
  invoice.month,
  -- Divide by currency_conversion_rate if converting non-USD to USD.
  SUM(cost)
    + SUM(
      IFNULL(
        (SELECT SUM(c.amount) FROM UNNEST(credits) AS c), 0))
    AS total
FROM PROJECT_ID.DATASET_NAME.reseller_billing_detailed_export_v1
WHERE
  export_time BETWEEN TIMESTAMP(START_DATE)
    AND TIMESTAMP(END_DATE)
  AND payer_billing_account_id IN (PAYER_BILLING_ACCOUNT_IDS)
GROUP BY
  billing_account_id,
  currency,
  invoice.month
ORDER BY
  billing_account_id,
  currency,
  invoice.month;

Per ulteriori informazioni su partizionamento, clustering e best practice, consulta i seguenti link:

  1. Eseguire query sulle tabelle partizionate
  2. Eseguire query sulle tabelle in cluster
  3. Ottimizzare il calcolo delle query
  4. Best practice per controllare i costi in BigQuery

Trovare l'ID account di fatturazione del pagatore

Per trovare l'ID account di fatturazione del pagatore, apri la pagina degli account di fatturazione di Partner Sales Console e fai clic sulla scheda Fatturazione partner.

Puoi vedere tutti gli account di fatturazione e gli ID account di fatturazione del pagatore.

ID account di fatturazione del pagatore

Configurare i controlli di accesso per altri utenti nel set di dati di esportazione

Esistono diversi modi per configurare i controlli di accesso ai dati in BigQuery Export. Per ulteriori informazioni, consulta i controlli di accesso di BigQuery.

Per assicurarti che gli utenti abbiano accesso solo ai dati che sono autorizzati a visualizzare, ti consigliamo di configurare le viste autorizzate per condividere i dati del set di dati esportato.

Per l'esportazione continua dei dati, quando configuri le autorizzazioni per gli utenti, assicurati che l'account di servizio cloud-channel-billing-reporting-rebilling@system.gserviceaccount.com abbia sempre accesso completo come editor al set di dati di esportazione.

Schema tabella

Il seguente schema descrive i dati nella tabella BigQuery.

Nel tuo set di dati BigQuery, l'esportazione dettagliata dei dati di rifatturazione viene caricata in una tabella di dati denominata reseller_billing_detailed_export_v1.

Campo Tipo Descrizione
billing_account_id Stringa L'ID account a cui è associato l'utilizzo, che può essere del cliente o tuo. A seconda della famiglia di prodotti, può trattarsi di un account di fatturazione o di Cloud Identity.
payer_billing_account_id Stringa L'ID del tuo account di fatturazione principale.
invoice.month Stringa L'anno e il mese (AAAAMM) della fattura che include le voci relative ai costi. Ad esempio, "202101" corrisponde a gennaio 2021.
cost_type Stringa Il tipo di costo rappresentato da questa voce: Regular (Normale), Tax (Imposte), Adjustment (Aggiustamento) o Rounding (Arrotondamento).
service.id Stringa L'ID del servizio a cui è associato l'utilizzo.
service.description Stringa Il servizio Google che ha registrato i dati di fatturazione.
sku.id Stringa L'ID SKU della risorsa utilizzata dal servizio.
sku.description Stringa Una descrizione del tipo di risorsa utilizzata dal servizio. Ad esempio, Cloud Storage è di tipo Standard Storage US.
usage_start_time Timestamp L'ora di inizio dell'intervallo di utilizzo orario del costo calcolato. L'utilizzo e i costi di tutti i servizi sono visualizzati con granularità oraria. L'utilizzo dei servizi a lunga esecuzione è distribuito su più intervalli orari. Per i prodotti in abbonamento, corrisponde all'inizio del mese di fatturazione.
usage_end_time Timestamp L'ora di fine dell'intervallo di utilizzo orario del costo calcolato. L'utilizzo e i costi di tutti i servizi sono visualizzati con granularità oraria. L'utilizzo dei servizi a lunga esecuzione è distribuito su più intervalli orari. Per i prodotti in abbonamento, corrisponde alla fine del mese di fatturazione.
project Struct Informazioni sul progetto Google Cloud che ha generato i dati di fatturazione Cloud.
project.number Stringa Un identificatore univoco e anonimizzato, generato internamente per il progetto Google Cloud che ha generato i dati di fatturazione Cloud.
project.id Stringa L'ID del progetto Google Cloud che ha generato i dati di fatturazione Cloud.
project.name Stringa Il nome del progetto Google Cloud che ha generato i dati di fatturazione Cloud.
project.labels Struct, ripetuto
project.labels.key Stringa Se sono presenti etichette, la parte relativa alla chiave della coppia chiave-valore.
project.labels.value Stringa Se sono presenti etichette, la parte relativa al valore della coppia chiave-valore.
project.ancestry_numbers Stringa I predecessori nella gerarchia di risorse del progetto identificati da project.id.
labels Struct, ripetuto
labels.key Stringa Se sono presenti etichette, la parte relativa alla chiave della coppia chiave-valore.
labels.value Stringa Se sono presenti etichette, la parte relativa al valore della coppia chiave-valore.
system_labels Struct, ripetuto
system_labels.key Stringa Se sono presenti etichette di sistema, la parte relativa alla chiave della coppia chiave-valore.
system_labels.value Stringa Se sono presenti etichette di sistema, la parte relativa al valore della coppia chiave-valore.
location.location Stringa Posizione di utilizzo a livello di paese, regione o zona. Mostra global per le risorse senza una posizione specifica. Per saperne di più, consulta Regioni e zone.
location.country Stringa Quando location.location è un paese, una regione o una zona, questo campo corrisponde al paese di utilizzo. Ad esempio, US. Per saperne di più, consulta Regioni e zone.
location.region Stringa Quando location.location è un paese o una regione, questo campo corrisponde alla regione di utilizzo. Ad esempio, us-central1. Per saperne di più, consulta Regioni e zone.
location.zone Stringa Quando location.location è una zona, questo campo è la zona di utilizzo. Ad esempio, us-central1-a. Per saperne di più, consulta Regioni e zone.
resource Struct Descrive la struttura e il valore delle informazioni pertinenti alle risorse di servizio (ad esempio macchine virtuali o un'unità SSD) che generano l'utilizzo del servizio.
resource.name Stringa Un identificatore di servizio specifico per la risorsa che ha generato l'utilizzo pertinente. Possono essere generati dagli utenti.
resource.global_name Stringa Un identificatore di servizio univoco globale per la risorsa che ha generato l'utilizzo pertinente.
cost Numerico Il costo dell'utilizzo prima di applicare eventuali crediti. Per ottenere il costo totale inclusi i crediti, aggiungi credits.amount a cost.
currency Stringa La valuta di fatturazione del costo. Per saperne di più, vedi Valuta locale per fatturazione e pagamenti.
currency_conversion_rate Numero in virgola mobile Il tasso di cambio dai dollari statunitensi alla valuta locale. In pratica, cost ÷ currency_conversion_rate è il costo in dollari statunitensi.
usage.amount Numerico La quantità di usage.unit utilizzata.
usage.unit Stringa L'unità di misura di base per la misurazione dell'utilizzo delle risorse. Ad esempio, l'unità base per l'archiviazione standard è byte-secondi.
usage.amount_in_pricing_unit Numerico La quantità di utilizzo di usage.pricing_unit.
usage.pricing_unit Stringa Le unità di misura per l'utilizzo delle risorse.
credits Struct, ripetuto Contiene campi che descrivono la struttura e il valore dei crediti.
credits.id Stringa Se compilato, indica che un credito è associato allo SKU prodotto.
credits.full_name Stringa Il nome del credito associato allo SKU prodotto.
credits.type Stringa Questo campo descrive lo scopo o l'origine di credits.id.
credits.name Stringa Una descrizione del credito applicato all'utilizzo.
credits.amount Numerico L'importo del credito applicato all'utilizzo.
credits.channel_partner_amount Numerico L'importo del credito applicato all'utilizzo, dopo che sono stati effettuati i markup di rifatturazione e gli sconti. In base al channel_partner_name e al ChannelPartnerRepricingConfig associato. Se credits.type è RESELLER_MARGIN, questo importo sarà pari a zero.
credits.customer_amount Numerico L'importo del credito applicato all'utilizzo, dopo che sono stati effettuati i markup di rifatturazione e gli sconti. In base al customer_name e al CustomerRepricingConfig associato. Se credits.type è RESELLER_MARGIN, questo importo sarà pari a zero.
adjustmentsInfo Struct, ripetuto Contiene campi che descrivono la struttura e il valore di un aggiustamento alle voci di costo.
adjustmentsInfo.adjustment_id Stringa Se compilato, indica che un aggiustamento è associato a una voce di costo. adjustmentsInfo.adjustments_id è l'ID univoco per tutti gli aggiustamenti causati da un problema.
adjustmentsInfo.adjustment_description Stringa Una descrizione dell'aggiustamento e della relativa causa.
adjustmentsInfo.adjustment_type Stringa Il tipo di aggiustamento.
adjustmentsInfo.adjustment_mode Stringa Modalità di emissione dell'aggiustamento,
export_time Timestamp Tempo di elaborazione associato a un'aggiunta di dati di fatturazione. Questo valore aumenterà sempre a ogni nuova esportazione. Utilizza la colonna export_time per conoscere la data dell'ultimo aggiornamento dei dati di fatturazione esportati.
entitlement_name Stringa Il nome della risorsa del diritto dell'API Cloud Channel. Utilizza il formato: accounts/{account}/customers/{customer}/entitlements/{entitlement}
channel_partner_name Stringa (Solo per i distributori) Il nome della risorsa del partner di canale che vende al cliente finale. Utilizza il formato: accounts/{account}/channelPartnerLinks/{channelPartner}.
channel_partner_cost Numerico (Solo per i distributori) Il costo per il partner di canale, identificato da channel_partner_name, dopo l'applicazione di un ChannelPartnerRepricingConfig esistente.
customer_name Stringa Il nome della risorsa del cliente del rivenditore che ha sfruttato questo utilizzo nel formato accounts/{account}/customers/{customer}
customer_cost Numerico Il costo per il cliente del rivenditore identificato dalla colonna customer_name, dopo l'applicazione di CustomerRepricingConfig, se esistente.
cost_at_list Numerico Il costo se l'addebito fosse stato effettuato in base al prezzo al pubblico.
customer_repricing_config_name Stringa Il nome della risorsa dell'API Cloud Channel CustomerRepricingConfig. Utilizza il formato: accounts/{account}/customers/{customer}/customerRepricingConfigs/{id}.
channel_partner_repricing_config_name Stringa (Solo per i distributori) Il nome della risorsa dell'API Cloud Channel ChannelPartnerRepricingConfig. Utilizza il formato: accounts/{account}/channelPartnerLinks/{channelPartner}/channelPartnerRepricingConfigs/{id}.
tags Struct Campi che descrivono il tag, ad esempio chiave, valore e spazio dei nomi.
tags.key Stringa Il nome breve o il nome visualizzato della chiave associata a questo determinato tag.
tags.value Stringa Le risorse associate a una chiave tag. In un determinato momento, a una risorsa per una determinata chiave può essere associato esattamente un valore.
tags.inherited Booleano Indica se un'associazione di tag è ereditata (Tag ereditati = True) o diretta/non ereditata (Tag ereditati = False).
tags.namespace Stringa Rappresenta la gerarchia delle risorse che definisce la chiave e i valori del tag. Lo spazio dei nomi può essere combinato con i nomi brevi della chiave tag e del valore tag per creare un nome univoco a livello globale e completamente qualificato per la chiave tag o il valore tag.
customer_correlation_id Stringa L'ID CRM esterno del cliente. Viene compilato solo se esiste un ID CRM per questo cliente.
price Struct Campi che descrivono la struttura e il valore relativi ai prezzi addebitati per l'utilizzo.
price.effective_price Numerico Il prezzo addebitato per l'utilizzo.
price.tier_start_amount Numerico Il numero minimo di unità per il livello di prezzo di uno SKU. Ad esempio, un SKU con tre livelli di prezzo, ad esempio 0-100 unità, 101-1000 unità e oltre 1001 unità, mostrerà tre righe di prezzo per lo SKU, con 0, 101 e 1001 nel campo price.tier_start_amount che rappresentano la quantità unitaria iniziale per i livelli di prezzo dello SKU. Scopri di più sui livelli di prezzo di Google Cloud.
price.unit Stringa L'unità di misura in cui sono specificati i prezzi e viene misurato l'utilizzo delle risorse (ad es. gibibyte, tebibyte, mese, anno, gibibyte/ora, gibibyte/mese o conteggio). Il valore nel campo price.unit corrisponda al valore nel campo usage.pricing_unit.
price.pricing_unit_quantity Numerico La quantità unitaria del livello di prezzo di SKU. Ad esempio, se il prezzo del livello è 1 $per 1000000 byte, questa colonna mostrerà 1000000.
transaction_type Stringa Il tipo di transazione del venditore. Il tipo di transazione potrebbe essere uno dei seguenti:
  • GOOGLE = 1: servizi venduti da Google Cloud.
  • THIRD_PARTY_RESELLER = 2: servizi di terze parti rivenduti da Google Cloud.
  • THIRD_PARTY_AGENCY = 3: servizi di terze parti venduti da un partner, con Google Cloud che agisce come agente.
seller_name Stringa Il nome legale del venditore.
subscription Struct Campi che descrivono gli impegni basati sulla spesa o sulle risorse. Puoi utilizzare questi campi per analizzare le commissioni per impegni specifici.
subscription.instance_id Stringa L'ID abbonamento collegato a un impegno.

Note aggiuntive sullo schema

Esistono alcune note aggiuntive sullo schema.

Colonne non applicabili a Google Workspace

Quando una colonna o un campo non si applica a una famiglia di prodotti, i dati esportati per questa famiglia contengono null in questo campo. I seguenti campi non si applicano alle esportazioni di Google Workspace:

  • project
  • labels
  • resource
  • credits
  • adjustmentsInfo
  • customer_repricing_config_name
  • channel_partner_repricing_config_name
  • tags
  • price.effective_price
  • price.tier_start_amount
  • transaction_type
  • seller_name

Colonne non applicabili agli ordini offline (anteprima)

Quando una colonna o un campo non si applica a una famiglia di prodotti, i dati esportati per questa famiglia di prodotti contengono null in questa colonna o in questo campo. Le seguenti colonne o campi non si applicano alle esportazioni della fatturazione degli ordini offline:

  • project
  • labels
  • system_labels
  • location
  • resource
  • credits
  • entitlement_name
  • channel_partner_name
  • channel_partner_cost
  • customer_name
  • customer_cost
  • cost_at_list
  • customer_repricing_config_name
  • channel_partner_repricing_config_name
  • tags
  • price.effective_price
  • price.tier_start_amount
  • transaction_type
  • seller_name

Altre note sull'esportazione di Google Workspace

Esistono diversi comportamenti speciali per le esportazioni di Google Workspace:

  • I dati di Google Workspace non contengono l'utilizzo del rivenditore.
  • Quando cost_type è tax e adjustment, usage.amount_in_pricing_units è sempre 1.
  • Nelle fatture di Google Workspace, le imposte vengono mostrate come una voce. Nell'esportazione, le imposte sono suddivise per cliente. Sebbene l'imposta totale debba corrispondere a quella indicata in fattura, le singole imposte potrebbero contenere piccole imprecisioni dovute all'arrotondamento.

billing_account_id

  • Per Google Cloud, si tratta dell'account di fatturazione Cloud a cui è associato l'utilizzo.
  • Per Google Workspace, si tratta dell'identità Cloud del cliente.
  • Per gli ordini offline, si tratta del nome del cliente.

service e sku

Per Google Workspace, queste colonne rappresentano "Prodotto" e "SKU" associati all'utilizzo. Scopri di più sugli ID prodotto e SKU.

usage_start_time e usage_end_time

Nel file CSV della fattura di Google Workspace, questo valore è rappresentato come date. Nelle esportazioni, questi valori sono rappresentati come timestamp:

  • Per usage_start_time, si tratta dell'ora di inizio (inclusa) dell'abbonamento, alle ore 00:00 PST della data di inizio.
  • Per usage_end_time, si tratta dell'ora di fine (esclusiva) dell'abbonamento, alle 00:00 PST del giorno successivo alla data di fine.

project.labels

Per Google Cloud, si tratta delle coppie chiave-valore nel progetto Google Cloud in cui si è verificato l'utilizzo. Per ulteriori informazioni, consulta la sezione Utilizzare le etichette.

labels

Per Google Cloud, si tratta delle coppie chiave-valore nella risorsa Google Cloud in cui si è verificato l'utilizzo. Per ulteriori informazioni, consulta la sezione Utilizzare le etichette.

system_labels

  • Per Google Cloud, si tratta delle coppie chiave-valore nella risorsa Google Cloud in cui si è verificato l'utilizzo. Per ulteriori informazioni, consulta la sezione Etichette di sistema disponibili.

  • Per Google Workspace, si tratta di metadati aggiuntivi relativi al costo, tra cui:

    • workspace.googleapis.com/domain_name: il nome di dominio del cliente.
    • workspace.googleapis.com/order_id: l'ID ordine.
    • workspace.googleapis.com/purchase_order_id: l'ID ordine di acquisto.
    • workspace.googleapis.com/subscription_id: l'ID abbonamento.
    • workspace.googleapis.com/usage_type: il tipo di utilizzo. Non applicabile se cost_type non è regular.

I tipi di utilizzo di Google Workspace includono:

  • COMMITMENT_TERM_START_ITEM: inizio di un abbonamento. In genere associato a un mese parziale per un abbonamento con impegno con fatturazione mensile e al periodo di fatturazione o contrattuale per un abbonamento prepagato.
  • COMMITMENT_TERM_END_ITEM: fine di un abbonamento. In genere associato agli addebiti dell'ultimo mese di un abbonamento con impegno fatturato mensilmente.
  • COMMITMENT_TERM_RENEWAL_ITEM: inizio di un periodo di abbonamento successivo.
  • COMMITMENT_MONTHLY_ITEM: utilizzo registrato per gli impegni esistenti all'inizio del mese. Nella maggior parte dei casi, l'addebito verrà esteso per tutto il mese.
  • COMMITMENT_SEATS_CHANGE_ITEM: registrato quando il livello di impegno cambia (aumento o diminuzione). Spesso inizia a metà mese e si estende fino alla fine del mese per un abbonamento con impegno con fatturazione mensile o fino alla fine del periodo di fatturazione o del contratto per un abbonamento prepagato.
  • COMMITMENT_CANCEL_ITEM: viene registrato quando un abbonamento viene annullato. Sono inclusi gli addebiti associati alla risoluzione anticipata. Rappresenta un addebito per il resto del periodo di contratto quando il contratto viene annullato a metà termine o un credito emesso per il resto del periodo di fatturazione quando un contratto viene modificato o annullato a metà termine.
  • FLEXIBLE_SEATS_ITEM: registra l'utilizzo per un determinato numero di utenti per un blocco contiguo di un determinato numero di giorni. Destinato solo agli utenti senza impegno.
  • COUPON_DISCOUNT_ITEM: importo dello sconto associato a un coupon.
  • MIGRATED_CREDIT_ITEM: credito proveniente dalla migrazione di Postini.
  • COMMITMENT_PREPAY_BILLING_PERIOD_ITEM: rappresenta i dati di utilizzo creati all'inizio del ciclo di pagamento per l'intero ciclo per un abbonamento prepagato con impegno.

usage.amount

Per l'utilizzo basato sulle utenze di Google Workspace, questo valore indica le utenze a pagamento. Ad esempio, utenze riservate agli impegni o numero di utenze a pagamento per il servizio flessibile.

usage.pricing_unit

  • Per Google Cloud, scopri di più sull'API Cloud Billing Catalog. {: track-type="tasks" class="external" track-name="externalLink" track-metadata-position="body"}
  • Per Google Workspace, si tratta di count.

credits.id

Per Google Cloud, si tratta di un identificatore univoco alfanumerico (12-b34-c56-d78) o di una descrizione del tipo di credito (Sconto per impegno di utilizzo: CPU ). Se il campo credits.id è vuoto, lo SKU prodotto non è associato a un credito.

credits.full_name

Per Google Cloud, si tratta di una descrizione leggibile di uncredits.id alfanumerico. Alcuni esempi sono credito per la prova gratuita o sconto per impegno di utilizzo basato sulla spesa . I valori credits.full_name vengono compilati solo per gli SKU con un credits.id alfanumerico. Se il valore di credits.id è una descrizione del tipo di credito (ad esempio Sconto per impegno di utilizzo: CPU), il campo credits.full_name sarà vuoto.

credits.type

Per Google Cloud, i tipi di credito includono:

  • COMMITTED_USAGE_DISCOUNT: contratti per uso confermato basati su risorse acquistati per Compute Engine in cambio di prezzi notevolmente scontati per l'utilizzo delle VM.
  • COMMITTED_USAGE_DISCOUNT_DOLLAR_BASE: contratti per uso confermato basati sulla spesa acquistati per servizi in cambio di un impegno di spesa minimo.
  • DISCOUNT: questo tipo di credito viene utilizzato per i crediti guadagnati al raggiungimento di una soglia di spesa contrattuale. Tieni presente che, nei report di fatturazione Cloud disponibili in Partner Sales Console, il tipo di credito sconto è indicato come Sconti basati sulla spesa (contrattuali).
  • FREE_TIER: alcuni servizi offrono l'utilizzo gratuito delle risorse fino ai limiti specificati. Per questi servizi, i crediti vengono applicati per implementare l'utilizzo del livello senza costi.
  • PROMOTION: questo tipo di credito include una prova senza costi di Google Cloud e crediti per le campagne di marketing oppure altri vantaggi per utilizzare Google Cloud. Se disponibili, i crediti promozionali sono considerati una forma di pagamento e vengono applicati automaticamente per ridurre l'importo totale della fattura.
  • RESELLER_MARGIN: se sei un rivenditore, il tipo di credito margine rivenditore indica gli sconti del Programma per rivenditori guadagnati per ogni voce idonea.
  • SUBSCRIPTION_BENEFIT: crediti guadagnati acquistando abbonamenti a lungo termine a servizi in cambio di sconti.
  • SUSTAINED_USAGE_DISCOUNT: Il tipo di credito per sconti per utilizzo sostenuto è uno sconto automatico guadagnato per l'esecuzione di risorse Compute Engine specifiche per una parte significativa del mese di fatturazione.

adjustmentsInfo

Per Google Cloud, questi valori vengono compilati solo se la voce di costo è stata generata in seguito a una modifica della fatturazione Cloud. Il tipo adjustmentsInfo contiene i dettagli sull'aggiustamento, se è stato emesso per correggere un errore o per altri motivi.

adjustmentsInfo.adjustment_type

Per Google Cloud, sono inclusi:

  • USAGE_CORRECTION: una correzione dovuta a un utilizzo errato registrato.
  • PRICE_CORRECTION: una correzione dovuta a regole per la determinazione del prezzo non corrette.
  • METADATA_CORRECTION: una correzione apportata ai metadati senza modificare il costo.
  • GOODWILL: un credito emesso per il cliente per l'avviamento.
  • SALES_BASED_GOODWILL: un credito emesso per il cliente per l'avviamento nell'ambito di un contratto.
  • SLA_VIOLATION: un credito emesso per il cliente a causa di una violazione di un obiettivo del livello di servizio (SLO).
  • BALANCE_TRANSFER: un aggiustamento per trasferire fondi da un account pagamenti a un altro.
  • ACCOUNT_CLOSURE: un aggiustamento per azzerare il saldo di un account chiuso.
  • GENERAL_ADJUSTMENT: una modifica generale dell'account di fatturazione Cloud.

adjustmentsInfo.adjustment_mode

Per Google Cloud, sono inclusi:

  • PARTIAL_CORRECTION: la correzione annulla parzialmente l'utilizzo e il costo originali.
  • COMPLETE_NEGATION_WITH_REMONETIZATION: la correzione annulla completamente l'utilizzo e il costo originali ed emette le voci corrette con utilizzo e costo aggiornati.
  • COMPLETE_NEGATION: la correzione annulla completamente l'utilizzo e il costo originali e non vengono rimonetizzati ulteriori utilizzi.
  • MANUAL_ADJUSTMENT: l'aggiustamento viene assegnato manualmente al costo e all'utilizzo.

price.effective_price

Per Google Cloud, si tratta del prezzo addebitato per l'utilizzo degli SKU e dei livelli di prezzo di Google Cloud o Google Maps Platform. Se il tuo account di fatturazione Cloud ha prezzi del contratto personalizzati, questo prezzo è specifico per la tua fatturazione Cloud. In caso contrario, si tratta del prezzo di listino dell'SKU o del livello SKU.