- HTTP-Anfrage
- Pfadparameter
- Anfrageparameter
- Anfragetext
- Antworttext
- Autorisierungsbereiche
- Rechnung
- InvoiceType
- AccountBudgetSummary
- InvalidActivitySummary
- AccountSummary
- Testen!
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 |
Erforderlich. Die ID des Kunden, für den Rechnungen abgerufen werden sollen. |
Abfrageparameter
Parameters | |
---|---|
billingSetup |
Erforderlich. Der Ressourcenname der Abrechnungseinrichtung der angeforderten Rechnungen.
|
issueYear |
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 |
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 ( |
Felder | |
---|---|
invoices[] |
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 ( |
Felder | |
---|---|
resourceName |
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:
|
type |
Nur Ausgabe Die Art der Rechnung. |
serviceDateRange |
Nur Ausgabe Der Zeitraum des Servicezeitraums dieser Rechnung. Das Enddatum ist eingeschlossen. |
adjustmentsSubtotalAmountMicros |
Nur Ausgabe Die Zwischensumme vor Steuern der Korrekturen auf Rechnungsebene in Mikroeinheiten. |
adjustmentsTaxAmountMicros |
Nur Ausgabe Die Summe der Steuern auf den Korrekturen auf Rechnungsebene in Mikros. |
adjustmentsTotalAmountMicros |
Nur Ausgabe Der Gesamtbetrag der Korrekturen auf Rechnungsebene in Mikroeinheiten. |
regulatoryCostsSubtotalAmountMicros |
Nur Ausgabe Die Zwischensumme vor Steuern der regulatorischen Kosten auf Rechnungsebene in Mikros. |
regulatoryCostsTaxAmountMicros |
Nur Ausgabe Die Summe der Steuern auf regulatorische Kosten auf Rechnungsebene in Mikros. |
regulatoryCostsTotalAmountMicros |
Nur Ausgabe Der Gesamtbetrag der regulatorischen Kosten auf Rechnungsebene in Mikros. |
replacedInvoices[] |
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
|
accountBudgetSummaries[] |
Nur Ausgabe Die Liste der zusammengefassten Informationen zum Kontobudget, die dieser Rechnung zugeordnet sind. |
accountSummaries[] |
Nur Ausgabe Die Liste der zusammengefassten Kontoinformationen für diese Rechnung. |
id |
Nur Ausgabe Die ID der Rechnung. Sie wird auf der PDF-Rechnung als „Rechnungsnummer“ angegeben. |
billingSetup |
Nur Ausgabe Der Ressourcenname der Abrechnungseinrichtung dieser Rechnung.
|
paymentsAccountId |
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 |
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 |
Nur Ausgabe Ausstellungsdatum im Format JJJJ-MM-TT. Es wird auf der PDF-Rechnung als „Ausstellungsdatum“ oder „Rechnungsdatum“ angegeben. |
dueDate |
Nur Ausgabe Das Fälligkeitsdatum im Format JJJJ-MM-TT. |
currencyCode |
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 |
Nur Ausgabe Die Zwischensumme vor Steuern der Exportgebühren auf Rechnungsebene in Mikros. |
exportChargeTaxAmountMicros |
Nur Ausgabe Die Summe der Steuern auf den Exportgebühren auf Rechnungsebene in Mikros. |
exportChargeTotalAmountMicros |
Nur Ausgabe Der Gesamtbetrag der Exportgebühren auf Rechnungsebene in Mikros. |
subtotalAmountMicros |
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 |
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 |
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 |
Nur Ausgabe Der Ressourcenname der ursprünglichen Rechnung, die gegebenenfalls durch diese Rechnung korrigiert, ausgebucht oder storniert wurde. Wenn
|
pdfUrl |
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 ( |
Felder | |
---|---|
billableActivityDateRange |
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[] |
Nur Ausgabe Liste der zusammengefassten Gutschriften für ungültige Aktivitäten mit ursprünglichen Verknüpfungen |
customer |
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:
|
customerDescriptiveName |
Nur Ausgabe Der beschreibende Name des Kunden für das Kontobudget. Sie erscheint auf der PDF-Rechnung als „Konto“. |
accountBudget |
Nur Ausgabe Der Ressourcenname des Kontobudgets, das diesen zusammengefassten abrechenbaren Kosten zugeordnet ist. Ressourcennamen vom Typ „AccountBudget“ haben das folgende Format:
|
accountBudgetName |
Nur Ausgabe Der Name des Kontobudgets. auf der PDF-Rechnung als „Kontobudget“ angegeben. |
purchaseOrderNumber |
Nur Ausgabe Die Auftragsnummer des Kontobudgets. Sie finden sie auf der PDF-Rechnung als „Auftrag“. |
subtotalAmountMicros |
Nur Ausgabe Der Zwischensummenbetrag vor Steuern, der auf dieses Budget während des Servicezeitraums zurückzuführen ist, in Mikroeinheiten. |
taxAmountMicros |
Nur Ausgabe Der Steuerbetrag, der während des Servicezeitraums auf dieses Budget zu zahlen ist, in Mikroeinheiten. |
totalAmountMicros |
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 |
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 |
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 |
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 |
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 ( |
Felder | |
---|---|
originalMonthOfService |
Nur Ausgabe Ursprünglicher Dienstmonat, in dem diese Gutschrift für ungültige Aktivitäten verwendet wurde. |
originalYearOfService |
Nur Ausgabe Ursprüngliches Jahr, in dem der Dienst im Zusammenhang mit dieser Gutschrift für ungültige Aktivitäten genutzt wurde. |
originalInvoiceId |
Nur Ausgabe Ursprüngliche Rechnungsnummer für diese Gutschrift für ungültige Aktivitäten. |
originalAccountBudgetName |
Nur Ausgabe Der ursprüngliche Name des Kontobudgets, auf das sich diese Gutschrift für ungültige Aktivitäten bezieht. |
originalPurchaseOrderNumber |
Nur Ausgabe Ursprüngliche Auftragsnummer, die mit dieser Gutschrift für ungültige Aktivitäten in Zusammenhang steht. |
amountMicros |
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 |
Nur Ausgabe Das mit der Kontoübersicht verknüpfte Konto. |
billingCorrectionSubtotalAmountMicros |
Nur Ausgabe Zwischensumme der Rechnungskorrektur vor Steuern in Mikros. |
billingCorrectionTaxAmountMicros |
Nur Ausgabe Steuer auf Rechnungskorrektur in Mikroeinheiten. |
billingCorrectionTotalAmountMicros |
Nur Ausgabe Gesamtbetrag der Rechnungskorrektur in Mikros. |
couponAdjustmentSubtotalAmountMicros |
Nur Ausgabe Zwischensumme des Gutscheins für die Anpassung vor Steuern in Mikros. |
couponAdjustmentTaxAmountMicros |
Nur Ausgabe Steuer auf Gutscheinkorrektur, in Mikroeinheiten. |
couponAdjustmentTotalAmountMicros |
Nur Ausgabe Gesamtbetrag der Gutscheinanpassung in Mikros. |
excessCreditAdjustmentSubtotalAmountMicros |
Nur Ausgabe Zwischensumme des Überschreitungsbetrags der Gutschriftkorrektur vor Steuern in Mikros. |
excessCreditAdjustmentTaxAmountMicros |
Nur Ausgabe Steuern auf überschüssige Gutschriftkorrektur in Mikroeinheiten. |
excessCreditAdjustmentTotalAmountMicros |
Nur Ausgabe Gesamtbetrag der überschüssigen Gutschriftkorrektur in Mikros. |
regulatoryCostsSubtotalAmountMicros |
Nur Ausgabe Zwischensumme der Zwischensumme der regulatorischen Kosten vor Steuern in Mikros. |
regulatoryCostsTaxAmountMicros |
Nur Ausgabe Steuer auf regulatorische Kosten in Mikroeinheiten. |
regulatoryCostsTotalAmountMicros |
Nur Ausgabe Gesamtbetrag der regulatorischen Kosten in Mikros. |
exportChargeSubtotalAmountMicros |
Nur Ausgabe Zwischensumme der Exportgebühr vor Steuern in Mikros. |
exportChargeTaxAmountMicros |
Nur Ausgabe Steuer auf die Ausfuhrabgabe in Mikros. |
exportChargeTotalAmountMicros |
Nur Ausgabe Gesamtsumme der Exportgebühr in Mikros. |
subtotalAmountMicros |
Nur Ausgabe Der gesamte Zwischenbetrag vor Steuern, der dem Konto während des Servicezeitraums zuzuschreiben ist, in Mikroeinheiten. |
taxAmountMicros |
Nur Ausgabe Der gesamte Steuerbetrag, der dem Konto während des Servicezeitraums zuzuschreiben ist, in Mikroeinheiten. |
totalAmountMicros |
Nur Ausgabe Der dem Konto während des Servicezeitraums zuzuordnende Gesamtbetrag in Mikrosekunden. Dies entspricht der Summe der subtotalAmountMicros und „taxAmountMicros“. |