Method: advertisers.invoices.list

列出在给定月份为广告客户过账的账单。

由与“合作伙伴”关联的结算资料生成的账单账单级别无法通过此方法检索。

HTTP 请求

GET https://displayvideo.googleapis.com/v2/advertisers/{advertiserId}/invoices

网址采用 gRPC 转码语法。

路径参数

参数
advertiserId

string (int64 format)

必需。要列出其账单的广告客户的 ID。

查询参数

参数
issueMonth

string

要列出其账单的月份。如果未设置，请求将检索上个月的账单。

必须采用 YYYYMM 格式。
loiSapinInvoiceType

enum (LoiSapinInvoiceType)

选择要为 Loi Sapin 广告客户检索的账单类型。

仅适用于 Loi Sapin 广告客户。否则，将会被忽略。
pageSize

integer

请求的页面大小。必须介于 1 到 200 之间。如果未指定，则默认为 100。如果指定的值无效，则返回错误代码 INVALID_ARGUMENT。
pageToken

string

用于标识服务器应返回的结果页面的令牌。通常，这是上次调用 invoices.list 方法后返回的 nextPageToken 值。如果未指定，则返回第一页结果。

请求正文

请求正文必须为空。

响应正文

如果成功，响应正文将包含结构如下的数据：

JSON 表示法 
{
  "invoices": [
    {
      object (Invoice)
    }
  ],
  "nextPageToken": string
}
字段
invoices[]

object (Invoice)

账单列表。

如果为空，此列表将不存在。
nextPageToken

string

用于检索下一页结果的令牌。在后续调用 invoices.list 方法时，将此值传入 pageToken 字段以检索下一页结果。

如果没有更多可返回的 invoices，则此令牌将不存在。

授权范围

需要以下 OAuth 范围之一：

  • https://www.googleapis.com/auth/display-video
  • https://www.googleapis.com/auth/display-video-mediaplanning

如需了解详情，请参阅 OAuth 2.0 概览。

LoiSapinInvoiceType

Loi Sapin 广告客户的可能的账单类型。

枚举
LOI_SAPIN_INVOICE_TYPE_UNSPECIFIED 未指定值。
LOI_SAPIN_INVOICE_TYPE_MEDIA 包含媒体费用的账单。
LOI_SAPIN_INVOICE_TYPE_PLATFORM 包含平台费用的账单。

账单

一张账单。

JSON 表示法 
{
  "name": string,
  "invoiceId": string,
  "displayName": string,
  "paymentsProfileId": string,
  "paymentsAccountId": string,
  "issueDate": {
    object (Date)
  },
  "dueDate": {
    object (Date)
  },
  "serviceDateRange": {
    object (DateRange)
  },
  "currencyCode": string,
  "subtotalAmountMicros": string,
  "totalTaxAmountMicros": string,
  "totalAmountMicros": string,
  "purchaseOrderNumber": string,
  "budgetInvoiceGroupingId": string,
  "invoiceType": enum (InvoiceType),
  "correctedInvoiceId": string,
  "replacedInvoiceIds": [
    string
  ],
  "pdfUrl": string,
  "budgetSummaries": [
    {
      object (BudgetSummary)
    }
  ],
  "nonBudgetMicros": string
}
字段
name

string

账单的资源名称。
invoiceId

string

账单的唯一 ID。
displayName

string

账单的显示名称。
paymentsProfileId

string

账单所属的付款资料的 ID。

在 PDF 账单上显示为 Billing ID。
paymentsAccountId

string

账单所属的付款账号的 ID。

在 PDF 账单上显示为 Billing Account Number。
issueDate

object (Date)

账单开具的日期。
dueDate

object (Date)

账单到期的日期。
serviceDateRange

object (DateRange)

此账单所涵盖的服务开始日期和结束日期。
currencyCode

string

账单中使用的币种（采用 ISO 4217 格式）。
subtotalAmountMicros

string (int64 format)

税前小计金额，以账单币种的微单位表示。

例如，如果 currencyCode 为 USD，则 1000000 表示一美元。
totalTaxAmountMicros

string (int64 format)

账单中所有税费的总和，以账单所用币种的微单位表示。

例如，如果 currencyCode 为 USD，则 1000000 表示一美元。
totalAmountMicros

string (int64 format)

账单总金额，以账单货币的微单位表示。

例如，如果 currencyCode 为 USD，则 1000000 表示一美元。
purchaseOrderNumber

string

与账单关联的采购订单编号。
budgetInvoiceGroupingId

string

此账单的预算分组 ID。

只有当相应结算资料的账单级别设为“预算账单分组 ID”时，才会设置此字段。
invoiceType

enum (InvoiceType)

账单文档的类型。
correctedInvoiceId

string

此账单调整的原始账单的 ID（如适用）。

可能会在 PDF 格式的账单上显示为 Reference invoice number。

如果设置了 replacedInvoiceIds，则此字段将为空。
replacedInvoiceIds[]

string

被此账单撤销的任何最初开具的账单的 ID（如适用）。如果将多个账单合并为一张账单，则这些账单可能会列出。

在 PDF 账单上，可能会显示为 Replaced invoice numbers。

如果设置了 correctedInvoiceId，则此字段将为空。
pdfUrl

string

用于下载 PDF 格式的账单副本的网址。

此网址是用户专有的网址，需要有效的 OAuth 2.0 访问令牌才能访问。访问令牌必须在 Authorization: Bearer HTTP 标头中提供，并针对以下范围之一获得授权：

  • https://www.googleapis.com/auth/display-video-mediaplanning
  • https://www.googleapis.com/auth/display-video

该网址在检索到此账单对象后 7 天内有效，或直到再次检索到此账单为止。
budgetSummaries[]

object (BudgetSummary)

与此账单关联的每项预算的汇总信息列表。

只有当相应结算资料的账单明细级别设为“预算级采购订单”时，才会设置此字段。
nonBudgetMicros

string (int64 format)

与特定预算无关的费用或调整项的总金额，以发票货币的微单位表示。

例如，如果 currencyCode 是 USD，则 1000000 代表一美元。

InvoiceType

可能的账单类型。

枚举
INVOICE_TYPE_UNSPECIFIED 未指定或在此版本中未知。
INVOICE_TYPE_CREDIT 账单金额为负数。
INVOICE_TYPE_INVOICE 账单金额为正数。

BudgetSummary

具体广告系列预算的摘要信息。

JSON 表示法 
{
  "externalBudgetId": string,
  "prismaCpeCode": {
    object (PrismaCpeCode)
  },
  "preTaxAmountMicros": string,
  "taxAmountMicros": string,
  "totalAmountMicros": string
}
字段
externalBudgetId

string

对应于广告系列预算的 externalBudgetId。如果未在广告系列预算中设置此值，则此字段将为空。
prismaCpeCode

object (PrismaCpeCode)

Mediaocean Prisma 工具中的相关客户端、产品和估算代码。

仅适用于externalBudgetSource为 EXTERNAL_BUDGET_SOURCE_MEDIA_OCEAN 的广告系列预算。
preTaxAmountMicros

string (int64 format)

此预算下的税前费用总和，以账单货币的微单位表示。

例如，如果 currencyCode 为 USD，则 1000000 表示一美元。
taxAmountMicros

string (int64 format)

对此预算下的费用征收的税额，以账单货币的微单位表示。

例如，如果 currencyCode 为 USD，则 1000000 表示一美元。
totalAmountMicros

string (int64 format)

在此预算下产生的费用总额（包括税费），以账单货币的微单位表示。

例如，如果 currencyCode 为 USD，则 1000000 表示一美元。