Method: customers.invoices.list

Gibt alle Rechnungen für einen bestimmten Monat zurück, die mit einer Abrechnungseinrichtung verknüpft sind.

Liste der ausgelösten Fehler: AuthenticationError AuthorizationError FieldError HeaderError InternalError InvoiceError QuotaError RequestError

HTTP-Anfrage

GET https://googleads.googleapis.com/v16/customers/{customerId}/invoices

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameters
customerId

string

Erforderlich. Die ID des Kunden, für den Rechnungen abgerufen werden sollen.

Abfrageparameter

Parameters
billingSetup

string

Erforderlich. Der Ressourcenname der Abrechnungseinrichtung der angeforderten Rechnungen.

customers/{customerId}/billingSetups/{billing_setup_id}
issueYear

string

Erforderlich. Das Ausstellungsjahr für das Abrufen von Rechnungen im Format yyyy. Es können nur Rechnungen abgerufen werden, die im Jahr 2019 oder später ausgestellt wurden.
issueMonth

enum (MonthOfYear)

Erforderlich. Der Ausstellungsmonat, in dem Rechnungen abgerufen werden sollen.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Antwortnachricht für InvoiceService.ListInvoices.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "invoices": [
    {
      object (Invoice)
    }
  ]
}
Felder
invoices[]

object (Invoice)

Die Liste der Rechnungen, die der Abrechnungseinrichtung und dem Zeitraum entsprechen.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/adwords

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

Rechnung

Eine Rechnung. Sämtliche Rechnungsinformationen werden anhand einer Zusammenfassung mit der PDF-Rechnung erstellt. Bei Rechnungen, die älter sind als die Einführung von InvoiceService, stimmen die Momentaufnahmen möglicherweise nicht mit der PDF-Rechnung überein.

JSON-Darstellung 
{
  "resourceName": string,
  "type": enum (InvoiceType),
  "serviceDateRange": {
    object (DateRange)
  },
  "adjustmentsSubtotalAmountMicros": string,
  "adjustmentsTaxAmountMicros": string,
  "adjustmentsTotalAmountMicros": string,
  "regulatoryCostsSubtotalAmountMicros": string,
  "regulatoryCostsTaxAmountMicros": string,
  "regulatoryCostsTotalAmountMicros": string,
  "replacedInvoices": [
    string
  ],
  "accountBudgetSummaries": [
    {
      object (AccountBudgetSummary)
    }
  ],
  "accountSummaries": [
    {
      object (AccountSummary)
    }
  ],
  "id": string,
  "billingSetup": string,
  "paymentsAccountId": string,
  "paymentsProfileId": string,
  "issueDate": string,
  "dueDate": string,
  "currencyCode": string,
  "exportChargeSubtotalAmountMicros": string,
  "exportChargeTaxAmountMicros": string,
  "exportChargeTotalAmountMicros": string,
  "subtotalAmountMicros": string,
  "taxAmountMicros": string,
  "totalAmountMicros": string,
  "correctedInvoice": string,
  "pdfUrl": string
}
Felder
resourceName

string

Nur Ausgabe Der Ressourcenname der Rechnung. Eine Rechnung kann von mehreren Kunden gemeinsam genutzt werden. Daher können mehrere Ressourcennamen auf dieselbe Rechnung verweisen. Namen von Rechnungsressourcen haben das folgende Format:

customers/{customerId}/invoices/{invoice_id}
type

enum (InvoiceType)

Nur Ausgabe Die Art der Rechnung.
serviceDateRange

object (DateRange)

Nur Ausgabe Der Zeitraum des Servicezeitraums dieser Rechnung. Das Enddatum ist eingeschlossen.
adjustmentsSubtotalAmountMicros

string (int64 format)

Nur Ausgabe Die Zwischensumme vor Steuern der Korrekturen auf Rechnungsebene in Mikroeinheiten.
adjustmentsTaxAmountMicros

string (int64 format)

Nur Ausgabe Die Summe der Steuern auf den Korrekturen auf Rechnungsebene in Mikros.
adjustmentsTotalAmountMicros

string (int64 format)

Nur Ausgabe Der Gesamtbetrag der Korrekturen auf Rechnungsebene in Mikroeinheiten.
regulatoryCostsSubtotalAmountMicros

string (int64 format)

Nur Ausgabe Die Zwischensumme vor Steuern der regulatorischen Kosten auf Rechnungsebene in Mikros.
regulatoryCostsTaxAmountMicros

string (int64 format)

Nur Ausgabe Die Summe der Steuern auf regulatorische Kosten auf Rechnungsebene in Mikros.
regulatoryCostsTotalAmountMicros

string (int64 format)

Nur Ausgabe Der Gesamtbetrag der regulatorischen Kosten auf Rechnungsebene in Mikros.
replacedInvoices[]

string

Nur Ausgabe Der Ressourcenname der ursprünglichen Rechnung(en), die neu in Rechnung gestellt oder durch diese Rechnung ersetzt wird (falls zutreffend). Aufgrund der Konsolidierung von Rechnungen werden möglicherweise mehrere Rechnungen ersetzt. Die ersetzten Rechnungen gehören möglicherweise nicht zu demselben Zahlungskonto. Wenn replacedInvoices festgelegt ist, wird correctedInvoice nicht festgelegt. Namen von Rechnungsressourcen haben das folgende Format:

customers/{customerId}/invoices/{invoice_id}
accountBudgetSummaries[]

object (AccountBudgetSummary)

Nur Ausgabe Die Liste der zusammengefassten Informationen zum Kontobudget, die dieser Rechnung zugeordnet sind.
accountSummaries[]

object (AccountSummary)

Nur Ausgabe Die Liste der zusammengefassten Kontoinformationen für diese Rechnung.
id

string

Nur Ausgabe Die ID der Rechnung. Sie wird auf der PDF-Rechnung als „Rechnungsnummer“ angegeben.
billingSetup

string

Nur Ausgabe Der Ressourcenname der Abrechnungseinrichtung dieser Rechnung.

customers/{customerId}/billingSetups/{billing_setup_id}
paymentsAccountId

string

Nur Ausgabe Eine 16-stellige ID zur Identifizierung des mit der Abrechnungseinrichtung verknüpften Zahlungskontos, z. B. „1234-5678-9012-3456“. Sie wird auf der PDF-Rechnung als „Rechnungskontonummer“ angegeben.
paymentsProfileId

string

Nur Ausgabe Eine 12-stellige ID zur Identifizierung des mit der Abrechnungseinrichtung verknüpften Zahlungsprofils, z. B. „1234-5678-9012“. Sie wird auf der PDF-Rechnung als „Abrechnungs-ID“ angegeben.
issueDate

string

Nur Ausgabe Ausstellungsdatum im Format JJJJ-MM-TT. Es wird auf der PDF-Rechnung als „Ausstellungsdatum“ oder „Rechnungsdatum“ angegeben.
dueDate

string

Nur Ausgabe Das Fälligkeitsdatum im Format JJJJ-MM-TT.
currencyCode

string

Nur Ausgabe Der Währungscode. Alle Kosten werden in dieser Währung zurückgegeben. Ein Teil der Währungscodes, der aus der Norm ISO 4217 abgeleitet wurde, wird unterstützt.
exportChargeSubtotalAmountMicros

string (int64 format)

Nur Ausgabe Die Zwischensumme vor Steuern der Exportgebühren auf Rechnungsebene in Mikros.
exportChargeTaxAmountMicros

string (int64 format)

Nur Ausgabe Die Summe der Steuern auf den Exportgebühren auf Rechnungsebene in Mikros.
exportChargeTotalAmountMicros

string (int64 format)

Nur Ausgabe Der Gesamtbetrag der Exportgebühren auf Rechnungsebene in Mikros.
subtotalAmountMicros

string (int64 format)

Nur Ausgabe Der Zwischensummenbetrag vor Steuern in Mikros. Dies entspricht der Summe der Zwischensummen der Kontobudget-Zusammenfassung und der Invoice.Adjustments_subtotal_amount_micros.
taxAmountMicros

string (int64 format)

Nur Ausgabe Die Summe aller Steuern auf der Rechnung in Mikroeinheiten. Dies entspricht der Summe der Steuerbeträge „AccountBudgetSummary“ zuzüglich der Steuern, die nicht mit einem bestimmten Kontobudget verknüpft sind.
totalAmountMicros

string (int64 format)

Nur Ausgabe Die Gesamtsumme in Mikroeinheiten. Dies entspricht der Summe aus „Invoice.subtotal_amount_micros“, „Invoice.tax_amount_micros“, „Invoice.regulatory_costs_subtotal_amount_micros“ und „Invoice.export_charge_subtotal_amount_micros“. Diese wird ab Version 14.1 in eine separate Position unterteilt.
correctedInvoice

string

Nur Ausgabe Der Ressourcenname der ursprünglichen Rechnung, die gegebenenfalls durch diese Rechnung korrigiert, ausgebucht oder storniert wurde. Wenn correctedInvoice festgelegt ist, wird replacedInvoices nicht festgelegt. Namen von Rechnungsressourcen haben das folgende Format:

customers/{customerId}/invoices/{invoice_id}
pdfUrl

string

Nur Ausgabe Die URL zu einer PDF-Kopie der Rechnung. Nutzer müssen ihr OAuth-Token übergeben, um die PDF-Datei mit dieser URL anzufordern.

InvoiceType

Der mögliche Rechnungstyp.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Wird nur für den Rückgabewert verwendet. Stellt einen unbekannten Wert in dieser Version dar.
CREDIT_MEMO Eine Rechnung mit einem negativen Betrag Das Konto erhält eine Gutschrift.
INVOICE Eine Rechnung mit einem positiven Betrag Auf dem Konto ist ein Saldo zu entrichten.

AccountBudgetSummary

Zusammengefasste abrechenbare Kosten für das Kontobudget.

JSON-Darstellung 
{
  "billableActivityDateRange": {
    object (DateRange)
  },
  "invalidActivitySummaries": [
    {
      object (InvalidActivitySummary)
    }
  ],
  "customer": string,
  "customerDescriptiveName": string,
  "accountBudget": string,
  "accountBudgetName": string,
  "purchaseOrderNumber": string,
  "subtotalAmountMicros": string,
  "taxAmountMicros": string,
  "totalAmountMicros": string,
  "servedAmountMicros": string,
  "billedAmountMicros": string,
  "overdeliveryAmountMicros": string,
  "invalidActivityAmountMicros": string
}
Felder
billableActivityDateRange

object (DateRange)

Nur Ausgabe Der Zeitraum für die abrechenbare Aktivität des Kontobudgets innerhalb des Bereitstellungszeitraums dieser Rechnung. Das Enddatum ist eingeschlossen. Dieser Wert kann vom Beginn und Ende des Kontobudgets abweichen.
invalidActivitySummaries[]

object (InvalidActivitySummary)

Nur Ausgabe Liste der zusammengefassten Gutschriften für ungültige Aktivitäten mit ursprünglichen Verknüpfungen
customer

string

Nur Ausgabe Der Ressourcenname des Kunden, der diesem Kontobudget zugeordnet ist. Sie enthält die Kundennummer, die auf der PDF-Rechnung als „Account ID“ aufgeführt ist. Ressourcennamen von Kunden haben das folgende Format:

customers/{customerId}
customerDescriptiveName

string

Nur Ausgabe Der beschreibende Name des Kunden für das Kontobudget. Sie erscheint auf der PDF-Rechnung als „Konto“.
accountBudget

string

Nur Ausgabe Der Ressourcenname des Kontobudgets, das diesen zusammengefassten abrechenbaren Kosten zugeordnet ist. Ressourcennamen vom Typ „AccountBudget“ haben das folgende Format:

customers/{customerId}/accountBudgets/{account_budget_id}
accountBudgetName

string

Nur Ausgabe Der Name des Kontobudgets. auf der PDF-Rechnung als „Kontobudget“ angegeben.
purchaseOrderNumber

string

Nur Ausgabe Die Auftragsnummer des Kontobudgets. Sie finden sie auf der PDF-Rechnung als „Auftrag“.
subtotalAmountMicros

string (int64 format)

Nur Ausgabe Der Zwischensummenbetrag vor Steuern, der auf dieses Budget während des Servicezeitraums zurückzuführen ist, in Mikroeinheiten.
taxAmountMicros

string (int64 format)

Nur Ausgabe Der Steuerbetrag, der während des Servicezeitraums auf dieses Budget zu zahlen ist, in Mikroeinheiten.
totalAmountMicros

string (int64 format)

Nur Ausgabe Der Gesamtbetrag, der diesem Budget während des Servicezeitraums zuzuschreiben ist, in Mikroeinheiten. Dies ist die Summe aus dem Zwischenbetrag des Kontobudgets und dem Steuerbetrag für das Kontobudget.
servedAmountMicros

string (int64 format)

Nur Ausgabe Der Betrag vor Steuern, der auf dieses Budget während des Servicezeitraums zurückzuführen ist, in Mikroeinheiten. Dies ist nur nützlich, um Rechnungs- und Lieferdaten abzugleichen.
billedAmountMicros

string (int64 format)

Nur Ausgabe Der in Rechnung gestellte Betrag vor Steuern, der diesem Budget während des Servicezeitraums zuzurechnen ist, in Mikroeinheiten. Hier werden keine Anpassungen berücksichtigt.
overdeliveryAmountMicros

string (int64 format)

Nur Ausgabe Der Betrag der Mehrauslieferung vor Steuern, der auf dieses Budget während des Servicezeitraums zurückzuführen ist, in Mikroeinheiten (negativer Wert).
invalidActivityAmountMicros

string (int64 format)

Nur Ausgabe Der Betrag der ungültigen Aktivitäten vor Steuern, der diesem Budget in den vergangenen Monaten zugeschrieben wurde, in Mikroeinheiten (negativer Wert).

InvalidActivitySummary

Details zu ungültigen Aktivitäten für die Rechnung, die zusätzliche Details zur Rechnung enthalten, anhand der Korrekturen vorgenommen werden.

JSON-Darstellung 
{
  "originalMonthOfService": enum (MonthOfYear),
  "originalYearOfService": string,
  "originalInvoiceId": string,
  "originalAccountBudgetName": string,
  "originalPurchaseOrderNumber": string,
  "amountMicros": string
}
Felder
originalMonthOfService

enum (MonthOfYear)

Nur Ausgabe Ursprünglicher Dienstmonat, in dem diese Gutschrift für ungültige Aktivitäten verwendet wurde.
originalYearOfService

string

Nur Ausgabe Ursprüngliches Jahr, in dem der Dienst im Zusammenhang mit dieser Gutschrift für ungültige Aktivitäten genutzt wurde.
originalInvoiceId

string

Nur Ausgabe Ursprüngliche Rechnungsnummer für diese Gutschrift für ungültige Aktivitäten.
originalAccountBudgetName

string

Nur Ausgabe Der ursprüngliche Name des Kontobudgets, auf das sich diese Gutschrift für ungültige Aktivitäten bezieht.
originalPurchaseOrderNumber

string

Nur Ausgabe Ursprüngliche Auftragsnummer, die mit dieser Gutschrift für ungültige Aktivitäten in Zusammenhang steht.
amountMicros

string (int64 format)

Nur Ausgabe Unzulässige Aktivität in Mikroeinheiten.

AccountSummary

Eine zusammengefasste Ansicht auf Kontoebene

JSON-Darstellung 
{
  "customer": string,
  "billingCorrectionSubtotalAmountMicros": string,
  "billingCorrectionTaxAmountMicros": string,
  "billingCorrectionTotalAmountMicros": string,
  "couponAdjustmentSubtotalAmountMicros": string,
  "couponAdjustmentTaxAmountMicros": string,
  "couponAdjustmentTotalAmountMicros": string,
  "excessCreditAdjustmentSubtotalAmountMicros": string,
  "excessCreditAdjustmentTaxAmountMicros": string,
  "excessCreditAdjustmentTotalAmountMicros": string,
  "regulatoryCostsSubtotalAmountMicros": string,
  "regulatoryCostsTaxAmountMicros": string,
  "regulatoryCostsTotalAmountMicros": string,
  "exportChargeSubtotalAmountMicros": string,
  "exportChargeTaxAmountMicros": string,
  "exportChargeTotalAmountMicros": string,
  "subtotalAmountMicros": string,
  "taxAmountMicros": string,
  "totalAmountMicros": string
}
Felder
customer

string

Nur Ausgabe Das mit der Kontoübersicht verknüpfte Konto.
billingCorrectionSubtotalAmountMicros

string (int64 format)

Nur Ausgabe Zwischensumme der Rechnungskorrektur vor Steuern in Mikros.
billingCorrectionTaxAmountMicros

string (int64 format)

Nur Ausgabe Steuer auf Rechnungskorrektur in Mikroeinheiten.
billingCorrectionTotalAmountMicros

string (int64 format)

Nur Ausgabe Gesamtbetrag der Rechnungskorrektur in Mikros.
couponAdjustmentSubtotalAmountMicros

string (int64 format)

Nur Ausgabe Zwischensumme des Gutscheins für die Anpassung vor Steuern in Mikros.
couponAdjustmentTaxAmountMicros

string (int64 format)

Nur Ausgabe Steuer auf Gutscheinkorrektur, in Mikroeinheiten.
couponAdjustmentTotalAmountMicros

string (int64 format)

Nur Ausgabe Gesamtbetrag der Gutscheinanpassung in Mikros.
excessCreditAdjustmentSubtotalAmountMicros

string (int64 format)

Nur Ausgabe Zwischensumme des Überschreitungsbetrags der Gutschriftkorrektur vor Steuern in Mikros.
excessCreditAdjustmentTaxAmountMicros

string (int64 format)

Nur Ausgabe Steuern auf überschüssige Gutschriftkorrektur in Mikroeinheiten.
excessCreditAdjustmentTotalAmountMicros

string (int64 format)

Nur Ausgabe Gesamtbetrag der überschüssigen Gutschriftkorrektur in Mikros.
regulatoryCostsSubtotalAmountMicros

string (int64 format)

Nur Ausgabe Zwischensumme der Zwischensumme der regulatorischen Kosten vor Steuern in Mikros.
regulatoryCostsTaxAmountMicros

string (int64 format)

Nur Ausgabe Steuer auf regulatorische Kosten in Mikroeinheiten.
regulatoryCostsTotalAmountMicros

string (int64 format)

Nur Ausgabe Gesamtbetrag der regulatorischen Kosten in Mikros.
exportChargeSubtotalAmountMicros

string (int64 format)

Nur Ausgabe Zwischensumme der Exportgebühr vor Steuern in Mikros.
exportChargeTaxAmountMicros

string (int64 format)

Nur Ausgabe Steuer auf die Ausfuhrabgabe in Mikros.
exportChargeTotalAmountMicros

string (int64 format)

Nur Ausgabe Gesamtsumme der Exportgebühr in Mikros.
subtotalAmountMicros

string (int64 format)

Nur Ausgabe Der gesamte Zwischenbetrag vor Steuern, der dem Konto während des Servicezeitraums zuzuschreiben ist, in Mikroeinheiten.
taxAmountMicros

string (int64 format)

Nur Ausgabe Der gesamte Steuerbetrag, der dem Konto während des Servicezeitraums zuzuschreiben ist, in Mikroeinheiten.
totalAmountMicros

string (int64 format)

Nur Ausgabe Der dem Konto während des Servicezeitraums zuzuordnende Gesamtbetrag in Mikrosekunden. Dies entspricht der Summe der subtotalAmountMicros und „taxAmountMicros“.