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

En esta página, se muestra cómo configurar una exportación de Channel Services y 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 especificado. Estos datos pueden ayudarte a realizar un análisis detallado de cómo tus clientes o socios de canal utilizan 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 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 la Facturación de Cloud que no son de revendedores, consulta cómo configurar las exportaciones de la 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.
• Habilita la API del Servicio de transferencia de datos de BigQuery en el proyecto.
• Crea un conjunto de datos para los 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 reutilizar 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 canales, necesitas los siguientes roles:

• En el caso de 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 , debes tener el rol de administrador de revendedor Google Cloud en Partner Sales Console.

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

• Para habilitar las exportaciones de Google Workspace, debes ser administrador de revendedor o tener privilegios de facturación de Google Workspace.

  Más información para asignar roles de Google Workspace en la Partner Sales Console

• (Opcional) Project Viewer 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 canales. 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 habilitas la exportación de datos de los servicios de canal por primera vez para cada 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 la exportación a BigQuery el 23 de septiembre, tu exportación incluirá los 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 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 los 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 compatibles con BigQuery

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

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

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.

Habilitar la exportación

Antes de habilitar la exportación de datos, anota el ID del conjunto de datos completo, que tiene 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.

Una vez configurada, 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 información desde el momento en que se configuró por primera vez para conservar 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 datos de facturación en la página Refacturación del cliente. 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 refacturación no estén disponibles durante el período en que se inhabilitó la función. Si borraste algún dato exportado durante ese período, no podremos reabastecer los registros borrados.

Permisos obligatorios 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 este administra, y 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 el rol predefinido: roles/bigquery.dataEditor para permitir las exportaciones. Para configurar los permisos, sigue los pasos para habilitar la exportación.

Consulta datos de manera eficiente

De forma predeterminada, la tabla de BigQuery se particiona por export_time y se agrupa en clústeres por payer_billing_account_id. Esto significa que la tabla se divide en particiones más pequeñas, cada una de las cuales se divide aún más en clústeres más pequeños. Usar las claves de partición y de clúster en una consulta ayudará a BigQuery a ubicar rápidamente los datos pertinentes, lo que puede reducir significativamente el costo de la consulta.

Por ejemplo, esta consulta es eficiente en comparación con una consulta sin claves de partición ni de 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 las particiones, el agrupamiento y las prácticas recomendadas, consulta los siguientes vínculos:

1. Consulta tablas particionadas
2. Consulta 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 la Consola de Ventas para Socios y haz clic en la pestaña Facturación para socios.

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

Cómo configurar 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 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 están autorizados a ver, te recomendamos que configures vistas autorizadas para compartir datos de tu conjunto de datos exportado.

Para la exportación continua de datos, 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.

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 aplica a una familia de productos, los datos exportados para esta familia de productos 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
• price.list_price
• price.effective_price_default
• price.list_price_consumption_model
• transaction_type
• seller_name
• consumption_model

Columnas no aplicables a los SKU de Google Workspace basados en el consumo

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

• service.id
• sku.id
• project
• labels
• resource
• customer_repricing_config_name
• channel_partner_repricing_config_name
• tags
• price.effective_price
• price.tier_start_amount
• transaction_type
• seller_name
• subscription

Columnas no aplicables a los pedidos sin conexión (versión preliminar)

Cuando una columna o un campo no se aplica a una familia de productos, los datos exportados para esta familia de productos 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
• price.list_price
• price.effective_price_default
• price.list_price_consumption_model
• transaction_type
• seller_name
• consumption_model

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 es tax y adjustment, usage.amount_in_pricing_units siempre es 1.
• En las facturas de Google Workspace, los impuestos se muestran como un solo concepto. En la exportación, los impuestos se desglosan por cliente. Si bien el impuesto total debe coincidir con el de la factura, los impuestos individuales pueden contener pequeñas imprecisiones de redondeo.

billing_account_id

• Para Google Cloud, esta es la cuenta de Facturación de Cloud con la que se asocia el uso.
• En el caso de Google Workspace, es el Cloud Identity del cliente.
• En el caso de los pedidos sin conexión, este 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 producto y SKU .

En el caso de los SKU de consumo de Google Workspace (Google Voice y Drive), las columnas sku.id y service.id contienen null.

usage_start_time y usage_end_time

En el CSV de la factura de Google Workspace, esto se representa como fechas. En las exportaciones, se representan como marcas de tiempo:

• En el caso de usage_start_time, esta es la hora de inicio (inclusive) de la suscripción, a las 0:00 (PST) en la fecha de inicio.
• En el caso de usage_end_time, esta 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

Para Google Cloud, estos son los pares clave-valor en el proyectoGoogle Cloud en el que se produjo el uso. Para obtener más información, consulta Usa etiquetas.

labels

Para Google Cloud, estos son los pares clave-valor en el recurso Google Clouden 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 recursoGoogle 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: Es 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.

Los tipos de uso de Google Workspace incluyen los siguientes:

• COMMITMENT_TERM_START_ITEM: Es el comienzo de una suscripción. Por lo general, se asocia con un mes parcial para una suscripción con compromiso facturada mensualmente y para el período de facturación o contractual de una suscripción prepagada.
• COMMITMENT_TERM_END_ITEM: Es el final 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: Es el inicio de un período de suscripción de seguimiento.
• 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 (ya sea que aumente o disminuya). A menudo, comienza a mediados del mes y se extiende hasta el final del mes en el caso de una suscripción con compromiso facturada mensualmente o hasta el final del período de facturación o del contrato en el caso de una suscripción prepagada.
• COMMITMENT_CANCEL_ITEM: Se registra cuando se cancela una suscripción. Incluye los cargos asociados a la cancelación anticipada. Representa un cargo por el resto del período del contrato cuando este se cancela a mitad del período o un crédito emitido por el resto del período de facturación cuando se cambia o cancela un contrato a mitad del período.
• FLEXIBLE_SEATS_ITEM: Registra el uso de una cantidad de usuarios durante un período contiguo de una cantidad de días. Solo está disponible para usuarios sin 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 la información de uso que se crea al comienzo del ciclo de pagos para todo el ciclo de una suscripción prepagada con compromiso.

usage.amount

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

En el caso de los SKU de consumo de Google Workspace (Google Voice y Drive), se indica la cantidad de minutos utilizados.

usage.pricing_unit

• Para 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"}
• En el caso de Google Workspace, es count.

credits.id

En el caso de Google Cloud, puede ser 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 a 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 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

Para 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 los límites especificados. En estos servicios, se aplican créditos para implementar el uso del nivel gratuito.
• PROMOTION: El tipo de crédito promocional incluye la Google Cloud prueba gratuita y los créditos de la campaña de marketing, o algún otro subsidio 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 un revendedor, el tipo de crédito de margen del revendedor indica los descuentos del programa para revendedores obtenidos en cada línea de pedido apta.
• 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 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 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: Se trata de un crédito que se emite al cliente para el fondo de comercio, como parte de un contrato.
• SLA_VIOLATION: Es un crédito que se emite 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 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 deGoogle Cloud o Google Maps Platform y los niveles de precios de los SKU. 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.