चेतावनी: आप एपीआई के REST इंटरफ़ेस के बारे में दस्तावेज़ देख रहे हैं. हमारी ज़्यादातर आधिकारिक क्लाइंट लाइब्रेरी, gRPC का इस्तेमाल करती हैं. ज़्यादा जानकारी के लिए, REST के बारे में जानकारी देखें.

इस पेज का अनुवाद Cloud Translation API से किया गया है.

BillingSetup

JSON फ़ॉर्मैट में दिखाना
BillingSetupStatus
PaymentsAccountInfo
- JSON फ़ॉर्मैट में दिखाना

ऐसा बिलिंग सेट अप जो पेमेंट्स खाता और विज्ञापन देने वाले से जुड़ा होता है. बिलिंग सेट अप, विज्ञापन देने वाले सिर्फ़ एक व्यक्ति या कंपनी के लिए होता है.

जेएसओएन के काेड में दिखाना

जेएसओएन के काेड में दिखाना
{ "resourceName": string, "status": enum (`BillingSetupStatus`), "paymentsAccountInfo": { object (`PaymentsAccountInfo`) }, "id": string, "paymentsAccount": string, // Union field `start_time` can be only one of the following: "startDateTime": string, "startTimeType": enum (`TimeType`) // End of list of possible types for union field `start_time`. // Union field `end_time` can be only one of the following: "endDateTime": string, "endTimeType": enum (`TimeType`) // End of list of possible types for union field `end_time`. }

{
  "resourceName": string,
  "status": enum (BillingSetupStatus),
  "paymentsAccountInfo": {
    object (PaymentsAccountInfo)
  },
  "id": string,
  "paymentsAccount": string,

  // Union field start_time can be only one of the following:
  "startDateTime": string,
  "startTimeType": enum (TimeType)
  // End of list of possible types for union field start_time.

  // Union field end_time can be only one of the following:
  "endDateTime": string,
  "endTimeType": enum (TimeType)
  // End of list of possible types for union field end_time.
}

फ़ील्ड
`resourceName`	`string` इम्यूटेबल. बिलिंग सेटअप के संसाधन का नाम. बिलिंग सेटअप के संसाधनों के नामों में यह फ़ॉर्म होता है: `customers/{customerId}/billingSetups/{billing_setup_id}`
`status`	`enum (BillingSetupStatus)` सिर्फ़ आउटपुट के लिए. बिलिंग सेटअप की स्थिति.
`paymentsAccountInfo`	`object (PaymentsAccountInfo)` इम्यूटेबल. इस बिलिंग सेटअप से जुड़े पेमेंट्स खाते की जानकारी. बिलिंग सेट अप करते समय, इसका इस्तेमाल नए पेमेंट्स खाते से साइन अप करने के लिए किया जाता है. इसके बाद, paymentsखाता सेट नहीं करना चाहिए. बिलिंग सेट अप करते समय, यह और पेमेंट्स खाते की जानकारी अपने-आप भर जाएगी.
`id`	`string (int64 format)` सिर्फ़ आउटपुट के लिए. बिलिंग सेटअप का आईडी.
`paymentsAccount`	`string` इम्यूटेबल. इस बिलिंग सेटअप से जुड़े पेमेंट्स खाते के संसाधन का नाम. पेमेंट रिसॉर्स के नाम में यह फ़ॉर्म होता है: `customers/{customerId}/paymentsAccounts/{paymentsAccountId}` बिलिंग सेट अप करते समय, इसका इस्तेमाल किसी मौजूदा पेमेंट्स खाते से साइन अप करने के लिए किया जाता है. इसके बाद, paymentsAccountInfo को सेट नहीं करना चाहिए. बिलिंग सेटअप करते समय, इस जानकारी और paymentsAccountInfo की जानकारी अपने-आप भर जाएगी.
यूनियन फ़ील्ड `start_time`. नया बिलिंग सेटअप बनाते समय, इस तारीख को सेटअप लागू होना चाहिए. अगर ग्राहक के पास कोई भी मंज़ूर किया गया सेटअप नहीं है, तो शुरुआत का समय सिर्फ़ NOW ही मान्य है. किसी मौजूदा बिलिंग सेटअप को फ़ेच करते समय, शुरू होने का अनुरोध किया गया समय होता है. हालांकि, अगर अनुरोध किए गए शुरू होने के समय के बाद सेटअप को स्वीकार किया गया (स्टेटस देखें), तो यह मंज़ूरी मिलने का समय होगा. `start_time` इनमें से सिर्फ़ एक हो सकती है:
`startDateTime`	`string` इम्यूटेबल. शुरू होने की तारीख का समय, yyyy-MM-dd या yyyy-MM-dd HH:mm:ss फ़ॉर्मैट में है. सिर्फ़ आगे के समय की अनुमति है.
`startTimeType`	`enum (TimeType)` इम्यूटेबल. टाइप के तौर पर, शुरू होने का समय. केवल NOW की अनुमति है.
यूनियन फ़ील्ड `end_time`. बिलिंग सेट अप खत्म या खत्म होने पर. यह शेड्यूल किए गए अगले बिलिंग सेटअप के शुरू होने का समय या हमेशा के लिए है. `end_time` इनमें से सिर्फ़ एक हो सकती है:
`endDateTime`	`string` सिर्फ़ आउटपुट के लिए. खत्म होने की तारीख का समय, yyyy-MM-dd या yyyy-MM-dd HH:mm:ss फ़ॉर्मैट में है.
`endTimeType`	`enum (TimeType)` सिर्फ़ आउटपुट के लिए. टाइप के तौर पर, खत्म होने का समय. एकमात्र संभावित मान हमेशा के लिए है.

BillingSetupStatus

बिलिंग सेटअप की संभावित स्थितियां.

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

PaymentsAccountInfo

इस बिलिंग के लिए, पेमेंट्स खाते की जानकारी का कंटेनर.

जेएसओएन के काेड में दिखाना
{ "paymentsAccountId": string, "paymentsAccountName": string, "paymentsProfileId": string, "paymentsProfileName": string, "secondaryPaymentsProfileId": string }

फ़ील्ड
`paymentsAccountId`	`string` सिर्फ़ आउटपुट के लिए. 16 अंकों का आईडी, जिसका इस्तेमाल बिलिंग सेटअप से जुड़े पेमेंट्स खाते की पहचान करने के लिए किया जाता है. इसे डैश वाली स्ट्रिंग के तौर पर पास किया जाना चाहिए. उदाहरण के लिए, "1234-5678-9012-3456".
`paymentsAccountName`	`string` इम्यूटेबल. बिलिंग सेटअप से जुड़े पेमेंट्स खाते का नाम. इससे उपयोगकर्ता, पेमेंट्स खाते के लिए कोई सही नाम तय कर सकता है, जिससे महीने के इनवॉइस का मिलान करने में मदद मिलती है. यह नाम, हर महीने के इनवॉइस में प्रिंट किया जाएगा.
`paymentsProfileId`	`string` इम्यूटेबल. 12 अंकों का आईडी, जिसका इस्तेमाल बिलिंग सेटअप से जुड़ी पेमेंट्स प्रोफ़ाइल की पहचान करने के लिए किया जाता है. इसे डैश वाली स्ट्रिंग के तौर पर पास किया जाना चाहिए, उदाहरण के लिए, "1234-5678-9012".
`paymentsProfileName`	`string` सिर्फ़ आउटपुट के लिए. बिलिंग सेटअप से जुड़ी पेमेंट्स प्रोफ़ाइल का नाम.
`secondaryPaymentsProfileId`	`string` सिर्फ़ आउटपुट के लिए. दूसरा पेमेंट्स प्रोफ़ाइल आईडी, जो असामान्य स्थितियों में मौजूद होता है. उदाहरण के लिए, क्रम के मुताबिक देनदारी का कानूनी समझौता.