Configuration de la facturation

Une configuration de la 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 générés par les budgets du compte de la configuration de la 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 générés par les budgets de son compte. Ce compte de paiement est associé à un profil de paiement qui est en fin de compte responsable des frais.

Les configurations de facturation contiennent à la fois un payments_account champ et un groupe de payments_account_info champs 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 est imprimé 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, alors plusieurs comptes Google Ads peuvent être regroupés sur la même facture en configurant leurs configurations de facturation pour qu'elles 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 à des comptes créés en même temps.

Utiliser un compte de paiement existant

Pour associer un compte de paiement existant, définissez payments_account sur l' ID de ressource d'un compte de paiement valide. Toutefois, ne modifiez pas payments_account_info.

Vous pouvez lister les comptes de paiement disponibles à l'aide de la PaymentsAccountService.ListPaymentsAccounts méthode. Les PaymentsAccounts renvoyés dépendent du compte administrateur que vous utilisez pour l'authentification.

Pour chaque PaymentsAccount, l'ID de son administrateur des paiements se trouve dans le paying_manager_customer champ.

Utiliser un 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) :

• payments_account_name
• payments_profile_id

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 avec 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);
}

S'il s'agit de 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 facturation

Les nouvelles BillingSetup instances doivent être approuvées avant d'être appliquées. Jusque-là, leur status est dans un PENDING état.

Un BillingSetup peut avoir l'un des status suivants :

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 le 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 été appliquée peut être annulée à l'aide de l'opération de suppression. Les configurations de facturation ne peuvent être annulées que si leur status est PENDING ou si elles sont APPROVED pour démarrer à une date ultérieure.