Method: advertisers.invoices.list

কোনও নির্দিষ্ট মাসে কোনও বিজ্ঞাপনদাতার জন্য পোস্ট করা ইনভয়েসের তালিকা করে।

"পার্টনার" ইনভয়েস লেভেল সহ বিলিং প্রোফাইলের মাধ্যমে জেনারেট করা ইনভয়েস এই পদ্ধতির মাধ্যমে ফিরিয়ে আনা যাবে না।

HTTP অনুরোধ

GET https://displayvideo.googleapis.com/v5/advertisers/{advertiserId}/invoices

URL-এ gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করা হয়।

পাথ প্যারামিটার

প্যারামিটারগুলি
advertiserId

string (int64 format)

প্রয়োজনীয়। যে বিজ্ঞাপনদাতার ইনভয়েস তালিকাভুক্ত করতে হবে তার আইডি।

কোয়েরি প্যারামিটার

প্যারামিটারগুলি
issueMonth

string

যে মাসের ইনভয়েস তালিকাভুক্ত করতে হবে। সেট করা না থাকলে, অনুরোধটি আগের মাসের ইনভয়েস ফিরিয়ে আনবে।

YYYYMM ফর্ম্যাটে হতে হবে।
loiSapinInvoiceType

enum (LoiSapinInvoiceType)

Loi Sapin বিজ্ঞাপনদাতাদের জন্য ইনভয়েসের ধরন বেছে নিন।

শুধুমাত্র Loi Sapin বিজ্ঞাপনদাতাদের জন্য প্রযোজ্য। অন্যথায় উপেক্ষা করা হবে।
pageSize

integer

অনুরোধ করা পৃষ্ঠার সাইজ। 1 থেকে 200-এর মধ্যে হতে হবে। উল্লেখ না করা থাকলে, ডিফল্ট হিসেবে 100 হবে। ভুল ভ্যালু উল্লেখ করা হলে, ত্রুটি কোড INVALID_ARGUMENT দেখায়।
pageToken

string

সার্ভার যে ফলাফল ফেরত পাঠাবে তার পৃষ্ঠা শনাক্ত করার টোকেন। সাধারণত, এটি হল nextPageToken-এর ভ্যালু যা invoices.list পদ্ধতিতে আগের কল থেকে ফেরত এসেছে। উল্লেখ করা না থাকলে, ফলাফলের প্রথম পৃষ্ঠা দেখানো হবে।

অনুরোধের বডি

অনুরোধের বডি ফাঁকা থাকতে হবে।

প্রতিক্রিয়ার বডি

সফল হলে, প্রতিক্রিয়ার বডিতে নিচে উল্লেখ করা স্ট্রাকচার সহ ডেটা থাকে:

JSON উপস্থাপনা 
{
  "invoices": [
    {
      object (Invoice)
    }
  ],
  "nextPageToken": string
}
ফিল্ড
invoices[]

object (Invoice)

ইনভয়েসের তালিকা।

খালি থাকলে এই তালিকাটি অনুপস্থিত থাকবে।
nextPageToken

string

পরবর্তী পৃষ্ঠার ফলাফল পাওয়ার জন্য টোকেন। পরবর্তী পৃষ্ঠার ফলাফল পেতে invoices.list পদ্ধতিতে পরবর্তী কলে pageToken ফিল্ডে এই ভ্যালু পাস করুন।

ফেরত দেওয়ার জন্য আর কোনও invoices না থাকলে এই টোকেন অনুপস্থিত থাকবে।

অনুমোদনের স্কোপ

নিম্নলিখিত OAuth স্কোপগুলির মধ্যে একটি প্রয়োজন:

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

আরও তথ্যের জন্য, OAuth 2.0 Overview দেখুন।

LoiSapinInvoiceType

Loi Sapin বিজ্ঞাপনদাতাদের জন্য সম্ভাব্য ইনভয়েসের ধরন।

Enums
LOI_SAPIN_INVOICE_TYPE_UNSPECIFIED ভ্যালু নির্দিষ্ট করা নেই।
LOI_SAPIN_INVOICE_TYPE_MEDIA মিডিয়ার খরচ সহ ইনভয়েস।
LOI_SAPIN_INVOICE_TYPE_PLATFORM প্ল্যাটফর্ম ফি সহ ইনভয়েস।

ইনভয়েস

একটি ইনভয়েস।

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
}
ফিল্ড
name

string

ইনভয়েসের রিসোর্স নাম।
invoiceId

string

ইনভয়েসের অনন্য আইডি।
displayName

string

ইনভয়েসের ডিসপ্লে নাম।
paymentsProfileId

string

ইনভয়েসটি যে পেমেন্ট প্রোফাইলের সাথে যুক্ত, সেটির আইডি।

ইনভয়েস পিডিএফ-এ Billing ID হিসেবে দেখানো হয়।
paymentsAccountId

string

ইনভয়েসটি যে পেমেন্ট অ্যাকাউন্টের সাথে যুক্ত, সেটির আইডি।

ইনভয়েস পিডিএফ-এ Billing Account Number হিসেবে দেখানো হয়।
issueDate

object (Date)

ইনভয়েস ইস্যু করার তারিখ।
dueDate

object (Date)

ইনভয়েস পেমেন্ট করার তারিখ।
serviceDateRange

object (DateRange)

এই ইনভয়েসে পরিষেবা শুরু ও শেষ হওয়ার তারিখ উল্লেখ করা আছে।
currencyCode

string

ইনভয়েসে ISO 4217 ফর্ম্যাটে ব্যবহার করা কারেন্সি।
subtotalAmountMicros

string (int64 format)

ইনভয়েসের কারেন্সির মাইক্রোতে ট্যাক্স-পূর্ব সাবটোটাল পরিমাণ।

যেমন, currencyCode যদি USD হয়, তাহলে 1000000 বলতে এক মার্কিন ডলার বোঝায়।
totalTaxAmountMicros

string (int64 format)

ইনভয়েসের মুদ্রার মাইক্রোতে ইনভয়েসের সব ট্যাক্সের যোগফল।

যেমন, currencyCode যদি USD হয়, তাহলে 1000000 বলতে এক মার্কিন ডলার বোঝায়।
totalAmountMicros

string (int64 format)

ইনভয়েসের মোট পরিমাণ, ইনভয়েসের মুদ্রার মাইক্রোতে।

যেমন, currencyCode যদি USD হয়, তাহলে 1000000 বলতে এক মার্কিন ডলার বোঝায়।
purchaseOrderNumber

string

ইনভয়েসের সাথে যুক্ত কেনার অর্ডারের নম্বর।
budgetInvoiceGroupingId

string

এই ইনভয়েসের জন্য বাজেট গ্রুপিং আইডি।

সংশ্লিষ্ট বিলিং প্রোফাইলের ইনভয়েস লেভেল "বাজেট ইনভয়েস গ্রুপিং আইডি" হিসেবে সেট করা থাকলে তবেই এই ফিল্ড সেট করা হবে।
invoiceType

enum (InvoiceType)

ইনভয়েস ডকুমেন্টের ধরন।
correctedInvoiceId

string

এই ইনভয়েসের মাধ্যমে অ্যাডজাস্ট করা আসল ইনভয়েসের আইডি, যদি প্রযোজ্য হয়।

ইনভয়েস পিডিএফ-এ Reference invoice number হিসেবে দেখা যেতে পারে।

replacedInvoiceIds সেট করা থাকলে, এই ফিল্ড খালি থাকবে।
replacedInvoiceIds[]

string

আসল ইস্যু করা ইনভয়েসের আইডি, যা এই ইনভয়েসের মাধ্যমে বাতিল করা হচ্ছে, যদি প্রযোজ্য হয়। একাধিক ইনভয়েস একটি ইনভয়েসে একত্রিত করা হলে, একাধিক ইনভয়েস তালিকাভুক্ত করা হতে পারে।

ইনভয়েস পিডিএফ-এ Replaced invoice numbers হিসেবে দেখা যেতে পারে।

correctedInvoiceId সেট করা থাকলে, এই ফিল্ড খালি থাকবে।
pdfUrl

string

ইনভয়েসের পিডিএফ কপি ডাউনলোড করার URL।

এই URL ব্যবহারকারী-নির্দিষ্ট এবং অ্যাক্সেস করার জন্য একটি সঠিক OAuth 2.0 অ্যাক্সেস টোকেন প্রয়োজন। অ্যাক্সেস টোকেন অবশ্যই Authorization: Bearer HTTP হেডারে প্রদান করতে হবে এবং নিম্নলিখিত যেকোনও একটি স্কোপের জন্য অনুমোদিত হতে হবে:

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

এই ইনভয়েস অবজেক্ট পাওয়ার পরে ৭ দিন পর্যন্ত অথবা এই ইনভয়েস আবার না পাওয়া পর্যন্ত URL কাজ করবে।
budgetSummaries[]

object (BudgetSummary)

এই ইনভয়েসের সাথে যুক্ত প্রতিটি বাজেটের জন্য সারসংক্ষেপ করা তথ্যের তালিকা।

সংশ্লিষ্ট বিলিং প্রোফাইলের ইনভয়েস বিবরণের লেভেল "বাজেট লেভেল PO" হিসেবে সেট করা থাকলে তবেই এই ফিল্ড সেট করা হবে।
nonBudgetMicros

string (int64 format)

ইনভয়েসের মুদ্রার মাইক্রোতে, নির্দিষ্ট বাজেটের সাথে যুক্ত নয় এমন খরচ বা অ্যাডজাস্টমেন্টের মোট পরিমাণ।

যেমন, currencyCode যদি USD হয়, তাহলে 1000000 বলতে এক মার্কিন ডলার বোঝায়।

InvoiceType

ইনভয়েসের সম্ভাব্য ধরন।

Enums
INVOICE_TYPE_UNSPECIFIED এই ভার্সনে উল্লেখ করা নেই বা অজানা।
INVOICE_TYPE_CREDIT ইনভয়েসে টাকার পরিমাণ শূন্যের থেকে কম।
INVOICE_TYPE_INVOICE ইনভয়েসে পজিটিভ অর্থরাশি আছে।

BudgetSummary

আলাদা আলাদা ক্যাম্পেনের বাজেটের সারসংক্ষেপ।

JSON উপস্থাপনা 
{
  "externalBudgetId": string,
  "prismaCpeCode": {
    object (PrismaCpeCode)
  },
  "preTaxAmountMicros": string,
  "taxAmountMicros": string,
  "totalAmountMicros": string
}
ফিল্ড
externalBudgetId

string

ক্যাম্পেন বাজেটের externalBudgetId-এর সাথে সম্পর্কিত। ক্যাম্পেন বাজেটে ভ্যালু সেট করা না থাকলে, এই ফিল্ড খালি থাকবে।
prismaCpeCode

object (PrismaCpeCode)

Mediaocean Prisma টুল থেকে প্রাসঙ্গিক ক্লায়েন্ট, প্রোডাক্ট এবং আনুমানিক কোড।

শুধুমাত্র EXTERNAL_BUDGET_SOURCE_MEDIA_OCEAN-এর externalBudgetSource সহ ক্যাম্পেন বাজেটের ক্ষেত্রে প্রযোজ্য।
preTaxAmountMicros

string (int64 format)

ইনভয়েসের মুদ্রার মাইক্রোতে, ট্যাক্স বাদ দিয়ে এই বাজেটের অধীনে করা চার্জের যোগফল।

যেমন, currencyCode যদি USD হয়, তাহলে 1000000 বলতে এক মার্কিন ডলার বোঝায়।
taxAmountMicros

string (int64 format)

এই বাজেটের অধীনে চার্জের উপর প্রযোজ্য ট্যাক্সের পরিমাণ, ইনভয়েসের মুদ্রার মাইক্রোতে।

যেমন, currencyCode যদি USD হয়, তাহলে 1000000 বলতে এক মার্কিন ডলার বোঝায়।
totalAmountMicros

string (int64 format)

ইনভয়েসের মুদ্রার মাইক্রোতে ট্যাক্স সহ এই বাজেটের অধীনে করা চার্জের মোট যোগফল।

যেমন, currencyCode যদি USD হয়, তাহলে 1000000 বলতে এক মার্কিন ডলার বোঝায়।