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 incurridos 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 sus presupuestos de cuenta. Esta cuenta de pagos está asociada a un perfil de pagos que es el responsable final de los cargos.
Las configuraciones de facturación contienen un campo payments_account y un grupo de campos payments_account_info que identifican la cuenta de pagos 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 a la configuración de facturación. Este nombre se imprime 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 se configura su facturación para que utilicen la misma cuenta de pagos subyacente.
Crear nuevas configuraciones de facturación
Puedes vincular configuraciones de facturación nuevas a cuentas de pagos existentes o a cuentas creadas al mismo tiempo.
Usar una cuenta de pagos existente
Para vincularla con una cuenta de pagos existente, establece payments_account en el ID de recurso de una cuenta de pagos válida. Sin embargo, no modifiques payments_account_info.
Puedes enumerar las cuentas de pago disponibles con el método PaymentsAccountService.ListPaymentsAccounts. Los PaymentsAccounts que se devuelven 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 campo paying_manager_customer.
Usar una cuenta de pagos nueva
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 nueva configuración de facturación a partir de un ID de perfil de pagos existente. Como se indicó anteriormente, esto también crea una nueva cuenta de Payments 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 pagos 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 estará 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 se aprobó el primer presupuesto correspondiente. Esto solo puede ocurrir en 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. |
Recupera la configuración de facturación de una cuenta
Al igual que la mayoría de las otras entidades en la API de Google Ads, un objeto BillingSetup se recupera consultando el objeto GoogleAdsService.SearchStream con una consulta del lenguaje de búsqueda de Google Ads que especifica qué campos se deben devolver.
Una vez que obtengas una referencia a un objeto BillingSetup, puedes usarla para crear un objeto AccountBudgetProposal, como se describe en Presupuesto de la cuenta.
Cómo cancelar una configuración de facturación pendiente
Un 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 su status es PENDING o si están APPROVED para comenzar en el futuro.