En esta página, se muestra cómo configurar una exportación de servicios de canal y, también, se describe el esquema disponible para una exportación.
Con BigQuery, puedes exportar datos de facturación de los servicios de canal a un conjunto de datos de BigQuery especificado. Estos datos pueden ayudarte a realizar un análisis detallado de cómo tus clientes o socios de canal usan los servicios que prestas.
Las exportaciones de los servicios de canal contienen datos específicos del revendedor que, de otro modo, no se incluyen en las exportaciones de Facturación de Cloud. Esto incluye los costos, los créditos y los datos de uso con las reglas de revisión de precios que configuraste. Estas exportaciones también agregan toda la información sobre las cuentas de facturación principales de tus clientes en un solo conjunto de datos.
Sin embargo, los datos de una exportación de servicios de canal son compatibles con las exportaciones de Facturación de Cloud, y puedes usar consultas para unir ambos conjuntos de datos para el análisis.
Para obtener información sobre las exportaciones de Facturación de Cloud que no son revendedores, consulta Configura exportaciones de Facturación de Cloud a BigQuery.
Antes de comenzar
Antes de comenzar a exportar datos de facturación de los servicios de canal, debe hacer lo siguiente:
- Configura un proyecto para alojar el conjunto de datos de BigQuery. Asegúrate de que la facturación esté habilitada en el proyecto.
- Habilitar la API del Servicio de transferencia de datos de BigQuery en el proyecto
- Crea un conjunto de datos para tus datos exportados.
Si ya tienes un proyecto y un conjunto de datos de BigQuery para exportar datos de Facturación de Cloud, puedes volver a usar ese proyecto y conjunto de datos para la exportación de servicios de canal.
Para obtener información detallada sobre cómo configurar un proyecto y un conjunto de datos, consulta Configura la exportación de datos de la Facturación de Cloud a BigQuery.
Permisos necesarios para las exportaciones
Para habilitar y configurar las exportaciones de servicios de canal, necesitas los siguientes roles:
En BigQuery, si creaste el conjunto de datos de destino, necesitas
BigQuery User
para el proyecto que contiene el conjunto de datos. Si otra persona creó el conjunto de datos, necesitas la funciónBigQuery Data Owner
.Para habilitar las exportaciones de Google Cloud, en Partner Sales Console, debes tener la función de administrador de revendedores de Google Cloud.
Obtén información para asignar roles de Google Cloud en Partner Sales Console
Para habilitar las exportaciones de Google Workspace, debes ser administrador de revendedor o tener los privilegios de facturación de Google Workspace.
Obtén información para asignar roles de Google Workspace en la Partner Sales Console.
Project Viewer
para el proyecto que contiene el conjunto de datos de destino de BigQuery (opcional) para verificar de forma automática si la facturación está habilitada en el proyecto.
Selecciona un proyecto y un conjunto de datos
En la Partner Sales Console, selecciona un proyecto y un conjunto de datos en BigQuery para almacenar los datos de los servicios de canal. Habilita la facturación en el proyecto si aún no está habilitada.
Cuando seleccionas o creas un conjunto de datos de BigQuery, puedes elegir una de las ubicaciones compatibles de BigQuery para el conjunto de datos. Cuando habilites la exportación de datos de los servicios de canal por primera vez por fuente de datos (Google Cloud o Google Workspace), haz lo siguiente:
Si configuras el conjunto de datos de BigQuery con el fin de que use una ubicación multirregional, los datos de BigQuery Export estarán disponibles para cada fuente de datos seleccionada desde el comienzo del mes anterior. Por ejemplo, si habilitas BigQuery Export el 23 de septiembre, tu exportación incluirá datos a partir del 1 de agosto.
Si configuras el conjunto de datos de BigQuery con el fin de usar una ubicación de la región (que no sea multirregional de EE.UU. o la UE), los datos de exportación de BigQuery estarán disponibles para cada fuente de datos seleccionada a partir de la fecha en que habilites la exportación. Es decir, los datos de BigQuery Export no se agregan de forma retroactiva para las ubicaciones de conjuntos de datos que no son multirregionales, por lo que no verás los datos de BigQuery Export de antes de habilitar la exportación.
Para exportar los datos de facturación de varias cuentas de Partner Sales Console, sigue estos pasos:
- En el conjunto de datos de BigQuery al que deseas exportar los datos, asegúrate de que los administradores de facturación de cada cuenta de Partner Sales Console tengan permisos para ver el conjunto de datos.
- Cuando configures la exportación de datos de facturación en cada cuenta de Partner Sales Console, selecciona el conjunto de datos unificado.
Ubicaciones de BigQuery compatibles
Multirregiones
En la siguiente tabla, se enumeran las multirregiones en las que se admite la exportación de datos de BigQuery de los servicios de canal.
Descripción de la multirregión | Nombre de la multirregión |
---|---|
Centros de datos dentro de los estados miembros de la Unión Europea1 | EU |
Centros de datos en Estados Unidos | US |
Regiones
En la siguiente tabla, se enumeran las regiones de América en las que se admite la exportación de datos de BigQuery de los servicios de canal.
Descripción de la región | Nombre de la región |
---|---|
Iowa | us-central1 |
Las Vegas | us-west4 |
Los Ángeles | us-west2 |
Montreal | northamerica-northeast1 |
Virginia del Norte | us-east4 |
Oregón | us-west1 |
Salt Lake City | us-west3 |
São Paulo | southamerica-east1 |
Carolina del Sur | us-east1 |
En la siguiente tabla, se enumeran las regiones de Asia-Pacífico en las que se admite la exportación de datos de BigQuery de los servicios de canal.
Descripción de la región | Nombre de la región |
---|---|
Hong Kong | asia-east2 |
Yakarta | asia-southeast2 |
Bombay | asia-south1 |
Osaka | asia-northeast2 |
Seúl | asia-northeast3 |
Singapur | asia-southeast1 |
Sídney | australia-southeast1 |
Taiwán | asia-east1 |
Tokio | asia-northeast1 |
En la siguiente tabla, se enumeran las regiones de Europa en las que se admite la exportación de datos de BigQuery de los servicios de canal.
Descripción de la región | Nombre de la región |
---|---|
Bélgica | europe-west1 |
Finlandia | europe-north1 |
Fráncfort | europe-west3 |
Londres | europe-west2 |
Países Bajos | europe-west4 |
Varsovia | europe-central2 |
Zúrich | europe-west6 |
Habilitar exportación
Antes de habilitar la exportación de datos, anota el ID de tu conjunto de datos completamente calificado, que tiene el formato PROJECT_ID:DATASET_NAME.
Para habilitar la exportación de los servicios de canal, sigue estos pasos:
- En Partner Sales Console, abre la página Facturación.
- Selecciona Exportación de la facturación.
- Ingresa el ID del conjunto de datos completamente calificado en el campo Conjunto de datos de refacturación.
- Selecciona las Fuentes de datos para las que quieres exportar los datos.
- Haga clic en Update. Si aparece un mensaje para actualizar los permisos del conjunto de datos, haz clic en Actualizar.
Una vez configurada, la exportación de facturación entrega datos de uso incrementales a diario. La tabla de exportación no se mostrará hasta que se ejecute la exportación de facturación para tu cuenta por primera vez. El conjunto de datos contiene datos de cuando se configuró por primera vez para retener datos.
Para dejar de exportar los datos de los costos de refacturación al conjunto de datos, haz clic en Inhabilitar la exportación de los datos de facturación en la página Refacturación del cliente. Para volver a habilitar la exportación, sigue los pasos anteriores a fin de especificar un ID de conjunto de datos.
Es posible que los datos de los costos de refacturación no estén disponibles mientras estuvo inhabilitado. Si borraste algún dato exportado durante ese tiempo, no podremos reabastecer los registros borrados.
Permisos necesarios de la cuenta de servicio
Para la exportación de datos de los servicios de canal, se usa una cuenta de servicio que Google posee y administra, y que tiene permiso para escribir los registros de facturación en una tabla. Esta es la cuenta de servicio:
cloud-channel-billing-reporting-rebilling@system.gserviceaccount.com
Esta cuenta de servicio requiere la función predefinida: roles/bigquery.dataEditor
para permitir las exportaciones. Puedes configurar los permisos siguiendo los pasos para habilitar la exportación.
Consulta datos de forma eficiente
La tabla de BigQuery está particionada por export_time
y agrupada en clústeres por payer_billing_account_id
de forma predeterminada. Esto significa que la tabla se divide en particiones más pequeñas, cada una de las cuales se divide en clústeres más pequeños.
El uso de las claves de partición y clúster en una consulta ayudará a BigQuery a encontrar con rapidez los datos relevantes, lo que puede reducir de manera significativa el costo de la consulta.
Por ejemplo, la siguiente consulta es eficiente en comparación con una que no tiene claves de partición y agrupamiento en clústeres:
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;
Para obtener más información sobre la partición, el agrupamiento en clústeres y las prácticas recomendadas, consulta los siguientes vínculos:
- Consulta tablas particionadas
- Cómo consultar tablas agrupadas
- Optimiza el procesamiento de las consultas
- Prácticas recomendadas para controlar los costos en BigQuery
Encuentra el ID de la cuenta de facturación del pagador
Para encontrar el ID de la cuenta de facturación del pagador, abre la página de cuentas de facturación de Partner Sales Console y haz clic en la pestaña Facturación de socios.
Puedes ver todas las cuentas de facturación y los ID de las cuentas de facturación del pagador.
Configura controles de acceso para otros usuarios en el conjunto de datos de exportación
Existen varias formas de configurar los controles de acceso a los datos en BigQuery Export. Si deseas obtener más información, consulta los controles de acceso de BigQuery.
A fin de garantizar que los usuarios solo tengan acceso a los datos que están autorizados a ver, recomendamos configurar vistas autorizadas para compartir datos del conjunto de datos exportado.
Cuando configures permisos para los usuarios, asegúrate de que la cuenta de servicio cloud-channel-billing-reporting-rebilling@system.gserviceaccount.com
siempre tenga acceso de edición completo al conjunto de datos de exportación para una exportación continua de datos.
Esquema de la tabla
En el siguiente esquema, se describen los datos en la tabla de BigQuery.
En tu conjunto de datos de BigQuery, la exportación de refacturación detallada se carga en una tabla de datos llamada reseller_billing_detailed_export_v1
.
Campo | Tipo | Descripción |
billing_account_id
|
String | El ID de la cuenta con el que está asociado el uso, que puede ser el del cliente o tuyo. Según la familia de productos, puede ser una cuenta de facturación o un ID de Cloud Identity. |
payer_billing_account_id
|
String | El ID de tu cuenta de facturación principal |
invoice.month
|
String | El año y el mes (AAAAMM) de la factura que incluye los elementos de una sola línea del costo. Por ejemplo: "202101" es lo mismo que enero de 2021. |
cost_type
|
String | Es el tipo de costo que representa este elemento de una sola línea: normal, impuesto, ajuste o error de redondeo. |
service.id
|
String | El ID del servicio con el que se asocia el uso. |
service.description
|
String | Es el servicio de Google que informó los datos de facturación. |
sku.id
|
String | Es el ID de SKU del recurso que usa el servicio. |
sku.description
|
String | Una descripción del tipo de recurso que usa el servicio. Por ejemplo, Cloud Storage es del tipo Standard Storage EE.UU.. |
usage_start_time
|
Marca de tiempo | La hora de inicio del período de uso por hora del costo calculado. El uso y los costos de todos los servicios se muestran con un nivel de detalle por hora. El uso de servicio a largo plazo se distribuye en varios períodos de una hora. En el caso de los productos de suscripción, corresponde al comienzo del mes de facturación. |
usage_end_time
|
Marca de tiempo | La hora de finalización del período de uso por hora del costo calculado. El uso y los costos de todos los servicios se muestran con un nivel de detalle por hora. El uso de servicio a largo plazo se distribuye en varios períodos de una hora. En el caso de los productos de suscripción, corresponde al final del mes de facturación. |
project
|
Estructural | Información sobre el proyecto de Google Cloud que generó los datos de la Facturación de Cloud. |
project.number
|
String | Un identificador único, anonimizado y generado internamente para el proyecto de Google Cloud que generó los datos de la Facturación de Cloud. |
project.id
|
String | El ID del proyecto de Google Cloud que generó los datos de la Facturación de Cloud. |
project.name
|
String | Es el nombre del proyecto de Google Cloud que generó los datos de la Facturación de Cloud. |
project.labels
|
Estructura, repetido | |
project.labels.key
|
String | Si hay etiquetas presentes, la parte clave del par clave-valor. |
project.labels.value
|
String | Si hay etiquetas presentes, la parte valor del par clave-valor. |
project.ancestry_numbers
|
String | Los elementos principales de la jerarquía de recursos del proyecto que identifica el project.id .
|
labels
|
Estructura, repetido | |
labels.key
|
String | Si hay etiquetas presentes, la parte clave del par clave-valor. |
labels.value
|
String | Si hay etiquetas presentes, la parte valor del par clave-valor. |
system_labels
|
Estructura, repetido | |
system_labels.key
|
String | Si las etiquetas del sistema están presentes, la parte de la clave del par clave-valor. |
system_labels.value
|
String | Si hay etiquetas del sistema, la parte valor del par clave-valor. |
location.location
|
String | Ubicación del uso a nivel de un país, una región o una zona. Se muestra global para los recursos sin una ubicación específica. Para obtener más información, consulta Regiones y zonas.
|
location.country
|
String | Cuando location.location es un país, una región o una zona, este campo es el país de uso. Por ejemplo, US Para obtener más información, consulta Regiones y zonas.
|
location.region
|
String | Cuando location.location es un país o una región, este campo es la región de uso. Por ejemplo, us-central1 Para obtener más información, consulta Regiones y zonas.
|
location.zone
|
String | Cuando location.location es una zona, este campo es la zona de uso. Por ejemplo, us-central1-a Para obtener más información, consulta Regiones y zonas.
|
resource
|
Estructural | Describe la estructura y el valor de la información relevante para los recursos del servicio (por ejemplo, máquinas virtuales o SSD) que generan el uso del servicio. |
resource.name
|
String | Un identificador específico del servicio para el recurso que generó el uso relevante. Pueden generarse por el usuario. |
resource.global_name
|
String | Un identificador de servicio único a nivel global para el recurso que generó el uso relevante. |
cost
|
Numéricos | El costo de uso antes de cualquier crédito aplicado. Para obtener el costo total, incluidos los créditos, agrega credits.amount a cost .
|
currency
|
String | Es la moneda de facturación del costo. Para obtener más información, consulta Moneda local para facturación y pagos. |
currency_conversion_rate
|
Número de punto flotante | El tipo de cambio de dólares estadounidenses a la moneda local. Es decir, cost ÷ currency_conversion_rate equivale al costo en dólares estadounidenses.
|
usage.amount
|
Numéricos | La cantidad de usage.unit que se usó.
|
usage.unit
|
String | La unidad base para medir el uso de recursos. Por ejemplo, la unidad base para el almacenamiento estándar es bytes por segundos. |
usage.amount_in_pricing_unit
|
Numéricos | La cantidad de uso de usage.pricing_unit .
|
usage.pricing_unit
|
String | Las unidades para medir el uso de recursos. |
credits
|
Estructura, repetido | Contiene campos que describen la estructura y el valor de los créditos. |
credits.id
|
String | Si se propaga, indica que hay un crédito asociado con el SKU del producto. |
credits.full_name
|
String | El nombre del crédito asociado con el SKU del producto. |
credits.type
|
String | En este campo, se describe el propósito o el origen de credits.id .
|
credits.name
|
String | Una descripción del crédito aplicado al uso. |
credits.amount
|
Numéricos | El importe del crédito aplicado al uso. |
credits.channel_partner_amount
|
Numéricos | El importe del crédito aplicado al uso, después de los descuentos y los márgenes de beneficios de la refacturación. Se basa en la channel_partner_name y las ChannelPartnerRepricingConfig asociadas. Si el valor de credits.type es RESELLER_MARGIN, este importe será cero.
|
credits.customer_amount
|
Numéricos | El importe del crédito aplicado al uso, después de los descuentos y los márgenes de beneficios de la refacturación. Se basa en la customer_name y las CustomerRepricingConfig asociadas. Si el valor de credits.type es RESELLER_MARGIN, este importe será cero.
|
adjustmentsInfo
|
Estructura, repetido | Contiene campos que describen la estructura y el valor de un ajuste de las líneas de pedido de costo. |
adjustmentsInfo.adjustment_id
|
String | Si se completa, un ajuste se asocia con una línea de pedido de costo. adjustmentsInfo.adjustments_id es el ID único de todos los ajustes que causa un problema.
|
adjustmentsInfo.adjustment_description
|
String | Una descripción del ajuste y su causa. |
adjustmentsInfo.adjustment_type
|
String | Es el tipo de ajuste. |
adjustmentsInfo.adjustment_mode
|
String | Cómo se emitió el ajuste. |
export_time
|
Marca de tiempo | Un tiempo de procesamiento asociado con un anexo de datos de facturación. Este aumentará con cada exportación nueva. Usa la columna export_time para comprender cuándo se actualizaron por última vez los datos de facturación exportados.
|
entitlement_name
|
String | El nombre del recurso de Entitlement de la API de Cloud Channel. Usa el formato: accounts/{account}/customers/{customer}/entitlements/{entitlement}
|
channel_partner_name
|
String | (Solo para distribuidores): Es el nombre de recurso del socio de canal que vende al cliente final. Usa el formato: accounts/{account}/channelPartnerLinks/{channelPartner} .
|
channel_partner_cost
|
Numéricos | (Solo para distribuidores): Es el costo para el socio de canal, identificado por channel_partner_name , después de aplicar una ChannelPartnerRepricingConfig existente.
|
customer_name
|
String | El nombre del recurso del cliente del revendedor que consumió este uso en el formato accounts/{account}/customers/{customer} |
customer_cost
|
Numéricos | El costo para el cliente del revendedor identificado en la columna customer_name , después de aplicar la CustomerRepricingConfig , si existe.
|
cost_at_list
|
Numéricos | Es el costo si se cobra con precios públicos. |
customer_repricing_config_name
|
String | El nombre del recurso de la API de Cloud Channel CustomerRepricingConfig . Usa el formato: accounts/{account}/customers/{customer}/customerRepricingConfigs/{id} .
|
channel_partner_repricing_config_name
|
String | (Solo para distribuidores): El nombre del recurso de la API de Cloud Channel ChannelPartnerRepricingConfig . Usa el formato: accounts/{account}/channelPartnerLinks/{channelPartner}/channelPartnerRepricingConfigs/{id} .
|
tags
|
Estructural | Campos que describen la etiqueta de política, como clave, valor y espacio de nombres. |
tags.key
|
String | El nombre corto o el nombre visible de la clave asociada con esta etiqueta de política en particular. |
tags.value
|
String | Los recursos adjuntos a una clave de etiqueta. En un momento determinado, se puede adjuntar solo un valor a un recurso para una clave determinada. |
tags.inherited
|
Booleano | Indica si una vinculación de etiqueta es heredada (etiquetas heredadas = verdadero) o directa o no heredada (etiquetas heredadas = falso). |
tags.namespace
|
String | Representa la jerarquía de recursos que define los valores y la clave de la etiqueta de política. El espacio de nombres se puede combinar con los nombres cortos de las claves y los valores de las etiquetas para crear un nombre global único y completamente calificado para la clave o el valor de la etiqueta. |
customer_correlation_id
|
String | Es el ID externo de CRM del cliente. Se propaga solo si existe un ID de CRM para este cliente. |
price
|
Estructural | Campos que describen la estructura y el valor relacionados con los precios que se cobran por uso. |
price.effective_price
|
Numéricos | Es el precio que se cobra por el uso. |
price.tier_start_amount
|
Numéricos | La cantidad limitada de unidades para el nivel de precios de un SKU. Por ejemplo, un SKU con tres niveles de precios, como de 0 a 100 unidades, de 101 a 1,000 unidades y más de 1,001 unidades, mostrará tres filas de precios para el SKU, donde 0, 101 y 1,001 en el campo price.tier_start_amount representa la cantidad inicial de unidades de los niveles de precios del SKU.
Obtén más información sobre los niveles de precios de Google Cloud.
|
price.unit
|
String | La unidad de uso en la que se especifica el precio y se mide el uso de recursos (por ejemplo, gibibyte, tebibyte, mes, año, gibibyte por hora, gibibyte por mes o recuento). El valor del campo price.unit coincide con el del campo usage.pricing_unit .
|
price.pricing_unit_quantity
|
Numéricos | El nivel de precios por cantidad de unidades del SKU. Por ejemplo, si el nivel de precio es $1 por 1,000,000 de bytes, en esta columna se mostrará 1,000,000. |
transaction_type
|
String | Es el tipo de transacción del vendedor. El tipo de transacción puede ser uno de los siguientes:
|
seller_name
|
String | Es el nombre legal del vendedor. |
subscription
|
Estructural | Campos que describen los compromisos basados en la inversión o en los recursos. Puedes usar estos campos para analizar las tarifas de compromisos específicos. |
subscription.instance_id
|
String | El ID de suscripción vinculado a un compromiso. |
Notas adicionales sobre el esquema
Columnas no aplicables a Google Workspace
Cuando una columna o un campo no se aplica a una familia de productos, los datos exportados para
esta familia de productos contendrán null
en esta columna o campo. Las siguientes columnas o campos no se aplican a las exportaciones de 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
Otras notas sobre la exportación de Google Workspace
Existen varios comportamientos especiales con las exportaciones de Google Workspace:
- Los datos de Google Workspace no contienen el uso propio del revendedor.
- Cuando
cost_type
estax
yadjustment
,usage.amount_in_pricing_units
siempre es 1. - En las facturas de Google Workspace, los impuestos se muestran como un elemento de una sola línea. En la exportación, los impuestos se desglosan por cliente. Si bien el impuesto total debe coincidir con la factura, los impuestos individuales pueden contener pequeñas imprecisiones en el redondeo.
billing_account_id
- Para Google Cloud, esta es la cuenta de Facturación de Cloud con la que está asociado el uso.
- Para Google Workspace, este es el ID de Cloud Identity del cliente.
service
y sku
Para Google Workspace, estas columnas representan el “Producto” y el “SKU” asociados con el uso. Obtén más información sobre los IDs de producto y SKU.
usage_start_time
y usage_end_time
En el archivo CSV de la factura de Google Workspace, esto se representa como fechas. En las exportaciones, estas se representan como marcas de tiempo:
- Para
usage_start_time
, esta es la hora de inicio (incluida) de la suscripción, a las 0:00 PST de la fecha de inicio. - Para
usage_end_time
, es la hora de finalización (exclusiva) de la suscripción, a las 0:00 PST del día posterior a la fecha de finalización.
project.labels
En Google Cloud, estos son los pares clave-valor del proyecto de Google Cloud en el que se produjo el uso. Para obtener más información, consulta Usa etiquetas.
labels
En Google Cloud, estos son los pares clave-valor del recurso de Google Cloud en el que se produjo el uso. Para obtener más información, consulta Usa etiquetas.
system_labels
Para Google Cloud, estos son los pares clave-valor en el recurso de Google Cloud en el que se produjo el uso. Para obtener más información, consulta Etiquetas del sistema disponibles.
En Google Workspace, estos son metadatos adicionales sobre el costo, que incluyen lo siguiente:
workspace.googleapis.com/domain_name
: Es el nombre de dominio del cliente.workspace.googleapis.com/order_id
: Es el ID de pedido.workspace.googleapis.com/purchase_order_id
: Es el ID de la orden de compra (PO).workspace.googleapis.com/subscription_id
: Es el ID de la suscripción.workspace.googleapis.com/usage_type
: Es el tipo de uso. No es aplicable sicost_type
no esregular
.
Entre los tipos de uso de Google Workspace, se incluyen los siguientes:
COMMITMENT_TERM_START_ITEM
: Inicio de una suscripción. Por lo general, se asocia a un mes parcial de una suscripción de compromiso facturada mensual y al período de facturación/contrato de una suscripción de prepago.COMMITMENT_TERM_END_ITEM
: Fin de una suscripción. Por lo general, se asocian con los cargos del último mes de una suscripción de compromiso mensual facturada.COMMITMENT_TERM_RENEWAL_ITEM
: Inicio de un período de suscripción posterior.COMMITMENT_MONTHLY_ITEM
: Uso registrado para los compromisos existentes al comienzo del mes. En la mayoría de los casos, el cargo se extenderá durante todo el mes.COMMITMENT_SEATS_CHANGE_ITEM
: Se registra cuando cambia el nivel de compromiso (ya sea aumenta o disminuye). A menudo, comienza a mediados de mes y se extiende hasta el final del mes para una suscripción de compromiso mensual facturada o hasta el final del período de facturación o contrato para una suscripción de prepago.COMMITMENT_CANCEL_ITEM
: Se registra cuando se cancela una suscripción. Incluye los cargos asociados a la rescisión anticipada. Representa un cargo por el resto del período del contrato cuando se cancela el contrato en la mitad del proceso o un crédito emitido para el resto del período de facturación cuando se modifica o cancela un contrato en la mitad del proceso.FLEXIBLE_SEATS_ITEM
: Registra el uso de una cierta cantidad de usuarios para un bloque contiguo de cierta cantidad de días. Actualmente, solo está destinado a usuarios sin un compromiso.COUPON_DISCOUNT_ITEM
: Es el importe de descuento asociado con un cupón.MIGRATED_CREDIT_ITEM
: Crédito de la migración de Postini.COMMITMENT_PREPAY_BILLING_PERIOD_ITEM
: Representa la información de uso que se crea al comienzo del ciclo de pago para todo el ciclo de una suscripción prepagada a un compromiso.
usage.amount
En el caso del uso por licencias de Google Workspace, esto indica las licencias pagadas. Por ejemplo, las licencias comprometidas para compromisos o la cantidad de licencias pagadas por el nivel flexible.
usage.pricing_unit
- Para Google Cloud, obtén más información sobre la API de Cloud Billing Catalog
- Para Google Workspace, es
count
.
credits.id
Para Google Cloud, es un identificador único alfanumérico (12-b34-c56-d78) o una descripción del tipo de crédito (Descuento por compromiso de uso: CPU). Si el campo credits.id
está vacío, el SKU del producto no está asociado con un crédito.
credits.full_name
En el caso de Google Cloud, es una descripción legible de un credits.id
alfanumérico. Los ejemplos incluyen crédito de prueba gratuita o descuento por compromiso de uso basado en la inversión. Los valores de credits.full_name
solo se propagan para los SKU con un credits.id
alfanumérico. Si el valor de credits.id
es una descripción del tipo de crédito (como Descuento por compromiso de uso: CPU), el campo credits.full_name
estará vacío.
credits.type
En el caso de Google Cloud, los tipos de crédito incluyen los siguientes:
COMMITTED_USAGE_DISCOUNT
: Contratos de compromiso de uso basados en recursos comprados para Compute Engine a cambio de precios muy reducidos por uso de VM.COMMITTED_USAGE_DISCOUNT_DOLLAR_BASE
: Contratos de compromiso de uso basados en la inversión comprados para servicios a cambio de tu compromiso de invertir un importe mínimo.DISCOUNT
: El tipo de crédito de descuento se usa para los créditos obtenidos después de que se alcanza un límite de gasto contractual. Ten en cuenta que, en los informes de Facturación de Cloud disponibles en Partner Sales Console, el tipo de crédito de descuento aparece como Descuentos basados en gastos (contractuales).FREE_TIER
: Algunos servicios ofrecen uso gratuito de recursos hasta límites específicos. En estos servicios, se aplican créditos para implementar el uso del nivel gratuito.PROMOTION
: El tipo de crédito promocional incluye créditos de prueba gratuita de Google Cloud y campañas de marketing, o bien otros subsidios para usar Google Cloud. Cuando están disponibles, los créditos promocionales se consideran una forma de pago y se aplican automáticamente para reducir el total de la factura.RESELLER_MARGIN
: Si eres revendedor, el tipo de crédito de margen del revendedor indica los descuentos del Programa de revendedores que se obtuvieron en cada línea de pedido apta.SUBSCRIPTION_BENEFIT
: Créditos que se obtienen por comprar suscripciones a largo plazo a servicios a cambio de descuentos.SUSTAINED_USAGE_DISCOUNT
: El tipo de crédito de descuento por uso continuo es un descuento automático que obtienes por ejecutar recursos específicos de Compute Engine durante una parte significativa del mes de facturación.
adjustmentsInfo
En el caso de Google Cloud, estos valores solo se propagan si el elemento de una sola línea de costo se generó para una modificación de la Facturación de Cloud. El tipo adjustmentsInfo
contiene detalles sobre el ajuste, ya sea que se haya emitido para corregir un error o por otros motivos.
adjustmentsInfo.adjustment_type
En el caso de Google Cloud, esto incluye lo siguiente:
USAGE_CORRECTION
: Es una corrección debido a un uso incorrecto informado.PRICE_CORRECTION
: Es una corrección debido a reglas de fijación de precios incorrectas.METADATA_CORRECTION
: Es una corrección para corregir metadatos sin cambiar el costo.GOODWILL
: Se trata de un crédito que se emite al cliente para el fondo de comercio.SALES_BASED_GOODWILL
: Es un crédito que se emite al cliente de fondo de comercio, como parte de un contrato.SLA_VIOLATION
: Es un crédito que se otorga al cliente debido a un incumplimiento del objetivo de nivel de servicio (SLO).BALANCE_TRANSFER
: Es un ajuste para transferir fondos de una cuenta de pagos a otra.ACCOUNT_CLOSURE
: Es un ajuste que lleva a una cuenta cerrada a un saldo de cero.GENERAL_ADJUSTMENT
: Es una modificación general de la cuenta de facturación.
adjustmentsInfo.adjustment_mode
En el caso de Google Cloud, esto incluye lo siguiente:
PARTIAL_CORRECTION
: La corrección anula de forma parcial el uso y el costo originales.COMPLETE_NEGATION_WITH_REMONETIZATION
: La corrección anula por completo el uso y el costo originales, y genera un problema con las líneas de pedido corregidas con el uso y el costo actualizados.COMPLETE_NEGATION
: La corrección anula por completo el uso y el costo originales, y no se vuelve a monetizar el uso adicional.MANUAL_ADJUSTMENT
: El ajuste se asigna manualmente al costo y al uso.
price.effective_price
En Google Cloud, es el precio que se cobra por el uso de los SKU y los niveles de precios de los SKU de Google Cloud o Google Maps Platform. Si tu cuenta de Facturación de Cloud tiene precios de contrato personalizados, este es el precio específico de la cuenta de facturación. De lo contrario, este es el precio de lista del nivel de SKU o SKU.