Method: customers.invoices.list

Belirli bir ay için bir faturalandırma ayarıyla ilişkili tüm faturaları döndürür.

Atılan hataların listesi: AuthenticationError AuthorizationError FieldError HeaderError InternalError InvoiceError QuotaError RequestError

HTTP isteği

GET https://googleads.googleapis.com/v17/customers/{customerId}/invoices

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
customerId

string

Zorunlu. Faturalarının alınacağı müşterinin kimliği.

Sorgu parametreleri

Parametreler
billingSetup

string

Zorunlu. İstenen faturaların faturalandırma kurulumu kaynak adı.

customers/{customerId}/billingSetups/{billing_setup_id}
issueYear

string

Zorunlu. Faturaların alınacağı, yyyy biçiminde girileceği yıl. Yalnızca 2019 veya sonrasında düzenlenen faturalar alınabilir.
issueMonth

enum (MonthOfYear)

Zorunlu. Faturaların düzenleneceği ay.

İstek içeriği

İstek metni boş olmalıdır.

Yanıt gövdesi

InvoiceService.ListInvoices için yanıt mesajı.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "invoices": [
    {
      object (Invoice)
    }
  ]
}
Alanlar
invoices[]

object (Invoice)

Faturalandırma ayarları ve dönemiyle eşleşen faturaların listesi.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/adwords

Daha fazla bilgi için OAuth 2.0 Overview (OAuth 2.0'a Genel Bakış) sayfasına göz atın.

Fatura

Fatura. Tüm fatura bilgileri, PDF faturayla eşleşecek şekilde anlık olarak görüntülenir. InvoiceService lansmanından daha eski faturalar için anlık görüntü bilgileri PDF faturayla eşleşmeyebilir.

JSON gösterimi 
{
  "resourceName": string,
  "type": enum (InvoiceType),
  "serviceDateRange": {
    object (DateRange)
  },
  "adjustmentsSubtotalAmountMicros": string,
  "adjustmentsTaxAmountMicros": string,
  "adjustmentsTotalAmountMicros": string,
  "regulatoryCostsSubtotalAmountMicros": string,
  "regulatoryCostsTaxAmountMicros": string,
  "regulatoryCostsTotalAmountMicros": string,
  "replacedInvoices": [
    string
  ],
  "accountBudgetSummaries": [
    {
      object (AccountBudgetSummary)
    }
  ],
  "accountSummaries": [
    {
      object (AccountSummary)
    }
  ],
  "id": string,
  "billingSetup": string,
  "paymentsAccountId": string,
  "paymentsProfileId": string,
  "issueDate": string,
  "dueDate": string,
  "currencyCode": string,
  "exportChargeSubtotalAmountMicros": string,
  "exportChargeTaxAmountMicros": string,
  "exportChargeTotalAmountMicros": string,
  "subtotalAmountMicros": string,
  "taxAmountMicros": string,
  "totalAmountMicros": string,
  "correctedInvoice": string,
  "pdfUrl": string
}
Alanlar
resourceName

string

Yalnızca çıkış. Faturanın kaynak adı. Belirli bir faturayı birden çok müşteri paylaşabilir. Bu nedenle, birden çok kaynak adı aynı faturaya işaret edebilir. Fatura kaynağı adları şu şekildedir:

customers/{customerId}/invoices/{invoice_id}
type

enum (InvoiceType)

Yalnızca çıkış. Faturanın türü.
serviceDateRange

object (DateRange)

Yalnızca çıkış. Bu faturanın hizmet dönemi tarih aralığı. Bitiş tarihi dahildir.
adjustmentsSubtotalAmountMicros

string (int64 format)

Yalnızca çıkış. Fatura seviyesi düzenlemelerinin vergi öncesi ara toplam tutarı (mikrosaniye cinsinden).
adjustmentsTaxAmountMicros

string (int64 format)

Yalnızca çıkış. Fatura düzeyinde düzenlemelerdeki vergilerin mikro cinsinden toplamı.
adjustmentsTotalAmountMicros

string (int64 format)

Yalnızca çıkış. Fatura düzeyinde düzenlemelerin mikro cinsinden toplam tutarı.
regulatoryCostsSubtotalAmountMicros

string (int64 format)

Yalnızca çıkış. Fatura düzeyindeki yasal maliyetlerin vergi öncesi ara toplamı (mikrosaniye cinsinden).
regulatoryCostsTaxAmountMicros

string (int64 format)

Yalnızca çıkış. Fatura düzeyinde yasal maliyetler üzerindeki vergilerin mikro cinsinden toplamı.
regulatoryCostsTotalAmountMicros

string (int64 format)

Yalnızca çıkış. Fatura düzeyinde yasal maliyetlerin mikro cinsinden toplam tutarı.
replacedInvoices[]

string

Yalnızca çıkış. Yeniden düzenlenen veya(varsa) bu faturayla değiştirilen orijinal faturaların kaynak adı. Fatura birleştirme nedeniyle değiştirilmiş birden fazla fatura olabilir. Değiştirilen faturalar aynı ödeme hesabına ait olmayabilir. replacedInvoices ayarlanırsa correctedInvoice ayarlanmaz. Fatura kaynağı adları şu şekildedir:

customers/{customerId}/invoices/{invoice_id}
accountBudgetSummaries[]

object (AccountBudgetSummary)

Yalnızca çıkış. Bu faturayla ilişkili hesap bütçesi bilgilerinin özetlenmiş listesi.
accountSummaries[]

object (AccountSummary)

Yalnızca çıkış. Bu faturayla ilişkili hesap bilgilerinin özet listesi.
id

string

Yalnızca çıkış. Faturanın kimliği. Fatura PDF'sinde "Fatura numarası" olarak görünür.
billingSetup

string

Yalnızca çıkış. Bu faturanın faturalandırma ayarlarının kaynak adı.

customers/{customerId}/billingSetups/{billing_setup_id}
paymentsAccountId

string

Yalnızca çıkış. Faturalandırma ayarlarıyla ilişkili ödeme hesabını tanımlamak için kullanılan 16 haneli kimlik (ör. "1234-5678-9012-3456"). Fatura PDF'sinde "Faturalandırma Hesabı Numarası" olarak görünür.
paymentsProfileId

string

Yalnızca çıkış. Faturalandırma ayarlarıyla ilişkili ödeme profilini tanımlamak için kullanılan 12 haneli kimlik (ör. "1234-5678-9012"). Fatura PDF'sinde "Faturalandırma Kimliği" olarak görünür.
issueDate

string

Yalnızca çıkış. yyyy-aa-gg biçiminde verilen yayın tarihi. Fatura PDF'sinde "Düzenlenme tarihi" olarak görünür veya "Fatura tarihi".
dueDate

string

Yalnızca çıkış. yyyy-aa-gg biçiminde son tarih.
currencyCode

string

Yalnızca çıkış. Para birimi kodu. Tüm maliyetler bu para biriminde döndürülür. ISO 4217 standardından türetilen para birimi kodlarının bir alt kümesi desteklenir.
exportChargeSubtotalAmountMicros

string (int64 format)

Yalnızca çıkış. Fatura düzeyinde ihracat masraflarının mikro cinsinden vergi öncesi ara toplam tutarı.
exportChargeTaxAmountMicros

string (int64 format)

Yalnızca çıkış. Fatura düzeyinde dışa aktarma ücretlerindeki vergilerin mikro cinsinden toplamı.
exportChargeTotalAmountMicros

string (int64 format)

Yalnızca çıkış. Fatura düzeyinde dışa aktarma ücretlerinin mikro cinsinden toplam tutarı.
subtotalAmountMicros

string (int64 format)

Yalnızca çıkış. Mikro cinsinden vergi öncesi ara toplam miktarı. Bu, HesapBütçeÖzeti ara toplam tutarlarının ve Invoice.adjustments_subtotal_amount_micros
taxAmountMicros

string (int64 format)

Yalnızca çıkış. Faturadaki tüm vergilerin mikro cinsinden toplamı. Bu, Hesap BütçesiÖzeti vergi tutarlarının ve belirli bir hesap bütçesiyle ilişkili olmayan vergilerin toplamına eşittir.
totalAmountMicros

string (int64 format)

Yalnızca çıkış. Mikro cinsinden toplam tutar. Bu, Invoice.subtotal_amount_micros, Invoice.tax_amount_micros, Invoice.regulatory_costs_subtotal_amount_micros ve Invoice.export_charge_subtotal_amount_micros (V14.1'den itibaren ayrı bir satır öğesine ayrılır) toplamına eşittir.
correctedInvoice

string

Yalnızca çıkış. Bu fatura tarafından düzeltilen, iptal edilen veya (varsa) orijinal faturanın kaynak adı. correctedInvoice ayarlanırsa replacedInvoices ayarlanmaz. Fatura kaynağı adları şu şekildedir:

customers/{customerId}/invoices/{invoice_id}
pdfUrl

string

Yalnızca çıkış. Faturanın PDF kopyasının URL'si. Kullanıcıların, bu URL'yi içeren PDF dosyasını istemek için OAuth jetonlarını iletmeleri gerekir.

InvoiceType

Olası fatura türü.

Sıralamalar
UNSPECIFIED Belirtilmedi.
UNKNOWN Yalnızca döndürülen değer için kullanılır. Bu sürümde bilinmeyen değeri temsil eder.
CREDIT_MEMO Negatif tutarda bir fatura. Hesap bir kredi alır.
INVOICE Pozitif tutarda bir fatura. Hesabın bakiye borcu olmalıdır.

AccountBudgetSummary

Hesap bütçesi faturalandırılabilir maliyetinin özetini temsil eder.

JSON gösterimi 
{
  "billableActivityDateRange": {
    object (DateRange)
  },
  "invalidActivitySummaries": [
    {
      object (InvalidActivitySummary)
    }
  ],
  "customer": string,
  "customerDescriptiveName": string,
  "accountBudget": string,
  "accountBudgetName": string,
  "purchaseOrderNumber": string,
  "subtotalAmountMicros": string,
  "taxAmountMicros": string,
  "totalAmountMicros": string,
  "servedAmountMicros": string,
  "billedAmountMicros": string,
  "overdeliveryAmountMicros": string,
  "invalidActivityAmountMicros": string
}
Alanlar
billableActivityDateRange

object (DateRange)

Yalnızca çıkış. Bu faturanın hizmet tarihi aralığında yer alan, hesap bütçesinin faturalandırılabilir etkinlik tarih aralığı. Bitiş tarihi dahildir. Bu tarih, hesap bütçesinin başlangıç ve bitiş zamanından farklı olabilir.
invalidActivitySummaries[]

object (InvalidActivitySummary)

Yalnızca çıkış. Orijinal bağlantılara sahip geçersiz etkinlik kredilerinin özetlenmiş listesi.
customer

string

Yalnızca çıkış. Bu hesap bütçesiyle ilişkili müşterinin kaynak adı. Bu bilgiler, fatura PDF'sinde "Hesap Kimliği" olarak görünen müşteri kimliğini içerir. Müşteri kaynağı adları şu şekildedir:

customers/{customerId}
customerDescriptiveName

string

Yalnızca çıkış. Hesap bütçesi müşterisinin açıklayıcı adı. PDF'de "Hesap" olarak görünür.
accountBudget

string

Yalnızca çıkış. Bu özetlenmiş faturalandırılabilir maliyetle ilişkili hesap bütçesinin kaynak adı. Hesap Bütçesi kaynak adları şu şekildedir:

customers/{customerId}/accountBudgets/{account_budget_id}
accountBudgetName

string

Yalnızca çıkış. Hesap bütçesinin adı. Fatura PDF'sinde "Hesap bütçesi" olarak görünür.
purchaseOrderNumber

string

Yalnızca çıkış. Hesap bütçesinin satın alma siparişi numarası. PDF'de "Satın alma siparişi" olarak görünür.
subtotalAmountMicros

string (int64 format)

Yalnızca çıkış. Hizmet dönemi boyunca bu bütçeyle ilişkilendirilebilen vergi öncesi ara toplam tutarı (mikrosaniye cinsinden).
taxAmountMicros

string (int64 format)

Yalnızca çıkış. Hizmet dönemi boyunca bu bütçeyle ilişkilendirilebilen vergi tutarı (mikrosaniye).
totalAmountMicros

string (int64 format)

Yalnızca çıkış. Mikro cinsinden hizmet dönemi boyunca bu bütçeyle ilişkilendirilebilen toplam tutar. Bu, hesap bütçesi ara toplamı ile hesap bütçesi vergi tutarının toplamına eşittir.
servedAmountMicros

string (int64 format)

Yalnızca çıkış. Hizmet dönemi boyunca bu bütçeyle ilişkilendirilebilecek vergi öncesi dağıtım tutarı (mikrosaniye). Bu yalnızca fatura ve yayın verilerinin mutabakatını sağlamak için yararlıdır.
billedAmountMicros

string (int64 format)

Yalnızca çıkış. Hizmet dönemi boyunca bu bütçeyle ilişkilendirilebilen vergi öncesi faturalandırılan tutar (mikrosaniye). Bu değerde herhangi bir düzenleme dikkate alınmaz.
overdeliveryAmountMicros

string (int64 format)

Yalnızca çıkış. Hizmet dönemi boyunca bu bütçeye atfedilebilecek vergi öncesi fazla yayın tutarı, mikro olarak (negatif değer).
invalidActivityAmountMicros

string (int64 format)

Yalnızca çıkış. Önceki aylarda bu bütçeyle ilişkilendirilebilecek vergi öncesi geçersiz etkinlik tutarı (mikrosaniye cinsinden) (negatif değer).

InvalidActivitySummary

Düzeltmelerin yapıldığı fatura hakkında ek ayrıntıları içeren, faturadaki geçersiz etkinlikle ilgili ayrıntılar.

JSON gösterimi 
{
  "originalMonthOfService": enum (MonthOfYear),
  "originalYearOfService": string,
  "originalInvoiceId": string,
  "originalAccountBudgetName": string,
  "originalPurchaseOrderNumber": string,
  "amountMicros": string
}
Alanlar
originalMonthOfService

enum (MonthOfYear)

Yalnızca çıkış. Bu geçersiz etkinlik kredisiyle ilgili hizmetin ilk ayı.
originalYearOfService

string

Yalnızca çıkış. Bu geçersiz etkinlik kredisiyle ilgili hizmetin ilk yılı.
originalInvoiceId

string

Yalnızca çıkış. Bu geçersiz etkinlik kredisine ilişkin orijinal fatura numarası.
originalAccountBudgetName

string

Yalnızca çıkış. Bu geçersiz etkinlik kredisiyle ilgili orijinal hesap bütçesi adı.
originalPurchaseOrderNumber

string

Yalnızca çıkış. Bu geçersiz etkinlik kredisiyle ilgili orijinal satın alma siparişi numarası.
amountMicros

string (int64 format)

Yalnızca çıkış. Mikro cinsinden geçersiz etkinlik miktarı.

AccountSummary

Hesap düzeyinde özetlenmiş bir görünümü temsil eder.

JSON gösterimi 
{
  "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
}
Alanlar
customer

string

Yalnızca çıkış. Hesap özetiyle ilişkilendirilen hesap.
billingCorrectionSubtotalAmountMicros

string (int64 format)

Yalnızca çıkış. Vergi öncesi faturalandırma düzeltmesi ara toplam tutarı (mikrosaniye).
billingCorrectionTaxAmountMicros

string (int64 format)

Yalnızca çıkış. Faturalandırma düzeltme vergisi (mikrosaniye cinsinden).
billingCorrectionTotalAmountMicros

string (int64 format)

Yalnızca çıkış. Faturalandırma düzeltme toplamı (mikrosaniye cinsinden).
couponAdjustmentSubtotalAmountMicros

string (int64 format)

Yalnızca çıkış. Vergi öncesi kupon düzenlemesi ara toplam tutarı (mikrosaniye).
couponAdjustmentTaxAmountMicros

string (int64 format)

Yalnızca çıkış. Kupon düzenlemesi vergisi, mikro olarak.
couponAdjustmentTotalAmountMicros

string (int64 format)

Yalnızca çıkış. Mikro cinsinden toplam kupon düzenleme tutarı.
excessCreditAdjustmentSubtotalAmountMicros

string (int64 format)

Yalnızca çıkış. Vergi öncesi fazla kredi düzenlemesi ara toplamı (mikrosaniye cinsinden).
excessCreditAdjustmentTaxAmountMicros

string (int64 format)

Yalnızca çıkış. Fazla kredi düzenlemesi vergisi, mikro olarak hesaplanır.
excessCreditAdjustmentTotalAmountMicros

string (int64 format)

Yalnızca çıkış. Toplam fazla kredi düzenleme tutarı (mikrosaniye cinsinden).
regulatoryCostsSubtotalAmountMicros

string (int64 format)

Yalnızca çıkış. Vergi öncesi yasal maliyetlerin mikro cinsinden toplam tutarı.
regulatoryCostsTaxAmountMicros

string (int64 format)

Yalnızca çıkış. Mikro cinsinden yasal maliyet vergisi.
regulatoryCostsTotalAmountMicros

string (int64 format)

Yalnızca çıkış. Mikro cinsinden toplam yasal maliyet tutarı.
exportChargeSubtotalAmountMicros

string (int64 format)

Yalnızca çıkış. Vergi öncesi dışa aktarma ücreti ara toplam tutarı (mikrosaniye cinsinden).
exportChargeTaxAmountMicros

string (int64 format)

Yalnızca çıkış. İhracat ücreti vergisi (mikro ölçekte).
exportChargeTotalAmountMicros

string (int64 format)

Yalnızca çıkış. Toplam ihracat ücreti tutarı (mikrosaniye cinsinden).
subtotalAmountMicros

string (int64 format)

Yalnızca çıkış. Hizmet dönemi boyunca hesapla ilişkilendirilebilecek, mikro cinsinden toplam vergi öncesi ara toplam tutar.
taxAmountMicros

string (int64 format)

Yalnızca çıkış. Hizmet dönemi boyunca hesapla ilişkilendirilebilen toplam vergi tutarı (mikrosaniye).
totalAmountMicros

string (int64 format)

Yalnızca çıkış. Hizmet dönemi boyunca hesapla ilişkilendirilebilen toplam tutar (mikrosaniye). Bu, subtotalAmountMicros ve taxAmountMicros değerlerinin toplamına eşittir.