Exportar datos de Channel Services a BigQuery

En esta página se explica cómo configurar una exportación de servicios de canal y se describe el esquema disponible para una exportación.

Con BigQuery, puedes exportar datos de facturación de Channel Services a un conjunto de datos de BigQuery específico. Estos datos pueden ayudarte a realizar un análisis detallado de cómo usan tus clientes o partners de canal los servicios que proporcionas.

Las exportaciones de Channel Services contienen datos específicos de distribuidores que no se incluyen en las exportaciones de facturación de Cloud. Dichos datos incluyen los costes, los créditos y el uso con las reglas de cambio de precio que hayas configurado. 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 Channel Services son compatibles con las exportaciones de Facturación de Cloud, y puedes usar consultas para combinar ambos conjuntos de datos y analizarlos.

Para obtener información sobre las exportaciones de Facturación de Cloud que no son de revendedores, consulta el artículo sobre cómo configurar exportaciones de Facturación de Cloud a BigQuery.

Antes de empezar

Antes de empezar a exportar datos de facturación de Channel Services, debes hacer lo siguiente:

• Configura un proyecto para alojar tu conjunto de datos de BigQuery. Asegúrate de que la facturación esté habilitada en el proyecto.
• Habilita la API BigQuery Data Transfer Service 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 facturación de Cloud, puedes reutilizar ese proyecto y ese conjunto de datos para la exportación de Channel Services.

Para obtener información detallada sobre cómo configurar un proyecto y un conjunto de datos, consulta Configurar la exportación de datos de Facturación de Cloud a BigQuery.

Permisos necesarios para las exportaciones

Para habilitar y configurar las exportaciones de Channel Services, necesitas los siguientes roles:

• En BigQuery, si has creado el conjunto de datos de destino, necesitas el rol BigQuery User en el proyecto que contiene el conjunto de datos. Si el conjunto de datos lo ha creado otra persona, necesitas el rol BigQuery Data Owner.

• Para habilitar las exportaciones de Google Cloud , debes tener el rol de administrador de distribuidor en Partner Sales Console. Google Cloud

  Consulta cómo asignar roles Google Cloud en la Partner Sales Console.

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

  Consulta cómo asignar roles de Google Workspace en la consola de Partner Sales.

• (Opcional) Project Viewer del proyecto que contiene el conjunto de datos de BigQuery de destino para comprobar automáticamente si la facturación está habilitada en el proyecto.

Seleccionar un proyecto y un conjunto de datos

En la consola Partner Sales, selecciona un proyecto y un conjunto de datos de BigQuery donde almacenar los datos de Channel Services. Habilita la facturación en el proyecto si aún no lo has hecho.

Cuando seleccionas o creas un conjunto de datos de BigQuery, puedes elegir una de las ubicaciones de BigQuery admitidas para el conjunto de datos. Cuando habilitas la exportación de datos de Channel Services por primera vez para cada fuente de datos (Google Cloud o Google Workspace):

• Si configuras tu conjunto de datos de BigQuery para que use una ubicación multirregional, los datos de BigQuery Export estarán disponibles para cada fuente de datos seleccionada desde el inicio del mes anterior. Por ejemplo, si habilitas la exportación a BigQuery el 23 de septiembre, la exportación incluirá datos a partir del 1 de agosto.

• Si configura su conjunto de datos de BigQuery para que use una región específica (que no sea la multirregión de EE. UU. o de la UE), los datos de BigQuery Export estarán disponibles para cada fuente de datos seleccionada a partir de la fecha en la que habilite la exportación. Es decir, los datos de exportación de BigQuery no se añaden de forma retroactiva en las ubicaciones de conjuntos de datos que no son multirregionales, por lo que no verás datos de exportación de BigQuery anteriores a la habilitación de 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 quieras 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.
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 admitidas

BigQuery admite dos tipos de regiones.

Multirregional

En la siguiente tabla se indican las multirregiones en las que se admite la exportación de datos de BigQuery de Channel Services.

Regiones

En la siguiente tabla se indican las regiones de América en las que se admite la exportación de datos de Channel Services a BigQuery.

En la siguiente tabla se indican 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 indican las regiones de Europa en las que se admite la exportación de datos de BigQuery de Channel Services.

Habilitar la exportación

Antes de habilitar la exportación de datos, anota el ID completo del conjunto de datos, que tiene el formato PROJECT_ID:DATASET_NAME.

Para habilitar la exportación de Channel Services, siga estos pasos:

1. En Partner Sales Console, abre la página Facturación.
2. Selecciona Exportación de facturación.
3. Introduce el ID de conjunto de datos cualificado en el campo Conjunto de datos para la modificación de facturas.
4. Seleccione las fuentes de datos de las que quiera 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 la facturación incluye nuevos datos de uso cada día. La tabla de exportación no aparecerá hasta que se ejecute por primera vez la exportación de facturación de tu cuenta. El conjunto de datos contiene datos desde que se configuró por primera vez para conservar datos.

Para dejar de exportar los datos de costes de modificación de facturas al conjunto de datos, haz clic en Inhabilitar exportación de datos de facturación en la página Modificación de facturació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 costes de modificación de facturas no estén disponibles durante el periodo en que la exportación haya estado inhabilitada. Si has eliminado datos exportados durante ese periodo, no podemos reponer los registros eliminados.

Permisos de cuenta de servicio necesarios

La exportación de datos de Channel Services usa una cuenta de servicio propiedad de Google y gestionada también por Google que tiene permiso para escribir registros de facturación en una tabla. La cuenta de servicio es:

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, siga los pasos para habilitar la exportación.

Consultar datos de forma eficiente

La tabla de BigQuery tiene particiones por export_time y está 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, y cada una de ellas se divide a su vez en clústeres más pequeños. Usar las claves de partición y de clúster en una consulta ayudará a BigQuery a localizar rápidamente los datos relevantes, lo que puede reducir significativamente el coste de la consulta.

Por ejemplo, esta consulta es eficiente en comparación con una consulta sin claves de partición y de clustering:

SELECT
  billing_account_id
  currency,
  invoice.month,
  -- Divide by currency_conversion_rate if converting non-USD to USD.
  SUM(cost)
    + SUM(
      IFNULL(
        (SELECT SUM(c.amount) FROM UNNEST(credits) AS c), 0))
    AS total
FROM PROJECT_ID.DATASET_NAME.reseller_billing_detailed_export_v1
WHERE
  export_time BETWEEN TIMESTAMP(START_DATE)
    AND TIMESTAMP(END_DATE)
  AND payer_billing_account_id IN (PAYER_BILLING_ACCOUNT_IDS)
GROUP BY
  billing_account_id,
  currency,
  invoice.month
ORDER BY
  billing_account_id,
  currency,
  invoice.month;

Para obtener más información sobre la creación de particiones, la creación de clústeres y las prácticas recomendadas, consulta los siguientes enlaces:

1. Consultar tablas con particiones
2. Consultar tablas agrupadas en clústeres
3. Optimizar las operaciones de computación de las consultas
4. Prácticas recomendadas para controlar los costes en BigQuery

Buscar el ID de cuenta de facturación del pagador

Para encontrar el ID de la cuenta de facturación del pagador, abra la página de cuentas de facturación de la consola Partner Sales y haga clic en la pestaña Facturación de partner.

Puede 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

Hay varias formas de configurar los controles de acceso a los datos en 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, te recomendamos que configures vistas autorizadas para compartir datos de tu conjunto de datos exportado.

En el caso de la exportación continua de datos, 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 completo de editor al conjunto de datos de exportación.

Esquema de tabla

El siguiente esquema describe los datos de la tabla de BigQuery.

En el conjunto de datos de BigQuery, la exportación detallada de las modificaciones de facturas 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 no aplicables a Google Workspace

Cuando una columna o un campo no se aplica a una familia de productos, los datos exportados de esa familia de productos contienen null en ese 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 SKUs de consumo de Google Workspace

Cuando una columna o un campo no se aplica a una familia de productos, los datos exportados de esa familia de productos contienen null en ese 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 pedidos sin conexión (vista previa)

Cuando una columna o un campo no se aplica a una familia de productos, los datos exportados de esa familia de productos contienen null en esa 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

Hay varios comportamientos especiales en las exportaciones de Google Workspace:

• Los datos de Google Workspace no incluyen el uso propio del distribuidor.
• 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 concepto. En la exportación, los impuestos se desglosan por cliente. Aunque el impuesto total debe coincidir con el de la factura, es posible que los impuestos individuales contengan pequeñas imprecisiones debido al redondeo.

billing_account_id

• En el caso de Google Cloud, se trata de la cuenta de facturación de Cloud a la que se asocia el uso.
• En el caso de Google Workspace, se trata del ID de Cloud Identity del cliente.
• En los pedidos sin conexión, es el nombre del cliente.

service y sku

En Google Workspace, estas columnas representan el producto y el SKU asociados al uso. Más información sobre los IDs de producto y SKU .

En el caso de los SKUs 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 archivo CSV de la factura de Google Workspace, se representa como fechas. En las exportaciones, se representan como marcas de tiempo:

• En el caso de usage_start_time, se trata de la hora de inicio (incluida) de la suscripción, a las 0:00 (PST) de la fecha de inicio.
• En el caso de usage_end_time, se trata de la hora de finalización (exclusiva) de la suscripción, a las 0:00 (PST) del día siguiente a la fecha de finalización.

project.labels

En el caso de Google Cloud, se trata de los pares clave-valor del Google Cloud proyecto en el que se ha producido el uso. Para obtener más información, consulta el artículo sobre el uso de etiquetas.

labels

En el caso de Google Cloud, se trata de los pares clave-valor del Google Cloud recurso en el que se ha producido el uso. Para obtener más información, consulta el artículo sobre el uso de etiquetas.

system_labels

• En el caso de Google Cloud, se trata de los pares clave-valor delGoogle Cloud recurso en el que se ha producido el uso. Para obtener más información, consulta las etiquetas disponibles del sistema.

• En el caso de Google Workspace, se trata de metadatos adicionales sobre el coste, que incluye lo siguiente:

  • workspace.googleapis.com/domain_name: nombre de dominio del cliente.
  • workspace.googleapis.com/order_id: el ID del pedido.
  • workspace.googleapis.com/purchase_order_id: ID de la orden de compra.
  • workspace.googleapis.com/subscription_id: el ID de la suscripción.
  • workspace.googleapis.com/usage_type: el tipo de uso. No aplicable si cost_type no es regular.

Los tipos de uso de Google Workspace son los siguientes:

• COMMITMENT_TERM_START_ITEM: inicio de una suscripción. Normalmente, se asocia a un mes parcial de una suscripción con compromiso de facturación mensual y al periodo de facturación o de contrato de una suscripción prepago.
• COMMITMENT_TERM_END_ITEM: fin de una suscripción. Normalmente se asocia a los cargos del último mes de una suscripción con compromiso de facturación mensual.
• COMMITMENT_TERM_RENEWAL_ITEM: inicio de un periodo de suscripción posterior.
• COMMITMENT_MONTHLY_ITEM: uso registrado de los compromisos que existían al principio del mes. En la mayoría de los casos, el cargo se aplicará durante todo el mes.
• COMMITMENT_SEATS_CHANGE_ITEM: se registra cuando cambia el nivel de compromiso (ya sea para aumentar o disminuir). Suele empezar a mediados de mes y se extiende hasta el final del mes en el caso de las suscripciones con compromiso de facturación mensual, o hasta el final del periodo de facturación o del contrato en el caso de las suscripciones prepago.
• 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 periodo restante del contrato cuando este se cancela a mitad de plazo o un crédito emitido por el periodo restante de facturación cuando se cambia o cancela un contrato a mitad de plazo.
• FLEXIBLE_SEATS_ITEM: registra el uso de un número de usuarios durante un bloque contiguo de un número de días. Solo para usuarios sin compromiso.
• COUPON_DISCOUNT_ITEM: 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 inicio del ciclo de pago de todo el ciclo de una suscripción prepago con compromiso.

usage.amount

En el caso del uso basado en puestos de Google Workspace, se indican los puestos pagados. Por ejemplo, los puestos confirmados en los planes de facturación fija y los puestos pagados en los planes de facturación flexible.

En el caso de los SKUs de consumo de Google Workspace (Google Voice y Drive), se trata del número de minutos utilizados.

usage.pricing_unit

• Para Google Cloud, consulta más información sobre la API Catalog de Facturación de Cloud. {: 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 ningún crédito.

credits.full_name

En el caso de Google Cloud, se trata de una descripción textual de un credits.id alfanumérico. Por ejemplo, Crédito de prueba gratuita o Descuento por compromiso de uso basado en el gasto . Los valores de credits.full_name solo se rellenan en el caso de los SKUs que tienen un código alfanumérico credits.id. Si el valor de credits.id es una descripción del tipo de crédito (por ejemplo, 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 con compromiso de uso basados en recursos que se compran para usar Compute Engine a cambio de importantes descuentos en el uso de máquinas virtuales.
• COMMITTED_USAGE_DISCOUNT_DOLLAR_BASE: contratos con compromiso de uso basados en gastos que se compran para usar determinados servicios a cambio del compromiso de gastar un importe mínimo.
• DISCOUNT: se usa cuando se obtienen créditos después de alcanzar un umbral de gasto definido en un contrato. En los informes de Facturación de Cloud que están disponibles en la consola de Partner Sales, este tipo de crédito aparece como Descuentos en función del gasto (contractuales).
• FREE_TIER: Algunos servicios ofrecen uso gratuito de recursos hasta alcanzar ciertos límites. Para ofrecer este uso, esos servicios utilizan créditos.
• PROMOTION: en este tipo de crédito están incluidos la Google Cloud prueba gratuita y los créditos de campañas de marketing, así como otras ayudas para usar Google Cloud. Cuando hay créditos promocionales disponibles, se considera que esos créditos son una forma de pago y se incluyen automáticamente en las facturas para reducir el importe total.
• RESELLER_MARGIN: si eres distribuidor, este tipo de crédito margen de distribuidor indica los descuentos del programa para distribuidores que se han obtenido por cada elemento de línea que cumplía los requisitos.
• SUBSCRIPTION_BENEFIT: crédito que se ha obtenido por adquirir suscripciones de larga duración a servicios a cambio de descuentos.
• SUSTAINED_USAGE_DISCOUNT: este tipo de crédito es un descuento automático que se obtiene por ejecutar determinados recursos de Compute Engine durante gran parte de un mes de facturación.

adjustmentsInfo

En el caso de Google Cloud, estos valores solo se rellenan si el elemento de línea de coste se ha generado en una modificación de Facturación de Cloud. El tipo adjustmentsInfo contiene detalles sobre el ajuste tanto si se ha emitido para corregir un error como si se ha hecho por otros motivos.

adjustmentsInfo.adjustment_type

En el caso de Google Cloud, esto incluye lo siguiente:

• USAGE_CORRECTION: corrección aplicada porque se ha registrado un uso que no era correcto.
• PRICE_CORRECTION: corrección aplicada debido a reglas de precios incorrectas.
• METADATA_CORRECTION: corrección de los metadatos que no cambia el coste.
• GOODWILL: crédito que se da al cliente como cortesía.
• SALES_BASED_GOODWILL: crédito que se da al cliente como cortesía porque figura en un contrato.
• SLA_VIOLATION: crédito que se da al cliente debido a una infracción del objetivo de nivel de servicio.
• BALANCE_TRANSFER: ajuste para transferir fondos de una cuenta de pagos a otra.
• ACCOUNT_CLOSURE: ajuste para dejar a cero una cuenta cerrada.
• 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 niega parcialmente el uso y el coste originales.
• COMPLETE_NEGATION_WITH_REMONETIZATION: la corrección niega por completo el uso y el coste originales. Se emiten elementos de línea con el uso y el coste actualizados.
• COMPLETE_NEGATION: la corrección niega por completo el uso y el coste originales. No se vuelve a monetizar ningún uso adicional.
• MANUAL_ADJUSTMENT: el ajuste se asigna al coste y al uso de forma manual.

price.effective_price

En el caso de Google Cloud, se trata del precio que se cobra por el uso de los SKUs deGoogle Cloud o de Google Maps Platform y de los niveles de precios de los SKUs. Si tu cuenta de Facturación de Cloud tiene precios de contrato personalizados, este precio es específico de tu cuenta de Facturación de Cloud. En caso contrario, se trata del precio según catálogo del SKU o del nivel del SKU.