- Permintaan HTTP
- Parameter lokasi
- Parameter kueri
- Isi permintaan
- Isi respons
- Cakupan otorisasi
- Invoice
- InvoiceType
- AccountBudgetSummary
- InvalidActivitySummary
- AccountSummary
- Cobalah!
Menampilkan semua invoice yang terkait dengan penyiapan penagihan, untuk bulan tertentu.
Daftar error yang ditampilkan: AuthenticationError AuthorizationError FieldError HeaderError InternalError InvoiceError QuotaError RequestError
Permintaan HTTP
GET https://googleads.googleapis.com/v15/customers/{customerId}/invoices
URL menggunakan sintaksis gRPC Transcoding.
Parameter jalur
Parameter | |
---|---|
customerId |
Wajib. ID pelanggan untuk mengambil invoice. |
Parameter kueri
Parameter | |
---|---|
billingSetup |
Wajib. Nama resource penyiapan penagihan dari invoice yang diminta.
|
issueYear |
Wajib. Tahun penerbitan untuk mengambil invoice, dalam format yyyy. Hanya invoice yang dikeluarkan pada tahun 2019 atau yang lebih baru yang dapat diambil. |
issueMonth |
Wajib. Bulan penerbitan untuk mengambil invoice. |
Isi permintaan
Isi permintaan harus kosong.
Isi respons
Pesan respons untuk InvoiceService.ListInvoices
.
Jika berhasil, isi respons memuat data dengan struktur berikut:
Representasi JSON |
---|
{
"invoices": [
{
object ( |
Kolom | |
---|---|
invoices[] |
Daftar invoice yang cocok dengan penyiapan penagihan dan jangka waktu. |
Cakupan otorisasi
Memerlukan cakupan OAuth berikut ini:
https://www.googleapis.com/auth/adwords
Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.
Invoice
Invoice. Semua informasi invoice akan dibuat snapshotnya agar sesuai dengan invoice PDF. Untuk invoice yang lebih lama dari peluncuran InvoiceService, informasi yang diambil mungkin tidak sesuai dengan invoice PDF.
Representasi JSON |
---|
{ "resourceName": string, "type": enum ( |
Kolom | |
---|---|
resourceName |
Hanya output. Nama resource invoice. Beberapa pelanggan dapat berbagi invoice yang ditentukan, sehingga beberapa nama resource dapat mengarah ke invoice yang sama. Nama resource invoice memiliki bentuk:
|
type |
Hanya output. Jenis invoice. |
serviceDateRange |
Hanya output. Rentang tanggal periode layanan invoice ini. Tanggal akhir bersifat inklusif. |
adjustmentsSubtotalAmountMicros |
Hanya output. Jumlah subtotal penyesuaian tingkat invoice sebelum pajak, dalam mikro. |
adjustmentsTaxAmountMicros |
Hanya output. Jumlah pajak pada penyesuaian tingkat invoice, dalam mikro. |
adjustmentsTotalAmountMicros |
Hanya output. Jumlah total penyesuaian tingkat invoice, dalam mikro. |
regulatoryCostsSubtotalAmountMicros |
Hanya output. Jumlah subtotal biaya peraturan tingkat invoice sebelum pajak, dalam mikro. |
regulatoryCostsTaxAmountMicros |
Hanya output. Jumlah pajak pada biaya peraturan tingkat invoice, dalam mikro. |
regulatoryCostsTotalAmountMicros |
Hanya output. Jumlah total biaya peraturan tingkat invoice, dalam mikro. |
replacedInvoices[] |
Hanya output. Nama resource invoice asli yang ditagih kembali atau diganti dengan invoice ini, jika ada. Kemungkinan ada beberapa invoice yang diganti karena konsolidasi invoice. Invoice yang diganti mungkin bukan milik akun pembayaran yang sama. Jika
|
accountBudgetSummaries[] |
Hanya output. Daftar ringkasan informasi anggaran akun yang terkait dengan invoice ini. |
accountSummaries[] |
Hanya output. Daftar ringkasan informasi akun yang terkait dengan invoice ini. |
id |
Hanya output. ID invoice. Alamat tersebut akan tercantum pada PDF invoice sebagai "Nomor invoice". |
billingSetup |
Hanya output. Nama resource penyiapan penagihan invoice ini.
|
paymentsAccountId |
Hanya output. ID 16 digit yang digunakan untuk mengidentifikasi akun pembayaran yang terkait dengan penyiapan penagihan, misalnya, "1234-5678-9012-3456". Alamat tersebut akan muncul pada PDF invoice sebagai "Nomor Rekening Penagihan". |
paymentsProfileId |
Hanya output. ID 12 digit yang digunakan untuk mengidentifikasi profil pembayaran yang terkait dengan penyiapan penagihan, misalnya, "1234-5678-9012". Alamat tersebut akan muncul pada PDF invoice sebagai "ID Penagihan". |
issueDate |
Hanya output. Tanggal penerbitan dalam format yyyy-mm-dd. Pada PDF invoice, tercantum "Tanggal penerbitan" atau "Tanggal invoice". |
dueDate |
Hanya output. Batas waktu dalam format yyyy-mm-dd. |
currencyCode |
Hanya output. Kode mata uang. Semua biaya ditampilkan dalam mata uang ini. Subset kode mata uang yang berasal dari standar ISO 4217 didukung. |
exportChargeSubtotalAmountMicros |
Hanya output. Jumlah subtotal biaya ekspor tingkat invoice sebelum pajak, dalam mikro. |
exportChargeTaxAmountMicros |
Hanya output. Jumlah pajak pada biaya ekspor tingkat invoice, dalam mikro. |
exportChargeTotalAmountMicros |
Hanya output. Jumlah total biaya ekspor tingkat invoice, dalam mikro. |
subtotalAmountMicros |
Hanya output. Jumlah subtotal sebelum pajak, dalam mikro. Jumlah ini sama dengan jumlah subtotal AccountBudgetSummary dan Invoice.adjustments_subtotal_amount_micros. |
taxAmountMicros |
Hanya output. Jumlah semua pajak di invoice, dalam mikro. Ini sama dengan jumlah pajak AccountBudgetSummary, ditambah pajak yang tidak terkait dengan anggaran akun tertentu. |
totalAmountMicros |
Hanya output. Jumlah total, dalam mikro. Ini sama dengan jumlah Invoice.subtotal_amount_micros, Invoice.tax_amount_micros, Invoice.regulatory_costs_subtotal_amount_micros, dan Invoice.export_charge_subtotal_amount_micros (yang dipisahkan menjadi item baris terpisah yang dimulai dengan V14.1). |
correctedInvoice |
Hanya output. Nama resource invoice asli yang dikoreksi, dihapuskan, atau dibatalkan oleh invoice ini, jika ada. Jika
|
pdfUrl |
Hanya output. URL ke salinan PDF invoice. Pengguna harus meneruskan token OAuth untuk meminta PDF dengan URL ini. |
InvoiceType
Kemungkinan jenis invoice.
Enum | |
---|---|
UNSPECIFIED |
Tidak ditentukan. |
UNKNOWN |
Hanya digunakan untuk nilai hasil. Mewakili nilai yang tidak diketahui pada versi ini. |
CREDIT_MEMO |
Invoice dengan jumlah negatif. Akun akan menerima kredit. |
INVOICE |
Invoice dengan jumlah positif. Rekening berutang saldo. |
AccountBudgetSummary
Mewakili ringkasan biaya anggaran akun yang dapat ditagih.
Representasi JSON |
---|
{ "billableActivityDateRange": { object ( |
Kolom | |
---|---|
billableActivityDateRange |
Hanya output. Rentang tanggal aktivitas yang dapat ditagih untuk anggaran akun, dalam rentang tanggal layanan invoice ini. Tanggal akhir bersifat inklusif. Waktu ini dapat berbeda dari waktu mulai dan berakhir anggaran akun. |
invalidActivitySummaries[] |
Hanya output. Daftar kredit aktivitas tidak valid yang diringkas dengan penautan asli. |
customer |
Hanya output. Nama resource pelanggan yang dikaitkan dengan anggaran akun ini. ID ini berisi ID pelanggan, yang muncul di PDF invoice sebagai "ID Akun". Nama resource pelanggan memiliki format:
|
customerDescriptiveName |
Hanya output. Nama deskriptif pelanggan anggaran akun. Alamat ini akan muncul di PDF invoice sebagai "Akun". |
accountBudget |
Hanya output. Nama resource anggaran akun yang terkait dengan ringkasan biaya yang dapat ditagih ini. Nama resource AccountBudget memiliki bentuk:
|
accountBudgetName |
Hanya output. Nama anggaran akun. ID tersebut akan muncul di PDF invoice sebagai "Anggaran akun". |
purchaseOrderNumber |
Hanya output. Nomor pesanan pembelian (PO) anggaran akun. Alamat ini akan muncul di PDF invoice sebagai "Pesanan pembelian". |
subtotalAmountMicros |
Hanya output. Jumlah subtotal sebelum pajak yang diatribusikan ke anggaran ini selama periode layanan, dalam mikro. |
taxAmountMicros |
Hanya output. Jumlah pajak yang dapat diatribusikan ke anggaran ini selama periode layanan, dalam mikro. |
totalAmountMicros |
Hanya output. Jumlah total yang dapat diatribusikan ke anggaran ini selama periode layanan, dalam mikro. Jumlah ini sama dengan jumlah subtotal anggaran akun dan jumlah pajak anggaran akun. |
servedAmountMicros |
Hanya output. Jumlah penayangan sebelum pajak yang diatribusikan ke anggaran ini selama periode layanan, dalam mikro. Ini hanya berguna untuk merekonsiliasi invoice dan data pengiriman. |
billedAmountMicros |
Hanya output. Jumlah tagihan sebelum pajak yang diatribusikan ke anggaran ini selama periode layanan, dalam mikro. Biaya ini tidak memperhitungkan penyesuaian apa pun. |
overdeliveryAmountMicros |
Hanya output. Jumlah kelebihan tayangan sebelum pajak yang diatribusikan ke anggaran ini selama periode layanan, dalam mikro (nilai negatif). |
invalidActivityAmountMicros |
Hanya output. Jumlah aktivitas tidak valid sebelum pajak yang diatribusikan ke anggaran ini pada bulan-bulan sebelumnya, dalam mikro (nilai negatif). |
InvalidActivitySummary
Detail tentang aktivitas tidak valid di invoice yang berisi detail tambahan tentang invoice yang diperbaiki.
Representasi JSON |
---|
{
"originalMonthOfService": enum ( |
Kolom | |
---|---|
originalMonthOfService |
Hanya output. Bulan layanan awal yang terkait dengan kredit aktivitas tidak valid ini. |
originalYearOfService |
Hanya output. Tahun layanan awal yang terkait dengan kredit aktivitas tidak valid ini. |
originalInvoiceId |
Hanya output. Nomor invoice asli yang terkait dengan kredit aktivitas tidak valid ini. |
originalAccountBudgetName |
Hanya output. Nama anggaran akun asli yang terkait dengan kredit aktivitas tidak valid ini. |
originalPurchaseOrderNumber |
Hanya output. Nomor pesanan pembelian (PO) asli yang terkait dengan kredit aktivitas tidak valid ini. |
amountMicros |
Hanya output. Jumlah aktivitas tidak valid dalam mikro. |
AccountSummary
Mewakili tampilan ringkasan di tingkat akun.
Representasi 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 } |
Kolom | |
---|---|
customer |
Hanya output. Akun yang terkait dengan ringkasan akun. |
billingCorrectionSubtotalAmountMicros |
Hanya output. Jumlah subtotal koreksi penagihan sebelum pajak, dalam mikro. |
billingCorrectionTaxAmountMicros |
Hanya output. Pajak atas koreksi penagihan, dalam mikro. |
billingCorrectionTotalAmountMicros |
Hanya output. Total jumlah koreksi penagihan, dalam mikro. |
couponAdjustmentSubtotalAmountMicros |
Hanya output. Jumlah subtotal penyesuaian kupon sebelum pajak, dalam mikro. |
couponAdjustmentTaxAmountMicros |
Hanya output. Pajak atas penyesuaian kupon, dalam mikro. |
couponAdjustmentTotalAmountMicros |
Hanya output. Jumlah penyesuaian kupon total, dalam mikro. |
excessCreditAdjustmentSubtotalAmountMicros |
Hanya output. Jumlah subtotal penyesuaian kredit kelebihan sebelum pajak, dalam mikro. |
excessCreditAdjustmentTaxAmountMicros |
Hanya output. Pajak atas penyesuaian kredit berlebih, dalam mikro. |
excessCreditAdjustmentTotalAmountMicros |
Hanya output. Total jumlah penyesuaian kredit berlebih, dalam mikro. |
regulatoryCostsSubtotalAmountMicros |
Hanya output. Jumlah subtotal biaya berdasarkan peraturan sebelum pajak, dalam mikro. |
regulatoryCostsTaxAmountMicros |
Hanya output. Pajak atas biaya peraturan, dalam mikro. |
regulatoryCostsTotalAmountMicros |
Hanya output. Total jumlah biaya peraturan, dalam mikro. |
exportChargeSubtotalAmountMicros |
Hanya output. Jumlah subtotal biaya ekspor sebelum pajak, dalam mikro. |
exportChargeTaxAmountMicros |
Hanya output. Pajak atas biaya ekspor, dalam mikro. |
exportChargeTotalAmountMicros |
Hanya output. Total jumlah biaya ekspor, dalam mikro. |
subtotalAmountMicros |
Hanya output. Total jumlah subtotal sebelum pajak yang dapat diatribusikan ke akun selama periode layanan, dalam mikro. |
taxAmountMicros |
Hanya output. Total jumlah pajak yang dapat diatribusikan ke akun selama periode layanan, dalam mikro. |
totalAmountMicros |
Hanya output. Jumlah total yang dapat diatribusikan ke akun selama periode layanan, dalam mikro. Ini sama dengan jumlah subtotalAmountMicros dan taxAmountMicros. |