- Richiesta HTTP
- Parametri del percorso
- Parametri di ricerca
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- LoiSapinInvoiceType
- Fattura
- InvoiceType
- BudgetSummary
- Prova!
Elenca le fatture pubblicate per un inserzionista in un determinato mese.
Le fatture generate dai profili di fatturazione a livello di "Partner" non possono essere recuperate con questo metodo.
Richiesta HTTP
GET https://displayvideo.googleapis.com/v1/advertisers/{advertiserId}/invoices
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
Parametri | |
---|---|
advertiserId |
Obbligatorio. L'ID dell'inserzionista per cui elencare le fatture. |
Parametri di ricerca
Parametri | |
---|---|
issueMonth |
Il mese di cui visualizzare l'elenco delle fatture. Se non viene configurato, la richiesta recupererà le fatture del mese precedente. Deve essere nel formato AAAAMM. |
loiSapinInvoiceType |
Seleziona il tipo di fattura da recuperare per gli inserzionisti in base alla legge Sapin. Valido solo per gli inserzionisti in base alla Legge Sapin. In caso contrario verrà ignorato. |
pageSize |
Dimensioni della pagina richiesta. Il valore deve essere compreso tra |
pageToken |
Un token che identifica una pagina di risultati che il server deve restituire. In genere, si tratta del valore di |
Corpo della richiesta
Il corpo della richiesta deve essere vuoto.
Corpo della risposta
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{
"invoices": [
{
object ( |
Campi | |
---|---|
invoices[] |
L'elenco delle fatture. Questo elenco non sarà presente se vuoto. |
nextPageToken |
Un token per recuperare la pagina di risultati successiva. Passa questo valore nel campo Questo token non sarà presente se non vengono restituiti altri |
Ambiti di autorizzazione
Richiede uno dei seguenti ambiti OAuth:
https://www.googleapis.com/auth/display-video
https://www.googleapis.com/auth/display-video-mediaplanning
Per ulteriori informazioni, consulta la Panoramica di OAuth 2.0.
LoiSapinInvoiceType
Possibili tipi di fatture per gli inserzionisti in base alla legge Sapin.
Enum | |
---|---|
LOI_SAPIN_INVOICE_TYPE_UNSPECIFIED |
Valore non specificato. |
LOI_SAPIN_INVOICE_TYPE_MEDIA |
Fatture con costo dei media. |
LOI_SAPIN_INVOICE_TYPE_PLATFORM |
Fatture con Tariffa piattaforma. |
Fattura
Una sola fattura.
Rappresentazione JSON |
---|
{ "name": string, "invoiceId": string, "displayName": string, "paymentsProfileId": string, "paymentsAccountId": string, "issueDate": { object ( |
Campi | |
---|---|
name |
Il nome risorsa della fattura. |
invoiceId |
L'ID univoco della fattura. |
displayName |
Il nome visualizzato della fattura. |
paymentsProfileId |
L'ID del profilo pagamenti a cui appartiene la fattura. Appare nel PDF della fattura come |
paymentsAccountId |
L'ID dell'account pagamenti a cui appartiene la fattura. Appare nel PDF della fattura come |
issueDate |
La data di emissione della fattura. |
dueDate |
Data di scadenza della fattura. |
serviceDateRange |
Le date di inizio e di fine del servizio coperte da questa fattura. |
currencyCode |
La valuta utilizzata nella fattura in formato ISO 4217. |
subtotalAmountMicros |
L'importo del subtotale al lordo delle imposte, in micro della valuta della fattura. Ad esempio, se |
totalTaxAmountMicros |
La somma di tutte le imposte in fattura, in micro della valuta della fattura. Ad esempio, se |
totalAmountMicros |
L'importo totale della fattura, in micro della valuta della fattura. Ad esempio, se |
purchaseOrderNumber |
Numero dell'ordine di acquisto associato alla fattura. |
budgetInvoiceGroupingId |
L'ID raggruppamento del budget per questa fattura. Questo campo verrà impostato solo se il livello fattura del profilo di fatturazione corrispondente è stato impostato su "ID raggruppamento delle fatture del budget". |
invoiceType |
Il tipo di documento di fatturazione. |
correctedInvoiceId |
L'ID della fattura originale rettificata da questa fattura, se applicabile. Può essere riportata sul PDF della fattura come Se il criterio |
replacedInvoiceIds[] |
Gli ID di qualsiasi fattura emessa in origine che viene annullata da questa fattura, se applicabile. Se vengono consolidate in un'unica fattura, possono essere elencate più fatture. Sul PDF della fattura può comparire come Se il criterio |
pdfUrl |
L'URL per scaricare una copia in formato PDF della fattura. Questo URL è specifico dell'utente e richiede un token di accesso OAuth 2.0 valido per accedere. Il token di accesso deve essere fornito in un'intestazione HTTP
L'URL sarà valido per 7 giorni dopo il recupero dell'oggetto di questa fattura o fino a quando la fattura non verrà nuovamente recuperata. |
budgetSummaries[] |
L'elenco di informazioni riepilogative per ciascun budget associato a questa fattura. Questo campo verrà impostato solo se il livello di dettaglio della fattura del profilo di fatturazione corrispondente è stato impostato su "Ordine di acquisto a livello di budget". |
nonBudgetMicros |
L'importo totale dei costi o degli aggiustamenti non legati a un determinato budget, in micro della valuta della fattura. Ad esempio, se |
InvoiceType
Possibili tipi di fatture.
Enum | |
---|---|
INVOICE_TYPE_UNSPECIFIED |
Non specificato o sconosciuto in questa versione. |
INVOICE_TYPE_CREDIT |
La fattura ha un importo negativo. |
INVOICE_TYPE_INVOICE |
La fattura ha un importo positivo. |
BudgetSummary
Informazioni riassunte sul budget di una singola campagna.
Rappresentazione JSON |
---|
{
"externalBudgetId": string,
"prismaCpeCode": {
object ( |
Campi | |
---|---|
externalBudgetId |
Corrisponde al |
prismaCpeCode |
Codici di clienti, prodotti e stime pertinenti dello strumento Mediaocean Prisma. Applicabile solo per i budget delle campagne con un |
preTaxAmountMicros |
La somma degli addebiti effettuati in base a questo budget al lordo delle imposte, in micro della valuta della fattura. Ad esempio, se |
taxAmountMicros |
L'importo delle imposte applicate agli addebiti con questo budget, in micro della valuta della fattura. Ad esempio, se |
totalAmountMicros |
La somma totale degli addebiti effettuati nell'ambito di questo budget, imposte incluse, in micro della valuta della fattura. Ad esempio, se |