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:
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 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. 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.