Esportare i dati di Channel Services in BigQuery

Nota: questa esportazione è disponibile solo per i partner di Google Cloud e Google Workspace. I dati di fatturazione di Google Workspace Essentials e Google Voice non sono inclusi nell'esportazione 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:

• Per BigQuery, se hai creato il set di dati di destinazione, devi avereBigQuery User per il progetto che contiene il set di dati. Se il set di dati è stato creato da qualcun altro, devi disporre del ruolo BigQuery Data Owner.

• Per attivare le esportazioni di Google Cloud, in Partner Sales Console devi disporre del ruolo Amministratore rivenditore Google Cloud.

  Scopri come assegnare i ruoli Google Cloud nella Console Partner Sales

• Per attivare le esportazioni di Google Workspace, devi essere un amministratore rivenditore o disporre dei privilegi di fatturazione di Google Workspace.

  Scopri di più sull'assegnazione dei ruoli di Google Workspace nella Partner Sales Console

• (Facoltativo) Project Viewer per il progetto che contiene il set di dati BigQuery di destinazione, per verificare automaticamente se la fatturazione è attivata nel progetto.

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 selezionato fonte di dati 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.

Nota: per l'esportazione della fatturazione degli ordini offline (anteprima), l'esportazione supporta solo le località dei set di dati multiregione.

Avviso: per i partner che disattivano e riattivano successivamente l'esportazione in BigQuery o modificano il set di dati di esportazione in un'altra posizione BigQuery, i dati potrebbero non essere disponibili per il periodo in cui l'esportazione è stata disattivata esplicitamente o tra l'ultima esportazione e il momento in cui è avvenuta la modifica del set di dati tra regioni. In questi casi non possiamo eseguire il backfill dei dati.

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.

Attenzione: se non hai precedentemente abilitato la fatturazione nel progetto, BigQuery potrebbe essere eseguito in modalità sandbox, il che potrebbe causare un comportamento imprevisto delle esportazioni. Scopri di più sull'upgrade dalla sandbox di BigQuery.

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*.

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.

Avviso: non modificare le tabelle di dati esportate.

La modifica di queste tabelle può causare l'interruzione delle esportazioni di dati. I dati aggiunti manualmente vengono persi finché non annulli le modifiche o non elimini la tabella. Se vuoi unire i dati di esportazioni precedenti di fatturazione Cloud in BigQuery, ti consigliamo di conservarli in tabelle separate e di utilizzare invece una query UNION.

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 della disattivazione. 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 è:

[e-mail]

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

Avviso: la rimozione di questo account di servizio mentre le esportazioni della fatturazione in BigQuery sono abilitate potrebbe comportare la perdita di dati.

Se rimuovi l'account di servizio, devi aggiungerlo di nuovo o riconfigurare l'autorizzazione del set di dati facendo clic sul pulsante Aggiorna nella pagina Esportazione della fatturazione. Non possiamo eseguire il backfill dei record eliminati o esportati se rimuovi i dati esportati o se reindirizzi l'esportazione a un altro set di dati.

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.

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.

Attenzione: non utilizzare il controllo dell'accesso a livello di riga o livello di colonna sul set di dati. L'attivazione di queste funzionalità di controllo dell'accesso dell'accesso comporta il fallimento dell'esportazione dei dati di fatturazione.

Per l'esportazione dei dati continua, quando configuri le autorizzazioni per gli utenti, assicurati che l'account di servizio [e-mail] abbia sempre accesso completo come editor al set di dati di esportazione.

Schema tabella

Avviso: il tentativo di modificare autonomamente lo schema di esportazione può comportare l'interruzione dell'esportazione dei dati. Se vuoi aggiungere o rimuovere colonne, puoi creare una visualizzazione o una visualizzazione materializzata oppure puoi eseguire un join con altre tabelle nelle query.

Se la tabella si trova in questo stato, devi ripristinare tutte le colonne corrette e nient'altro. Successivamente, potrebbe essere necessario andare alla pagina Esportazione fatturazione e fare clic su Aggiorna.

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 ulteriori informazioni, 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 ulteriori informazioni, consulta Regioni e zone.
location.zone	Stringa	Quando location.location è una zona, questo campo è la zona di utilizzo. Ad esempio, us-central1-a. Per ulteriori informazioni, 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}. Nota: per Google Cloud, il primo mese completo di dati con questo campo è gennaio 2023. Questo campo è "NULL" se il ricalcolo del prezzo è configurato per le offerte private di Cloud Marketplace.
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}. Nota: per Google Cloud, il primo mese completo di dati con questo campo è gennaio 2023.
tags	Struct	Campi che descrivono il tag, ad esempio chiave, valore e spazio dei nomi. Nota: per Google Cloud, il primo mese completo di dati con questi tag è gennaio 2023.
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 una definizione di tag è ereditata (Tags Inherited = True) o diretta/non ereditata (Tags Inherited = 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. Nota: per Google Cloud, il primo mese completo di dati con questo campo è marzo 2023.
price	Struct	Campi che descrivono la struttura e il valore relativi ai prezzi addebitati per l'utilizzo. Nota: per Google Cloud, il primo mese completo di dati con i campi dei prezzi è maggio 2023.
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. Nota: per Google Cloud, il primo mese completo di dati con questo campo è agosto 2023.
seller_name	Stringa	Il nome legale del venditore. Nota: per Google Cloud, il primo mese completo di dati con questo campo è agosto 2023.
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. Nota: per Google Cloud, il primo mese completo di dati con i campi dei prezzi è febbraio 2024.

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 sono 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.

Nota: per gli SKU di Google Drive precedenti, sku.description potrebbe non corrispondere alla colonna "Abbonamento" nel file CSV della fattura (ad esempio, il file CSV mostra "Spazio di archiviazione Google Drive da 20 GB", ma sku.description mostra 20 GB). Questo è normale per gli SKU di Google Drive precedenti. Questo valore è disponibile nella Partner Sales Console. Vai a un cliente specifico, fai clic sull'abbonamento precedente e poi su "Visualizza il piano di pagamento". Dovresti quindi vedere i valori che corrispondono a sku.description.

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 a pagamento 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.