Eine Abrechnungseinrichtung ist eine Verknüpfung auf Kontoebene zwischen einem Google Ads-Konto und einem Zahlungskonto (auch Rechnungseinrichtung genannt). Damit wird festgelegt, wem die durch die Kontobudgets der Abrechnungseinrichtung entstehenden Kosten in Rechnung gestellt werden. Jedes Zahlungskonto entspricht einer einzelnen Rechnung.
Zahlungskonten
Jede BillingSetup identifiziert ein Zahlungskonto, dem die Kosten aus den zugehörigen Kontobudgets in Rechnung gestellt werden. Dieses Zahlungskonto ist mit einem Zahlungsprofil verknüpft, das letztlich für die Kosten verantwortlich ist.
Abrechnungseinrichtungen enthalten sowohl das Feld payments_account als auch eine Gruppe von payments_account_info-Feldern, die angeben, ob das Zahlungskonto gerade verwendet wird. Dazu gehören:
payments_account_info.payments_account_id: Eine 16-stellige ID, mit der das mit der Abrechnungseinrichtung verknüpfte Zahlungskonto identifiziert wird.payments_account_info.payments_account_name: Der Name des Zahlungskontos, das mit der Abrechnungseinrichtung verknüpft ist. Dieser Name steht auf den monatlichen Rechnungen.payments_account_info.payments_profile_id: Eine 12-stellige ID, mit der das mit der Abrechnungseinrichtung verknüpfte Zahlungsprofil identifiziert wird.
Wenn ein Zahlungskonto die Voraussetzungen für die konsolidierte Abrechnung erfüllt, können mehrere Google Ads-Konten in derselben Rechnung zusammengefasst werden. Dazu muss in den Abrechnungseinrichtungen dasselbe zugrunde liegende Zahlungskonto verwendet werden.
Neue Abrechnungseinrichtungen erstellen
Sie können neue Abrechnungseinrichtungen mit vorhandenen Payments-Konten verknüpfen oder mit Konten, die gleichzeitig erstellt wurden.
Vorhandenes Zahlungskonto verwenden
Wenn Sie eine Verknüpfung mit einem vorhandenen Zahlungskonto erstellen möchten, legen Sie payments_account auf die Ressourcen-ID eines gültigen Zahlungskontos fest. Ändern Sie payments_account_info jedoch nicht.
Sie können verfügbare Zahlungskonten mit der Methode PaymentsAccountService.ListPaymentsAccounts auflisten. Welche PaymentsAccounts zurückgegeben werden, hängt vom Verwaltungskonto ab, das Sie für die Authentifizierung verwenden.
Für jedes PaymentsAccount befindet sich die ID des zugehörigen Zahlungsverwaltungskontos im Feld paying_manager_customer.
Neues Zahlungskonto verwenden
Legen Sie für eine Verknüpfung mit einem neuen Zahlungskonto die folgenden Felder in payments_account_info fest (nicht legen Sie payments_account fest):
Im folgenden Beispiel wird gezeigt, wie Sie anhand einer vorhandenen Zahlungsprofil-ID eine neue Abrechnungseinrichtung erstellen. Wie oben angegeben, wird dadurch auch ein neues Zahlungskonto mit dem Namen My New Payments Account erstellt.
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);
}
Wenn dies die erste Abrechnungseinrichtung ist, die einem Google Ads-Konto hinzugefügt wird, wird der Kunde dadurch für die Abrechnung mit dem entsprechenden Zahlungsprofil angemeldet.
Status der Abrechnungseinrichtung
Neue BillingSetup-Instanzen müssen genehmigt werden, bevor sie wirksam werden. Bis dahin hat das status den Status PENDING.
Ein BillingSetup kann in einem der folgenden status enthalten sein:
| Status der Abrechnungseinrichtung | Beschreibung |
|---|---|
PENDING |
Genehmigung ausstehend. |
APPROVED_HELD |
Genehmigt, aber das entsprechende erste Budget nicht. Das ist nur bei Abrechnungseinrichtungen möglich, die mit monatlicher Rechnungsstellung konfiguriert sind. |
APPROVED |
Einrichtung wurde genehmigt. |
CANCELLED |
Die Einrichtung wurde vor der Genehmigung vom Nutzer abgebrochen. |
Abrechnungseinrichtung eines Kontos abrufen
Wie die meisten anderen Entitäten in der Google Ads API wird ein BillingSetup durch Abfrage des GoogleAdsService.SearchStream abgerufen. Dazu wird eine Google Ads Query Language-Abfrage verwendet, die angibt, welche Felder zurückgegeben werden sollen.
Nachdem du einen Verweis auf einen BillingSetup erhalten hast, kannst du damit einen AccountBudgetProposal erstellen, wie unter Kontobudget beschrieben.
Ausstehende Abrechnungseinrichtung abbrechen
Ein BillingSetup, der noch nicht wirksam ist, kann mit dem Entfernen-Vorgang abgebrochen werden. Abrechnungseinrichtungen können nur abgebrochen werden, wenn ihre status den Wert PENDING haben oder wenn APPROVED ein Startdatum in der Zukunft ist.