बिलिंग सेटअप, 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
हो कि वे आने वाले समय में शुरू होने वाले हैं.