- 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 tingkat invoice "Partner" tidak dapat diambil melalui metode ini.
Permintaan HTTP
GET https://displayvideo.googleapis.com/v2/advertisers/{advertiserId}/invoices
URL menggunakan sintaksis gRPC Transcoding.
Parameter jalur
Parameter | |
---|---|
advertiserId |
Wajib. ID pengiklan yang invoice-nya akan dicantumkan. |
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. Jika tidak, akan diabaikan. |
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 yang memiliki invoice. Muncul di PDF invoice sebagai |
paymentsAccountId |
ID akun pembayaran yang mencakup invoice. Muncul di PDF invoice sebagai |
issueDate |
Tanggal saat invoice diterbitkan. |
dueDate |
Tanggal jatuh tempo invoice. |
serviceDateRange |
Tanggal mulai dan akhir layanan yang tercakup dalam invoice ini. |
currencyCode |
Mata uang yang digunakan di invoice dengan 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 disesuaikan oleh invoice ini, jika ada. Dapat muncul di PDF invoice sebagai Jika |
replacedInvoiceIds[] |
ID 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 dalam invoice PDF sebagai Jika |
pdfUrl |
URL untuk mendownload salinan invoice dalam bentuk PDF. URL ini bersifat khusus pengguna dan memerlukan token akses OAuth 2.0 yang valid untuk mengaksesnya. Token akses harus diberikan dalam header HTTP
URL ini akan berlaku selama 7 hari setelah objek invoice ini diambil atau hingga invoice ini diambil kembali. |
budgetSummaries[] |
Daftar ringkasan informasi untuk setiap anggaran yang terkait dengan faktur 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 memiliki jumlah negatif. |
INVOICE_TYPE_INVOICE |
Invoice memiliki jumlah positif. |
BudgetSummary
Ringkasan informasi anggaran kampanye individual.
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 dikenakan 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 |