- HTTP-Anfrage
- Pfadparameter
- Anfrageparameter
- Anfragetext
- Antworttext
- Autorisierungsbereiche
- LoiSapinInvoiceType
- Rechnung
- InvoiceType
- BudgetSummary
- Testen!
Listet die Rechnungen auf, die in einem bestimmten Monat an einen Werbetreibenden gesendet wurden.
Rechnungen, die über Abrechnungsprofile mit der Rechnungsebene „Partner“ erstellt wurden, können nicht über diese Methode abgerufen werden.
HTTP-Anfrage
GET https://displayvideo.googleapis.com/v1/advertisers/{advertiserId}/invoices
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
Parameter | |
---|---|
advertiserId |
Erforderlich. Die ID des Werbetreibenden, für den Rechnungen aufgeführt werden sollen. |
Abfrageparameter
Parameter | |
---|---|
issueMonth |
Der Monat, für den die Rechnungen aufgelistet werden sollen. Wenn die Richtlinie nicht konfiguriert ist, werden über die Anfrage die Rechnungen für den Vormonat abgerufen. Muss das Format JJJJMM haben. |
loiSapinInvoiceType |
Wählen Sie die Art der Rechnung aus, die für Werbetreibende gemäß Sapin-Gesetz abgerufen werden soll. Gilt nur für Werbetreibende gemäß dem Sapin-Gesetz. Andernfalls wird sie ignoriert. |
pageSize |
Angeforderte Seitengröße. Muss zwischen |
pageToken |
Ein Token, das eine Ergebnisseite identifiziert, die der Server liefern soll. In der Regel ist dies der Wert von |
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Wenn der Vorgang erfolgreich ist, enthält der Antworttext Daten mit folgender Struktur:
JSON-Darstellung |
---|
{
"invoices": [
{
object ( |
Felder | |
---|---|
invoices[] |
Die Liste der Rechnungen. Diese Liste ist nicht vorhanden, wenn sie leer ist. |
nextPageToken |
Ein Token, mit dem die nächste Ergebnisseite abgerufen werden kann. Übergeben Sie diesen Wert im nachfolgenden Aufruf der Dieses Token ist nicht vorhanden, wenn keine |
Autorisierungsbereiche
Erfordert einen der folgenden OAuth-Bereiche:
https://www.googleapis.com/auth/display-video
https://www.googleapis.com/auth/display-video-mediaplanning
Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.
LoiSapinInvoiceType
Mögliche Arten von Rechnungen für Werbetreibende gemäß Sapin-Gesetz.
Enums | |
---|---|
LOI_SAPIN_INVOICE_TYPE_UNSPECIFIED |
Der Wert ist nicht angegeben. |
LOI_SAPIN_INVOICE_TYPE_MEDIA |
Rechnungen mit Mediakosten. |
LOI_SAPIN_INVOICE_TYPE_PLATFORM |
Rechnungen mit Plattformgebühr. |
Rechnung
Eine einzelne Rechnung.
JSON-Darstellung |
---|
{ "name": string, "invoiceId": string, "displayName": string, "paymentsProfileId": string, "paymentsAccountId": string, "issueDate": { object ( |
Felder | |
---|---|
name |
Der Ressourcenname der Rechnung. |
invoiceId |
Die eindeutige ID der Rechnung. |
displayName |
Der Anzeigename der Rechnung. |
paymentsProfileId |
Die ID des Zahlungsprofils, zu dem die Rechnung gehört. Erscheint auf der Rechnung im PDF-Format als |
paymentsAccountId |
Die ID des Zahlungskontos, zu dem die Rechnung gehört. Erscheint auf der Rechnung im PDF-Format als |
issueDate |
Das Datum, an dem die Rechnung ausgestellt wurde. |
dueDate |
Das Datum, an dem die Rechnung fällig ist. |
serviceDateRange |
Das Start- und Enddatum der Dienstleistung, auf die sich diese Rechnung bezieht. |
currencyCode |
Die in der Rechnung verwendete Währung im Format ISO 4217. |
subtotalAmountMicros |
Die Zwischensumme vor Steuern in Mikros in der Währung der Rechnung. Wenn |
totalTaxAmountMicros |
Die Summe aller Steuern in der Rechnung in Mikros in der Währung der Rechnung. Wenn |
totalAmountMicros |
Der Rechnungsgesamtbetrag in „micros“, millionstel Einheiten der Rechnungswährung. Wenn |
purchaseOrderNumber |
Auftragsnummer, die der Rechnung zugeordnet ist. |
budgetInvoiceGroupingId |
Die Budgetgruppierungs-ID für diese Rechnung. Dieses Feld wird nur festgelegt, wenn die Rechnungsebene des entsprechenden Abrechnungsprofils auf „ID der Rechnungsgruppe des Budgets“ festgelegt wurde. |
invoiceType |
Die Art des Rechnungsdokuments. |
correctedInvoiceId |
Die ID der ursprünglichen Rechnung, die gegebenenfalls durch diese Rechnung korrigiert wird. Kann auf der PDF-Rechnung als Wenn |
replacedInvoiceIds[] |
Die IDs jeder ursprünglich ausgestellten Rechnung, die gegebenenfalls durch diese Rechnung storniert wird. Es können mehrere Rechnungen aufgeführt werden, sofern diese zu einer einzigen Rechnung zusammengefasst werden. Kann auf der Rechnung als PDF-Datei als Wenn |
pdfUrl |
Die URL zum Herunterladen einer PDF-Kopie der Rechnung. Diese URL ist nutzerspezifisch. Für den Zugriff ist ein gültiges OAuth 2.0-Zugriffstoken erforderlich. Das Zugriffstoken muss in einem
Die URL ist nach dem Abrufen dieses Rechnungsobjekts 7 Tage lang oder so lange gültig, bis die Rechnung noch einmal abgerufen wird. |
budgetSummaries[] |
Die Liste der zusammengefassten Informationen für jedes Budget, das dieser Rechnung zugeordnet ist. Dieses Feld wird nur festgelegt, wenn die Rechnungsdetails des entsprechenden Abrechnungsprofils auf „Bestellung auf Budgetebene“ festgelegt wurden. |
nonBudgetMicros |
Der Gesamtbetrag der Kosten oder Korrekturen, die nicht an ein bestimmtes Budget gebunden sind, in "micros", millionstel Einheiten der Rechnungswährung. Wenn |
InvoiceType
Mögliche Arten von Rechnungen.
Enums | |
---|---|
INVOICE_TYPE_UNSPECIFIED |
Nicht angegeben oder in dieser Version unbekannt. |
INVOICE_TYPE_CREDIT |
Die Rechnung enthält einen negativen Betrag. |
INVOICE_TYPE_INVOICE |
Die Rechnung enthält einen positiven Betrag. |
BudgetSummary
Zusammengefasste Informationen zu einem einzelnen Kampagnenbudget
JSON-Darstellung |
---|
{
"externalBudgetId": string,
"prismaCpeCode": {
object ( |
Felder | |
---|---|
externalBudgetId |
Entspricht dem |
prismaCpeCode |
Relevante Kunden-, Produkt- und Schätzungscodes aus dem Mediaocean Prisma-Tool. Gilt nur für Kampagnenbudgets mit einem |
preTaxAmountMicros |
Die Summe der Kosten, die im Rahmen dieses Budgets vor Steuern angefallen sind, in Mikros in der Währung der Rechnung. Wenn |
taxAmountMicros |
Der Steuerbetrag für Kosten im Rahmen dieses Budgets, in Mikros in der Währung der Rechnung. Wenn |
totalAmountMicros |
Die Gesamtsumme der Kosten, die im Rahmen dieses Budgets angefallen sind, einschließlich Steuern, in Mikros in der Währung der Rechnung. Wenn |