本頁面由 Cloud Translation API 翻譯而成。

應付憑據

您可以使用 InvoiceService 擷取 Google Ads 帳戶的月結單。

必要條件

為 Google Ads 帳戶啟用月結。請參閱帳戶帳單設定和預算指南，瞭解如何使用 Google Ads API 管理帳單。
如果已設定，login-customer-id 必須指定管理員帳戶的客戶 ID，該帳戶負責管理您要擷取月結單的 Google Ads 帳戶。在 Google Ads 使用者介面中，這會標示為「付款管理員」。

擷取月結單

如要擷取月結單，您必須要求 InvoiceService.ListInvoices 方法，並在 ListInvoicesRequest 中設定所有必要欄位：customer_id、billing_setup、issue_year 和 issue_month。

如果您已設定合併帳單，Google Ads API 會傳回相同帳單設定下所有客戶的月結單，而不只是 API 要求中指定的 customer_id 月結單。

customer_id必須是 Google Ads 放送帳戶。如要取得付款管理員的所有月結單，請為每個 Google Ads 放送帳戶提出要求。

範例如下：

Java

// Issues the request.
ListInvoicesResponse response =
    invoiceServiceClient.listInvoices(
        String.valueOf(customerId),
        ResourceNames.billingSetup(customerId, billingSetupId),
        String.valueOf(oneMonthAgo.getYear()),
        MonthOfYear.valueOf(oneMonthAgo.getMonth().toString()));GetInvoices.java

C#

ListInvoicesResponse response = invoiceServiceClient.ListInvoices(customerId.ToString(),
    ResourceNames.BillingSetup(customerId, billingSetupId),
    // Year must be 2019 or later.
    lastMonthDateTime.Year.ToString("yyyy"),
    lastMonth);GetInvoices.cs

PHP

// Issues the request.
$response = $googleAdsClient->getInvoiceServiceClient()->listInvoices(
    ListInvoicesRequest::build(
        $customerId,
        ResourceNames::forBillingSetup($customerId, $billingSetupId),
        // The year needs to be 2019 or later.
        date('Y', $lastMonth),
        MonthOfYear::value(strtoupper(date('F', $lastMonth)))
    )
);GetInvoices.php

`AccountBudgetSummary`	評估規則
`served_amount_micros`	$account\_budget\_served$
`billed_amount_micros`	$account\_budget\_billed$
`overdelivery_amount_micros`	$account\_budget\_overdelivery$
`invalid_activity_amount_micros`	$account\_budget\_invalid\_activity$
`subtotal_amount_micros`	$account\_budget\_pretax$
`tax_amount_micros`	$account\_budget\_tax$
`total_amount_micros`	$account\_budget\_pretax + $ $account\_budget\_tax$

`AccountSummary`	評估規則
`billing_correction_subtotal_amount_micros`	$account\_billing\_correction\_pretax$
`coupon_adjustment_subtotal_amount_micros`	$account\_coupon\_adjustment\_pretax$
`excess_credit_adjustment_subtotal_amount_micros`	$account\_excess\_credit\_adjustment\_pretax$
`regulatory_costs_subtotal_amount_micros`	$account\_regulatory\_costs\_pretax$
`export_charge_subtotal_amount_micros`	$account\_export\_charge\_pretax$
`billing_correction_tax_amount_micros`	$account\_billing\_correction\_tax$
`coupon_adjustment_tax_amount_micros`	$account\_coupon\_adjustment\_tax$
`excess_credit_adjustment_tax_amount_micros`	$account\_excess\_credit\_adjustment\_tax$
`regulatory_costs_tax_amount_micros`	$account\_regulatory\_costs\_tax$
`export_charge_tax_amount_micros`	$account\_export\_charge\_tax$
`billing_correction_total_amount_micros`	$account\_billing\_correction\_pretax + $ $account\_billing\_correction\_tax$
`coupon_adjustment_total_amount_micros`	$account\_coupon\_adjustment\_pretax + $ $account\_coupon\_adjustment\_tax$
`excess_credit_adjustment_total_amount_micros`	$account\_excess\_credit\_adjustment\_pretax + $ $account\_excess\_credit\_adjustment\_tax$
`regulatory_costs_total_amount_micros`	$account\_regulatory\_costs\_pretax + $ $account\_regulatory\_costs\_tax$
`export_charge_total_amount_micros`	$account\_export\_charge\_pretax + $ $account\_export\_charge\_tax$
`subtotal_amount_micros`	$account\_pretax$
`tax_amount_micros`	$account\_tax$
`total_amount_micros`	$account\_pretax + $ $account\_tax$

`Invoice`	評估規則
`adjustments_subtotal_amount_micros`	$\sum_{i=1}^n account\_billing\_correction\_pretax_i + $ $\sum_{i=1}^n account\_coupon\_adjustment\_pretax_i + $ $\sum_{i=1}^n account\_excess\_credit\_adjustment\_pretax_i$
`regulatory_costs_subtotal_amount_micros`	$\sum_{i=1}^n account\_regulatory\_costs\_pretax_i$
`export_charge_subtotal_amount_micros`	$\sum_{i=1}^n account\_export\_charge\_pretax_i$
`adjustments_tax_amount_micros`	$\sum_{i=1}^n account\_billing\_correction\_tax_i + $ $\sum_{i=1}^n account\_coupon\_adjustment\_tax_i + $ $\sum_{i=1}^n account\_excess\_credit\_adjustment\_tax_i$
`regulatory_costs_tax_amount_micros`	$\sum_{i=1}^n account\_regulatory\_costs\_tax_i$
`export_charge_tax_amount_micros`	$\sum_{i=1}^n account\_export\_charge\_tax_i$
`adjustments_total_amount_micros`	$adjustments\_pretax + $ $adjustments\_tax$
`regulatory_costs_total_amount_micros`	$regulatory\_costs\_pretax + $ $regulatory\_costs\_tax$
`export_charge_total_amount_micros`	$export\_charge\_pretax + $ $export\_charge\_tax$
`subtotal_amount_micros`	$adjustments\_pretax + $ $\sum_{i=1}^n account\_budget\_pretax_i$
`tax_amount_micros`	$adjustments\_tax + $ $regulatory\_costs\_tax + $ $export\_charge\_tax + $ $\sum_{i=1}^n account\_budget\_tax_i$
`total_amount_micros`	$pretax + $ $regulatory\_costs\_pretax + $ $export\_charge\_pretax + $ $tax$

情境	錯誤代碼
缺少或空白的帳單設定、發行年份或發行月份。	`RequestError.REQUIRED_FIELD_MISSING`
無法剖析指定的帳單設定、發行年份或發行月份。	`FieldError.INVALID_VALUE`
要求提供 2019 年 1 月 1 日前的月結單。	`InvoiceError.YEAR_MONTH_TOO_OLD`
要求是針對未收到月結單的客戶。	`InvoiceError.NOT_INVOICED_CUSTOMER`
使用者沒有權限查看帳單設定的月結單。	`AuthorizationError.ACTION_NOT_PERMITTED`

應付憑據

必要條件

擷取月結單

Java

C#

PHP

Python

Ruby

Perl

curl

取得預算詳細資料

取得帳戶詳細資料

瞭解金額

Java

C#

PHP

Python

Ruby

Perl

下載月結單 PDF

常見錯誤代碼

應付憑據 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

必要條件

擷取月結單

Java

C#

PHP

Python

Ruby

Perl

curl

取得預算詳細資料

取得帳戶詳細資料

瞭解金額

Java

C#

PHP

Python

Ruby

Perl

下載月結單 PDF

常見錯誤代碼

應付憑據