बिलिंग सेट अप

बिलिंग सेटअप, Google Ads खाते और पेमेंट्स खाते (इसे इनवॉइस सेटअप भी कहा जाता है) के बीच अकाउंट-लेवल का लिंक होता है. इससे यह तय होता है कि बिलिंग सेटअप के खाते के बजट से होने वाले खर्च के लिए, किसे बिल भेजा जाएगा. हर पेमेंट्स खाते के लिए एक इनवॉइस होता है.

पेमेंट्स खातों के बारे में जानकारी

हर BillingSetup, उस पेमेंट्स खाते की पहचान करता है जिसे खाते के बजट से जुड़ी लागतों के लिए इनवॉइस भेजा जाता है. यह पेमेंट्स खाता, पेमेंट्स प्रोफ़ाइल से जुड़ा है. इस प्रोफ़ाइल के ज़रिए ही पेमेंट किया जाता है.

बिलिंग सेटअप में, payments_account फ़ील्ड और payments_account_info फ़ील्ड का ग्रुप, दोनों शामिल होते हैं. ये फ़ील्ड, इस्तेमाल किए जा रहे पेमेंट्स खाते की पहचान करते हैं. इनमें ये शामिल हैं:

  • payments_account_info.payments_account_id: यह 16 अंकों का आईडी होता है. इसे हाइफ़न वाली स्ट्रिंग के तौर पर फ़ॉर्मैट किया जाता है. उदाहरण के लिए, "1234-5678-9012-3456". इसका इस्तेमाल, बिलिंग सेटअप से जुड़े पेमेंट्स खाते की पहचान करने के लिए किया जाता है.
  • payments_account_info.payments_account_name: बिलिंग सेटअप से जुड़ा पेमेंट्स खाता. यह नाम, हर महीने के इनवॉइस पर प्रिंट होता है.
  • payments_account_info.payments_profile_id: यह 12 अंकों वाला आईडी होता है. इसे हाइफ़न वाली स्ट्रिंग के तौर पर फ़ॉर्मैट किया जाता है. उदाहरण के लिए, "1234-5678-9012". इसका इस्तेमाल, बिलिंग सेटअप से जुड़ी पेमेंट्स प्रोफ़ाइल की पहचान करने के लिए किया जाता है.

अगर कोई पेमेंट्स खाता, सभी खातों के लिए एक बिल की ज़रूरी शर्तें पूरी करता है, तो एक ही इनवॉइस में कई Google Ads खातों को ग्रुप किया जा सकता है. इसके लिए, उनके बिलिंग सेटअप को एक ही पेमेंट्स खाते का इस्तेमाल करने के लिए सेट करना होगा.

नए बिलिंग सेटअप बनाना

नए बिलिंग सेटअप को मौजूदा पेमेंट्स खातों से लिंक किया जा सकता है. इसके अलावा, उन्हें उन खातों से भी लिंक किया जा सकता है जिन्हें उसी समय बनाया गया हो.

किसी मौजूदा पेमेंट्स खाते का इस्तेमाल करना

किसी मौजूदा पेमेंट्स खाते से लिंक करने के लिए, payments_account को किसी मान्य पेमेंट्स खाते के संसाधन नाम पर सेट करें. उदाहरण के लिए, customers/{customer_id}/paymentsAccounts/{payments_account_id}. हालांकि, payments_account_info में बदलाव न करें.

PaymentsAccountService.ListPaymentsAccounts तरीके का इस्तेमाल करके, उपलब्ध पेमेंट्स खातों की सूची दी जा सकती है. PaymentsAccount ऑब्जेक्ट, पुष्टि करने के लिए इस्तेमाल किए गए मैनेजर खाते के हिसाब से दिखते हैं.

हर PaymentsAccount के लिए, उसके पैसे चुकाने वाले मैनेजर का संसाधन नाम, paying_manager_customer फ़ील्ड में होता है.

नए पेमेंट्स खाते का इस्तेमाल करना

किसी नए पेमेंट्स खाते से लिंक करने के लिए, payments_account_info में ये फ़ील्ड सेट करें (payments_account को सेट न करें):

यहां दिए गए उदाहरण में, मौजूदा पेमेंट्स प्रोफ़ाइल आईडी से नया बिलिंग सेटअप बनाने का तरीका बताया गया है. जैसा कि पहले बताया गया था, इससे 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 को भी फ़ेच किया जाता है. इसके लिए, Google Ads क्वेरी लैंग्वेज (GAQL) क्वेरी का इस्तेमाल करके GoogleAdsService.Search या GoogleAdsService.SearchStream को क्वेरी किया जाता है. इस क्वेरी में यह तय किया जाता है कि किन फ़ील्ड को वापस लाना है:

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 हों.