বিলিং সেটআপ

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

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

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

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

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

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

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

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

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

বিদ্যমান কোনো পেমেন্টস অ্যাকাউন্টের সাথে লিঙ্ক করতে, payments_account একটি বৈধ পেমেন্টস অ্যাকাউন্টের রিসোর্স নামে সেট করুন (উদাহরণস্বরূপ, customers/{customer_id}/paymentsAccounts/{payments_account_id} )। তবে, payments_account_info পরিবর্তন করবেন না ।

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

প্রতিটি PaymentsAccount ক্ষেত্রে, তার পেমেন্ট ম্যানেজারের রিসোর্স নেমটি paying_manager_customer ফিল্ডে থাকে।

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

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

• payments_account_name
• payments_profile_id

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

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

BillingSetupOperation operation =
    BillingSetupOperation.newBuilder().setCreate(billingSetup).build();

try (BillingSetupServiceClient billingSetupServiceClient =
    googleAdsClient.getBillingSetupServiceClient()) {
  MutateBillingSetupResponse response =
      billingSetupServiceClient.mutateBillingSetup(
          Long.toString(customerId), operation);
}

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

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

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

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

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

Google Ads API-এর অন্যান্য বেশিরভাগ এনটিটির মতোই, একটি BillingSetup ফেচ করা হয় GoogleAdsService.Search অথবা GoogleAdsService.SearchStream একটি Google Ads Query Language (GAQL) কোয়েরি ব্যবহার করে কোয়েরি করার মাধ্যমে, যেখানে নির্দিষ্ট করে দেওয়া হয় কোন কোন ফিল্ড রিটার্ন করা হবে:

SELECT
  billing_setup.resource_name,
  billing_setup.id,
  billing_setup.status,
  billing_setup.payments_account,
  billing_setup.payments_account_info.payments_account_id,
  billing_setup.payments_account_info.payments_account_name,
  billing_setup.payments_account_info.payments_profile_id,
  billing_setup.payments_account_info.payments_profile_name,
  billing_setup.start_date_time,
  billing_setup.end_date_time,
  billing_setup.end_time_type
FROM billing_setup

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

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

যে BillingSetup এখনও কার্যকর হয়নি, সেটি বাতিল করতে হলে একটি BillingSetupOperation পাঠাতে হবে এবং এর remove ফিল্ডটিকে বিলিং সেটআপটির রিসোর্স নামে ( customers/{customer_id}/billingSetups/{billing_setup_id} ) সেট করতে হবে। বিলিং সেটআপগুলো কেবল তখনই বাতিল করা যাবে, যদি সেগুলোর status PENDING থাকে অথবা ভবিষ্যতে কোনো এক সময়ে চালু হওয়ার জন্য সেগুলো APPROVED থাকে।