Method: organizations.reportPropertyUsage

संगठन में मौजूद प्रॉपर्टी के लिए, तय किए गए महीने का इस्तेमाल और बिलिंग डेटा पाएं.

प्रत्येक डायरेक्ट क्लाइंट संगठन के लिए, उपयोगकर्ता को संगठन का एडमिन/बिलिंग एडमिन होना चाहिए, ताकि वह बिलिंग और इस्तेमाल का डेटा देख सके.

सेल्स पार्टनर क्लाइंट संगठन के लिए, उपयोगकर्ता को सेल्स पार्टनर संगठन का OrgAdmin/BillingAdmin होना चाहिए, ताकि वह बिलिंग और इस्तेमाल से जुड़ा डेटा देख सके. इसके अलावा, उपयोगकर्ता को सेल्स पार्टनर क्लाइंट संगठन का OrgAdmin/BillingAdmin होना चाहिए, ताकि वह सिर्फ़ इस्तेमाल से जुड़ा डेटा देख सके.

एचटीटीपी अनुरोध

POST https://marketingplatformadmin.googleapis.com/v1alpha/{organization=organizations/*}:reportPropertyUsage

यह यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ पैरामीटर

पैरामीटर
organization

string

ज़रूरी है. यह उस संगठन के बारे में बताता है जिसकी प्रॉपर्टी के इस्तेमाल की जानकारी दिखाई जाएगी.

फ़ॉर्मैट: organizations/{org_id}

अनुरोध का मुख्य भाग

अनुरोध के मुख्य हिस्से में, इस स्ट्रक्चर का डेटा शामिल होता है:

JSON के काेड में दिखाना 
{
  "month": string
}
फ़ील्ड
month

string

ज़रूरी है. प्रॉपर्टी के इस्तेमाल की सूची बनाने के लिए टारगेट महीना.

फ़ॉर्मैट: YYYY-MM. उदाहरण के लिए, "2025-05"

जवाब का मुख्य भाग

organizations.reportPropertyUsage RPC के लिए जवाब का मैसेज.

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

JSON के काेड में दिखाना 
{
  "propertyUsages": [
    {
      object (PropertyUsage)
    }
  ],
  "billInfo": {
    object (BillInfo)
  }
}
फ़ील्ड
propertyUsages[]

object (PropertyUsage)

चुने गए संगठन और महीने की सभी प्रॉपर्टी के इस्तेमाल का डेटा.
billInfo

object (BillInfo)

संगठन और महीने के हिसाब से बिल की रकम.

अगर उपयोगकर्ता के पास सिर्फ़ इस्तेमाल से जुड़े डेटा का ऐक्सेस है, तो यह फ़ील्ड खाली होगा.

अनुमति पाने के लिंक

इसके लिए, इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:

  • https://www.googleapis.com/auth/marketingplatformadmin.analytics.read
  • https://www.googleapis.com/auth/marketingplatformadmin.analytics.update

PropertyUsage

इसमें प्रॉपर्टी को मिले इवेंट की संख्या शामिल होती है. साथ ही, इसमें ऐसा मेटाडेटा भी शामिल होता है जिससे billable इवेंट की संख्या पर असर पड़ता है.

JSON के काेड में दिखाना 
{
  "property": string,
  "displayName": string,
  "accountId": string,
  "serviceLevel": enum (AnalyticsServiceLevel),
  "propertyType": enum (AnalyticsPropertyType),
  "totalEventCount": string,
  "billableEventCount": string
}
फ़ील्ड
property

string

Google Analytics एडमिन एपीआई प्रॉपर्टी रिसॉर्स का नाम.

फ़ॉर्मैट: analyticsadmin.googleapis.com/properties/{property_id}
displayName

string

प्रॉपर्टी का डिसप्ले नेम.
accountId

string (int64 format)

प्रॉपर्टी के पैरंट खाते का आईडी.
serviceLevel

enum (AnalyticsServiceLevel)

प्रॉपर्टी का सेवा लेवल.
propertyType

enum (AnalyticsPropertyType)

Analytics प्रॉपर्टी का सबटाइप. इससे बिल किए जा सकने वाले इवेंट की संख्या पर असर पड़ता है.
totalEventCount

string (int64 format)

अनुरोध किए गए महीने के दौरान, प्रॉपर्टी को मिले इवेंट की कुल संख्या.
billableEventCount

string (int64 format)

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

AnalyticsPropertyType

Google Analytics प्रॉपर्टी के टाइप.

Enums
ANALYTICS_PROPERTY_TYPE_UNSPECIFIED प्रॉपर्टी का टाइप अज्ञात है या बताया नहीं गया है
ANALYTICS_PROPERTY_TYPE_ORDINARY Google Analytics की सामान्य प्रॉपर्टी
ANALYTICS_PROPERTY_TYPE_SUBPROPERTY Google Analytics की सब-प्रॉपर्टी
ANALYTICS_PROPERTY_TYPE_ROLLUP Google Analytics रोलअप प्रॉपर्टी

BillInfo

इसमें बिल की रकम होती है.

JSON के काेड में दिखाना 
{
  "baseFee": {
    object (Money)
  },
  "eventFee": {
    object (Money)
  },
  "priceProtectionCredit": {
    object (Money)
  },
  "total": {
    object (Money)
  }
}
फ़ील्ड
baseFee

object (Money)

हर महीने के बुनियादी शुल्क की रकम.
eventFee

object (Money)

इवेंट के लिए ली जाने वाली फ़ीस.
priceProtectionCredit

object (Money)

कीमत सुरक्षा के तहत मिलने वाले क्रेडिट की रकम. यह सिर्फ़ उन खरीदारों के लिए उपलब्ध है जो ज़रूरी शर्तें पूरी करते हैं.
total

object (Money)

बिल की कुल रकम.

पैसे

यह मुद्रा के टाइप के साथ-साथ, पैसे की रकम को दिखाता है.

JSON के काेड में दिखाना 
{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}
फ़ील्ड
currencyCode

string

ISO 4217 में तय किया गया तीन अक्षर वाला मुद्रा कोड.
units

string (int64 format)

राशि की पूरी यूनिट. उदाहरण के लिए, अगर currencyCode की वैल्यू "USD" है, तो एक यूनिट की कीमत एक डॉलर होगी.
nanos

integer

रकम की नैनो (10^-9) यूनिट की संख्या. वैल्यू, -999,999,999 और +999,999,999 के बीच होनी चाहिए. अगर units पॉज़िटिव है, तो nanos पॉज़िटिव या शून्य होना चाहिए. अगर units शून्य है, तो nanos पॉज़िटिव, शून्य या नेगेटिव हो सकता है. अगर units की वैल्यू नेगेटिव है, तो nanos की वैल्यू नेगेटिव या शून्य होनी चाहिए. उदाहरण के लिए, -1.75 डॉलर को units=-1 और nanos=-750,000,000 के तौर पर दिखाया जाता है.