- HTTP অনুরোধ
- পাথ প্যারামিটার
- ক্যোয়ারী প্যারামিটার
- শরীরের অনুরোধ
- প্রতিক্রিয়া শরীর
- অনুমোদনের সুযোগ
- চালান
- চালান প্রকার
- AccountBudget Summary
- অবৈধ কার্যকলাপের সারাংশ
- অ্যাকাউন্টের সারাংশ
- এটা চেষ্টা করুন!
একটি নির্দিষ্ট মাসের জন্য বিলিং সেটআপের সাথে যুক্ত সমস্ত চালান ফেরত দেয়।
নিক্ষিপ্ত ত্রুটির তালিকা: প্রমাণীকরণ ত্রুটি অনুমোদন ত্রুটি ক্ষেত্র ত্রুটি শিরোনাম ত্রুটি অভ্যন্তরীণ ত্রুটি চালান ত্রুটি কোটা ত্রুটি অনুরোধ ত্রুটি
HTTP অনুরোধ
GET https://googleads.googleapis.com/v17/customers/{customerId}/invoices
URL gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করে।
পাথ প্যারামিটার
পরামিতি | |
---|---|
customerId | প্রয়োজন। চালান আনতে গ্রাহকের আইডি। |
ক্যোয়ারী প্যারামিটার
পরামিতি | |
---|---|
billingSetup | প্রয়োজন। অনুরোধ করা চালানগুলির বিলিং সেটআপ সংস্থানের নাম৷ |
issueYear | প্রয়োজন। yyyy ফর্ম্যাটে ইনভয়েস পুনরুদ্ধার করার জন্য ইস্যুর বছর। শুধুমাত্র 2019 বা তার পরে জারি করা চালানগুলি পুনরুদ্ধার করা যেতে পারে। |
issueMonth | প্রয়োজন। ইনভয়েস পুনরুদ্ধার করার মাস। |
শরীরের অনুরোধ
অনুরোধের বডি খালি হতে হবে।
প্রতিক্রিয়া শরীর
InvoiceService.ListInvoices
এর জন্য প্রতিক্রিয়া বার্তা।
সফল হলে, প্রতিক্রিয়া বডিতে নিম্নলিখিত কাঠামোর সাথে ডেটা থাকে:
JSON প্রতিনিধিত্ব |
---|
{
"invoices": [
{
object ( |
ক্ষেত্র | |
---|---|
invoices[] | বিলিং সেটআপ এবং সময়কালের সাথে মেলে ইনভয়েসের তালিকা। |
অনুমোদনের সুযোগ
নিম্নলিখিত OAuth সুযোগ প্রয়োজন:
-
https://www.googleapis.com/auth/adwords
আরও তথ্যের জন্য, OAuth 2.0 ওভারভিউ দেখুন।
চালান
একটি চালান। সমস্ত চালানের তথ্য পিডিএফ চালানের সাথে মেলে স্ন্যাপশট করা হয়। InvoiceService চালুর চেয়ে পুরনো ইনভয়েসের জন্য, স্ন্যাপশট করা তথ্য PDF চালানের সাথে নাও মিলতে পারে।
JSON প্রতিনিধিত্ব |
---|
{ "resourceName": string, "type": enum ( |
ক্ষেত্র | |
---|---|
resourceName | শুধুমাত্র আউটপুট। চালানের সম্পদের নাম। একাধিক গ্রাহক একটি প্রদত্ত চালান ভাগ করতে পারেন, তাই একাধিক সম্পদের নাম একই চালানের দিকে নির্দেশ করতে পারে। চালান সম্পদ নামের ফর্ম আছে: |
type | শুধুমাত্র আউটপুট। চালানের ধরন। |
serviceDateRange | শুধুমাত্র আউটপুট। এই চালানের পরিষেবা সময়ের তারিখের ব্যাপ্তি। শেষ তারিখ অন্তর্ভুক্ত। |
adjustmentsSubtotalAmountMicros | শুধুমাত্র আউটপুট। মাইক্রোতে ইনভয়েস লেভেল অ্যাডজাস্টমেন্টের প্রিট্যাক্স সাবটোটাল পরিমাণ। |
adjustmentsTaxAmountMicros | শুধুমাত্র আউটপুট। মাইক্রোতে ইনভয়েস লেভেল অ্যাডজাস্টমেন্টে ট্যাক্সের যোগফল। |
adjustmentsTotalAmountMicros | শুধুমাত্র আউটপুট। মাইক্রোতে ইনভয়েস লেভেল অ্যাডজাস্টমেন্টের মোট পরিমাণ। |
regulatoryCostsSubtotalAmountMicros | শুধুমাত্র আউটপুট। মাইক্রোতে ইনভয়েস স্তরের নিয়ন্ত্রক খরচের প্রিট্যাক্স সাবটোটাল পরিমাণ। |
regulatoryCostsTaxAmountMicros | শুধুমাত্র আউটপুট। মাইক্রোতে ইনভয়েস স্তরের নিয়ন্ত্রক খরচের উপর করের সমষ্টি। |
regulatoryCostsTotalAmountMicros | শুধুমাত্র আউটপুট। মাইক্রোতে ইনভয়েস স্তরের নিয়ন্ত্রক খরচের মোট পরিমাণ। |
replacedInvoices[] | শুধুমাত্র আউটপুট। যদি প্রযোজ্য হয় তাহলে এই চালানের মাধ্যমে রিবিল করা বা প্রতিস্থাপিত মূল চালানের সম্পদের নাম। ইনভয়েস একত্রীকরণের কারণে একাধিক ইনভয়েস প্রতিস্থাপিত হতে পারে। প্রতিস্থাপিত চালান একই অর্থপ্রদান অ্যাকাউন্টের অন্তর্গত নাও হতে পারে। |
accountBudgetSummaries[] | শুধুমাত্র আউটপুট। এই চালানের সাথে যুক্ত অ্যাকাউন্ট বাজেটের তথ্যের সংক্ষিপ্ত তালিকা। |
accountSummaries[] | শুধুমাত্র আউটপুট। এই চালানের সাথে সম্পর্কিত সংক্ষিপ্ত অ্যাকাউন্ট তথ্যের তালিকা। |
id | শুধুমাত্র আউটপুট। চালানের আইডি। এটি চালান পিডিএফ-এ "চালান নম্বর" হিসাবে প্রদর্শিত হয়। |
billingSetup | শুধুমাত্র আউটপুট। এই চালানের বিলিং সেটআপের সংস্থানের নাম। |
paymentsAccountId | শুধুমাত্র আউটপুট। একটি 16 সংখ্যার ID যা বিলিং সেটআপের সাথে যুক্ত পেমেন্ট অ্যাকাউন্ট সনাক্ত করতে ব্যবহৃত হয়, উদাহরণস্বরূপ, "1234-5678-9012-3456"৷ এটি চালান পিডিএফ-এ "বিলিং অ্যাকাউন্ট নম্বর" হিসাবে প্রদর্শিত হবে। |
paymentsProfileId | শুধুমাত্র আউটপুট। একটি 12 সংখ্যার ID যা বিলিং সেটআপের সাথে যুক্ত পেমেন্ট প্রোফাইল সনাক্ত করতে ব্যবহৃত হয়, উদাহরণস্বরূপ, "1234-5678-9012"৷ এটি চালান পিডিএফ-এ "বিলিং আইডি" হিসাবে প্রদর্শিত হয়। |
issueDate | শুধুমাত্র আউটপুট। ইস্যুর তারিখ yyyy-mm-dd ফর্ম্যাটে। এটি চালান পিডিএফ-এ "ইস্যু তারিখ" বা "চালানের তারিখ" হিসাবে প্রদর্শিত হয়। |
dueDate | শুধুমাত্র আউটপুট। yyyy-mm-dd ফর্ম্যাটে নির্ধারিত তারিখ৷ |
currencyCode | শুধুমাত্র আউটপুট। মুদ্রা কোড। সমস্ত খরচ এই মুদ্রায় ফেরত দেওয়া হয়. ISO 4217 মান থেকে প্রাপ্ত মুদ্রা কোডগুলির একটি উপসেট সমর্থিত। |
exportChargeSubtotalAmountMicros | শুধুমাত্র আউটপুট। মাইক্রোতে ইনভয়েস লেভেল এক্সপোর্ট চার্জের প্রিট্যাক্স সাবটোটাল পরিমাণ। |
exportChargeTaxAmountMicros | শুধুমাত্র আউটপুট। মাইক্রোতে ইনভয়েস স্তরের রপ্তানি চার্জের ট্যাক্সের সমষ্টি। |
exportChargeTotalAmountMicros | শুধুমাত্র আউটপুট। মাইক্রোতে ইনভয়েস লেভেল এক্সপোর্ট চার্জের মোট পরিমাণ। |
subtotalAmountMicros | শুধুমাত্র আউটপুট। মাইক্রোতে প্রিট্যাক্স সাবটোটাল পরিমাণ। এটি AccountBudgetSummary সাবটোটাল রাশি এবং Invoice.adjustments_subtotal_amount_micros এর সমষ্টির সমান। |
taxAmountMicros | শুধুমাত্র আউটপুট। মাইক্রোতে চালানের সমস্ত করের সমষ্টি। এটি AccountBudgetSummary ট্যাক্সের পরিমাণের সমষ্টির সমান, এবং ট্যাক্সগুলি একটি নির্দিষ্ট অ্যাকাউন্ট বাজেটের সাথে যুক্ত নয়। |
totalAmountMicros | শুধুমাত্র আউটপুট। মাইক্রোতে মোট পরিমাণ। এটি Invoice.subtotal_amount_micros, Invoice.tax_amount_micros, Invoice.regulatory_costs_subtotal_amount_micros, এবং Invoice.export_charge_subtotal_amount_micros (যা V41 শুরু করে একটি পৃথক লাইন আইটেমে বিভক্ত) এর সমষ্টির সমান। |
correctedInvoice | শুধুমাত্র আউটপুট। যদি প্রযোজ্য হয় তবে এই চালানের মাধ্যমে মূল চালানের সম্পদের নাম সংশোধন করা হয়েছে, লিখে দেওয়া হয়েছে বা বাতিল করা হয়েছে। |
pdfUrl | শুধুমাত্র আউটপুট। চালানের একটি PDF কপির URL। এই URL এর সাথে PDF এর জন্য অনুরোধ করতে ব্যবহারকারীদের তাদের OAuth টোকেন পাস করতে হবে। |
চালান প্রকার
চালানের সম্ভাব্য প্রকার।
Enums | |
---|---|
UNSPECIFIED | উল্লেখ করা হয়নি। |
UNKNOWN | শুধুমাত্র রিটার্ন মান জন্য ব্যবহৃত. এই সংস্করণে অজানা মান প্রতিনিধিত্ব করে। |
CREDIT_MEMO | ঋণাত্মক পরিমাণ সহ একটি চালান। অ্যাকাউন্ট একটি ক্রেডিট পায়. |
INVOICE | একটি ধনাত্মক পরিমাণ সহ একটি চালান৷ অ্যাকাউন্টে একটি ব্যালেন্স বকেয়া আছে। |
AccountBudget Summary
একটি সংক্ষিপ্ত অ্যাকাউন্ট বাজেট বিলযোগ্য খরচ প্রতিনিধিত্ব করে।
JSON প্রতিনিধিত্ব |
---|
{ "billableActivityDateRange": { object ( |
ক্ষেত্র | |
---|---|
billableActivityDateRange | শুধুমাত্র আউটপুট। এই চালানের পরিষেবা তারিখের পরিসরের মধ্যে অ্যাকাউন্ট বাজেটের বিলযোগ্য কার্যকলাপ তারিখ পরিসর। শেষ তারিখ অন্তর্ভুক্ত। এটি অ্যাকাউন্টের বাজেটের শুরু এবং শেষের সময় থেকে আলাদা হতে পারে। |
invalidActivitySummaries[] | শুধুমাত্র আউটপুট। মূল লিঙ্কেজ সহ অবৈধ কার্যকলাপ ক্রেডিটগুলির সংক্ষিপ্ত তালিকা। |
customer | শুধুমাত্র আউটপুট। এই অ্যাকাউন্ট বাজেটের সাথে যুক্ত গ্রাহকের সম্পদের নাম। এতে গ্রাহক আইডি থাকে, যা চালান পিডিএফ-এ "অ্যাকাউন্ট আইডি" হিসাবে প্রদর্শিত হয়। গ্রাহক সম্পদ নামের ফর্ম আছে: |
customerDescriptiveName | শুধুমাত্র আউটপুট। অ্যাকাউন্ট বাজেটের গ্রাহকের বর্ণনামূলক নাম। এটি চালান পিডিএফ-এ "অ্যাকাউন্ট" হিসাবে প্রদর্শিত হবে। |
accountBudget | শুধুমাত্র আউটপুট। এই সংক্ষিপ্ত বিলযোগ্য খরচের সাথে সম্পর্কিত অ্যাকাউন্ট বাজেটের সম্পদের নাম। AccountBudget সম্পদের নামের ফর্ম আছে: |
accountBudgetName | শুধুমাত্র আউটপুট। হিসাব বাজেটের নাম। এটি চালান পিডিএফ-এ "অ্যাকাউন্ট বাজেট" হিসাবে প্রদর্শিত হয়। |
purchaseOrderNumber | শুধুমাত্র আউটপুট। অ্যাকাউন্ট বাজেটের ক্রয় অর্ডার নম্বর। এটি চালান পিডিএফ-এ "পারচেজ অর্ডার" হিসাবে প্রদর্শিত হয়। |
subtotalAmountMicros | শুধুমাত্র আউটপুট। মাইক্রোতে পরিষেবার সময়কালে এই বাজেটের জন্য প্রিট্যাক্স সাবটোটাল পরিমাণ। |
taxAmountMicros | শুধুমাত্র আউটপুট। মাইক্রোতে পরিষেবার সময়কালে এই বাজেটের জন্য দায়ী করের পরিমাণ। |
totalAmountMicros | শুধুমাত্র আউটপুট। মাইক্রোতে পরিষেবার সময়কালে এই বাজেটের জন্য দায়ী মোট পরিমাণ। এটি অ্যাকাউন্ট বাজেটের সাবটোটাল রাশি এবং অ্যাকাউন্ট বাজেট ট্যাক্সের পরিমাণের সমান। |
servedAmountMicros | শুধুমাত্র আউটপুট। মাইক্রোতে পরিষেবার সময়কালে এই বাজেটের জন্য প্রিট্যাক্স পরিবেশিত পরিমাণ। এটি শুধুমাত্র চালান এবং ডেলিভারি ডেটা সমন্বয় করতে উপযোগী। |
billedAmountMicros | শুধুমাত্র আউটপুট। মাইক্রোতে পরিষেবার সময়কালে এই বাজেটের জন্য প্রিট্যাক্স বিল করা পরিমাণ। এটি কোন সমন্বয় জন্য অ্যাকাউন্ট না. |
overdeliveryAmountMicros | শুধুমাত্র আউটপুট। মাইক্রোস (নেতিবাচক মান) মধ্যে পরিষেবার সময়কালে এই বাজেটের জন্য প্রিট্যাক্স ওভারডেলিভারি পরিমাণ। |
invalidActivityAmountMicros | শুধুমাত্র আউটপুট। মাইক্রোস (নেতিবাচক মান) তে, পূর্ববর্তী মাসগুলিতে এই বাজেটের জন্য প্রিট্যাক্স অবৈধ কার্যকলাপের পরিমাণ। |
অবৈধ কার্যকলাপের সারাংশ
ইনভয়েসের জন্য অবৈধ কার্যকলাপ সম্পর্কে বিশদ বিবরণ যাতে ইনভয়েস সম্পর্কে অতিরিক্ত বিবরণ থাকে যার বিরুদ্ধে সংশোধন করা হয়।
JSON প্রতিনিধিত্ব |
---|
{
"originalMonthOfService": enum ( |
ক্ষেত্র | |
---|---|
originalMonthOfService | শুধুমাত্র আউটপুট। এই অবৈধ কার্যকলাপ ক্রেডিট সম্পর্কিত পরিষেবার মূল মাস। |
originalYearOfService | শুধুমাত্র আউটপুট। এই অবৈধ কার্যকলাপ ক্রেডিট সম্পর্কিত পরিষেবার মূল বছর। |
originalInvoiceId | শুধুমাত্র আউটপুট। এই অবৈধ কার্যকলাপ ক্রেডিট সম্পর্কিত আসল চালান নম্বর। |
originalAccountBudgetName | শুধুমাত্র আউটপুট। এই অবৈধ কার্যকলাপ ক্রেডিট সম্পর্কিত মূল অ্যাকাউন্ট বাজেট নাম. |
originalPurchaseOrderNumber | শুধুমাত্র আউটপুট। এই অবৈধ কার্যকলাপ ক্রেডিট সম্পর্কিত আসল ক্রয় অর্ডার নম্বর। |
amountMicros | শুধুমাত্র আউটপুট। মাইক্রোতে অবৈধ কার্যকলাপ পরিমাণ। |
অ্যাকাউন্টের সারাংশ
অ্যাকাউন্ট স্তরে একটি সংক্ষিপ্ত দৃশ্যের প্রতিনিধিত্ব করে।
JSON প্রতিনিধিত্ব |
---|
{ "customer": string, "billingCorrectionSubtotalAmountMicros": string, "billingCorrectionTaxAmountMicros": string, "billingCorrectionTotalAmountMicros": string, "couponAdjustmentSubtotalAmountMicros": string, "couponAdjustmentTaxAmountMicros": string, "couponAdjustmentTotalAmountMicros": string, "excessCreditAdjustmentSubtotalAmountMicros": string, "excessCreditAdjustmentTaxAmountMicros": string, "excessCreditAdjustmentTotalAmountMicros": string, "regulatoryCostsSubtotalAmountMicros": string, "regulatoryCostsTaxAmountMicros": string, "regulatoryCostsTotalAmountMicros": string, "exportChargeSubtotalAmountMicros": string, "exportChargeTaxAmountMicros": string, "exportChargeTotalAmountMicros": string, "subtotalAmountMicros": string, "taxAmountMicros": string, "totalAmountMicros": string } |
ক্ষেত্র | |
---|---|
customer | শুধুমাত্র আউটপুট। অ্যাকাউন্টের সারাংশের সাথে যুক্ত অ্যাকাউন্ট। |
billingCorrectionSubtotalAmountMicros | শুধুমাত্র আউটপুট। প্রিট্যাক্স বিলিং সংশোধন সাবটোটাল পরিমাণ, মাইক্রোতে। |
billingCorrectionTaxAmountMicros | শুধুমাত্র আউটপুট। বিলিং সংশোধনের উপর ট্যাক্স, মাইক্রোতে। |
billingCorrectionTotalAmountMicros | শুধুমাত্র আউটপুট। মোট বিলিং সংশোধনের পরিমাণ, মাইক্রোতে। |
couponAdjustmentSubtotalAmountMicros | শুধুমাত্র আউটপুট। প্রিট্যাক্স কুপন সমন্বয় সাবটোটাল পরিমাণ, মাইক্রোতে। |
couponAdjustmentTaxAmountMicros | শুধুমাত্র আউটপুট। কুপন সমন্বয় উপর ট্যাক্স, মাইক্রো. |
couponAdjustmentTotalAmountMicros | শুধুমাত্র আউটপুট। মোট কুপন সামঞ্জস্যের পরিমাণ, মাইক্রোতে। |
excessCreditAdjustmentSubtotalAmountMicros | শুধুমাত্র আউটপুট। প্রিট্যাক্স অতিরিক্ত ক্রেডিট সমন্বয় সাবটোটাল পরিমাণ, মাইক্রোতে। |
excessCreditAdjustmentTaxAmountMicros | শুধুমাত্র আউটপুট। অতিরিক্ত ক্রেডিট সমন্বয়ের উপর ট্যাক্স, মাইক্রোতে। |
excessCreditAdjustmentTotalAmountMicros | শুধুমাত্র আউটপুট। মাইক্রোতে মোট অতিরিক্ত ক্রেডিট সমন্বয়ের পরিমাণ। |
regulatoryCostsSubtotalAmountMicros | শুধুমাত্র আউটপুট। প্রিট্যাক্স নিয়ন্ত্রক খরচ সাবটোটাল পরিমাণ, মাইক্রোতে। |
regulatoryCostsTaxAmountMicros | শুধুমাত্র আউটপুট। মাইক্রোতে নিয়ন্ত্রক খরচের উপর ট্যাক্স। |
regulatoryCostsTotalAmountMicros | শুধুমাত্র আউটপুট। মাইক্রোতে মোট নিয়ন্ত্রক খরচের পরিমাণ। |
exportChargeSubtotalAmountMicros | শুধুমাত্র আউটপুট। প্রিট্যাক্স এক্সপোর্ট চার্জ সাবটোটাল পরিমাণ, মাইক্রোতে। |
exportChargeTaxAmountMicros | শুধুমাত্র আউটপুট। মাইক্রোতে এক্সপোর্ট চার্জের উপর ট্যাক্স। |
exportChargeTotalAmountMicros | শুধুমাত্র আউটপুট। মোট এক্সপোর্ট চার্জের পরিমাণ, মাইক্রোতে। |
subtotalAmountMicros | শুধুমাত্র আউটপুট। মাইক্রোতে পরিষেবার সময়কালে অ্যাকাউন্টে আরোপযোগ্য মোট প্রিট্যাক্স সাবটোটাল পরিমাণ। |
taxAmountMicros | শুধুমাত্র আউটপুট। মাইক্রোতে পরিষেবার সময়কালে অ্যাকাউন্টে মোট ট্যাক্সের পরিমাণ। |
totalAmountMicros | শুধুমাত্র আউটপুট। পরিষেবার সময়কালে অ্যাকাউন্টে যোগ করা মোট পরিমাণ, মাইক্রোতে। এটি সাবটোটালঅ্যামাউন্টমাইক্রো এবং ট্যাক্সঅ্যামাউন্টমাইক্রোর সমষ্টির সমান। |