Se usó la API de Cloud Translation para traducir esta página.

Factura

Las facturas mensuales de una cuenta de Google Ads se pueden recuperar con InvoiceService.

Requisitos previos

Tener habilitada la facturación mensual para la cuenta de Google Ads Consulta las guías sobre la configuración de la facturación y los presupuestos de la cuenta para obtener información sobre cómo administrar la facturación con la API de Google Ads.
Si se configura, login-customer-id debe especificar el ID de cliente de una cuenta de administrador que administre la cuenta de Google Ads para la que recuperas facturas. En la IU de Google Ads, se etiqueta como administrador de pagos.

Recupera facturas

Para recuperar facturas, debes solicitar el método InvoiceService.ListInvoices y configurar todos los campos obligatorios en ListInvoicesRequest: customer_id, billing_setup, issue_year y issue_month.

Si tienes una configuración de facturación consolidada, la API de Google Ads devuelve facturas para todos los clientes que tienen la misma configuración de facturación, no solo la factura del objeto customer_id especificado en la solicitud de la API.

El customer_id debe ser una cuenta de publicación de Google Ads. Para obtener todas las facturas de un administrador de pagos, realiza una solicitud por cuenta de publicación de Google Ads.

A continuación, se muestra un ejemplo:

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`	Regla de evaluación
`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`	Regla de evaluación
`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`	Regla de evaluación
`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$

Situación	Código de error
Falta la configuración de facturación, el año de publicación o el mes de publicación, o bien están vacíos.	`RequestError.REQUIRED_FIELD_MISSING`
No se puede analizar la configuración de facturación, el año de emisión o el mes de emisión proporcionados.	`FieldError.INVALID_VALUE`
La solicitud es para facturas emitidas antes del 1 de enero de 2019.	`InvoiceError.YEAR_MONTH_TOO_OLD`
La solicitud es para un cliente que no recibe facturas.	`InvoiceError.NOT_INVOICED_CUSTOMER`
El usuario no tiene permiso para ver las facturas de la configuración de facturación.	`AuthorizationError.ACTION_NOT_PERMITTED`

Factura

Requisitos previos

Recupera facturas

Java

C#

PHP

Python

Ruby

Perl

curl

Obtén detalles del presupuesto

Obtén detalles de la cuenta

Comprende los importes

Java

C#

PHP

Python

Ruby

Perl

Cómo descargar un PDF de la factura

Códigos de error comunes

Factura Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Requisitos previos

Recupera facturas

Java

C#

PHP

Python

Ruby

Perl

curl

Obtén detalles del presupuesto

Obtén detalles de la cuenta

Comprende los importes

Java

C#

PHP

Python

Ruby

Perl

Cómo descargar un PDF de la factura

Códigos de error comunes

Factura