बिलिंग सेट अप

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

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

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

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

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

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

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

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

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

किसी मौजूदा पेमेंट्स खाते से जोड़ने के लिए, payments_account को किसी मान्य पेमेंट्स खाते के संसाधन आईडी पर सेट करें. हालांकि, payments_account_info में बदलाव न करें.

PaymentsAccountService.ListPaymentsAccounts तरीके का इस्तेमाल करके, उपलब्ध पेमेंट्स खातों की सूची बनाई जा सकती है. नतीजे के तौर पर मिला PaymentsAccounts, पुष्टि के लिए इस्तेमाल किए जाने वाले मैनेजर खाते पर निर्भर करता है.

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

नए पेमेंट्स खाते का उपयोग करना

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

नीचे दिए गए उदाहरण में, मौजूदा पेमेंट्स प्रोफ़ाइल आईडी से नया बिलिंग सेट अप बनाने का तरीका बताया गया है. जैसा कि ऊपर बताया गया है, इससे 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);
}

अगर Google Ads खाते में यह पहला बिलिंग सेट अप जोड़ा जा रहा है, तो यह बताए गए पेमेंट्स प्रोफ़ाइल का इस्तेमाल करके ग्राहक को बिलिंग के लिए असरदार तरीके से साइन अप करेगा.

बिलिंग सेटअप का स्टेटस

BillingSetup के नए इंस्टेंस को अनुमति के बाद ही लागू किया जा सकता है. तब तक, उनके status की स्थिति PENDING है.

BillingSetup, इनमें से किसी एक status में हो सकता है:

बिलिंग सेटअप का स्टेटस ब्यौरा
PENDING मंज़ूरी मिलनी बाकी.
APPROVED_HELD स्वीकार कर लिया गया है, लेकिन उससे जुड़ा पहला बजट स्वीकार नहीं किया गया है. ऐसा सिर्फ़ महीने के इनवॉइस के लिए कॉन्फ़िगर किए गए बिलिंग सेटअप के लिए हो सकता है.
APPROVED सेटअप को मंज़ूरी मिल गई है.
CANCELLED अनुमति मिलने से पहले, उपयोगकर्ता ने सेटअप को रद्द कर दिया.

किसी खाते का बिलिंग सेटअप वापस पाना

Google Ads API की दूसरी इकाइयों की तरह, BillingSetup को भी GoogleAdsService.SearchStream के लिए क्वेरी करके फ़ेच किया जाता है. ऐसा Google Ads की क्वेरी लैंग्वेज क्वेरी का इस्तेमाल करके किया जाता है, जो यह तय करती है कि कौनसे फ़ील्ड दिखाए जाने हैं.

BillingSetup का रेफ़रंस मिलने के बाद, उसका इस्तेमाल AccountBudgetProposal करने के लिए किया जा सकता है, जैसा कि खाते का बजट में बताया गया है.

रुका हुआ बिलिंग सेटअप रद्द करना

अगर BillingSetup अभी तक लागू नहीं हुआ है, तो उसे हटाने की कार्रवाई इस्तेमाल करके रद्द किया जा सकता है. बिलिंग सेट अप सिर्फ़ तब रद्द किए जा सकते हैं, जब उनका status PENDING हो या APPROVED को आने वाले समय में शुरू करना हो.