Method: advertisers.invoices.list

একটি নির্দিষ্ট মাসে একটি বিজ্ঞাপনদাতার জন্য পোস্ট করা চালান তালিকা করুন।

একটি "অংশীদার" চালান স্তর সহ বিলিং প্রোফাইল দ্বারা উত্পন্ন চালানগুলি এই পদ্ধতির মাধ্যমে পুনরুদ্ধারযোগ্য নয়৷

HTTP অনুরোধ

GET https://displayvideo.googleapis.com/v3/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 ওভারভিউ দেখুন।

LoiSapin ইনভয়েস টাইপ

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 হিসাবে চালান PDF এ উপস্থিত হয়।

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

প্রযোজ্য হলে এই চালান দ্বারা বাতিল করা যেকোন আসল জারি করা চালানের ID(গুলি)। একাধিক চালান তালিকাভুক্ত হতে পারে যদি সেই চালানগুলিকে একক চালানে একত্রিত করা হয়।

চালান PDF এ Replaced invoice numbers হিসাবে প্রদর্শিত হতে পারে।

correctedInvoiceId করা হলে, এই ক্ষেত্রটি খালি থাকবে।

pdfUrl

string

চালানের একটি PDF কপি ডাউনলোড করার 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 এক মার্কিন ডলারের প্রতিনিধিত্ব করে।

চালান প্রকার

সম্ভাব্য প্রকারের চালান।

Enums
INVOICE_TYPE_UNSPECIFIED এই সংস্করণে নির্দিষ্ট বা অজানা নয়।
INVOICE_TYPE_CREDIT চালান একটি ঋণাত্মক পরিমাণ আছে.
INVOICE_TYPE_INVOICE চালান একটি ধনাত্মক পরিমাণ আছে.

বাজেটের সংক্ষিপ্তসার

একটি পৃথক প্রচারাভিযানের বাজেটের সংক্ষিপ্ত তথ্য।

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 এক মার্কিন ডলারের প্রতিনিধিত্ব করে।