- HTTP isteği
- Yol parametreleri
- Sorgu parametreleri
- İstek metni
- Yanıt metni
- Yetkilendirme kapsamları
- LoiSapinInvoiceType
- Fatura
- InvoiceType
- BudgetSummary
- Deneyin.
Bir reklamveren için belirli bir ayda gönderilen faturaları listeler.
"İş ortağı" fatura düzeyine sahip faturalandırma profilleri tarafından oluşturulan faturalara bu yöntemle erişilemez.
HTTP isteği
GET https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/invoices
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Yol parametreleri
Parametreler | |
---|---|
advertiserId |
Zorunlu. Faturalarının listeleneceği reklamverenin kimliği. |
Sorgu parametreleri
Parametreler | |
---|---|
issueMonth |
Faturaların listeleneceği ay. Ayarlanmazsa istek, önceki ayın faturaları alır. YYYYAA biçiminde olmalıdır. |
loiSapinInvoiceType |
Sapin Yasası reklamverenleri için alınacak fatura türünü seçin. Yalnızca Sapin Yasası'ndaki reklamverenler için geçerlidir. Aksi takdirde yoksayılır. |
pageSize |
İstenen sayfa boyutu. |
pageToken |
Sunucunun döndürmesi gereken sonuçların yer aldığı sayfayı tanımlayan bir jeton. Genellikle bu, |
İstek içeriği
İstek metni boş olmalıdır.
Yanıt gövdesi
Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:
JSON gösterimi |
---|
{
"invoices": [
{
object ( |
Alanlar | |
---|---|
invoices[] |
Fatura listesi. Boş bırakılırsa bu liste görünmez. |
nextPageToken |
Sonraki sonuç sayfasını almak için jeton. Sonraki sonuç sayfasını almak için bu değeri, Döndürülecek başka |
Yetkilendirme kapsamları
Aşağıdaki OAuth kapsamlarından birini gerektirir:
https://www.googleapis.com/auth/display-video
https://www.googleapis.com/auth/display-video-mediaplanning
Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleye bakın.
LoiSapinInvoiceType
Sapin Yasası reklamverenleri için olası fatura türleri.
Sıralamalar | |
---|---|
LOI_SAPIN_INVOICE_TYPE_UNSPECIFIED |
Değer belirtilmedi. |
LOI_SAPIN_INVOICE_TYPE_MEDIA |
Medya maliyeti içeren faturalar. |
LOI_SAPIN_INVOICE_TYPE_PLATFORM |
Platform ücreti içeren faturalar. |
Fatura
Tek fatura.
JSON gösterimi |
---|
{ "name": string, "invoiceId": string, "displayName": string, "paymentsProfileId": string, "paymentsAccountId": string, "issueDate": { object ( |
Alanlar | |
---|---|
name |
Faturanın kaynak adı. |
invoiceId |
Faturanın benzersiz kimliği. |
displayName |
Faturanın görünen adı. |
paymentsProfileId |
Faturanın ait olduğu ödeme profilinin kimliği. Fatura PDF'sinde |
paymentsAccountId |
Faturanın ait olduğu ödeme hesabının kimliği. Fatura PDF'sinde |
issueDate |
Faturanın düzenlendiği tarih. |
dueDate |
Faturanın ödenmesi gereken tarih. |
serviceDateRange |
Bu fatura kapsamındaki hizmet başlangıç ve bitiş tarihleri. |
currencyCode |
Faturada kullanılan, ISO 4217 biçimindeki para birimi. |
subtotalAmountMicros |
Faturanın para biriminin mikro cinsinden olarak vergi öncesi ara toplam tutarı. Örneğin, |
totalTaxAmountMicros |
Faturadaki tüm vergilerin, fatura para biriminin mikro cinsinden toplamı. Örneğin, |
totalAmountMicros |
Faturanın para birimi cinsinden mikro cinsinden toplam fatura tutarı. Örneğin, |
purchaseOrderNumber |
Faturayla ilişkili satın alma siparişi numarası. |
budgetInvoiceGroupingId |
Bu faturanın bütçe gruplandırma kimliği. Bu alan, yalnızca ilgili faturalandırma profilinin fatura düzeyi "Bütçe faturası gruplandırma kimliği" olarak ayarlanmışsa ayarlanır. |
invoiceType |
Fatura belgesinin türü. |
correctedInvoiceId |
Varsa, bu faturaya göre düzenlenen orijinal faturanın kimliği. Fatura PDF'sinde
|
replacedInvoiceIds[] |
Varsa, bu fatura ile iptal edilen ilk başta düzenlenen faturaların no'ları. Söz konusu faturalar tek bir faturada birleştiriliyorsa birden fazla fatura listelenebilir. Fatura PDF'sinde
|
pdfUrl |
Faturanın PDF kopyasını indirme URL'si. Bu URL kullanıcıya özeldir ve erişmek için geçerli bir OAuth 2.0 erişim jetonu gerektirir. Erişim jetonu bir
URL, bu fatura nesnesi alındıktan sonra 7 gün boyunca veya bu fatura tekrar alınana kadar geçerli olacaktır. |
budgetSummaries[] |
Bu faturayla ilişkili her bütçeyle ilgili özet bilgilerin listesi. Bu alan, yalnızca ilgili faturalandırma profilinin fatura ayrıntı düzeyi "Bütçe düzeyi PO" olarak ayarlanmışsa ayarlanır. |
nonBudgetMicros |
Belirli bir bütçeye bağlı olmayan toplam maliyet veya düzenleme tutarı (faturanın para biriminin mikro cinsinden). Örneğin, |
InvoiceType
Olası fatura türleri.
Sıralamalar | |
---|---|
INVOICE_TYPE_UNSPECIFIED |
Bu sürümde belirtilmedi veya bilinmiyor. |
INVOICE_TYPE_CREDIT |
Faturada negatif bir tutar var. |
INVOICE_TYPE_INVOICE |
Faturada pozitif bir tutar var. |
BudgetSummary
Tek bir kampanya bütçesine ait özet bilgiler.
JSON gösterimi |
---|
{
"externalBudgetId": string,
"prismaCpeCode": {
object ( |
Alanlar | |
---|---|
externalBudgetId |
Kampanya bütçesinin |
prismaCpeCode |
Mediaocean Prisma aracından ilgili müşteri, ürün ve tahmin kodları. Yalnızca |
preTaxAmountMicros |
Bu bütçe kapsamında, vergiler hariç olarak yapılan masrafların toplamı (faturanın para birimi cinsinden mikro cinsinden). Örneğin, |
taxAmountMicros |
Bu bütçe kapsamındaki ücretlere uygulanan vergi tutarı (faturanın para biriminin mikro cinsinden). Örneğin, |
totalAmountMicros |
Vergi dahil, bu bütçe kapsamında yapılan masrafların toplamının faturanın para birimi cinsinden mikro cinsinden ifadesidir. Örneğin, |