- 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 con livello di fatturazione "Partner" non possono essere recuperate tramite questo metodo.
Richiesta HTTP
GET https://displayvideo.googleapis.com/v2/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 elencare le fatture. Se il criterio 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 dovrebbe 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 dei risultati successiva. Passa questo valore nel campo Questo token non sarà presente se non sono presenti 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 pagina 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 della 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 |
La data di scadenza della fattura. |
serviceDateRange |
Le date di inizio e di fine del servizio coperte dalla fattura. |
currencyCode |
La valuta utilizzata nella fattura in formato ISO 4217. |
subtotalAmountMicros |
L'importo 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 di 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ò comparire nel PDF della fattura come Se il criterio |
replacedInvoiceIds[] |
Gli ID di qualsiasi fattura emessa in origine che verrà annullata da questa fattura, se applicabile. Se vengono consolidate in un'unica fattura, possono essere elencate più fatture. Può comparire sul PDF della fattura come Se il criterio |
pdfUrl |
L'URL per scaricare una copia in formato PDF della fattura. Questo URL è specifico per l'utente e per accedere è necessario un token di accesso OAuth 2.0 valido. 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à recuperata nuovamente. |
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 riepilogate del budget di una singola campagna.
Rappresentazione JSON |
---|
{
"externalBudgetId": string,
"prismaCpeCode": {
object ( |
Campi | |
---|---|
externalBudgetId |
Corrisponde all'importo di |
prismaCpeCode |
Codici di clienti, prodotti e stime pertinenti dello strumento Mediaocean Prisma. Applicabile solo per i budget delle campagne con un valore di |
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 al di sotto di questo budget, in micro della valuta della fattura. Ad esempio, se |
totalAmountMicros |
La somma totale degli addebiti effettuati nell'ambito di questo budget, tasse incluse, in micro della valuta della fattura. Ad esempio, se |