Una configuración de facturación es un vínculo a nivel de cuenta entre una cuenta de Google Ads y una cuenta de pagos (también conocida como configuración de factura), que determina de forma 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 generados por los presupuestos de su cuenta. Esta cuenta de pagos está asociada con un perfil de pagos que, en última instancia, es 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:
payments_account_info.payments_account_id
: Es un ID de 16 dígitos que se usa para identificar la cuenta de pagos asociada con la configuración de facturación.payments_account_info.payments_account_name
: Es el nombre de la cuenta de pagos asociada con la configuración de facturación. Este nombre está impreso en las facturas mensuales.payments_account_info.payments_profile_id
: Es un ID de 12 dígitos que se usa para identificar el perfil de pagos asociado con la configuración de facturación.
Si una cuenta de pagos es apta para la facturación consolidada, se pueden agrupar varias cuentas de Google Ads en la misma factura si estableces su configuración de facturación para que usen la misma cuenta de pagos subyacente.
Creación de nuevas configuraciones de facturación
Puedes vincular configuraciones de facturación nuevas a cuentas de pagos existentes o a cuentas creadas al mismo tiempo.
Usa 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
.
Puedes enumerar las cuentas de pagos disponibles con el método PaymentsAccountService.ListPaymentsAccounts
. Los PaymentsAccounts
que se muestran dependen de la cuenta de administrador que usas para la autenticación.
Para cada PaymentsAccount
, el ID de su administrador de pagos se encuentra en el campo paying_manager_customer
.
Usa una nueva cuenta de pagos
Para vincular una cuenta de pagos nueva, configura los siguientes campos en payments_account_info
(no configures 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, esto también creará una nueva cuenta de pagos 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, esto hará que se registre al cliente para que facture con el perfil de pagos al que se hace referencia.
Estado de la configuración de facturación
Las instancias BillingSetup
nuevas están sujetas a aprobación antes de entrar en vigencia. Hasta entonces, su status
estará en el estado PENDING
.
Un BillingSetup
puede estar en uno de los siguientes status
:
Estado de la configuración de facturación | Descripción |
---|---|
PENDING |
Aprobación pendiente. |
APPROVED_HELD |
Se aprobó, pero el primer presupuesto correspondiente no lo ha hecho. Esto solo puede ocurrir con las configuraciones de facturación establecidas 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 demás entidades de la API de Google Ads, se recupera un BillingSetup
a través de una consulta a GoogleAdsService.SearchStream
con un lenguaje de consulta de Google Ads que especifica qué campos mostrar.
Una vez que obtengas una referencia a un BillingSetup
, puedes usarla para crear un 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 entró en vigencia se puede cancelar con la operación de eliminación. Las configuraciones de facturación solo se pueden cancelar si sus status
son PENDING
o si tienen APPROVED
comenzar en el futuro.