- Permintaan HTTP
- Parameter lokasi
- Parameter kueri
- Isi permintaan
- Isi respons
- Cakupan Otorisasi
- LoiSapinInvoiceType
- Invoice
- InvoiceType
- BudgetSummary
- Cobalah!
Mencantumkan invoice yang diposting untuk pengiklan pada bulan tertentu.
Invoice yang dibuat oleh profil penagihan dengan "Partner" tingkat faktur tidak dapat diambil melalui metode ini.
Permintaan HTTP
GET https://displayvideo.googleapis.com/v1/advertisers/{advertiserId}/invoices
URL menggunakan sintaksis gRPC Transcoding.
Parameter jalur
Parameter | |
---|---|
advertiserId |
Wajib. ID pengiklan yang akan dicantumkan invoice. |
Parameter kueri
Parameter | |
---|---|
issueMonth |
Bulan untuk mencantumkan invoice. Jika tidak ditetapkan, permintaan akan mengambil invoice untuk bulan sebelumnya. Harus dalam format YYYYMM. |
loiSapinInvoiceType |
Pilih jenis invoice yang akan diambil untuk pengiklan Loi Sapin. Hanya berlaku untuk pengiklan Loi Sapin. Akan diabaikan jika tidak. |
pageSize |
Ukuran halaman yang diminta. Harus antara |
pageToken |
Token yang mengidentifikasi halaman hasil yang harus ditampilkan server. Biasanya, nilai ini adalah nilai |
Isi permintaan
Isi permintaan harus kosong.
Isi respons
Jika berhasil, isi respons memuat data dengan struktur berikut:
Representasi JSON |
---|
{
"invoices": [
{
object ( |
Kolom | |
---|---|
invoices[] |
Daftar invoice. Daftar ini tidak akan ada jika kosong. |
nextPageToken |
Token untuk mengambil halaman hasil berikutnya. Teruskan nilai ini di kolom Token ini tidak akan ada jika tidak ada lagi |
Cakupan Otorisasi
Memerlukan salah satu cakupan OAuth berikut:
https://www.googleapis.com/auth/display-video
https://www.googleapis.com/auth/display-video-mediaplanning
Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.
LoiSapinInvoiceType
Kemungkinan jenis invoice untuk pengiklan Loi Sapin.
Enum | |
---|---|
LOI_SAPIN_INVOICE_TYPE_UNSPECIFIED |
Nilai tidak ditentukan. |
LOI_SAPIN_INVOICE_TYPE_MEDIA |
Invoice dengan Biaya media. |
LOI_SAPIN_INVOICE_TYPE_PLATFORM |
Invoice dengan biaya Platform. |
Faktur
Satu faktur.
Representasi JSON |
---|
{ "name": string, "invoiceId": string, "displayName": string, "paymentsProfileId": string, "paymentsAccountId": string, "issueDate": { object ( |
Kolom | |
---|---|
name |
Nama resource invoice. |
invoiceId |
ID unik invoice. |
displayName |
Nama tampilan invoice. |
paymentsProfileId |
ID profil pembayaran yang memiliki invoice. Muncul dalam PDF invoice sebagai |
paymentsAccountId |
ID akun pembayaran yang memiliki invoice. Muncul dalam PDF invoice sebagai |
issueDate |
Tanggal penerbitan invoice. |
dueDate |
Tanggal jatuh tempo invoice. |
serviceDateRange |
Tanggal mulai dan akhir layanan yang dicakup dalam invoice ini. |
currencyCode |
Mata uang yang digunakan di invoice dalam format ISO 4217. |
subtotalAmountMicros |
Jumlah subtotal sebelum pajak, dalam mikro mata uang invoice. Misalnya, jika |
totalTaxAmountMicros |
Jumlah semua pajak dalam invoice, dalam mikro mata uang invoice. Misalnya, jika |
totalAmountMicros |
Jumlah total faktur, dalam mikro mata uang faktur. Misalnya, jika |
purchaseOrderNumber |
Nomor pesanan pembelian (PO) yang terkait dengan invoice. |
budgetInvoiceGroupingId |
ID pengelompokan anggaran untuk invoice ini. Kolom ini hanya akan ditetapkan jika tingkat invoice profil penagihan yang sesuai ditetapkan ke "Budget invoice targeting ID". |
invoiceType |
Jenis dokumen invoice. |
correctedInvoiceId |
ID invoice asli yang disesuaikan oleh invoice ini, jika ada. Dapat muncul di PDF invoice sebagai Jika |
replacedInvoiceIds[] |
ID dari invoice pertama yang telah diterbitkan yang dibatalkan oleh invoice ini, jika ada. Beberapa invoice dapat dicantumkan jika invoice tersebut digabungkan ke dalam satu invoice. Dapat muncul di PDF invoice sebagai Jika |
pdfUrl |
URL untuk mendownload salinan invoice dalam format PDF. URL ini khusus pengguna dan memerlukan token akses OAuth 2.0 yang valid untuk mengakses. Token akses harus diberikan dalam header HTTP
URL ini akan berlaku selama 7 hari setelah pengambilan objek invoice ini atau hingga invoice ini diambil lagi. |
budgetSummaries[] |
Daftar informasi ringkasan untuk setiap anggaran yang terkait dengan invoice ini. Kolom ini hanya akan ditetapkan jika tingkat detail invoice untuk profil penagihan terkait ditetapkan ke "PO tingkat anggaran". |
nonBudgetMicros |
Jumlah total biaya atau penyesuaian yang tidak terkait dengan anggaran tertentu, dalam mikro mata uang invoice. Misalnya, jika |
InvoiceType
Kemungkinan jenis invoice.
Enum | |
---|---|
INVOICE_TYPE_UNSPECIFIED |
Tidak ditentukan atau tidak diketahui dalam versi ini. |
INVOICE_TYPE_CREDIT |
Jumlah invoice negatif. |
INVOICE_TYPE_INVOICE |
Invoice memiliki jumlah positif. |
BudgetSummary
Ringkasan informasi anggaran masing-masing kampanye.
Representasi JSON |
---|
{
"externalBudgetId": string,
"prismaCpeCode": {
object ( |
Kolom | |
---|---|
externalBudgetId |
Sesuai dengan |
prismaCpeCode |
Kode klien, produk, dan estimasi yang relevan dari alat Mediaocean Prisma. Hanya berlaku untuk anggaran kampanye dengan |
preTaxAmountMicros |
Jumlah tagihan yang dibuat berdasarkan anggaran ini sebelum pajak, dalam mikro mata uang invoice. Misalnya, jika |
taxAmountMicros |
Jumlah pajak yang dikenakan untuk tagihan berdasarkan anggaran ini, dalam mikro mata uang invoice. Misalnya, jika |
totalAmountMicros |
Jumlah total tagihan yang dibuat berdasarkan anggaran ini, termasuk pajak, dalam mikro mata uang invoice. Misalnya, jika |