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 los datos de facturación de los servicios de canal a un conjunto de datos de BigQuery específico. Estos datos pueden ayudarte a realizar un análisis detallado de la manera en que tus clientes o socios de canal usan los servicios que ofreces.
Las exportaciones de los servicios de canal contienen datos específicos del revendedor que 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 la Facturación de Cloud y puedes usar las 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 de revendedores, consulta Configura exportaciones de Facturación de Cloud a BigQuery.
Antes de comenzar
Antes de comenzar a exportar los datos de facturación de los servicios de canal, debes 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 las exportaciones de datos de la 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
en el proyecto que lo contiene. Si otra persona creó el conjunto de datos, necesitarás la funciónBigQuery Data Owner
.Para habilitar las exportaciones de Google Cloud, en la Partner Sales Console, debes tener la función de administrador de distribuidor de Google Cloud.
Más información para asignar roles de Google Cloud en Partner Sales Console
Para habilitar las exportaciones de Google Workspace, debes ser un administrador revendedor o tener los privilegios de facturación de Google Workspace.
Más información para asignar roles de Google Workspace en Partner Sales Console
(Opcional)
Project Viewer
para el proyecto que contiene el conjunto de datos de destino de BigQuery, a fin de verificar de forma automática si la facturación está habilitada en el proyecto.
Selecciona un proyecto y un conjunto de datos
En 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 de BigQuery compatibles para el conjunto de datos. Cuando habilitas la exportación de datos de los servicios de canal por primera vez por fuente de datos (Google Cloud o Google Workspace), sucede lo siguiente:
Si configuras tu conjunto de datos de BigQuery para que use una ubicación multirregional, los datos de exportación de BigQuery 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 tu conjunto de datos de BigQuery para que use una ubicación regional (que no sea multirregional en EE.UU. o UE), tus 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 y después. Es decir, los datos de exportación de BigQuery no se agregan de forma retroactiva a las ubicaciones de conjuntos de datos no multirregionales, por lo que no verás datos de BigQuery Export anteriores a la habilitación de la exportación.
Para exportar datos de facturación para varias cuentas de Partner Sales Console, sigue estos pasos:
- En el conjunto de datos de BigQuery al que deseas exportar tus 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 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 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 del conjunto de datos completamente calificado, que tiene el formato PROJECT_ID:DATASET_NAME.
Para habilitar la exportación de 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 deseas exportar los datos.
- Haz clic en Update. Si ves un mensaje para actualizar los permisos del conjunto de datos, haz clic en Actualizar.
Después de configurarla, la exportación de facturación entrega datos de uso incrementales diariamente. La tabla de exportación no se mostrará hasta que la exportación de facturación se ejecute por primera vez en tu cuenta. El conjunto de datos contiene datos desde el momento en que 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 exportación de datos de facturación en la página Refacturación del cliente. A fin de volver a habilitar la exportación, sigue los pasos anteriores para especificar un ID de conjunto de datos.
Es posible que los datos de costos de refacturación no estén disponibles durante el tiempo que estuvieron inhabilitados. Si borraste algún dato exportado durante ese tiempo, no podremos reabastecer los registros borrados.
Permisos necesarios de la cuenta de servicio
La exportación de datos de los servicios de canal usa una cuenta de servicio que pertenece a Google y que la administra, y que tiene permiso para escribir registros de facturación en una tabla. La cuenta de servicio es la siguiente:
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 si sigues 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 según 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 ubicar 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 consulta sin 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 en clústeres
- Optimiza el procesamiento de las consultas
- Prácticas recomendadas para controlar los costos en BigQuery
Cómo encontrar 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 Partner billing.
Puedes ver todas las cuentas de facturación y los IDs de las cuentas de facturación del pagador.
Configurar controles de acceso para otros usuarios en el conjunto de datos de exportación
Existen varias formas de configurar controles de acceso en los datos de BigQuery Export. Para obtener más información, consulta los controles de acceso de BigQuery.
Para asegurarte de que los usuarios solo tengan acceso a los datos que están autorizados a ver, recomendamos que configures Vistas autorizadas para compartir datos de tu conjunto de datos exportado.
Cuando configures los permisos para los usuarios, asegúrate de que la cuenta de servicio
cloud-channel-billing-reporting-rebilling@system.gserviceaccount.com
siempre
tenga acceso completo de editor en el conjunto de datos de exportación para la exportación de datos continua.
Esquema de la tabla
En el siguiente esquema, se describen los datos de 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 la que está asociado el uso, que puede ser tuyo o del cliente. 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" equivale a enero de 2021. |
cost_type
|
String | El tipo de costo que representa esta línea de pedido: regular, impuesto, ajuste o error de redondeo. |
service.id
|
String | El ID del servicio con el que se asocia el uso. |
service.description
|
String | El servicio de Google que informó los datos de facturación. |
sku.id
|
String | 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 US. |
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 del servicio a largo plazo se distribuye en varios períodos de una hora. En el caso de los productos de suscripción, este es el 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 del servicio a largo plazo se distribuye en varios períodos de una hora. En el caso de los productos de suscripción, este es el final del mes de facturación. |
project
|
Struct | 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 | Es el ID del proyecto de Google Cloud que generó los datos de la Facturación de Cloud. |
project.name
|
String | El nombre del proyecto de Google Cloud que generó los datos de la Facturación de Cloud. |
project.labels
|
Struct (repetido) | |
project.labels.key
|
String | Si hay etiquetas presentes, la porción clave del par clave-valor. |
project.labels.value
|
String | Si hay etiquetas presentes, la parte del valor del par clave-valor. |
project.ancestry_numbers
|
String | Los principales de la jerarquía de recursos para el proyecto que identifica el project.id .
|
labels
|
Struct (repetido) | |
labels.key
|
String | Si hay etiquetas presentes, la porción clave del par clave-valor. |
labels.value
|
String | Si hay etiquetas presentes, la parte del valor del par clave-valor. |
system_labels
|
Struct (repetido) | |
system_labels.key
|
String | Si hay etiquetas del sistema, la porción clave del par clave-valor. |
system_labels.value
|
String | Si hay etiquetas del sistema, la parte del valor del par clave-valor. |
location.location
|
String | Ubicación del uso a nivel de un país, una región o una zona. 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
|
Struct | Describe la estructura y el valor de la información relevante para los recursos del servicio (por ejemplo, máquinas virtuales o una SSD) que generan el uso del servicio. |
resource.name
|
String | Un identificador específico del servicio para el recurso que generó un uso relevante. Pueden ser generados por el usuario. |
resource.global_name
|
String | Un identificador de servicio único a nivel global para el recurso que generó un uso relevante. |
cost
|
Numérico | 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 | La moneda de facturación del costo. Si deseas 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 es igual al costo en dólares estadounidenses.
|
usage.amount
|
Numérico | 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érico | La cantidad de uso de usage.pricing_unit .
|
usage.pricing_unit
|
String | Las unidades para medir el uso de recursos. |
credits
|
Struct (repetido) | Contiene campos que describen la estructura y el valor de los créditos. |
credits.id
|
String | Si se propaga, indica que un crédito está 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 | Es una descripción del crédito aplicado al uso. |
credits.amount
|
Numérico | El importe del crédito aplicado al uso. |
credits.channel_partner_amount
|
Numérico | El importe del crédito aplicado al uso, después de los descuentos y los márgenes de facturación de refacturación. Se basa en el channel_partner_name y el ChannelPartnerRepricingConfig asociado. Si el valor de credits.type es RESELLER_MARGIN, este importe será de cero.
|
credits.customer_amount
|
Numérico | El importe del crédito aplicado al uso, después de los descuentos y los márgenes de facturación de refacturación. Se basa en el customer_name y el CustomerRepricingConfig asociado. Si el valor de credits.type es RESELLER_MARGIN, este importe será de cero.
|
adjustmentsInfo
|
Struct (repetido) | Contiene campos que describen la estructura y el valor de un ajuste para las líneas de pedido de costo. |
adjustmentsInfo.adjustment_id
|
String | Si se propaga, se asocia un ajuste con una línea de pedido de costo. adjustmentsInfo.adjustments_id es el ID único de todos los ajustes que generó 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 Derecho de la API de Cloud Channel. Usa el formato accounts/{account}/customers/{customer}/entitlements/{entitlement} .
|
channel_partner_name
|
String | (Solo distribuidores) Es el nombre del recurso del socio de canal que le vende al cliente final. Usa el formato: accounts/{account}/channelPartnerLinks/{channelPartner} .
|
channel_partner_cost
|
Numérico | (Solo distribuidores) Es el costo para el socio de canal, identificado por el 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érico | El costo para el cliente del revendedor identificado en la columna customer_name , después de aplicar el CustomerRepricingConfig , si existe.
|
cost_at_list
|
Numérico | El costo si se cobra con el precio público. |
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 distribuidores) El nombre del recurso de la API de Cloud Channel ChannelPartnerRepricingConfig . Usa el formato: accounts/{account}/channelPartnerLinks/{channelPartner}/channelPartnerRepricingConfigs/{id} .
|
tags
|
Struct | 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 exactamente un valor a un recurso para una clave determinada. |
tags.inherited
|
Booleano | Indica si una vinculación de etiqueta es heredada (Tags Inherited = True) o directa/no heredada (Tags Inherited = False). |
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 la clave y el valor de la etiqueta para crear un nombre global único y completamente calificado para la clave o el valor de la etiqueta. |
customer_correlation_id
|
String | El ID de CRM externo para el cliente: Se propaga solo si existe un ID de CRM para este cliente. |
price
|
Struct | Campos que describen la estructura y el valor relacionados con los precios que se cobran por el uso. |
price.effective_price
|
Numérico | Es el precio que se cobra por el uso. |
price.tier_start_amount
|
Numérico | 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, con 0, 101 y 1,001 en el campo price.tier_start_amount que representa la cantidad inicial de unidades para los niveles de precios del SKU.
Obtén más información sobre los niveles de precios de Google Cloud.
|
price.unit
|
String | Es 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 valor del campo usage.pricing_unit .
|
price.pricing_unit_quantity
|
Numérico | 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
|
Struct | 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 aplican a una familia de productos, los datos exportados para esta familia contendrán null
en esta columna o campo. Los siguientes campos o columnas 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 en las exportaciones de Google Workspace:
- Los datos de Google Workspace no incluyen 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
- En 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 productos 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, estos 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 a.m. PST de la fecha de inicio. - Para
usage_end_time
, esta es la hora de finalización (exclusiva) de la suscripción, a las 0:00 a.m. PST del día posterior a la fecha de finalización.
project.labels
En el caso de 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 el caso de Google Cloud, estos son los pares clave-valor del recurso de Google Cloud en el que ocurrió el uso. Para obtener más información, consulta Usa etiquetas.
system_labels
En el caso de Google Cloud, estos son los pares clave-valor del recurso de Google Cloud en el que ocurrió el uso. Para obtener más información, consulta Etiquetas del sistema disponibles.
En el caso de Google Workspace, estos son metadatos adicionales sobre el costo, que incluyen lo siguiente:
workspace.googleapis.com/domain_name
: 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 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 con un mes parcial para una suscripción de compromiso facturada mensual y para el 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 asocia con los cargos del último mes de una suscripción de compromiso facturada por mes.COMMITMENT_TERM_RENEWAL_ITEM
: Inicio de un período de suscripción con seguimiento.COMMITMENT_MONTHLY_ITEM
: Uso registrado de los compromisos existentes a principios de 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 un aumento o una disminución). Por lo general, comienza a mediados de mes y se extiende hasta el final del mes en el caso de una suscripción de compromiso facturada mensual o hasta el final del período de facturación o contrato de una suscripción prepagada.COMMITMENT_CANCEL_ITEM
: Se registra cuando se cancela una suscripción. Incluye los cargos asociados con la rescisión anticipada. Representa un cargo por el resto del período del contrato cuando el contrato se cancela a mitad de camino o un crédito emitido para el resto del período de facturación cuando un contrato se cambia o se cancela a mitad de camino.FLEXIBLE_SEATS_ITEM
: Registra el uso por parte de una cierta cantidad de usuarios durante un bloque contiguo de cierta cantidad de días. Actualmente, solo está dirigido a usuarios sin 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 de compromiso.
usage.amount
Para el uso por licencias de Google Workspace, esto indica las licencias pagadas. Por ejemplo, licencias comprometidas para compromisos o cantidad de licencias pagadas por flexibilidad.
usage.pricing_unit
- Para Google Cloud, obtén más información sobre la API de Cloud Billing Catalog.
- En el caso de 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 Google Cloud, es una descripción legible por humanos de un credits.id
alfanumérico. Los ejemplos incluyen el crédito de prueba gratuita o el 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éditos incluyen los siguientes:
COMMITTED_USAGE_DISCOUNT
: Contratos por compromiso de uso basados en recursos que se compran para Compute Engine a cambio de precios con grandes descuentos por el uso de VM.COMMITTED_USAGE_DISCOUNT_DOLLAR_BASE
: Contratos por compromiso de uso basados en la inversión que se compran 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 alcanzar un umbral 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 especificados. Para estos servicios, se aplican créditos para implementar el uso del nivel gratuito.PROMOTION
: El tipo de crédito promocional incluye una prueba gratuita de Google Cloud y créditos de 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 tu factura.RESELLER_MARGIN
: Si eres revendedor, el tipo de crédito de margen de revendedor indica los descuentos del Programa de revendedores que obtuviste en cada línea de pedido apta.SUBSCRIPTION_BENEFIT
: Son créditos que se obtienen por la compra de 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 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
: Una corrección debido a que se informó un uso incorrecto.PRICE_CORRECTION
: Una corrección debido a reglas de fijación de precios incorrectas.METADATA_CORRECTION
: Es una corrección para corregir los 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 como parte de un contrato como parte de un fondo de comercio.SLA_VIOLATION
: Es un crédito que se otorga al cliente debido a una infracción 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 para poner una cuenta cerrada a un saldo de cero.GENERAL_ADJUSTMENT
: 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 parcialmente el uso y el costo originales.COMPLETE_NEGATION_WITH_REMONETIZATION
: La corrección anula por completo el uso y el costo originales, y emite líneas de pedido corregidas con uso y costo actualizados.COMPLETE_NEGATION
: La corrección anula por completo el uso y el costo originales, y no se vuelve a monetizar ningún uso posterior.MANUAL_ADJUSTMENT
: El ajuste se asigna al costo y al uso de forma manual.
price.effective_price
En el caso de Google Cloud, este es el precio que se cobra por el uso de los SKUs de Google Cloud o Google Maps Platform y los niveles de precios de SKU. Si tu cuenta de Facturación de Cloud tiene precios de contrato personalizados, este es el precio específico de tu cuenta de facturación. De lo contrario, será el precio de lista del nivel de SKU o SKU.