Abrechnungseinstellungen

Eine Abrechnungseinrichtung ist eine Verknüpfung auf Kontoebene zwischen einem Google Ads-Konto und einem Zahlungskonto (auch als Rechnungseinrichtung bezeichnet). Sie bestimmt, wer für die Kosten aufkommt, die durch die Kontobudgets der Abrechnungseinrichtung entstehen. Jedes Zahlungskonto entspricht einer einzelnen Rechnung.

Zahlungskonten

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

Abrechnungseinrichtungen enthalten sowohl ein payments_account-Feld als auch eine Gruppe von payments_account_info-Feldern, die das verwendete Zahlungskonto identifizieren, darunter:

  • payments_account_info.payments_account_id: Eine 16-stellige ID, die als String mit Bindestrichen formatiert ist (z. B. "1234-5678-9012-3456") und zur Identifizierung des mit der Abrechnungseinrichtung verknüpften Zahlungskontos verwendet wird.
  • payments_account_info.payments_account_name: Der Name des Zahlungskontos, das mit der Abrechnungseinrichtung verknüpft ist. Dieser Name wird auf monatlichen Rechnungen gedruckt.
  • payments_account_info.payments_profile_id: Eine 12-stellige ID, die als String mit Bindestrichen formatiert ist (z. B. "1234-5678-9012") und zur Identifizierung des mit der Abrechnungseinrichtung verknüpften Zahlungsprofils verwendet wird.

Wenn ein Zahlungskonto für die konsolidierte Abrechnung infrage kommt, können mehrere Google Ads-Konten in derselben Rechnung zusammengefasst werden. Dazu müssen die Abrechnungseinrichtungen so konfiguriert werden, dass sie dasselbe zugrunde liegende Zahlungskonto verwenden.

Neue Abrechnungseinrichtungen erstellen

Sie können neue Abrechnungseinrichtungen mit vorhandenen Zahlungskonten oder mit gleichzeitig erstellten Zahlungskonten verknüpfen.

Vorhandenes Zahlungskonto verwenden

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

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

Für jede PaymentsAccount befindet sich der Ressourcenname des Zahlungsmanagers 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):

Im folgenden Beispiel wird gezeigt, wie Sie eine neue Abrechnungseinrichtung aus 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 damit für die Abrechnung über das referenzierte Zahlungsprofil registriert.

Status der Abrechnungseinrichtung

Neue BillingSetup-Instanzen müssen genehmigt werden, bevor sie wirksam werden. Bis dahin hat die status den Status PENDING.

Ein BillingSetup kann einen der folgenden status-Werte haben:

BillingSetupStatus Beschreibung
PENDING Genehmigung ausstehend.
APPROVED_HELD Genehmigt, aber das entsprechende erste Budget wurde nicht genehmigt. Dies kann nur bei Abrechnungseinrichtungen mit monatlicher Rechnungsstellung auftreten.
APPROVED Die Einrichtung wurde genehmigt.
CANCELLED Die Einrichtung wurde vom Nutzer vor der Genehmigung abgebrochen.

Abrechnungseinrichtung eines Kontos abrufen

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

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 abgebrochen werden, wobei das Feld remove auf den Ressourcennamen der Abrechnungseinrichtung (customers/{customer_id}/billingSetups/{billing_setup_id}) festgelegt ist. Abrechnungseinrichtungen können nur abgebrochen werden, wenn ihr status PENDING ist oder wenn sie für einen Start in der Zukunft APPROVED sind.

Zurück
Abrechnungsübersicht
Weiter
Kontobudget