Abrechnungseinstellungen

Eine Abrechnungseinrichtung ist eine Verknüpfung auf Kontoebene zwischen einem Google Ads-Konto und einem Zahlungskonto (auch Rechnungseinrichtung genannt). Sie legt fest, wer für die Kosten in Rechnung gestellt wird, die durch die Kontobudgets der Abrechnungseinrichtung entstehen. Jedes Zahlungskonto entspricht einer einzelnen Rechnung.

Zahlungskonten

Jedes BillingSetup identifiziert ein Zahlungskonto, das für Kosten in Rechnung gestellt wird, die durch die Kontobudgets entstehen. Dieses Zahlungskonto ist mit einem Zahlungsprofil verknüpft, das letztendlich für die Gebühren verantwortlich ist.

Abrechnungseinrichtungen enthalten sowohl ein Feld payments_account als auch eine Gruppe von Feldern payments_account_info, die das verwendete Zahlungskonto identifizieren, einschließlich der folgenden:

• payments_account_info.payments_account_id: Eine 16-stellige ID, die als String mit Bindestrichen formatiert ist (z. B. "1234-5678-9012-3456"). Sie wird verwendet, um das mit der Abrechnungseinrichtung verknüpfte Zahlungskonto zu identifizieren.
• payments_account_info.payments_account_name: Der Name des mit der Abrechnungseinrichtung verknüpften Zahlungskontos. Dieser Name wird auf monatlichen Rechnungen angegeben.
• payments_account_info.payments_profile_id: Eine 12-stellige ID, die als String mit Bindestrichen formatiert ist (z. B. "1234-5678-9012"). Sie wird verwendet, um das Zahlungsprofil zu identifizieren, das mit der Abrechnungseinrichtung verknüpft ist.

Wenn ein Zahlungskonto für die konsolidierte Abrechnung infrage kommt, können mehrere Google Ads-Konten auf derselben Rechnung zusammengefasst werden. Dazu muss in den Abrechnungseinrichtungen das gleiche zugrunde liegende Zahlungskonto verwendet werden.

Neue Abrechnungseinrichtungen erstellen

Sie können neue Abrechnungseinrichtungen mit vorhandenen Zahlungskonten oder mit Konten verknüpfen, die gleichzeitig erstellt wurden.

Vorhandenes Zahlungskonto verwenden

Wenn Sie eine Verknüpfung mit einem bestehenden Zahlungskonto herstellen möchten, legen Sie payments_account auf den Ressourcennamen eines gültigen Zahlungskontos fest (z. B. customers/{customer_id}/paymentsAccounts/{payments_account_id}). Ändern Sie jedoch payments_account_info nicht.

Mit der Methode PaymentsAccountService.ListPaymentsAccounts können Sie verfügbare Zahlungsprofile auflisten. Die zurückgegebenen PaymentsAccount-Objekte hängen vom Verwaltungskonto ab, das Sie für die Authentifizierung verwenden.

Für jedes PaymentsAccount befindet sich der Ressourcenname des Zahlungsverwaltungskontos im Feld paying_manager_customer.

Neues Zahlungskonto verwenden

Wenn Sie eine Verknüpfung mit einem neuen Zahlungskonto herstellen möchten, legen Sie die folgenden Felder in payments_account_info fest (nicht payments_account):

• payments_account_name
• payments_profile_id

Im folgenden Beispiel wird gezeigt, wie Sie eine neue Abrechnungseinrichtung anhand einer vorhandenen Zahlungsprofil-ID erstellen. Wie bereits erwähnt, wird dadurch auch ein neues Zahlungskonto mit dem Namen My New Payments Account erstellt.

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

Wenn dies die erste Abrechnungseinrichtung ist, die einem Google Ads-Konto hinzugefügt wird, wird der Kunde dadurch effektiv für die Abrechnung über das referenzierte Zahlungsprofil registriert.

Status der Abrechnungseinrichtung

Neue BillingSetup-Instanzen müssen genehmigt werden, bevor sie in Kraft treten. Bis dahin befindet sich ihr status im Status PENDING.

Ein BillingSetup kann einen der folgenden status-Werte haben:

Abrechnungseinrichtung eines Kontos abrufen

Wie die meisten anderen Entitäten in der Google Ads API wird eine BillingSetup abgerufen, indem GoogleAdsService.Search oder GoogleAdsService.SearchStream mit einer GAQL-Abfrage (Google Ads Query Language) abgefragt wird, in der die zurückzugebenden Felder angegeben werden:

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

Sobald Sie einen Verweis auf ein BillingSetup haben, können Sie damit ein AccountBudgetProposal erstellen, wie unter Kontobudgets beschrieben.

Ausstehende Abrechnungseinrichtung abbrechen

Eine BillingSetup, die noch nicht in Kraft getreten ist, kann durch Senden einer BillingSetupOperation mit dem Feld remove, das auf den Ressourcennamen der Abrechnungseinrichtung (customers/{customer_id}/billingSetups/{billing_setup_id}) festgelegt ist, storniert werden. Abrechnungseinrichtungen können nur storniert werden, wenn ihr status PENDING ist oder wenn sie APPROVED sind, um irgendwann in der Zukunft zu beginnen.