बिलिंग सेट अप

बिलिंग सेटअप, 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 में ये फ़ील्ड सेट करें. हालांकि, don't सेट 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 में मौजूद ज़्यादातर अन्य इकाइयों की तरह, a BillingSetup को भी the GoogleAdsService.SearchStream पर क्वेरी करके फ़ेच किया जाता है. इसके लिए, Google Ads Query Language की क्वेरी का इस्तेमाल किया जाता है. इस क्वेरी में, यह तय किया जाता है कि कौनसे फ़ील्ड की वैल्यू वापस मिलनी चाहिए.

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

मंज़ूरी के लिए सबमिट किए गए बिलिंग सेटअप को रद्द करना

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