- HTTP 请求
- 路径参数
- 查询参数
- 请求正文
- 响应正文
- 授权范围
- 账单
- InvoiceType
- AccountBudgetSummary
- InvalidActivitySummaryInvalidActivitySummary
- AccountSummary
- 试试看!
返回指定月份内与结算设置关联的所有账单。
抛出的错误列表:AuthenticationError AuthorizationError FieldError HeaderError HeaderError InternalError InvoiceError QuotaError RequestError
HTTP 请求
GET https://googleads.googleapis.com/v16/customers/{customerId}/invoices
网址采用 gRPC 转码语法。
路径参数
参数 | |
---|---|
customerId |
必需。要获取其账单的客户的 ID。 |
查询参数
参数 | |
---|---|
billingSetup |
必需。所请求账单的结算设置资源名称。
|
issueYear |
必需。用于检索账单的开具年份,采用 yyyy 格式。只能检索 2019 年或之后开具的账单。 |
issueMonth |
必需。检索账单的开具月份。 |
请求正文
请求正文必须为空。
响应正文
InvoiceService.ListInvoices
的响应消息。
如果成功,响应正文将包含结构如下的数据:
JSON 表示法 |
---|
{
"invoices": [
{
object ( |
字段 | |
---|---|
invoices[] |
与结算设置和时间段匹配的账单列表。 |
授权范围
需要以下 OAuth 作用域:
https://www.googleapis.com/auth/adwords
有关详情,请参阅 OAuth 2.0 概览。
账单
账单。系统会截取所有账单信息的快照,以匹配 PDF 账单。对于早于 InvoiceService 启用日期的帐单,快照显示的信息可能与 PDF 帐单不一致。
JSON 表示法 |
---|
{ "resourceName": string, "type": enum ( |
字段 | |
---|---|
resourceName |
仅供输出。账单的资源名称。多个客户可以共享一份给定账单,因此多个资源名称可能指向同一账单。账单资源名称采用以下形式:
|
type |
仅供输出。账单的类型。 |
serviceDateRange |
仅供输出。此账单的服务期限日期范围。结束日期包含结束日期。 |
adjustmentsSubtotalAmountMicros |
仅供输出。账单级调整的税前小计金额(以微单位表示)。 |
adjustmentsTaxAmountMicros |
仅供输出。账单级调整项的税费总和(以微单位表示)。 |
adjustmentsTotalAmountMicros |
仅供输出。账单级调整项的总金额(以微单位表示)。 |
regulatoryCostsSubtotalAmountMicros |
仅供输出。账单级监管费用的税前小计金额(以微单位表示)。 |
regulatoryCostsTaxAmountMicros |
仅供输出。账单级监管费用的税费总和(以微单位表示)。 |
regulatoryCostsTotalAmountMicros |
仅供输出。账单级监管费用总额(以微单位表示)。 |
replacedInvoices[] |
仅供输出。使用此账单重新结算或替换的原始账单的资源名称(如果适用)。由于账单合并,可能会出现多个被替换的账单。已被替换的账单可能不属于同一付款帐号。如果设置了
|
accountBudgetSummaries[] |
仅供输出。与此账单关联的账号预算信息汇总列表。 |
accountSummaries[] |
仅供输出。与此账单关联的汇总帐号信息列表。 |
id |
仅供输出。账单的 ID。它在账单 PDF 上显示为“账单编号”。 |
billingSetup |
仅供输出。此账单的结算设置的资源名称。
|
paymentsAccountId |
仅供输出。用于标识与结算设置相关联的付款帐号的 16 位数 ID,例如“1234-5678-9012-3456”。它在账单 PDF 上显示为“结算账号”。 |
paymentsProfileId |
仅供输出。用于标识与结算设置相关联的付款资料的 12 位数 ID,例如“1234-5678-9012”。它在账单 PDF 上显示为“结算 ID”。 |
issueDate |
仅供输出。采用 yyyy-mm-dd 格式的签发日期。它在账单 PDF 上会显示为“开具日期”或“账单日期”。 |
dueDate |
仅供输出。采用 yyyy-mm-dd 格式的截止日期。 |
currencyCode |
仅供输出。货币代码。所有费用均以该币种返回。支持源自 ISO 4217 标准的货币代码子集。 |
exportChargeSubtotalAmountMicros |
仅供输出。账单级导出费用的税前小计金额(以微单位表示)。 |
exportChargeTaxAmountMicros |
仅供输出。账单级出口费用的税费总和(以微单位表示)。 |
exportChargeTotalAmountMicros |
仅供输出。账单级导出费用的总金额(以微单位表示)。 |
subtotalAmountMicros |
仅供输出。税前小计金额(以微单位表示)。这等于 AccountBudgetSummary 小计金额和 Invoice.adjustments_subtotal_amount_micros 的总和。 |
taxAmountMicros |
仅供输出。账单上的所有税费的总和(以微单位表示)。这等于 AccountBudgetSummary 税费的总和,加上不与特定帐号预算相关联的税费。 |
totalAmountMicros |
仅供输出。总金额(以微单位表示)。这等于 Invoice.subtotal_amount_micros、Invoice.tax_amount_micros、Invoice.regulatory_costs_subtotal_amount_micros 和 Invoice.export_charge_subtotal_amount_micros 的总和(从 V14.1 开始分为单独的专列项)。 |
correctedInvoice |
仅供输出。由此账单更正、核销或取消的原始账单的资源名称(如果适用)。如果设置了
|
pdfUrl |
仅供输出。指向账单 PDF 副本的网址。用户需要传入其 OAuth 令牌,才能使用此网址请求 PDF。 |
InvoiceType
可能的账单类型。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中的未知值。 |
CREDIT_MEMO |
金额为负的账单。相应帐号会收到赠送金额。 |
INVOICE |
金额为正的账单。账户有欠款。 |
AccountBudgetSummary
表示汇总的帐号预算可结算费用。
JSON 表示法 |
---|
{ "billableActivityDateRange": { object ( |
字段 | |
---|---|
billableActivityDateRange |
仅供输出。帐号预算的可结算活动日期范围(在此账单的服务日期范围内)。结束日期包含结束日期。该时间可以不同于帐号预算的开始时间和结束时间。 |
invalidActivitySummaries[] |
仅供输出。包含原始关联的无效活动返还金额汇总列表。 |
customer |
仅供输出。与此账号预算关联的客户的资源名称。其中包含客户 ID,该 ID 在账单 PDF 中显示为“帐号 ID”。客户资源名称采用以下形式:
|
customerDescriptiveName |
仅供输出。对账号预算的客户的描述性名称。它在账单 PDF 上会显示为“帐号”。 |
accountBudget |
仅供输出。与此汇总的可结算费用相关联的帐号预算的资源名称。AccountBudget 资源名称的格式如下:
|
accountBudgetName |
仅供输出。帐号预算的名称。它在账单 PDF 上会显示为“帐号预算”。 |
purchaseOrderNumber |
仅供输出。帐号预算的采购订单编号。它在账单 PDF 上会显示为“采购订单”。 |
subtotalAmountMicros |
仅供输出。服务期内可计入此预算的税前小计金额(以微单位表示)。 |
taxAmountMicros |
仅供输出。服务期内归因于此预算的税额(以微单位表示)。 |
totalAmountMicros |
仅供输出。服务期间可计入此预算的总金额(以微单位表示)。这相当于帐号预算小计金额和帐号预算税费金额的总和。 |
servedAmountMicros |
仅供输出。服务期间归因于此预算的税前投放金额(以微单位表示)。这仅用于对账单和交付数据进行对帐。 |
billedAmountMicros |
仅供输出。服务期内可计入此预算的税前结算金额(以微单位表示)。这未考虑任何调整。 |
overdeliveryAmountMicros |
仅供输出。服务期内可归因于此预算的税前超额投放金额,以微单位(负值)为单位。 |
invalidActivityAmountMicros |
仅供输出。过去几个月中归因于此预算的税前无效活动金额,以微单位(负值)为单位。 |
InvalidActivitySummary
账单的无效活动详细信息,其中包含需要更正的账单的更多详细信息。
JSON 表示法 |
---|
{
"originalMonthOfService": enum ( |
字段 | |
---|---|
originalMonthOfService |
仅供输出。与此无效活动返还金额相关的原始服务月份。 |
originalYearOfService |
仅供输出。与此无效活动返还金额相关的原始服务年份。 |
originalInvoiceId |
仅供输出。与此无效活动返还金额相关的原始账单编号。 |
originalAccountBudgetName |
仅供输出。与此无效活动返还金额相关的原始帐号预算名称。 |
originalPurchaseOrderNumber |
仅供输出。与此无效活动返还金额相关的原始采购订单编号。 |
amountMicros |
仅供输出。无效活动金额(以微单位表示)。 |
AccountSummary
表示帐号一级的汇总视图。
JSON 表示法 |
---|
{ "customer": string, "billingCorrectionSubtotalAmountMicros": string, "billingCorrectionTaxAmountMicros": string, "billingCorrectionTotalAmountMicros": string, "couponAdjustmentSubtotalAmountMicros": string, "couponAdjustmentTaxAmountMicros": string, "couponAdjustmentTotalAmountMicros": string, "excessCreditAdjustmentSubtotalAmountMicros": string, "excessCreditAdjustmentTaxAmountMicros": string, "excessCreditAdjustmentTotalAmountMicros": string, "regulatoryCostsSubtotalAmountMicros": string, "regulatoryCostsTaxAmountMicros": string, "regulatoryCostsTotalAmountMicros": string, "exportChargeSubtotalAmountMicros": string, "exportChargeTaxAmountMicros": string, "exportChargeTotalAmountMicros": string, "subtotalAmountMicros": string, "taxAmountMicros": string, "totalAmountMicros": string } |
字段 | |
---|---|
customer |
仅供输出。与账号摘要相关联的账号。 |
billingCorrectionSubtotalAmountMicros |
仅供输出。税前账单更正小计金额(以微单位表示)。 |
billingCorrectionTaxAmountMicros |
仅供输出。结算更正税费(以微单位表示)。 |
billingCorrectionTotalAmountMicros |
仅供输出。账单修正金额总额(以微单位表示)。 |
couponAdjustmentSubtotalAmountMicros |
仅供输出。税前优惠券调整小计金额(以微单位表示)。 |
couponAdjustmentTaxAmountMicros |
仅供输出。优惠券调整税(以微单位表示)。 |
couponAdjustmentTotalAmountMicros |
仅供输出。优惠券调整总额(以微单位表示)。 |
excessCreditAdjustmentSubtotalAmountMicros |
仅供输出。税前超额贷记调整项小计金额(以微单位表示)。 |
excessCreditAdjustmentTaxAmountMicros |
仅供输出。因富余金额而调整的税费(以微单位表示)。 |
excessCreditAdjustmentTotalAmountMicros |
仅供输出。富余金额调整总额(以微单位表示)。 |
regulatoryCostsSubtotalAmountMicros |
仅供输出。税前监管费用小计金额(以微单位表示)。 |
regulatoryCostsTaxAmountMicros |
仅供输出。监管费用税费(以微单位表示)。 |
regulatoryCostsTotalAmountMicros |
仅供输出。总监管费用金额(以微单位表示)。 |
exportChargeSubtotalAmountMicros |
仅供输出。税前导出费用小计金额(以微单位表示)。 |
exportChargeTaxAmountMicros |
仅供输出。出口费用税费(以微单位表示)。 |
exportChargeTotalAmountMicros |
仅供输出。出口费用总额(以微单位表示)。 |
subtotalAmountMicros |
仅供输出。服务期内可归因于帐号的税前小计总额(以微单位表示)。 |
taxAmountMicros |
仅供输出。在服务期间可计入帐号的总税额(以微单位表示)。 |
totalAmountMicros |
仅供输出。服务期间可计入帐号的总金额(以微单位表示)。这等于 subtotalAmountMicros 和 taxAmountMicros 的总和。 |