- Permintaan HTTP
- Parameter lokasi
- Parameter kueri
- Isi permintaan
- Isi respons
- Cakupan otorisasi
- LoiSapinInvoiceType
- Invoice
- InvoiceType
- BudgetSummary
- Cobalah!
Mencantumkan faktur yang diposting untuk pengiklan pada bulan tertentu.
Invoice yang dibuat oleh profil penagihan dengan tingkat invoice "Partner" tidak dapat diambil melalui metode ini.
Permintaan HTTP
GET https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/invoices
URL menggunakan sintaksis gRPC Transcoding.
Parameter jalur
Parameter | |
---|---|
advertiserId |
Wajib. ID pengiklan yang akan mencantumkan invoice. |
Parameter kueri
Parameter | |
---|---|
issueMonth |
Bulan untuk membuat daftar 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, 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. |
Invoice
Satu invoice.
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 tempat invoice tersebut berada. Muncul di PDF invoice sebagai |
paymentsAccountId |
ID akun pembayaran tempat invoice tersebut berada. Muncul di PDF invoice sebagai |
issueDate |
Tanggal penerbitan faktur. |
dueDate |
Tanggal saat invoice jatuh tempo. |
serviceDateRange |
Tanggal mulai dan akhir layanan yang tercakup 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 di invoice, dalam mikro mata uang invoice. Misalnya, jika |
totalAmountMicros |
Jumlah total invoice, dalam mikro mata uang invoice. 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 terkait ditetapkan ke "ID pengelompokan invoice anggaran". |
invoiceType |
Jenis dokumen invoice. |
correctedInvoiceId |
ID invoice asli yang sedang disesuaikan oleh invoice ini, jika ada. Dapat muncul di PDF invoice sebagai Jika |
replacedInvoiceIds[] |
ID dari setiap invoice yang diterbitkan pertama kali yang dibatalkan oleh invoice ini, jika ada. Beberapa faktur dapat dicantumkan jika faktur tersebut digabungkan ke dalam satu faktur. Dapat muncul di PDF invoice sebagai Jika |
pdfUrl |
URL untuk mendownload salinan invoice dalam format PDF. URL ini spesifik per pengguna dan memerlukan token akses OAuth 2.0 yang valid untuk mengakses. Token akses harus diberikan di header HTTP
URL ini akan berlaku selama 7 hari setelah pengambilan objek invoice ini atau hingga invoice ini diambil kembali. |
budgetSummaries[] |
Daftar ringkasan informasi untuk setiap anggaran yang terkait dengan invoice ini. Kolom ini hanya akan ditetapkan jika tingkat detail invoice 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 |
Invoice tersebut memiliki jumlah negatif. |
INVOICE_TYPE_INVOICE |
Invoice tersebut memiliki jumlah positif. |
BudgetSummary
Informasi ringkasan anggaran kampanye individual.
Representasi JSON |
---|
{
"externalBudgetId": string,
"prismaCpeCode": {
object ( |
Kolom | |
---|---|
externalBudgetId |
Berhubungan 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 pada 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 |