Method: organizations.reportPropertyUsage

নির্দিষ্ট মাসের জন্য প্রতিষ্ঠানের অন্তর্গত সম্পত্তিগুলোর ব্যবহার এবং বিলিং সংক্রান্ত তথ্য সংগ্রহ করে।

প্রতিটি সরাসরি ক্লায়েন্ট সংস্থার বিলিং এবং ব্যবহারের ডেটা দেখার জন্য, ব্যবহারকারীকে সেই সংস্থার OrgAdmin/BillingAdmin হতে হবে।

প্রতিটি সেলস পার্টনার ক্লায়েন্ট অর্গের ক্ষেত্রে, বিলিং এবং ব্যবহারের ডেটা দেখার জন্য ব্যবহারকারীকে অবশ্যই সেলস পার্টনার অর্গের OrgAdmin/BillingAdmin হতে হবে, অথবা শুধুমাত্র ব্যবহারের ডেটা দেখার জন্য সেলস পার্টনার ক্লায়েন্ট অর্গের OrgAdmin/BillingAdmin হতে হবে।

HTTP অনুরোধ

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

URL-টিতে gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করা হয়েছে।

পথের পরামিতি

প্যারামিটার
organization

string

আবশ্যক। যে প্রতিষ্ঠানের সম্পত্তির ব্যবহার তালিকাভুক্ত করা হবে, তা নির্দিষ্ট করে।

বিন্যাস: সংস্থা/{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

সম্পত্তি ব্যবহার

প্রপার্টিতে প্রাপ্ত ইভেন্টের সংখ্যা এবং billable ইভেন্টের পরিমাণকে প্রভাবিত করে এমন মেটাডেটা এতে অন্তর্ভুক্ত থাকে।

JSON উপস্থাপনা 
{
  "property": string,
  "displayName": string,
  "accountId": string,
  "serviceLevel": enum (AnalyticsServiceLevel),
  "propertyType": enum (AnalyticsPropertyType),
  "totalEventCount": string,
  "billableEventCount": string
}
ক্ষেত্র
property

string

গুগল অ্যানালিটিক্স অ্যাডমিন এপিআই প্রপার্টি রিসোর্সের নাম।

ফর্ম্যাট: analyticsadmin.googleapis.com/properties/{property_id}

displayName

string

প্রপার্টিটির প্রদর্শিত নাম।

accountId

string ( int64 format)

প্রপার্টিটির প্যারেন্ট অ্যাকাউন্টের আইডি।

serviceLevel

enum ( AnalyticsServiceLevel )

সম্পত্তিটির সেবার মান।

propertyType

enum ( AnalyticsPropertyType )

অ্যানালিটিক্স প্রপার্টির উপপ্রকার। এটি বিলযোগ্য ইভেন্টের সংখ্যাকে প্রভাবিত করে।

totalEventCount

string ( int64 format)

অনুরোধকৃত মাসে প্রপার্টিটি কর্তৃক প্রাপ্ত মোট ইভেন্টের সংখ্যা।

billableEventCount

string ( int64 format)

অনুরোধকৃত মাসে যেসব ইভেন্টের জন্য সম্পত্তিটির বিল করা হয়, তার সংখ্যা।

অ্যানালিটিক্সপ্রপার্টিটাইপ

গুগল অ্যানালিটিক্স প্রপার্টির প্রকারভেদ।

এনাম
ANALYTICS_PROPERTY_TYPE_UNSPECIFIED অজানা বা অনির্দিষ্ট প্রপার্টি টাইপ
ANALYTICS_PROPERTY_TYPE_ORDINARY সাধারণ গুগল অ্যানালিটিক্স সম্পত্তি
ANALYTICS_PROPERTY_TYPE_SUBPROPERTY গুগল অ্যানালিটিক্স সাবপ্রপার্টি
ANALYTICS_PROPERTY_TYPE_ROLLUP গুগল অ্যানালিটিক্স রোলআপ প্রপার্টি

বিলইনফো

এতে বিলের পরিমাণ রয়েছে।

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 হিসাবে প্রকাশ করা হয়।