Une configuration de facturation est une association au niveau du compte entre un compte Google Ads et un compte de paiement (également appelée configuration de facture). Elle détermine qui est facturé pour les coûts générés par les budgets de compte de la configuration de facturation. Chaque compte de paiement correspond à une seule facture.
À propos des comptes de paiement
Chaque BillingSetup identifie un compte de paiement qui reçoit une facture pour les frais générés par les budgets de son compte. Ce compte de paiement est associé à un profil de paiement qui est responsable des frais.
Les configurations de facturation contiennent un champ payments_account et un groupe de champs payments_account_info qui identifient le compte de paiement utilisé, y compris les éléments suivants :
payments_account_info.payments_account_id: ID à 16 chiffres formaté sous forme de chaîne avec trait d'union (par exemple,"1234-5678-9012-3456") permettant d'identifier le compte de paiement associé à la configuration de facturation.payments_account_info.payments_account_name: nom du compte de paiement associé à la configuration de facturation. Ce nom figure sur les factures mensuelles.payments_account_info.payments_profile_id: ID à 12 chiffres au format d'une chaîne avec trait d'union (par exemple,"1234-5678-9012") permettant d'identifier le profil de paiement associé à la configuration de facturation.
Si un compte de paiement est éligible à la facturation consolidée, plusieurs comptes Google Ads peuvent être regroupés sur la même facture en définissant leurs configurations de facturation de sorte qu'ils utilisent le même compte de paiement sous-jacent.
Créer des configurations de facturation
Vous pouvez associer de nouvelles configurations de facturation à des comptes de paiement existants ou créés en même temps.
Utiliser un compte de paiement existant
Pour l'associer à un compte de paiement existant, définissez payments_account sur le nom de ressource d'un compte de paiement valide (par exemple, customers/{customer_id}/paymentsAccounts/{payments_account_id}). Toutefois, ne modifiez pas payments_account_info.
Vous pouvez lister les comptes de paiement disponibles à l'aide de la méthode PaymentsAccountService.ListPaymentsAccounts.
Les objets PaymentsAccount renvoyés dépendent du compte administrateur que vous utilisez pour l'authentification.
Pour chaque PaymentsAccount, le nom de ressource de son administrateur payeur se trouve dans le champ paying_manager_customer.
Utiliser un nouveau compte de paiement
Pour associer un nouveau compte de paiement, définissez les champs suivants dans payments_account_info (ne définissez pas payments_account) :
L'exemple suivant montre comment créer une configuration de facturation à partir d'un ID de profil de paiement existant. Comme indiqué précédemment, cela crée également un compte de paiement nommé 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);
}
S'il s'agit de la première configuration de facturation ajoutée à un compte Google Ads, le client sera inscrit à la facturation à l'aide du profil de paiement référencé.
État de la configuration de la facturation
Les nouvelles instances BillingSetup doivent être approuvées avant d'être appliquées. En attendant, leur status est à l'état PENDING.
Un BillingSetup peut avoir l'une des valeurs status suivantes :
BillingSetupStatus |
Description |
|---|---|
PENDING |
En attente d'approbation |
APPROVED_HELD |
Approuvé, mais le premier budget correspondant n'a pas été approuvé. Cela ne peut se produire que pour les configurations de facturation définies sur la facturation mensuelle. |
APPROVED |
La configuration a été approuvée. |
CANCELLED |
La configuration a été annulée par l'utilisateur avant l'approbation. |
Récupérer la configuration de facturation d'un compte
Comme la plupart des autres entités de l'API Google Ads, un BillingSetup est récupéré en interrogeant GoogleAdsService.Search ou GoogleAdsService.SearchStream à l'aide d'une requête en langage de requête Google Ads (GAQL) qui spécifie les champs à renvoyer :
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
Une fois que vous avez obtenu une référence à un BillingSetup, vous pouvez l'utiliser pour créer un AccountBudgetProposal, comme décrit dans Budgets de compte.
Annuler une configuration de facturation en attente
Une BillingSetup qui n'a pas encore pris effet peut être annulée en envoyant une BillingSetupOperation avec son champ remove défini sur le nom de ressource de la configuration de facturation (customers/{customer_id}/billingSetups/{billing_setup_id}). Les configurations de facturation ne peuvent être annulées que si leur status est PENDING ou si elles sont APPROVED pour démarrer à un moment donné dans le futur.