বিলিং সেটআপ

বিলিং সেটআপ হলো একটি গুগল অ্যাডস অ্যাকাউন্ট এবং একটি পেমেন্টস অ্যাকাউন্টের মধ্যেকার অ্যাকাউন্ট-স্তরের সংযোগ (যা ইনভয়েস সেটআপ নামেও পরিচিত), যা কার্যকরভাবে নির্ধারণ করে যে বিলিং সেটআপের অ্যাকাউন্ট বাজেট দ্বারা ব্যয়িত খরচের জন্য কাকে বিল করা হবে। প্রতিটি পেমেন্টস অ্যাকাউন্ট একটিমাত্র ইনভয়েসের সাথে যুক্ত থাকে।

পেমেন্ট অ্যাকাউন্ট সম্পর্কে

প্রতিটি BillingSetup একটি পেমেন্টস অ্যাকাউন্ট শনাক্ত করে, যেটিকে তার অ্যাকাউন্ট বাজেট অনুযায়ী সংঘটিত খরচের জন্য চালান পাঠানো হয়। এই পেমেন্টস অ্যাকাউন্টটি একটি পেমেন্টস প্রোফাইলের সাথে যুক্ত থাকে, যা চূড়ান্তভাবে চার্জের জন্য দায়ী।

বিলিং সেটআপে একটি payments_account ফিল্ড এবং একগুচ্ছ payments_account_info ফিল্ড থাকে, যা ব্যবহৃত পেমেন্ট অ্যাকাউন্টটি শনাক্ত করে, যার মধ্যে নিম্নলিখিতগুলো অন্তর্ভুক্ত:

• payments_account_info.payments_account_id : বিলিং সেটআপের সাথে যুক্ত পেমেন্টস অ্যাকাউন্ট শনাক্ত করতে ব্যবহৃত একটি ১৬-সংখ্যার আইডি।
• payments_account_info.payments_account_name : বিলিং সেটআপের সাথে যুক্ত পেমেন্টস অ্যাকাউন্টের নাম। এই নামটি মাসিক ইনভয়েসে মুদ্রিত থাকে।
• payments_account_info.payments_profile_id : বিলিং সেটআপের সাথে যুক্ত পেমেন্টস প্রোফাইল শনাক্ত করতে ব্যবহৃত একটি ১২-সংখ্যার আইডি।

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

নতুন বিলিং সেটআপ তৈরি করুন

আপনি নতুন বিলিং সেটআপগুলোকে বিদ্যমান পেমেন্টস অ্যাকাউন্টের সাথে অথবা একই সময়ে তৈরি করা অ্যাকাউন্টগুলোর সাথে লিঙ্ক করতে পারেন।

একটি বিদ্যমান পেমেন্ট অ্যাকাউন্ট ব্যবহার করুন

বিদ্যমান কোনো পেমেন্টস অ্যাকাউন্টের সাথে লিঙ্ক করতে, payments_account একটি বৈধ পেমেন্টস অ্যাকাউন্টের রিসোর্স আইডি-তে সেট করুন। তবে, payments_account_info পরিবর্তন করবেন না ।

আপনি PaymentsAccountService.ListPaymentsAccounts মেথড ব্যবহার করে উপলব্ধ পেমেন্ট অ্যাকাউন্টগুলোর তালিকা দেখতে পারেন। ফেরত আসা PaymentsAccounts নির্ভর করে আপনার অথেনটিকেশনের জন্য ব্যবহৃত ম্যানেজার অ্যাকাউন্টের উপর।

প্রতিটি PaymentsAccount ক্ষেত্রে, তার অর্থ প্রদানকারী ম্যানেজারের আইডি paying_manager_customer ফিল্ডে থাকে।

একটি নতুন পেমেন্ট অ্যাকাউন্ট ব্যবহার করুন

নতুন পেমেন্টস অ্যাকাউন্টের সাথে লিঙ্ক করতে, payments_account_info তে নিম্নলিখিত ফিল্ডগুলি সেট করুন ( payments_account সেট করবেন না ):

• payments_account_name
• payments_profile_id

নিম্নলিখিত উদাহরণটি দেখায় কিভাবে একটি বিদ্যমান পেমেন্টস প্রোফাইল আইডি থেকে একটি নতুন বিলিং সেটআপ তৈরি করতে হয়। পূর্বে যেমন উল্লেখ করা হয়েছে, এটি My New Payments Account নামে একটি নতুন পেমেন্টস অ্যাকাউন্টও তৈরি করে।

BillingSetup bsetup = BillingSetup.newBuilder()
    .setPaymentsAccountInfo(PaymentsAccountInfo.newBuilder()
        .setPaymentsAccountName("My New Payments Account")
        .setPaymentsProfileId("1234-5678-9012")
        .build())
    .setStartTimeType(TimeType.NOW)
    .build();

BillingSetupOperation op = BillingSetupOperation.newBuilder().setCreate(bsetup).build();

try (BillingSetupServiceClient billingSetupServiceClient = googleAdsClient
    .getBillingSetupServiceClient()) {

  MutateBillingSetupResponse response =
      billingSetupServiceClient.mutateBillingSetup(Long.toString(customerId), op);
}

যদি কোনো গুগল অ্যাডস অ্যাকাউন্টে প্রথমবারের মতো বিলিং সেটআপ যোগ করা হয়, তাহলে এর মাধ্যমে গ্রাহক উল্লিখিত পেমেন্টস প্রোফাইল ব্যবহার করে বিলিংয়ের জন্য কার্যকরভাবে সাইন আপ করবেন।

বিলিং সেটআপের অবস্থা

নতুন BillingSetup ইনস্ট্যান্সগুলো কার্যকর হওয়ার আগে অনুমোদনের প্রয়োজন হয়। অনুমোদন না পাওয়া পর্যন্ত, সেগুলোর status PENDING অবস্থায় থাকে।

একটি BillingSetup নিম্নলিখিত status মধ্যে যেকোনো একটিতে থাকতে পারে:

একটি অ্যাকাউন্টের বিলিং সেটআপ পুনরুদ্ধার করুন

Google Ads API-এর অন্যান্য বেশিরভাগ এনটিটির মতোই, একটি BillingSetup GoogleAdsService.SearchStream কে কোয়েরি করার মাধ্যমে ফেচ করা হয়। এর জন্য এমন একটি Google Ads Query Language কোয়েরি ব্যবহার করতে হয়, যা নির্দিষ্ট করে দেয় কোন কোন ফিল্ড রিটার্ন করা হবে।

একবার আপনি BillingSetup এর একটি রেফারেন্স পেয়ে গেলে, Account Budget- এ বর্ণিত পদ্ধতি অনুযায়ী সেটি ব্যবহার করে একটি AccountBudgetProposal তৈরি করতে পারবেন।

অপেক্ষাধীন বিলিং সেটআপ বাতিল করুন

যে BillingSetup এখনও কার্যকর হয়নি, তা রিমুভ অপারেশন ব্যবহার করে বাতিল করা যেতে পারে। বিলিং সেটআপ শুধুমাত্র তখনই বাতিল করা যাবে, যদি সেটির status PENDING থাকে অথবা ভবিষ্যতে কোনো এক সময়ে শুরু হওয়ার জন্য সেটি APPROVED থাকে।