Method: organizations.reportPropertyUsage

รับข้อมูลการใช้งานและการเรียกเก็บเงินสำหรับพร็อพเพอร์ตี้ภายในองค์กรสำหรับเดือนที่ระบุ

ผู้ใช้ต้องเป็นผู้ดูแลระบบองค์กร/ผู้ดูแลระบบการเรียกเก็บเงินในองค์กรจึงจะดูข้อมูลการเรียกเก็บเงินและการใช้งานได้

ผู้ใช้ต้องเป็นผู้ดูแลระบบองค์กร/ผู้ดูแลระบบการเรียกเก็บเงินในองค์กรพาร์ทเนอร์การขายจึงจะดูข้อมูลการเรียกเก็บเงินและการใช้งานได้ หรือเป็นผู้ดูแลระบบองค์กร/ผู้ดูแลระบบการเรียกเก็บเงินในองค์กรลูกค้าของพาร์ทเนอร์การขายจึงจะดูข้อมูลการใช้งานได้เท่านั้น

คำขอ HTTP

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

URL ใช้ไวยากรณ์การแปลงรหัส gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
organization

string

ต้องระบุ ระบุองค์กรที่จะแสดงการใช้งานพร็อพเพอร์ตี้

รูปแบบ: organizations/{org_id}

เนื้อความของคำขอ

เนื้อหาของคำขอมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "month": string
}
ฟิลด์
month

string

ต้องระบุ เดือนเป้าหมายที่จะแสดงการใช้งานพร็อพเพอร์ตี้

รูปแบบ: ปปปป-ดด เช่น "2025-05"

เนื้อหาการตอบกลับ

ข้อความตอบกลับสำหรับ RPC organizations.reportPropertyUsage

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง 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 Admin API

รูปแบบ: 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

Enum
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

รหัสสกุลเงิน 3 ตัวอักษรที่กำหนดไว้ใน ISO 4217
units

string (int64 format)

หน่วยทั้งหมดของจำนวนเงิน เช่น หาก currencyCode เป็น "USD" แสดงว่า 1 หน่วยเท่ากับ 1 ดอลลาร์สหรัฐ
nanos

integer

จำนวนหน่วยนาโน (10^-9) ของจำนวนเงิน ค่าต้องอยู่ระหว่าง -999,999,999 ถึง +999,999,999 หาก units เป็นบวก nanos ต้องเป็นบวกหรือ 0 หาก units เป็น 0 nanos จะเป็นค่าบวก 0 หรือค่าลบก็ได้ หาก units ติดลบ nanos ต้องติดลบหรือเป็น 0 เช่น $-1.75 จะแสดงเป็น units=-1 และ nanos=-750,000,000