Une configuration de facturation est un lien au niveau du compte entre un compte Google Ads et un compte de paiement (également appelé configuration de facture). Elle détermine qui est facturé pour les coûts engendrés par les budgets du 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 est facturé pour les coûts engendrés par ses budgets de compte. Ce compte de paiement est associé à un profil de paiement qui est en dernier ressort responsable des frais.
Les configurations de la facturation contiennent à la fois un champ payments_account et un groupe de champs payments_account_info qui identifient le compte de paiement utilisé, y compris les suivants :
payments_account_info.payments_account_id: ID à 16 chiffres utilisé pour identifier le compte de paiement associé à la configuration de la facturation.payments_account_info.payments_account_name: nom du compte de paiement associé à la configuration de la facturation. Ce nom figure sur les factures mensuelles.payments_account_info.payments_profile_id: ID à 12 chiffres utilisé pour identifier le profil de paiement associé à la configuration de la 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 configurant leur facturation pour qu'elle utilise 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 à des comptes créés en même temps.
Utiliser un compte Paiements existant
Pour l'associer à un compte de paiement existant, définissez payments_account sur l'ID de ressource d'un compte de paiement valide. Cependant, ne modifiez pas payments_account_info.
Vous pouvez lister les comptes de paiement disponibles avec la méthode PaymentsAccountService.ListPaymentsAccounts. Les PaymentsAccounts renvoyés dépendent du compte administrateur que vous utilisez pour l'authentification.
Pour chaque PaymentsAccount, l'ID de son gestionnaire de compte payant se trouve dans le champ paying_manager_customer.
Utiliser un nouveau compte de paiement
Pour l'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 Payments portant le nom 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 c'est la première configuration de facturation ajoutée à un compte Google Ads, le client sera effectivement 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 dans l'état PENDING.
Un BillingSetup peut être associé à l'un des status suivants :
| État de la configuration de la facturation | Description |
|---|---|
PENDING |
En attente d'approbation |
APPROVED_HELD |
Approuvé, mais pas le premier budget correspondant. Cela ne peut se produire que pour les configurations de facturation définies pour 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 la 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.SearchStream à l'aide d'une requête du langage de requête Google Ads qui spécifie les champs à renvoyer.
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 Budget du compte.
Annuler une configuration de facturation en attente
Une BillingSetup qui n'a pas encore pris effet peut être annulée à l'aide de l'opération de suppression. Vous ne pouvez annuler une configuration de facturation que si son status est PENDING ou si elle est APPROVED pour commencer ultérieurement.