- 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/v2/advertisers/{advertiserId}/invoices
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
Parameters | |
---|---|
advertiserId |
Erforderlich. Die ID des Werbetreibenden, für den Rechnungen aufgelistet werden sollen. |
Abfrageparameter
Parameters | |
---|---|
issueMonth |
Der Monat, für den die Rechnungen aufgelistet werden sollen. Wenn die Richtlinie nicht konfiguriert ist, werden mit der Anfrage Rechnungen für den Vormonat abgerufen. Muss im Format JJJJMM vorliegen. |
loiSapinInvoiceType |
Wählen Sie die Art der Rechnung aus, die für Werbetreibende im Sapin-Gesetz abgerufen werden soll. Gilt nur für Werbetreibende nach dem Sapin-Gesetz. Wird sonst 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 fehlt, 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 fehlt, wenn keine weiteren |
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 Rechnungsarten für Kunden im Sapin-Gesetz
Enums | |
---|---|
LOI_SAPIN_INVOICE_TYPE_UNSPECIFIED |
Es ist kein Wert 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 |
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 als |
paymentsAccountId |
Die ID des Zahlungskontos, zu dem die Rechnung gehört. Erscheint auf der Rechnung im PDF 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, die von dieser Rechnung abgedeckt werden. |
currencyCode |
Die auf der Rechnung verwendete Währung im ISO 4217-Format. |
subtotalAmountMicros |
Der Zwischensummenbetrag vor Steuern in Mikros in der Währung der Rechnung. Wenn |
totalTaxAmountMicros |
Die Summe aller Steuern der Rechnung in Mikros in der Währung der Rechnung. Wenn |
totalAmountMicros |
Der Rechnungsgesamtbetrag in Mikros in der Währung der Rechnung. Wenn |
purchaseOrderNumber |
Die mit der Rechnung verknüpfte Auftragsnummer. |
budgetInvoiceGroupingId |
Die Budgetgruppierungs-ID für diese Rechnung. Dieses Feld wird nur ausgefüllt, wenn die Rechnungsebene des entsprechenden Abrechnungsprofils auf „ID der Rechnungsgruppe für das Budget“ festgelegt wurde. |
invoiceType |
Die Art des Rechnungsdokuments. |
correctedInvoiceId |
Die ID der ursprünglichen Rechnung, die durch diese Rechnung korrigiert wurde (sofern zutreffend). 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, wenn diese zu einer einzigen Rechnung zusammengefasst werden. Kann auf PDF-Rechnungen als Wenn |
pdfUrl |
Die URL zum Herunterladen einer PDF-Kopie der Rechnung. Diese URL ist benutzerspezifisch. 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 bis zum erneuten Abrufen der Rechnung gültig. |
budgetSummaries[] |
Die Liste der zusammengefassten Informationen für jedes Budget, das dieser Rechnung zugeordnet ist. Dieses Feld wird nur ausgefüllt, wenn für die Rechnungsdetails des entsprechenden Abrechnungsprofils „Auftrag auf Budgetebene“ festgelegt ist. |
nonBudgetMicros |
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 im Rahmen dieses Budgets angefallenen Kosten vor Steuern in Mikros in der Währung der Rechnung. Wenn |
taxAmountMicros |
Der Steuerbetrag, der auf Kosten im Rahmen dieses Budgets berechnet wird, in Mikros in der Währung der Rechnung. Wenn |
totalAmountMicros |
Die Gesamtsumme der im Rahmen dieses Budgets angefallenen Kosten, einschließlich Steuern, in „micros“ (millionstel Einheiten) in der Währung der Rechnung. Wenn |