बिलिंग सेटअप, 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 खातों के बिलिंग सेटअप सेट करके, एक ही इनवॉइस में कई 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
को फ़ेच करने के लिए, Google Ads क्वेरी लैंग्वेज की क्वेरी का इस्तेमाल करके GoogleAdsService.SearchStream
पर क्वेरी की जाती है. इस क्वेरी से यह तय होता है कि कौनसे फ़ील्ड दिखाने हैं.
BillingSetup
का रेफ़रंस मिलने के बाद, उसका इस्तेमाल करके AccountBudgetProposal
बनाया जा सकता है. इसके बारे में खाते का बजट सेक्शन में बताया गया है.
मंज़ूरी के लिए बाकी बिलिंग सेटअप रद्द करना
जिस BillingSetup
पर अब तक कोई असर नहीं पड़ा है उसे हटाने की कार्रवाई का इस्तेमाल करके रद्द किया जा सकता है. बिलिंग सेटअप सिर्फ़ तब रद्द किए जा सकते हैं, जब उनके status
PENDING
हों या आने वाले समय में उनके शुरू होने की तारीख APPROVED
हो.