बिलिंग सेट अप

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

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

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

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

  • payments_account_info.payments_account_id: यह 16 अंकों का आईडी होता है, जिसे हाइफ़न वाली स्ट्रिंग के तौर पर फ़ॉर्मैट किया जाता है (उदाहरण के लिए, "1234-5678-9012-3456"). इसका इस्तेमाल, बिलिंग सेटअप से जुड़े पेमेंट्स खाते की पहचान करने के लिए किया जाता है.
  • payments_account_info.payments_account_name: बिलिंग सेटअप से जुड़े पेमेंट्स खाते का नाम. यह नाम, हर महीने के इनवॉइस पर प्रिंट होता है.
  • payments_account_info.payments_profile_id: यह 12 अंकों का आईडी होता है, जिसे हाइफ़न वाली स्ट्रिंग के तौर पर फ़ॉर्मैट किया जाता है. उदाहरण के लिए, "1234-5678-9012". इसका इस्तेमाल, बिलिंग सेटअप से जुड़ी पेमेंट्स प्रोफ़ाइल की पहचान करने के लिए किया जाता है.

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

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

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

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

किसी मौजूदा पेमेंट्स खाते से लिंक करने के लिए, payments_account को किसी मान्य पेमेंट्स खाते के संसाधन के नाम पर सेट करें. उदाहरण के लिए, customers/{customer_id}/paymentsAccounts/{payments_account_id}. हालांकि, payments_account_info में बदलाव न करें.

PaymentsAccountService.ListPaymentsAccounts तरीके का इस्तेमाल करके, उपलब्ध पेमेंट्स खातों की सूची देखी जा सकती है. लौटाए गए PaymentsAccount ऑब्जेक्ट, उस मैनेजर खाते पर निर्भर करते हैं जिसका इस्तेमाल आपने पुष्टि करने के लिए किया है.

हर PaymentsAccount के लिए, उसके पेइंग मैनेजर का संसाधन नाम, paying_manager_customer फ़ील्ड में होता है.

नए पेमेंट्स खाते का इस्तेमाल करना

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

यहां दिए गए उदाहरण में, मौजूदा पेमेंट्स प्रोफ़ाइल आईडी से नया बिलिंग सेटअप बनाने का तरीका बताया गया है. जैसा कि पहले बताया गया है, इससे My New Payments Account नाम से एक नया पेमेंट्स खाता भी बन जाता है.

BillingSetup billingSetup =
    BillingSetup.newBuilder()
        .setPaymentsAccountInfo(
            PaymentsAccountInfo.newBuilder()
                .setPaymentsAccountName("My New Payments Account")
                .setPaymentsProfileId("1234-5678-9012")
                .build())
        .setStartTimeType(TimeTypeEnum.TimeType.NOW)
        .build();

BillingSetupOperation operation =
    BillingSetupOperation.newBuilder().setCreate(billingSetup).build();

try (BillingSetupServiceClient billingSetupServiceClient =
    googleAdsClient.getBillingSetupServiceClient()) {
  MutateBillingSetupResponse response =
      billingSetupServiceClient.mutateBillingSetup(
          Long.toString(customerId), operation);
}

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

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

BillingSetup के नए इंस्टेंस लागू होने से पहले, उन्हें मंज़ूरी लेनी होगी. तब तक, उनके status का स्टेटस PENDING रहेगा.

BillingSetup में इनमें से कोई एक status वैल्यू हो सकती है:

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

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

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

SELECT
  billing_setup.resource_name,
  billing_setup.id,
  billing_setup.status,
  billing_setup.payments_account,
  billing_setup.payments_account_info.payments_account_id,
  billing_setup.payments_account_info.payments_account_name,
  billing_setup.payments_account_info.payments_profile_id,
  billing_setup.payments_account_info.payments_profile_name,
  billing_setup.start_date_time,
  billing_setup.end_date_time,
  billing_setup.end_time_type
FROM billing_setup

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

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

ऐसा BillingSetup जो अब तक लागू नहीं हुआ है, उसे रद्द किया जा सकता है. इसके लिए, BillingSetupOperation भेजें. इसमें remove फ़ील्ड को बिलिंग सेटअप (customers/{customer_id}/billingSetups/{billing_setup_id}) के रिसॉर्स नेम पर सेट करें. बिलिंग सेटअप सिर्फ़ तब रद्द किए जा सकते हैं, जब उनका status, PENDING हो या उन्हें आने वाले समय में शुरू होने के लिए APPROVED किया गया हो.

पीछे जाएं
बिलिंग की खास जानकारी
आगे बढ़ें
खाते का बजट