Method: advertisers.invoices.list

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/v1/advertisers/{advertiserId}/invoices

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
advertiserId

string (int64 format)

Wajib. ID pengiklan yang akan mencantumkan invoice.

Parameter kueri

Parameter
issueMonth

string

Bulan untuk membuat daftar invoice. Jika tidak ditetapkan, permintaan akan mengambil invoice untuk bulan sebelumnya.

Harus dalam format YYYYMM.
loiSapinInvoiceType

enum (LoiSapinInvoiceType)

Pilih jenis invoice yang akan diambil untuk pengiklan Loi Sapin.

Hanya berlaku untuk pengiklan Loi Sapin. Akan diabaikan jika tidak.
pageSize

integer

Ukuran halaman yang diminta. Harus antara 1 dan 200. Jika tidak ditentukan akan ditetapkan secara default ke 100. Menampilkan kode error INVALID_ARGUMENT jika nilai yang ditentukan tidak valid.
pageToken

string

Token yang mengidentifikasi halaman hasil yang harus ditampilkan server. Biasanya, ini adalah nilai nextPageToken yang ditampilkan dari panggilan sebelumnya ke metode invoices.list. Jika tidak ditentukan, halaman pertama hasil akan ditampilkan.

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "invoices": [
    {
      object (Invoice)
    }
  ],
  "nextPageToken": string
}
Kolom
invoices[]

object (Invoice)

Daftar invoice.

Daftar ini tidak akan ada jika kosong.
nextPageToken

string

Token untuk mengambil halaman hasil berikutnya. Teruskan nilai ini di kolom pageToken dalam panggilan berikutnya ke metode invoices.list untuk mengambil halaman hasil berikutnya.

Token ini tidak akan ada jika tidak ada lagi invoices untuk ditampilkan.

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 (Date)
  },
  "dueDate": {
    object (Date)
  },
  "serviceDateRange": {
    object (DateRange)
  },
  "currencyCode": string,
  "subtotalAmountMicros": string,
  "totalTaxAmountMicros": string,
  "totalAmountMicros": string,
  "purchaseOrderNumber": string,
  "budgetInvoiceGroupingId": string,
  "invoiceType": enum (InvoiceType),
  "correctedInvoiceId": string,
  "replacedInvoiceIds": [
    string
  ],
  "pdfUrl": string,
  "budgetSummaries": [
    {
      object (BudgetSummary)
    }
  ],
  "nonBudgetMicros": string
}
Kolom
name

string

Nama resource invoice.
invoiceId

string

ID unik invoice.
displayName

string

Nama tampilan invoice.
paymentsProfileId

string

ID profil pembayaran tempat invoice tersebut berada.

Muncul di PDF invoice sebagai Billing ID.
paymentsAccountId

string

ID akun pembayaran tempat invoice tersebut berada.

Muncul di PDF invoice sebagai Billing Account Number.
issueDate

object (Date)

Tanggal penerbitan faktur.
dueDate

object (Date)

Tanggal saat invoice jatuh tempo.
serviceDateRange

object (DateRange)

Tanggal mulai dan akhir layanan yang tercakup dalam invoice ini.
currencyCode

string

Mata uang yang digunakan di invoice dalam format ISO 4217.
subtotalAmountMicros

string (int64 format)

Jumlah subtotal sebelum pajak, dalam mikro mata uang invoice.

Misalnya, jika currencyCode adalah USD, 1000000 mewakili satu dolar AS.
totalTaxAmountMicros

string (int64 format)

Jumlah semua pajak di invoice, dalam mikro mata uang invoice.

Misalnya, jika currencyCode adalah USD, 1000000 mewakili satu dolar AS.
totalAmountMicros

string (int64 format)

Jumlah total invoice, dalam mikro mata uang invoice.

Misalnya, jika currencyCode adalah USD, 1000000 mewakili satu dolar AS.
purchaseOrderNumber

string

Nomor pesanan pembelian (PO) yang terkait dengan invoice.
budgetInvoiceGroupingId

string

ID pengelompokan anggaran untuk invoice ini.

Kolom ini hanya akan ditetapkan jika tingkat invoice profil penagihan terkait ditetapkan ke "ID pengelompokan invoice anggaran".
invoiceType

enum (InvoiceType)

Jenis dokumen invoice.
correctedInvoiceId

string

ID invoice asli yang sedang disesuaikan oleh invoice ini, jika ada.

Dapat muncul di PDF invoice sebagai Reference invoice number.

Jika replacedInvoiceIds ditetapkan, kolom ini akan kosong.
replacedInvoiceIds[]

string

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 Replaced invoice numbers.

Jika correctedInvoiceId ditetapkan, kolom ini akan kosong.
pdfUrl

string

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 Authorization: Bearer dan diizinkan untuk salah satu cakupan berikut:

  • https://www.googleapis.com/auth/display-video-mediaplanning
  • https://www.googleapis.com/auth/display-video

URL ini akan berlaku selama 7 hari setelah pengambilan objek invoice ini atau hingga invoice ini diambil kembali.
budgetSummaries[]

object (BudgetSummary)

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

string (int64 format)

Jumlah total biaya atau penyesuaian yang tidak terkait dengan anggaran tertentu, dalam mikro mata uang invoice.

Misalnya, jika currencyCode adalah USD, 1000000 mewakili satu dolar AS.

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 (PrismaCpeCode)
  },
  "preTaxAmountMicros": string,
  "taxAmountMicros": string,
  "totalAmountMicros": string
}
Kolom
externalBudgetId

string

Berhubungan dengan externalBudgetId anggaran kampanye. Jika nilai tidak ditetapkan dalam anggaran kampanye, kolom ini akan kosong.
prismaCpeCode

object (PrismaCpeCode)

Kode klien, produk, dan estimasi yang relevan dari alat Mediaocean Prisma.

Hanya berlaku untuk anggaran kampanye dengan externalBudgetSource sebesar EXTERNAL_BUDGET_SOURCE_MEDIA_OCEAN.
preTaxAmountMicros

string (int64 format)

Jumlah tagihan yang dibuat berdasarkan anggaran ini sebelum pajak, dalam mikro mata uang invoice.

Misalnya, jika currencyCode adalah USD, 1000000 mewakili satu dolar AS.
taxAmountMicros

string (int64 format)

Jumlah pajak yang dikenakan pada tagihan berdasarkan anggaran ini, dalam mikro mata uang invoice.

Misalnya, jika currencyCode adalah USD, 1000000 mewakili satu dolar AS.
totalAmountMicros

string (int64 format)

Jumlah total tagihan yang dibuat berdasarkan anggaran ini, termasuk pajak, dalam mikro mata uang invoice.

Misalnya, jika currencyCode adalah USD, 1000000 mewakili satu dolar AS.