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:
payments_account_info.payments_account_id: Es un ID de 16 dígitos que se usa para identificar la cuenta de Payments asociada a la configuración de facturación.payments_account_info.payments_account_name: Es el nombre de la cuenta de Payments 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 Payments asociado a la configuración de facturación.
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.