चेतावनी: आप एपीआई के 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)` इम्यूटेबल. इस बिलिंग सेट अप से जुड़े पेमेंट्स खाते की जानकारी. बिलिंग सेट अप करते समय, इसका इस्तेमाल नए पेमेंट्स खाते में साइन अप करने के लिए किया जाता है. इसके बाद, पेमेंट्स खाता सेट नहीं करना चाहिए. बिलिंग सेट अप करते समय, इस पेमेंट्स खाते की जानकारी अपने-आप भर जाएगी.
`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` सिर्फ़ आउटपुट के लिए. असामान्य स्थितियों में मौजूद दूसरा पेमेंट्स प्रोफ़ाइल आईडी. उदाहरण के लिए, क्रम के मुताबिक देनदारी का कानूनी समझौता तय करने पर.