Esportare i dati di Channel Services in BigQuery

Nota: questa esportazione è disponibile solo per i partner Google Cloud e Google Workspace. I dati di fatturazione di Google Workspace Essentials e Google Voice non sono inclusi nell'esportazione di BigQuery.

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

Utilizzando 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 fornisci.

Le esportazioni da Channel Services contengono dati specifici del rivenditore non altrimenti inclusi nelle esportazioni di fatturazione Cloud. inclusi costi, crediti e dati sull'utilizzo con le regole di ricalcolo del prezzo configurate. Inoltre, queste esportazioni aggregano tutte le informazioni sugli account di fatturazione padre dei clienti in un unico set di dati.

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

Per informazioni sulle esportazioni della fatturazione Cloud non dei rivenditori, consulta la pagina relativa alla configurazione delle esportazioni della 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.
• Abilitare l'API BigQuery Data Transfer Service nel progetto.
• Crea un set di dati per i dati esportati.

Se disponi già di un progetto e di un set di dati BigQuery per le esportazioni dei dati di fatturazione Cloud, puoi riutilizzare il progetto e il set di dati 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 abilitare e configurare le esportazioni di Channel Services, devi disporre dei seguenti ruoli:

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

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

  Scopri come assegnare i ruoli di Google Cloud in Partner Sales Console

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

  Scopri come assegnare i ruoli di Google Workspace in Partner Sales Console

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

Seleziona un progetto e un set di dati

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

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 set di dati BigQuery in modo da utilizzare una località multiregionale, i dati di BigQuery Export sono disponibili per ogni origine dati selezionata dall'inizio del mese precedente. Ad esempio, se abiliti l'esportazione in BigQuery il 23 settembre, l'esportazione includerà i dati a partire dal 1° agosto.

• Se configuri il set di dati BigQuery in modo da utilizzare una località (diversa da una località con più regioni degli Stati Uniti o dell'UE), i dati di BigQuery Export sono disponibili per ogni origine dati selezionata a partire dalla data in cui abiliti l'esportazione. In altre parole, i dati di BigQuery Export non vengono aggiunti in modo retroattivo per le località di set di dati diversi da più regioni, pertanto i dati di esportazione BigQuery non verranno visualizzati prima dell'abilitazione dell'esportazione.

Avviso: per i partner che disattivano e riattivano l'esportazione o la modifica del set di dati di esportazione in BigQuery in una località BigQuery diversa, i dati potrebbero non essere disponibili per il periodo in cui l'esportazione è stata disattivata esplicitamente o tra l'ultima esportazione e quando si è verificata 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 per ogni account Partner Sales Console dispongano delle 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

Più regioni

Nella tabella seguente sono elencate le località multiregionali in cui è supportata l'esportazione dei dati di BigQuery di Channel Services.

Descrizione per più regioni	Nome più regioni
Data center negli stati membri dell'Unione Europea^1	EU
Data center negli Stati Uniti	US

Regioni

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

Descrizione della regione	Nome 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 seguente tabella elenca le regioni dell'Asia Pacifico in cui è supportata l'esportazione dei dati di BigQuery di Channel Services.

Descrizione della regione	Nome 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 seguente tabella elenca le regioni in Europa in cui è supportata l'esportazione dei dati di BigQuery di Channel Services.

Descrizione della regione	Nome 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 abilitare l'esportazione dei dati, prendi nota dell'ID completo del set di dati, che ha il formato PROJECT_ID:DATASET_NAME.

Attenzione: se non hai mai attivato la fatturazione nel progetto, BigQuery potrebbe essere eseguito in modalità sandbox e ciò 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 Update (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 quotidianamente dati sull'utilizzo incrementali. La tabella di esportazione non verrà visualizzata fino alla prima esecuzione dell'esportazione della fatturazione per il tuo account. Il set di dati contiene dati a partire dalla sua configurazione iniziale per conservare i dati.

Avviso: non modificare le tabelle di dati esportate.

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

Per interrompere l'esportazione dei dati di costo di rifatturazione nel set di dati, fai clic su Disabilita l'esportazione dei dati di fatturazione nella pagina Rifatturazione cliente. Per riattivare l'esportazione, segui i passaggi precedenti per specificare un ID set di dati.

I dati relativi ai costi di rifatturazione potrebbero non essere disponibili per il periodo di tempo in cui sono stati disattivati. Se hai eliminato dati esportati durante questo periodo, non possiamo eseguire il backfill dei record eliminati.

Autorizzazioni account di servizio richieste

Per l'esportazione dei dati di Channel Services viene utilizzato un account di servizio di proprietà e gestito da Google che dispone dell'autorizzazione per 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. Puoi configurare le autorizzazioni seguendo i passaggi per abilitare l'esportazione.

Avviso: la rimozione di questo account di servizio mentre sono abilitate le esportazioni della fatturazione in BigQuery 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 set di dati diverso.

Esegui query sui dati in modo efficiente

La tabella BigQuery è partizionata per export_time e clusterizzata in base a payer_billing_account_id per impostazione predefinita. Ciò significa che la tabella è divisa in partizioni più piccole, ciascuna delle quali è ulteriormente divisa 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, la query seguente è efficiente rispetto a una query senza chiavi di partizionamento e 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 link seguenti:

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

Individuare l'ID account di fatturazione del pagatore

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

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

Configurazione dei controlli dell'accesso per altri utenti nel set di dati di esportazione

Esistono diversi modi per configurare i controlli di accesso ai dati nell'esportazione in BigQuery. Per ulteriori informazioni, consulta i controlli di accesso a BigQuery.

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

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

Durante la configurazione delle autorizzazioni per gli utenti, assicurati che l'account di servizio [e-mail] abbia sempre l'accesso completo in modifica al set di dati di esportazione per l'esportazione continua dei dati.

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 vista o una vista materializzata oppure puoi unire le colonne in altre tabelle nelle query.

Se la tabella rimane in questo stato, dovrai ripristinare tutte le colonne corrette e nient'altro. Successivamente, potresti dover andare alla pagina Esportazione della fatturazione e fare clic su Aggiorna.

Lo schema seguente descrive i dati della tabella BigQuery.

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

Campo	Tipo	Description
billing_account_id	Stringa	L'ID account a cui è associato l'utilizzo, che può essere del cliente o del tuo. A seconda della famiglia di prodotti, può essere un account di fatturazione o un ID Cloud Identity.
payer_billing_account_id	Stringa	L'ID del tuo account di fatturazione padre.
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 della finestra di utilizzo orario del costo calcolato. L'utilizzo e i costi per tutti i servizi sono visualizzati con granularità oraria. L'utilizzo dei servizi a lunga esecuzione è distribuito su più finestre orarie. Per i prodotti in abbonamento, corrisponde all'inizio del mese di fatturazione.
usage_end_time	Timestamp	L'ora di fine della finestra di utilizzo oraria del costo calcolato. L'utilizzo e i costi per tutti i servizi sono visualizzati con granularità oraria. L'utilizzo dei servizi a lunga esecuzione è distribuito su più finestre orarie. 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, generato internamente e anonimizzato 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 di questa coppia chiave-valore.
project.ancestry_numbers	Stringa	I predecessori della gerarchia delle risorse per il progetto identificato 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 di questa 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	Località di utilizzo a livello di paese, regione o zona. Mostra global per le risorse senza una località specifica. Per saperne di più, consulta Regioni e zone.
location.country	Stringa	Quando location.location è un paese, una regione o una zona, questo campo indica il 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 indica la 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 SSD) che generano l'utilizzo dei servizi.
resource.name	Stringa	Un identificatore di servizio specifico per la risorsa che ha generato l'utilizzo pertinente. Può essere generato dall'utente.
resource.global_name	Stringa	Un identificatore di servizio univoco globale per la risorsa che ha generato l'utilizzo pertinente.
cost	Numerico	Il costo di utilizzo prima di eventuali crediti applicati. Per visualizzare 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	In virgola mobile	Il tasso di cambio dai dollari statunitensi alla valuta locale. Ciò significa che cost ÷ currency_conversion_rate è uguale al costo in dollari statunitensi.
usage.amount	Numerico	La quantità di usage.unit utilizzata.
usage.unit	Stringa	L'unità 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à per misurare l'utilizzo delle risorse.
credits	Struct, ripetuto	Contiene i campi che descrivono la struttura e il valore dei crediti.
credits.id	Stringa	Se compilato, indica che un credito è associato allo SKU del 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 i markup di rifatturazione e gli sconti. In base ai channel_partner_name e ai ChannelPartnerRepricingConfig associati. Se credits.type è RESELLER_MARGIN, questo importo sarà pari a zero.
credits.customer_amount	Numerico	L'importo del credito applicato all'utilizzo, dopo i markup di rifatturazione e gli sconti. In base ai customer_name e ai CustomerRepricingConfig associati. Se credits.type è RESELLER_MARGIN, questo importo sarà pari a zero.
adjustmentsInfo	Struct, ripetuto	Contiene i campi che descrivono la struttura e il valore di un aggiustamento agli elementi pubblicitari di costo.
adjustmentsInfo.adjustment_id	Stringa	Se compilato, un aggiustamento viene associato a un elemento pubblicitario di costo. adjustmentsInfo.adjustments_id è l'ID univoco di 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 capire quando è stato eseguito l'ultimo aggiornamento dei dati di fatturazione esportati.
entitlement_name	Stringa	Il nome della risorsa dell'API Cloud Channel Entitlement. Utilizza il formato: accounts/{account}/customers/{customer}/entitlements/{entitlement}
channel_partner_name	Stringa	(Solo 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 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 utilizzato 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 dell'CustomerRepricingConfig, se esistente.
cost_at_list	Numerico	Il costo se addebitato con il prezzo 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.
channel_partner_repricing_config_name	Stringa	(Solo 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, come 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 tag specifico.
tags.value	Stringa	Le risorse collegate a una chiave tag. In un dato momento, è possibile associare un solo valore a una risorsa per una determinata chiave.
tags.inherited	Booleano	Indica se un'associazione di tag viene ereditata (Tag ereditati = True) o diretta/non ereditati (Tag ereditati = False).
tags.namespace	Stringa	Rappresenta la gerarchia delle risorse che definisce le chiavi e i valori dei tag. Lo spazio dei nomi può essere combinato con i nomi brevi della chiave tag e dei valori tag per creare un nome completo e univoco globale per la chiave o il valore tag.
customer_correlation_id	Stringa	L'ID CRM esterno del cliente. Il campo 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 campi prezzo è maggio 2023.
price.effective_price	Numerico	Il prezzo addebitato per l'utilizzo.
price.tier_start_amount	Numerico	Il numero del limite inferiore di unità per il livello di prezzo di uno SKU. Ad esempio, uno SKU con tre livelli di prezzo, come 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 utilizzo in cui viene specificato il prezzo e l'utilizzo delle risorse viene misurato (ad esempio gibibyte, tebibyte, mese, anno, ora gibibyte, mese gibibyte o conteggio). Il valore del campo price.unit corrisponde al valore del 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, in questa colonna viene visualizzato il valore 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 in cui Google Cloud agisce in qualità di 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 tue tariffe 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 campi prezzo è febbraio 2024.

Note aggiuntive sullo schema

Colonne non applicabili a Google Workspace

Quando una colonna o un campo non è applicabile a una famiglia di prodotti, i dati esportati per questa famiglia di prodotti conterranno null in questa colonna/campo. Le seguenti colonne/campi non si applicano alle esportazioni di Google Workspace:

• project
• labels
• resource
• credits
• adjustmentsInfo
• 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 con le esportazioni di Google Workspace:

• I dati di Google Workspace non riguardano l'utilizzo da parte del rivenditore.
• Quando cost_type è tax e adjustment, usage.amount_in_pricing_units è sempre 1.
• Sulle fatture di Google Workspace, le imposte sono indicate con un'unica voce. Nell'esportazione, le tasse sono suddivise per cliente. Sebbene l'importo totale delle imposte debba corrispondere a quello della fattura, le imposte individuali potrebbero contenere piccole inesattezze per gli arrotondamenti.

billing_account_id

• Per Google Cloud, si tratta dell'account di fatturazione Cloud a cui è associato l'utilizzo.
• Per Google Workspace, si tratta dell'ID Cloud Identity del cliente.

service e sku

Per Google Workspace, queste colonne rappresentano il "Prodotto" e lo "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 delle fatture (ad esempio, nel file CSV è indicato "Spazio di archiviazione di Google Drive 20 GB", ma sku.description mostra 20 GB). Si tratta di una situazione prevista per gli SKU di Google Drive precedenti. Questo valore è disponibile nella Partner Sales Console. Accedi a un cliente specifico, fai clic sull'abbonamento precedente, quindi su "Visualizza il piano di pagamento". Dovresti quindi vedere i valori che corrispondono a sku.description.

usage_start_time e usage_end_time

Nel CSV della fattura di Google Workspace, le date sono rappresentate. Nelle esportazioni, queste sono rappresentate come timestamp:

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

project.labels

Per Google Cloud, queste sono le coppie chiave-valore nel progetto Google Cloud in cui si è verificato l'utilizzo. Per ulteriori informazioni, consulta la pagina relativa all'utilizzo delle etichette.

labels

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

system_labels

• Per Google Cloud, queste sono le 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, questi sono metadati aggiuntivi relativi al costo, che includono:

  • 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 dell'ordine di acquisto (PO).
  • 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 associata a un mese parziale per un abbonamento con impegno mensile fatturato e per il periodo di fatturazione/contratto per un abbonamento con pagamento anticipato.
• COMMITMENT_TERM_END_ITEM: termine dell'abbonamento. In genere è associato agli addebiti dell'ultimo mese di un abbonamento con impegno con fatturazione mensile.
• 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 mensile fatturato o fino alla fine del periodo di fatturazione/contratto per un abbonamento con pagamento anticipato.
• COMMITMENT_CANCEL_ITEM: registrato quando viene annullato un abbonamento. Include gli addebiti associati alla risoluzione anticipata. Rappresenta un addebito per la restante durata del periodo di validità del contratto, quando il contratto viene annullato a metà del periodo, oppure un credito emesso per il resto del periodo di fatturazione, quando un contratto viene modificato o annullato a metà.
• FLEXIBLE_SEATS_ITEM: registra l'utilizzo da parte di un determinato numero di utenti per un blocco contiguo di un determinato numero di giorni. Attualmente destinata solo agli utenti senza un impegno.
• COUPON_DISCOUNT_ITEM: importo dello sconto associato a un coupon.
• MIGRATED_CREDIT_ITEM: credito derivante dalla migrazione di DKIM.
• COMMITMENT_PREPAY_BILLING_PERIOD_ITEM: rappresenta le informazioni sull'utilizzo create all'inizio del ciclo di pagamento per l'intero ciclo di un abbonamento con pagamento anticipato con impegno.

usage.amount

Per l'utilizzo basato sulle utenze di Google Workspace, indica utenze a pagamento. Ad esempio, utenze impegnate per impegni o numero di utenze pagate per Flex.

usage.pricing_unit

• Per Google Cloud, scopri di più sull'API Cloud Billing Catalog
• Per Google Workspace, è 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 del prodotto non è associato a un credito.

credits.full_name

Per Google Cloud, questa è una descrizione leggibile di un credits.id alfanumerico. Alcuni esempi sono il credito per la prova gratuita o lo sconto per impegno di utilizzo basato sulla spesa. I valori credits.full_name vengono compilati solo per gli SKU con un valore 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 con impegno di utilizzo basato sulle risorse acquistati per Compute Engine a fronte di prezzi molto scontati per l'utilizzo delle VM.
• COMMITTED_USAGE_DISCOUNT_DOLLAR_BASE : contratti basati sulla spesa per impegno di utilizzo acquistati per servizi in cambio dell'impegno di spendere un importo minimo.
• DISCOUNT: il tipo di credito di sconto viene utilizzato per i crediti guadagnati dopo il raggiungimento di una soglia di spesa contrattuale. Tieni presente che nei report di fatturazione Cloud disponibili in Partner Sales Console, il tipo di credito di sconto è elencato come Sconti basati sulla spesa (contrattuali).
• FREE_TIER : alcuni servizi offrono utilizzo gratuito delle risorse fino a limiti specifici Per questi servizi, i crediti vengono applicati per implementare l'utilizzo del livello gratuito.
• PROMOTION: il tipo di credito promozionale include la prova gratuita di Google Cloud e i crediti per le campagne di marketing oppure altre sovvenzioni per l'utilizzo di Google Cloud. Se disponibili, i crediti promozionali sono considerati una forma di pagamento e vengono applicati automaticamente per ridurre il totale della fattura.
• RESELLER_MARGIN: se sei un rivenditore, il tipo di credito margine rivenditore indica gli sconti del Programma per rivenditori guadagnati su ogni elemento pubblicitario idoneo.
• SUBSCRIPTION_BENEFIT: crediti guadagnati acquistando abbonamenti a lungo termine ai servizi in cambio di sconti.
• SUSTAINED_USAGE_DISCOUNT : il tipo di credito per gli sconti per utilizzo sostenuto è uno sconto automatico ottenuto 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 per una modifica alla fatturazione Cloud. Il tipo adjustmentsInfo contiene i dettagli dell'aggiustamento, se è stato emesso per correggere un errore o per altri motivi.

adjustmentsInfo.adjustment_type

Per Google Cloud, ciò include:

• USAGE_CORRECTION: una correzione dovuta a un utilizzo errato segnalato.
• PRICE_CORRECTION: una correzione dovuta a regole per la determinazione del prezzo errate.
• METADATA_CORRECTION: una correzione per correggere i metadati senza modificare il costo.
• GOODWILL: un credito emesso al cliente per avviamento.
• SALES_BASED_GOODWILL: un credito emesso al cliente per avviamento, come parte di un contratto.
• SLA_VIOLATION: un credito emesso al cliente a causa di una violazione dell'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.

adjustmentsInfo.adjustment_mode

Per Google Cloud, ciò include:

• 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 e genera elementi pubblicitari corretti 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, questo è il prezzo addebitato per l'utilizzo degli SKU di Google Cloud o Google Maps Platform e dei relativi prezzi. Se il tuo account di fatturazione Cloud prevede prezzi contrattuali personalizzati, si tratta del prezzo specifico per l'account di fatturazione, altrimenti è il prezzo di listino per il livello SKU o SKU.