- HTTP 请求
- 路径参数
- 查询参数
- 请求正文
- 响应正文
- 授权范围
- LoiSapinInvoiceType
- 账单
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- InvoiceType
- BudgetSummary
<ph type="x-smartling-placeholder">
- </ph>
- JSON 表示法
- 试试看!
列出在给定月份为广告客户过账的账单。
由与“合作伙伴”关联的结算资料生成的账单账单级别无法通过此方法检索。
HTTP 请求
GET https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/invoices
网址采用 gRPC 转码语法。
路径参数
参数 | |
---|---|
advertiserId |
必需。要列出其账单的广告客户的 ID。 |
查询参数
参数 | |
---|---|
issueMonth |
要列出其账单的月份。如果未设置,此请求将检索上月的账单。 必须采用 YYYYMM 格式。 |
loiSapinInvoiceType |
选择要为 Loi Sapin 广告客户检索的账单类型。 仅适用于 Loi Sapin 广告客户。否则,将会被忽略。 |
pageSize |
请求的页面大小。必须介于 |
pageToken |
用于标识服务器应返回的结果页面的令牌。通常,这是上次调用 |
请求正文
请求正文必须为空。
响应正文
如果成功,响应正文将包含结构如下的数据:
JSON 表示法 |
---|
{
"invoices": [
{
object ( |
字段 | |
---|---|
invoices[] |
账单列表。 如果为空,此列表将不存在。 |
nextPageToken |
用于检索下一页结果的令牌。在后续调用 如果没有更多可返回的 |
授权范围
需要以下 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 ( |
字段 | |
---|---|
name |
账单的资源名称。 |
invoiceId |
账单的唯一 ID。 |
displayName |
账单的显示名称。 |
paymentsProfileId |
账单所属的付款资料的 ID。 在 PDF 账单上,显示为“ |
paymentsAccountId |
账单所属的付款账号的 ID。 在 PDF 账单上,显示为“ |
issueDate |
账单开具的日期。 |
dueDate |
账单到期的日期。 |
serviceDateRange |
此账单所涵盖的服务开始日期和结束日期。 |
currencyCode |
账单中使用的币种(采用 ISO 4217 格式)。 |
subtotalAmountMicros |
税前金额小计,以账单货币的微单位表示。 例如,如果 |
totalTaxAmountMicros |
账单中所有税费的总和,以账单所用币种的微单位表示。 例如,如果 |
totalAmountMicros |
账单总金额,以账单货币的微单位表示。 例如,如果 |
purchaseOrderNumber |
与账单关联的采购订单编号。 |
budgetInvoiceGroupingId |
此账单的预算分组 ID。 只有当相应结算资料的账单级别设为“预算账单分组 ID”时,才会设置此字段。 |
invoiceType |
账单文档的类型。 |
correctedInvoiceId |
此账单调整的原始账单的 ID(如适用)。 可能会在 PDF 格式的账单上显示为 如果设置了 |
replacedInvoiceIds[] |
被此账单撤销的任何最初开具的账单的 ID(如适用)。如果将多个账单合并为一张账单,则该账单可能会列出。 在 PDF 账单上,可能会显示为 如果设置了 |
pdfUrl |
用于下载 PDF 格式的账单副本的网址。 此网址是用户专有的网址,需要有效的 OAuth 2.0 访问令牌才能访问。访问令牌必须在
该网址在检索到此账单对象后 7 天内有效,或直到再次检索到此账单为止。 |
budgetSummaries[] |
与此账单关联的每项预算的汇总信息列表。 只有当相应结算资料的账单明细级别设为“预算级采购订单”时,才会设置此字段。 |
nonBudgetMicros |
与特定预算无关的费用或调整项的总金额,以发票货币的微单位表示。 例如,如果 |
InvoiceType
可能的账单类型。
枚举 | |
---|---|
INVOICE_TYPE_UNSPECIFIED |
未指定或在此版本中未知。 |
INVOICE_TYPE_CREDIT |
账单金额为负数。 |
INVOICE_TYPE_INVOICE |
账单金额为正数。 |
BudgetSummary
具体广告系列预算的摘要信息。
JSON 表示法 |
---|
{
"externalBudgetId": string,
"prismaCpeCode": {
object ( |
字段 | |
---|---|
externalBudgetId |
对应于广告系列预算的 |
prismaCpeCode |
Mediaocean Prisma 工具中的相关客户端、产品和估算代码。 仅适用于 |
preTaxAmountMicros |
此预算下的税前费用总和,以账单货币的微单位表示。 例如,如果 |
taxAmountMicros |
对此预算下的费用征收的税额,以账单货币的微单位表示。 例如,如果 |
totalAmountMicros |
此预算下产生的费用总额(包括税费),以账单货币的微单位表示。 例如,如果 |