- HTTP isteği
- Yol parametreleri
- Sorgu parametreleri
- İstek metni
- Yanıt metni
- Yetkilendirme kapsamları
- Fatura
- InvoiceType
- AccountBudgetSummary
- InvalidActivitySummary
- AccountSummary
- Deneyin.
Belirli bir ay için faturalandırma ayarları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/v14/customers/{customerId}/invoices
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Yol parametreleri
Parametreler | |
---|---|
customerId |
Zorunlu. Faturalarını alınacak müşterinin kimliği. |
Sorgu parametreleri
Parametreler | |
---|---|
billingSetup |
Zorunlu. İstenen faturaların faturalandırma ayarları kaynağı adı.
|
issueYear |
Zorunlu. Faturaların yyyy biçimindeki düzenlenme yılı. Yalnızca 2019 veya sonrasında kesilen faturalar alınabilir. |
issueMonth |
Zorunlu. Faturaların alındığı 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 ( |
Alanlar | |
---|---|
invoices[] |
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'a Genel Bakış başlıklı makaleye bakın.
Fatura
Fatura. Tüm fatura bilgileri, PDF faturayla eşleşecek şekilde anlık olarak görüntülenir. InvoiceService'in kullanıma sunulmasından daha eski faturalarda anlık görüntü alınan bilgiler PDF faturayla eşleşmeyebilir.
JSON gösterimi |
---|
{ "resourceName": string, "type": enum ( |
Alanlar | |
---|---|
resourceName |
Yalnızca çıkış. Faturanın kaynak adı. Belirli bir faturayı birden çok müşteri paylaşabilir. Bu nedenle, birden fazla kaynak adı aynı faturayı gösterebilir. Fatura kaynak adları şu biçimdedir:
|
type |
Yalnızca çıkış. Faturanın türü. |
serviceDateRange |
Yalnızca çıkış. Bu faturanın hizmet dönemi tarih aralığı. Bitiş tarihi dahildir. |
adjustmentsSubtotalAmountMicros |
Yalnızca çıkış. Fatura seviyesindeki düzenlemelerin vergi öncesi ara toplam tutarı (mikrosaniye cinsinden). |
adjustmentsTaxAmountMicros |
Yalnızca çıkış. Fatura seviyesindeki düzenlemelerdeki vergilerin toplamı (mikrosaniye cinsinden). |
adjustmentsTotalAmountMicros |
Yalnızca çıkış. Fatura seviyesindeki düzenlemelerin mikro cinsinden toplam tutarı. |
regulatoryCostsSubtotalAmountMicros |
Yalnızca çıkış. Fatura düzeyindeki yasal maliyetlerin vergi öncesi ara toplam tutarı (mikro ölçekte). |
regulatoryCostsTaxAmountMicros |
Yalnızca çıkış. Fatura düzeyindeki yasal maliyetlerin vergilerin toplamı (mikrosaniye cinsinden). |
regulatoryCostsTotalAmountMicros |
Yalnızca çıkış. Fatura düzeyindeki yasal maliyetlerin mikro cinsinden toplam tutarı. |
replacedInvoices[] |
Yalnızca çıkış. Yeniden düzenlenen veya bu faturayla değiştirilen orijinal faturaların kaynak adı(varsa). Fatura birleştirme nedeniyle birden fazla fatura değiştirilmiş olabilir. Değiştirilen faturalar aynı ödeme hesabına ait olmayabilir.
|
accountBudgetSummaries[] |
Yalnızca çıkış. Bu faturayla ilişkili özet hesap bütçesi bilgilerinin listesi. |
accountSummaries[] |
Yalnızca çıkış. Bu faturayla ilişkili özet hesap bilgilerinin listesi. |
id |
Yalnızca çıkış. Faturanın kimliği. Fatura PDF'sinde "Fatura numarası" olarak görünür. |
billingSetup |
Yalnızca çıkış. Bu faturanın faturalandırma ayarlarının kaynak adı.
|
paymentsAccountId |
Yalnızca çıkış. Faturalandırma kurulumuyla ilişkili ödeme hesabını tanımlamak için kullanılan 16 haneli kimlik (ör. "1234-5678-9012-3456"). Bu numara, fatura PDF'sinde "Faturalandırma Hesabı Numarası" olarak görünür. |
paymentsProfileId |
Yalnızca çıkış. Faturalandırma ayarlarıyla ilişkili ödeme profilini tanımlamak için kullanılan 12 haneli kimlik (ör. "1234-5678-9012"). Bu numara, fatura PDF'sinde "Faturalandırma Kimliği" olarak görünür. |
issueDate |
Yalnızca çıkış. yyyy-aa-gg biçiminde verilme tarihi. Fatura PDF'sinde "Düzenlenme tarihi" veya "Fatura tarihi" olarak görünür. |
dueDate |
Yalnızca çıkış. yyyy-aa-gg biçiminde teslim tarihi. |
currencyCode |
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 alt kümesi desteklenir. |
exportChargeSubtotalAmountMicros |
Yalnızca çıkış. Fatura düzeyinde ihracat masraflarının vergi öncesi ara toplam tutarı (mikrosaniye cinsinden). |
exportChargeTaxAmountMicros |
Yalnızca çıkış. Fatura düzeyinde ihracat masraflarının vergilerinin toplamı (mikrosaniye cinsinden). |
exportChargeTotalAmountMicros |
Yalnızca çıkış. Fatura düzeyinde dışa aktarma masraflarının mikro cinsinden toplam tutarı. |
subtotalAmountMicros |
Yalnızca çıkış. Vergi öncesi ara toplam tutarı (mikro cinsinden). Bu değer, AccountBudgetSummary alt toplam tutarları ile Invoice.adjustments_subtotal_amount_micros değerlerinin toplamına eşittir. |
taxAmountMicros |
Yalnızca çıkış. Faturadaki tüm vergilerin mikro cinsinden toplamı. Bu tutar, Hesap Bütçe Özeti vergi tutarlarının yanı sıra belirli bir hesap bütçesiyle ilişkili olmayan vergilerin toplamına eşittir. |
totalAmountMicros |
Yalnızca çıkış. Mikro cinsinden toplam tutar. Bu, Invoice.subtotal_amount_micros, Faturalar. |
correctedInvoice |
Yalnızca çıkış. Orijinal faturanın kaynak adı (varsa) bu fatura tarafından düzeltildi veya iptal edildi.
|
pdfUrl |
Yalnızca çıkış. Faturanın PDF kopyasının URL'si. Kullanıcıların, PDF dosyasını bu URL'yle istemek için OAuth jetonlarını iletmesi gerekir. |
InvoiceType
Olası fatura türleri.
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 tutarı olan bir fatura. Hesaba kredi aktarılır. |
INVOICE |
Pozitif tutarlı bir fatura. Hesabın bakiye borcu. |
AccountBudgetSummary
Özetlenmiş bir hesap bütçesi faturalandırılabilir maliyetini temsil eder.
JSON gösterimi |
---|
{ "billableActivityDateRange": { object ( |
Alanlar | |
---|---|
billableActivityDateRange |
Yalnızca çıkış. Hesap bütçesinin, bu faturanın hizmet tarihi aralığı içindeki faturalandırılabilir etkinlik tarih aralığı. Bitiş tarihi dahildir. Bu zaman aralığı, hesap bütçesinin başlangıç ve bitiş zamanından farklı olabilir. |
invalidActivitySummaries[] |
Yalnızca çıkış. Orijinal bağlantılara sahip özetlenmiş geçersiz etkinlik kredilerinin listesi. |
customer |
Yalnızca çıkış. Bu hesap bütçesiyle ilişkilendirilmiş müşterinin kaynak adı. Bu öğe, fatura PDF dosyasında "Account ID" olarak görünen müşteri kimliğini içerir. Müşteri kaynakları adları şu biçimdedir:
|
customerDescriptiveName |
Yalnızca çıkış. Hesap bütçesi müşterisinin açıklayıcı adı. Fatura PDF'sinde "Hesap" olarak görünür. |
accountBudget |
Yalnızca çıkış. Bu özet faturalandırılabilir maliyetle ilişkili hesap bütçesinin kaynak adı. Hesap Bütçesi kaynak adları şu biçimdedir:
|
accountBudgetName |
Yalnızca çıkış. Hesap bütçesinin adı. Fatura PDF'sinde "Hesap bütçesi" olarak görünür. |
purchaseOrderNumber |
Yalnızca çıkış. Hesap bütçesinin satın alma siparişi numarası. Fatura PDF'sinde "Satın alma siparişi" olarak görünür. |
subtotalAmountMicros |
Yalnızca çıkış. Hizmet dönemi boyunca bu bütçeyle ilişkilendirilebilecek vergi öncesi ara toplam tutarı (mikrosaniye cinsinden). |
taxAmountMicros |
Yalnızca çıkış. Hizmet dönemi boyunca bu bütçeyle ilişkilendirilebilen vergi tutarı (mikrosaniye cinsinden). |
totalAmountMicros |
Yalnızca çıkış. Hizmet dönemi boyunca bu bütçeyle ilişkilendirilebilecek toplam tutar (mikrosaniye cinsinden). Bu tutar, hesap bütçesi ara toplam tutarı ile hesap bütçesi vergi tutarının toplamına eşittir. |
servedAmountMicros |
Yalnızca çıkış. Hizmet dönemi boyunca bu bütçeyle ilişkilendirilebilen vergi hariç tutar (mikrosaniye cinsinden). Bu yalnızca fatura ve teslimat verilerini mutabık kılmak için yararlıdır. |
billedAmountMicros |
Yalnızca çıkış. Hizmet dönemi boyunca bu bütçeyle ilişkilendirilebilen vergi hariç faturalandırılmış tutar (mikrosaniye cinsinden). Bu, herhangi bir düzenlemeyi hesaba katmaz. |
overdeliveryAmountMicros |
Yalnızca çıkış. Hizmet dönemi boyunca bu bütçeyle ilişkilendirilebilen fazla yayın için vergi hariç tutar (mikro cinsinden (negatif değer). |
invalidActivityAmountMicros |
Yalnızca çıkış. Önceki aylarda bu bütçeyle ilişkilendirilebilen geçersiz etkinlik tutarının mikro cinsinden (negatif değer) değeri. |
InvalidActivitySummary
Faturayla ilgili geçersiz etkinlikle ilgili, düzeltmeler yapılan faturayla ilgili ek ayrıntıları içeren ayrıntılar.
JSON gösterimi |
---|
{
"originalMonthOfService": enum ( |
Alanlar | |
---|---|
originalMonthOfService |
Yalnızca çıkış. Bu geçersiz etkinlik kredisiyle ilgili orijinal hizmet ayı. |
originalYearOfService |
Yalnızca çıkış. Bu geçersiz etkinlik kredisiyle ilgili orijinal hizmet yılı. |
originalInvoiceId |
Yalnızca çıkış. Bu geçersiz etkinlik kredisine ait orijinal fatura numarası. |
originalAccountBudgetName |
Yalnızca çıkış. Bu geçersiz etkinlik kredisiyle ilgili orijinal hesap bütçesi adı. |
originalPurchaseOrderNumber |
Yalnızca çıkış. Bu geçersiz etkinlik kredisiyle ilgili orijinal satın alma siparişi numarası. |
amountMicros |
Yalnızca çıkış. Mikro cinsinden geçersiz etkinlik miktarı. |
AccountSummary
Hesap düzeyinde özet 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 |
Yalnızca çıkış. Hesap özetiyle ilişkilendirilen hesap. |
billingCorrectionSubtotalAmountMicros |
Yalnızca çıkış. Vergi öncesi faturalandırma düzeltmesi ara toplam tutarı (mikro cinsinden). |
billingCorrectionTaxAmountMicros |
Yalnızca çıkış. Fatura düzeltme vergisi (mikrosaniye cinsinden). |
billingCorrectionTotalAmountMicros |
Yalnızca çıkış. Toplam faturalandırma düzeltme tutarı (mikro cinsinden). |
couponAdjustmentSubtotalAmountMicros |
Yalnızca çıkış. Vergi öncesi kupon düzenlemesi ara toplam tutarı (mikro cinsinden). |
couponAdjustmentTaxAmountMicros |
Yalnızca çıkış. Kupon düzenleme vergisi (mikrosaniye cinsinden). |
couponAdjustmentTotalAmountMicros |
Yalnızca çıkış. Toplam kupon düzenleme tutarı (mikrosaniye cinsinden). |
excessCreditAdjustmentSubtotalAmountMicros |
Yalnızca çıkış. Vergi öncesi artı kredi düzenleme ara toplam tutarı (mikro cinsinden). |
excessCreditAdjustmentTaxAmountMicros |
Yalnızca çıkış. Fazla kredi düzenlemesi vergisi (mikro ölçekte). |
excessCreditAdjustmentTotalAmountMicros |
Yalnızca çıkış. Toplam fazladan kredi düzenleme tutarı (mikrosaniye cinsinden). |
regulatoryCostsSubtotalAmountMicros |
Yalnızca çıkış. Vergi öncesi yasal maliyetlerin mikro cinsinden ara toplam tutarı. |
regulatoryCostsTaxAmountMicros |
Yalnızca çıkış. Yasal maliyetlerle ilgili vergi (mikro ölçekte). |
regulatoryCostsTotalAmountMicros |
Yalnızca çıkış. Toplam yasal maliyet tutarı (mikro cinsinden). |
exportChargeSubtotalAmountMicros |
Yalnızca çıkış. Vergi öncesi dışa aktarma ücreti ara toplam tutarı (mikro cinsinden). |
exportChargeTaxAmountMicros |
Yalnızca çıkış. İhracat ücreti vergisi (mikrosaniye cinsinden). |
exportChargeTotalAmountMicros |
Yalnızca çıkış. Mikro cinsinden toplam ihracat ücreti tutarı. |
subtotalAmountMicros |
Yalnızca çıkış. Hizmet dönemi süresince hesapla ilişkilendirilebilecek toplam vergi öncesi ara toplam tutarı (mikrosaniye cinsinden). |
taxAmountMicros |
Yalnızca çıkış. Hizmet dönemi süresince hesapla ilişkilendirilebilecek toplam vergi tutarı (mikro ölçekte). |
totalAmountMicros |
Yalnızca çıkış. Hizmet dönemi süresince hesapla ilişkilendirilebilecek toplam tutar (mikrosaniye cinsinden). Bu, alttotalAmountMicros ve taxAmountMicros toplamına eşittir. |