Una configuración de facturación es una vinculación a nivel de la cuenta entre una cuenta de Google Ads y una cuenta de Payments (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 los presupuestos de la 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 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 Payments 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 Payments es apta para la facturación consolidada, se pueden agrupar varias cuentas de Google Ads en la misma factura configurando sus parámetros de facturación para que usen la misma cuenta subyacente de Payments.
Cómo crear nuevas configuraciones de facturación
Puedes vincular configuraciones de facturación nuevas a cuentas de pagos existentes o a las que se crearon al mismo tiempo.
Usa una cuenta de pagos existente
Para vincular 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 obtener una lista de las cuentas de pago disponibles con el
método PaymentsAccountService.ListPaymentsAccounts
. El PaymentsAccounts
que se muestra depende 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 nueva cuenta de pagos
Para vincular con una nueva cuenta de pagos, 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, también 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, 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
está en un 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 no se aprobó 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, para recuperar un BillingSetup
, se debe consultar GoogleAdsService.SearchStream
con una consulta del lenguaje de consulta de Google Ads que especifique 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.
Cancela 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 es APPROVED
para comenzar en algún momento en el futuro.