- HTTP request
- Path parameters
- Query parameters
- Request body
- Response body
- Authorization scopes
- LoiSapinInvoiceType
- Invoice
- InvoiceType
- BudgetSummary
- Try it!
Lists invoices posted for an advertiser in a given month.
Invoices generated by billing profiles with a "Partner" invoice level are not retrievable through this method.
HTTP request
GET https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/invoices
The URL uses gRPC Transcoding syntax.
Path parameters
Parameters | |
---|---|
advertiserId |
Required. The ID of the advertiser to list invoices for. |
Query parameters
Parameters | |
---|---|
issueMonth |
The month to list the invoices for. If not set, the request will retrieve invoices for the previous month. Must be in the format YYYYMM. |
loiSapinInvoiceType |
Select type of invoice to retrieve for Loi Sapin advertisers. Only applicable to Loi Sapin advertisers. Will be ignored otherwise. |
pageSize |
Requested page size. Must be between |
pageToken |
A token identifying a page of results the server should return. Typically, this is the value of |
Request body
The request body must be empty.
Response body
If successful, the response body contains data with the following structure:
JSON representation |
---|
{
"invoices": [
{
object ( |
Fields | |
---|---|
invoices[] |
The list of invoices. This list will be absent if empty. |
nextPageToken |
A token to retrieve the next page of results. Pass this value in the This token will be absent if there are no more |
Authorization scopes
Requires one of the following OAuth scopes:
https://www.googleapis.com/auth/display-video
https://www.googleapis.com/auth/display-video-mediaplanning
For more information, see the OAuth 2.0 Overview.
LoiSapinInvoiceType
Possible types of invoices for Loi Sapin advertisers.
Enums | |
---|---|
LOI_SAPIN_INVOICE_TYPE_UNSPECIFIED |
Value is not specified. |
LOI_SAPIN_INVOICE_TYPE_MEDIA |
Invoices with Media cost. |
LOI_SAPIN_INVOICE_TYPE_PLATFORM |
Invoices with Platform fee. |
Invoice
A single invoice.
JSON representation |
---|
{ "name": string, "invoiceId": string, "displayName": string, "paymentsProfileId": string, "paymentsAccountId": string, "issueDate": { object ( |
Fields | |
---|---|
name |
The resource name of the invoice. |
invoiceId |
The unique ID of the invoice. |
displayName |
The display name of the invoice. |
paymentsProfileId |
The ID of the payments profile the invoice belongs to. Appears on the invoice PDF as |
paymentsAccountId |
The ID of the payments account the invoice belongs to. Appears on the invoice PDF as |
issueDate |
The date when the invoice was issued. |
dueDate |
The date when the invoice is due. |
serviceDateRange |
The service start and end dates which are covered by this invoice. |
currencyCode |
The currency used in the invoice in ISO 4217 format. |
subtotalAmountMicros |
The pre-tax subtotal amount, in micros of the invoice's currency. For example, if |
totalTaxAmountMicros |
The sum of all taxes in invoice, in micros of the invoice's currency. For example, if |
totalAmountMicros |
The invoice total amount, in micros of the invoice's currency. For example, if |
purchaseOrderNumber |
Purchase order number associated with the invoice. |
budgetInvoiceGroupingId |
The budget grouping ID for this invoice. This field will only be set if the invoice level of the corresponding billing profile was set to "Budget invoice grouping ID". |
invoiceType |
The type of invoice document. |
correctedInvoiceId |
The ID of the original invoice being adjusted by this invoice, if applicable. May appear on the invoice PDF as If |
replacedInvoiceIds[] |
The ID(s) of any originally issued invoice that is being cancelled by this invoice, if applicable. Multiple invoices may be listed if those invoices are being consolidated into a single invoice. May appear on invoice PDF as If |
pdfUrl |
The URL to download a PDF copy of the invoice. This URL is user specific and requires a valid OAuth 2.0 access token to access. The access token must be provided in an
The URL will be valid for 7 days after retrieval of this invoice object or until this invoice is retrieved again. |
budgetSummaries[] |
The list of summarized information for each budget associated with this invoice. This field will only be set if the invoice detail level of the corresponding billing profile was set to "Budget level PO". |
nonBudgetMicros |
The total amount of costs or adjustments not tied to a particular budget, in micros of the invoice's currency. For example, if |
InvoiceType
Possible types of invoices.
Enums | |
---|---|
INVOICE_TYPE_UNSPECIFIED |
Not specified or is unknown in this version. |
INVOICE_TYPE_CREDIT |
The invoice has a negative amount. |
INVOICE_TYPE_INVOICE |
The invoice has a positive amount. |
BudgetSummary
Summarized information of an individual campaign budget.
JSON representation |
---|
{
"externalBudgetId": string,
"prismaCpeCode": {
object ( |
Fields | |
---|---|
externalBudgetId |
Corresponds to the |
prismaCpeCode |
Relevant client, product, and estimate codes from the Mediaocean Prisma tool. Only applicable for campaign budgets with an |
preTaxAmountMicros |
The sum of charges made under this budget before taxes, in micros of the invoice's currency. For example, if |
taxAmountMicros |
The amount of tax applied to charges under this budget, in micros of the invoice's currency. For example, if |
totalAmountMicros |
The total sum of charges made under this budget, including tax, in micros of the invoice's currency. For example, if |