बिलिंग सेट अप

बिलिंग सेटअप, 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):

• payments_account_name
• payments_profile_id

ध्यान दें: payments_account और payments_account_info, दोनों की जानकारी बिलिंग सेट अप के बाद के वर्शन में दिखेगी.

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