Configuración de facturación

Una configuración de facturación es un vínculo a nivel de la cuenta entre una cuenta de Google Ads y una cuenta de pagos (también conocida como configuración de facturas), que determina de manera efectiva a quién se le facturan los costos generados por los presupuestos de la cuenta de la configuración de facturación. Cada cuenta de pagos corresponde a una sola factura.

Acerca de las cuentas de pagos

Cada BillingSetup identifica una cuenta de pagos a la que se le facturan los costos incurridos por los presupuestos de su cuenta. Esta cuenta de pagos está asociada con un perfil de pagos que es, en última instancia, responsable de los cargos.

Las configuraciones de facturación contienen un campo payments_account y un grupo de campos payments_account_info que identifican que la cuenta de pagos está en uso, incluidos los siguientes:

Si una cuenta de pagos es apta para la facturación consolidada, se pueden agrupar varias cuentas de Google Ads en la misma factura. Para ello, debes establecer la configuración de facturación de modo que use la misma cuenta de pagos subyacente.

Cómo crear configuraciones de facturación nuevas

Puedes vincular configuraciones de facturación nuevas a cuentas de pagos existentes o a cuentas creadas al mismo tiempo.

Cómo usar una cuenta de pagos existente

Para vincular una cuenta de pagos existente, configura payments_account con el ID de recurso de una cuenta de pagos válida. Sin embargo, no modifiques payments_account_info.

Para obtener una lista de las cuentas de pagos disponibles, puedes usar el método PaymentsAccountService.ListPaymentsAccounts. El PaymentsAccounts que se muestra dependerá de la cuenta de administrador que uses para la autenticación.

Para cada PaymentsAccount, el ID de su administrador de pagos se encuentra en el campo paying_manager_customer.

Cómo usar una cuenta de pagos nueva

Para vincular una cuenta de pagos nueva, configura los siguientes campos en payments_account_info (no establezcas payments_account):

En el siguiente ejemplo, se muestra cómo crear una configuración de facturación nueva a partir de un ID de perfil de pagos existente. Como se indicó anteriormente, se creará una cuenta de pagos nueva con el nombre My New Payments Account.

BillingSetup bsetup = BillingSetup.newBuilder()
    .setPaymentsAccountInfo(PaymentsAccountInfo.newBuilder()
        .setPaymentsAccountName("My New Payments Account")
        .setPaymentsProfileId("1234-5678-9012")
        .build())
    .setStartTimeType(TimeType.NOW)
    .build();

BillingSetupOperation op = BillingSetupOperation.newBuilder().setCreate(bsetup).build();

try (BillingSetupServiceClient billingSetupServiceClient = googleAdsClient
    .getBillingSetupServiceClient()) {

  MutateBillingSetupResponse response =
      billingSetupServiceClient.mutateBillingSetup(Long.toString(customerId), op);
}

Si esta es la primera configuración de facturación que se agrega a una cuenta de Google Ads, el cliente se registrará para la facturación con el perfil de pagos al que se hace referencia.

Estado de configuración de facturación

Las instancias BillingSetup nuevas están sujetas a aprobación antes de que entren en vigor. Hasta entonces, su status estará en un estado PENDING.

Un BillingSetup puede estar en uno de los siguientes status:

Estado de configuración de facturación Descripción
PENDING Aprobación pendiente.
APPROVED_HELD Se aprobó, pero el primer presupuesto correspondiente no lo recibió. Esto solo puede ocurrir para las configuraciones de facturación configuradas para la facturación mensual.
APPROVED Se aprobó la configuración.
CANCELLED El usuario canceló la configuración antes de la aprobación.

Recuperar la configuración de facturación de una cuenta

Al igual que la mayoría de las otras entidades de la API de Google Ads, se recupera un BillingSetup cuando se consulta GoogleAdsService.SearchStream mediante una consulta del lenguaje de consulta de Google Ads que especifica qué campos mostrar.

Una vez que obtengas una referencia a un BillingSetup, podrás usarla para crear un AccountBudgetProposal como se describe en Presupuesto de la cuenta.

Cancela una configuración de facturación pendiente

Una BillingSetup que aún no entró en efecto se puede cancelar con la operación de eliminación. Las configuraciones de facturación solo se pueden cancelar si su status es PENDING o si su fecha de inicio es APPROVED en el futuro.