বিলিং সেট-আপ

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

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

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

বিলিং সেট-আপে 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") যা বিলিং সেট-আপের সাথে যুক্ত পেমেন্ট প্রোফাইল শনাক্ত করতে ব্যবহার করা হয়।

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

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

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

আগে থেকে থাকা পেমেন্ট অ্যাকাউন্ট ব্যবহার করুন

আগে থেকে আছে এমন কোনও Payments অ্যাকাউন্টের সাথে লিঙ্ক করতে, payments_account-কে কোনও সঠিক Payments অ্যাকাউন্টের রিসোর্স নেমে সেট করুন (যেমন, 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

মনে রাখবেন: বিলিং সেট-আপের পরবর্তী রিট্রিভালে payments_account এবং payments_account_info উভয়ই পপুলেট করা হবে।

আগে থেকে থাকা পেমেন্ট প্রোফাইল আইডি থেকে কীভাবে নতুন বিলিং সেট-আপ তৈরি করতে হয় তা নিম্নলিখিত উদাহরণ থেকে দেখুন। আগে যেমন বলা হয়েছে, এর ফলে 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);
}

Google Ads অ্যাকাউন্টে প্রথমবার বিলিং সেট-আপ যোগ করা হলে, এটি রেফারেন্স দেওয়া পেমেন্ট প্রোফাইল ব্যবহার করে বিলিংয়ের জন্য গ্রাহককে কার্যকরভাবে সাইন-আপ করবে।

বিলিং সেট-আপের স্ট্যাটাস

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

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

BillingSetupStatus	বিবরণ
PENDING	অনুমোদন করা বাকি আছে।
APPROVED_HELD	অনুমোদিত, তবে সংশ্লিষ্ট প্রথম বাজেট অনুমোদিত হয়নি। মাসিক ইনভয়েসের জন্য কনফিগার করা বিলিং সেট-আপের ক্ষেত্রেই শুধু এটি হতে পারে।
APPROVED	সেট-আপ অনুমোদন করা হয়েছে।
CANCELLED	অনুমোদন পাওয়ার আগেই ব্যবহারকারী সেট-আপ বাতিল করে দিয়েছেন।

কোনও অ্যাকাউন্টের বিলিং সেট-আপ ফিরিয়ে আনা

Google Ads API-তে অন্যান্য বেশিরভাগ এন্টিটির মতো, BillingSetup GoogleAdsService.Search বা GoogleAdsService.SearchStream-এ কোয়েরি করে ফেচ করা হয়, এর জন্য Google Ads কোয়েরি ল্যাঙ্গুয়েজ (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-এর রেফারেন্স পেয়ে গেলে, অ্যাকাউন্ট বাজেট-এ যেভাবে বর্ণনা করা হয়েছে সেইভাবে AccountBudgetProposal তৈরি করতে এটি ব্যবহার করতে পারবেন।

বাকি থাকা বিলিং সেট-আপ বাতিল করা

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