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 pagos (también conocida como configuración de facturas), que determina de manera efectiva a quién se le facturan los costos en los que incurren 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
que se factura por los costos en los que incurren sus presupuestos de la cuenta. Esta cuenta de pagos está asociada a 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 la cuenta de pagos en uso, incluidos los siguientes:
payments_account_info.payments_account_id: Es un ID de 16 dígitos con formato de cadena con guiones (por ejemplo,"1234-5678-9012-3456") 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 con formato de cadena con guiones (por ejemplo,"1234-5678-9012") 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 establece que sus configuraciones de facturación usen la misma cuenta de pagos subyacente.
Cómo crear nuevas configuraciones de facturación
Puedes vincular configuraciones de facturación nuevas a cuentas de pagos existentes o creadas al mismo tiempo.
Usa una cuenta de pagos existente
Para vincular con una cuenta de pagos existente, establece
payments_account en el nombre del recurso de una cuenta de pagos
válida (por ejemplo,
customers/{customer_id}/paymentsAccounts/{payments_account_id}). Sin embargo,
no modifiques payments_account_info.
Puedes enumerar las cuentas de pagos disponibles con el método PaymentsAccountService.ListPaymentsAccounts.
Los objetos PaymentsAccount que se devuelven dependen de la cuenta de administrador que uses para la autenticación.
Para cada PaymentsAccount, el nombre del recurso de su administrador de pagos se encuentra en el campo paying_manager_customer.
Usa una cuenta de pagos nueva
Para vincular con 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ó antes, esto también crea una nueva cuenta de pagos
con el nombre My New Payments Account.
BillingSetup billingSetup =
BillingSetup.newBuilder()
.setPaymentsAccountInfo(
PaymentsAccountInfo.newBuilder()
.setPaymentsAccountName("My New Payments Account")
.setPaymentsProfileId("1234-5678-9012")
.build())
.setStartTimeType(TimeTypeEnum.TimeType.NOW)
.build();
BillingSetupOperation operation =
BillingSetupOperation.newBuilder().setCreate(billingSetup).build();
try (BillingSetupServiceClient billingSetupServiceClient =
googleAdsClient.getBillingSetupServiceClient()) {
MutateBillingSetupResponse response =
billingSetupServiceClient.mutateBillingSetup(
Long.toString(customerId), operation);
}
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 tener uno de los siguientes valores de status:
BillingSetupStatus |
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 establecidas 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 de la API de Google Ads, se recupera un BillingSetup consultando GoogleAdsService.Search o GoogleAdsService.SearchStream con una consulta de lenguaje de consulta de Google Ads (GAQL) que especifica qué campos se deben devolver:
SELECT
billing_setup.resource_name,
billing_setup.id,
billing_setup.status,
billing_setup.payments_account,
billing_setup.payments_account_info.payments_account_id,
billing_setup.payments_account_info.payments_account_name,
billing_setup.payments_account_info.payments_profile_id,
billing_setup.payments_account_info.payments_profile_name,
billing_setup.start_date_time,
billing_setup.end_date_time,
billing_setup.end_time_type
FROM billing_setup
Una vez que obtengas una referencia a un BillingSetup, podrás usarla para crear un AccountBudgetProposal, como se describe en Presupuestos de la cuenta.
Cómo cancelar una configuración de facturación pendiente
Un BillingSetup que aún no haya entrado en vigencia se puede cancelar enviando un BillingSetupOperation con su campo remove establecido en el nombre del recurso de la configuración de facturación (customers/{customer_id}/billingSetups/{billing_setup_id}). 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.