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 Payments (también conocida como una configuración de facturas), que determina quién recibe la factura por los costos generados por los presupuestos de la cuenta de la configuración de facturación. Cada cuenta de Payments corresponde a una sola factura.

Acerca de las cuentas de Payments

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

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

Si una cuenta de Payments es apta para la facturación consolidada, entonces se pueden agrupar varias cuentas de Google Ads en la misma factura si se configura su facturación para que usen la misma cuenta de Payments subyacente.

Cómo crear configuraciones de facturación nuevas

Puedes vincular configuraciones de facturación nuevas a cuentas de Payments existentes o a las que se crearon al mismo tiempo.

Cómo usar una cuenta de Payments existente

Para vincularla con una cuenta de Payments existente, establece payments_account en el ID de recurso de una cuenta de Payments válida. Sin embargo, no modifiques payments_account_info.

Puedes enumerar las cuentas de pagos disponibles con el PaymentsAccountService.ListPaymentsAccounts método. Las PaymentsAccounts que se muestran dependen 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 paying_manager_customer campo.

Cómo usar una cuenta de Payments nueva

Para vincularla con una cuenta de Payments nueva, establece 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 Payments existente. Como se indicó anteriormente, esto también crea una cuenta de Payments 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, se registrará al cliente para la facturación con el perfil de Payments al que se hace referencia.

Estado de la configuración de facturación

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

Un BillingSetup puede tener uno de los siguientes status:

Estado de la configuración de facturación Descripción
PENDING Aprobación pendiente.
APPROVED_HELD Se aprobó, pero no el primer presupuesto correspondiente. 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.

Cómo 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 una BillingSetup consultando GoogleAdsService.SearchStream con una consulta del lenguaje de búsqueda de Google Ads que especifica qué campos se deben mostrar.

Una vez que obtienes una referencia a una BillingSetup, puedes usarla para crear una AccountBudgetProposal, como se describe en Presupuesto de la cuenta.

Cómo cancelar una configuración de facturación pendiente

Una BillingSetup que aún no haya entrado en vigencia 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 están APPROVED para comenzar en algún momento en el futuro.