Cómo exportar datos de los servicios de canal a BigQuery

En esta página, se muestra cómo configurar una exportación de los 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 proporcionas.

Las exportaciones de los servicios de canal contienen datos específicos del revendedor que no se incluyen en las exportaciones de la Facturación de Cloud. Esto incluye los costos, los créditos y los datos de uso con tus reglas de revisión de precios configuradas. 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 los 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 de revendedores, consulta Cómo configurar 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, 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.
• Habilita 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 los 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 los 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 el rol BigQuery Data Owner.

• Para habilitar las exportaciones de Google Cloud, en Partner Sales Console, debes tener el rol de administrador de revendedor 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 revendedores o tener privilegios de facturación de Google Workspace.

  Obtén información para asignar roles de Google Workspace en Partner Sales Console

• Project Viewer (opcional) para el proyecto que contiene el conjunto de datos de BigQuery de destino, para verificar automáticamente 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 [BigQuery

  conjunto de datos](/bigquery/docs/datasets-intro) para usar una ubicación multirregional, los datos de exportación de BigQuery están disponibles para cada fuente de datos seleccionada desde el comienzo del mes anterior. Por ejemplo, si habilitas la exportación a BigQuery el 23 de septiembre, tu exportación incluirá los datos a partir del 1 de agosto.

• Si configuras tu [BigQuery

  conjunto de datos](/bigquery/docs/datasets-intro) para usar una ubicación regional (que no sea multirregional de EE.UU. o la 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 para las ubicaciones de conjuntos de datos que no son multirregionales, por lo que no verás los datos de exportación de BigQuery anteriores a la fecha en que habilitaste la exportación.

Para exportar datos de facturación de varias cuentas de Partner Sales Console, sigue estos pasos:

1. 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.
2. 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

BigQuery admite dos tipos de regiones.

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.

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.

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.

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.

Habilita la exportación

Antes de habilitar la exportación de datos, anota el ID del conjunto de datos completamente calificado, que está en el formato PROJECT_ID:DATASET_NAME.

Para habilitar la exportación de los servicios de canal, sigue estos pasos:

1. En Partner Sales Console, abre la página Facturación.
2. Selecciona Exportación de la facturación.
3. Ingresa el ID del conjunto de datos completamente calificado en el campo Conjunto de datos de refacturación.
4. Selecciona las fuentes de datos para las que deseas exportar datos.
5. Haz clic en Actualizar. *Si aparece 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 a diario. La tabla de exportación no aparecerá hasta que se ejecute la exportación de facturación de tu cuenta por primera vez. El conjunto de datos contiene datos desde la primera vez que se configuró para retenlos.

Para dejar de exportar datos de costos de refacturación al conjunto de datos, haz clic en Inhabilitar la exportación de datos de facturación en la página Refacturación de clientes. Para 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 la refacturación no estén disponibles durante el período en que se inhabilitó. Si borraste datos exportados durante ese período, 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 es propiedad de Google y que esta administra, y tiene permiso para escribir registros de facturación en una tabla. La cuenta de servicio tiene las siguientes características:

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

Esta cuenta de servicio requiere el rol predefinido: roles/bigquery.dataEditor para permitir las exportaciones. Para configurar los permisos, sigue los pasos para habilitar la exportación.

Cómo consultar datos de manera eficiente

La tabla de BigQuery se particiona por export_time y se agrupa 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 rápidamente los datos relevantes, lo que puede reducir significativamente el costo de la consulta.

Por ejemplo, esta consulta es eficiente en comparación con una consulta sin particiones ni claves de agrupación:

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 el particionamiento, el agrupamiento y las prácticas recomendadas, consulta los siguientes vínculos:

1. Consulta tablas particionadas
2. Cómo consultar tablas agrupadas
3. Optimiza el procesamiento de las consultas
4. 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 Facturación de socios.

Puedes ver todas las cuentas de facturación y los IDs de las cuentas de facturación del pagador.

Cómo 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 la exportación de BigQuery. 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 tienen autorización para ver, te recomendamos que configures vistas autorizadas para compartir datos de tu conjunto de datos exportado.

Para la exportación de datos continua, cuando configures los permisos de los usuarios, asegúrate de que la cuenta de servicio cloud-channel-billing-reporting-rebilling@system.gserviceaccount.com siempre tenga acceso de editor completo en el conjunto de datos de exportación.

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 detallada de la refacturación se carga en una tabla de datos llamada reseller_billing_detailed_export_v1.

Notas adicionales sobre el esquema

Hay algunas notas adicionales sobre el esquema.

Columnas que no se aplican a Google Workspace

Cuando una columna o un campo no se aplican a una familia de productos, los datos exportados para esta familia contienen null en este campo. Los siguientes campos no se aplican a las exportaciones de Google Workspace:

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

Columnas que no se aplican a los pedidos sin conexión (versión preliminar)

Cuando una columna o un campo no se aplican a una familia de productos, los datos exportados para esta familia contienen null en esta columna o campo. Las siguientes columnas o campos no se aplican a las exportaciones de facturación de pedidos sin conexión:

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

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 incluyen el uso del revendedor.
• Cuando cost_type es tax y adjustment, 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 imprecisiones menores de redondeo.

billing_account_id

• En el caso de Google Cloud, esta es la cuenta de Facturación de Cloud con la que está asociado el uso.
• En el caso de Google Workspace, es la Cloud Identity del cliente.
• En el caso de los pedidos sin conexión, es el nombre del cliente.

service y sku

En el caso de 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, se representan como marcas de tiempo:

• Para usage_start_time, esta es la hora de inicio (inclusive) 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 después de 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 Cómo usar etiquetas.

labels

En el caso de 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 Cómo usar etiquetas.

system_labels

• En el caso de 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 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: Es el nombre de dominio del cliente.
  • workspace.googleapis.com/order_id: Es el ID del pedido.
  • workspace.googleapis.com/purchase_order_id: El ID de la orden de compra (OC).
  • workspace.googleapis.com/subscription_id: Es el ID de la suscripción.
  • workspace.googleapis.com/usage_type: Es el tipo de uso. No se aplica si cost_type no es regular.

Estos son algunos de los tipos de uso de Google Workspace:

• 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 mensualmente y para el período de facturación o contrato de una suscripción prepagada.
• COMMITMENT_TERM_END_ITEM: Finalización de una suscripción. Por lo general, se asocia con los cargos del último mes de una suscripción con compromiso facturada mensualmente.
• COMMITMENT_TERM_RENEWAL_ITEM: Inicio de un período de suscripción adicional.
• COMMITMENT_MONTHLY_ITEM: Es el 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 (aumento o disminución). A menudo, comienza a mediados de mes y se extiende hasta el final del mes para una suscripción de compromiso con facturación mensual o hasta el final del período de facturación o contrato para 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 este se cancela antes de su finalización o un crédito emitido por el resto del período de facturación cuando se cambia o cancela un contrato antes de su finalización.
• FLEXIBLE_SEATS_ITEM: Registra el uso de una cantidad determinada de usuarios durante un bloque continuo de algunos días. Solo está diseñado para usuarios sin un compromiso.
• COUPON_DISCOUNT_ITEM: Es el importe del descuento asociado a un cupón.
• MIGRATED_CREDIT_ITEM: Crédito de la migración de Postini.
• COMMITMENT_PREPAY_BILLING_PERIOD_ITEM: Representa una información de uso que se crea al comienzo del ciclo de pago para todo el ciclo de una suscripción con pago por adelantado con compromiso.

usage.amount

En el caso del uso basado en licencias de Google Workspace, esto indica las licencias pagadas. Por ejemplo, licencias prometidas para compromisos o cantidad de licencias pagadas para la flexibilidad.

usage.pricing_unit

• En el caso de Google Cloud, obtén más información sobre la API de Cloud Billing Catalog{: track-type="tasks" class="external" track-name="externalLink" track-metadata-position="body"}
• Para Google Workspace, es count.

credits.id

En el caso de 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, esta es una descripción en lenguaje natural de un credits.id alfanumérico. En los ejemplos, se incluyen un crédito de prueba gratuita o un descuento por compromiso de uso basado en el gasto. Los valores de credits.full_name solo se propagan para los SKU con credits.id alfanuméricos. 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 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 descuentos considerables en los precios por el uso de VM.
• COMMITTED_USAGE_DISCOUNT_DOLLAR_BASE: Contratos de compromiso de uso basados en gastos adquiridos por servicios a cambio de tu compromiso para invertir un importe mínimo.
• DISCOUNT: El tipo de crédito de descuento se usa para los créditos que se obtienen después de alcanzar un límite de gastos 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 se muestra como Descuentos basados en gastos (contrato).
• FREE_TIER: Algunos servicios ofrecen uso de recursos gratuitos 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 la prueba gratuita de Google Cloud y los créditos de la campaña de marketing, o algún otro otorgamiento para usar Google Cloud. Cuando están disponibles, estos créditos se consideran una forma de pago y se aplican de forma automática para reducir el total de tu factura.
• RESELLER_MARGIN: Si eres un distribuidor, el tipo de crédito de margen del distribuidor indica los descuentos del programa para distribuidores ganados en cada elemento de una sola línea apto.
• SUBSCRIPTION_BENEFIT: Son los créditos que se obtienen mediante la compra de suscripciones a largo plazo a los 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 de Compute Engine específicos durante una parte significativa del mes de facturación.

adjustmentsInfo

En el caso de Google Cloud, estos valores solo se completan si el elemento de una sola línea del costo se generó para una modificación de la Facturación de Cloud. El tipo adjustmentsInfo contiene detalles sobre el ajuste, si se emitió 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 un uso incorrecto informado.
• PRICE_CORRECTION: Una corrección debido a reglas de fijación de precios incorrectas.
• METADATA_CORRECTION: 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: Un crédito que se emite al cliente para el fondo de comercio, como parte de un contrato.
• SLA_VIOLATION: Un crédito que se emite al cliente debido a un incumplimiento del objetivo de nivel de servicio (SLO).
• BALANCE_TRANSFER: Un ajuste para transferir fondos de una cuenta de pago a otra.
• ACCOUNT_CLOSURE: Un ajuste para llevar una cuenta cerrada a un saldo de cero.
• GENERAL_ADJUSTMENT: Una modificación general de la cuenta de Facturación de Cloud.

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 emite elementos de una sola línea corregidos 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.
• 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 SKU y los niveles de precios de Google Cloud o Google Maps Platform. Si tu cuenta de Facturación de Cloud tiene precios personalizados por contrato, este precio es específico de tu Facturación de Cloud. De lo contrario, este es el precio de lista del SKU o nivel de SKU.