Method: organizations.reportPropertyUsage

Lấy dữ liệu về mức sử dụng và thông tin thanh toán của các tài sản trong tổ chức cho tháng được chỉ định.

Đối với mỗi tổ chức khách hàng trực tiếp, người dùng cần phải là Quản trị viên tổ chức/Quản trị viên phụ trách việc thanh toán của tổ chức để xem dữ liệu về việc thanh toán và mức sử dụng.

Đối với mỗi tổ chức khách hàng của đối tác bán hàng, người dùng cần phải là Quản trị viên tổ chức/Quản trị viên thanh toán của tổ chức đối tác bán hàng để xem dữ liệu thanh toán và mức sử dụng, hoặc là Quản trị viên tổ chức/Quản trị viên thanh toán của tổ chức khách hàng của đối tác bán hàng để chỉ xem dữ liệu mức sử dụng.

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Tham số
organization

string

Bắt buộc. Chỉ định tổ chức có mức sử dụng tài sản sẽ được liệt kê.

Định dạng: organizations/{org_id}

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu với cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "month": string
}
Trường
month

string

Bắt buộc. Tháng mục tiêu để liệt kê các lượt sử dụng tài sản.

Định dạng: YYYY-MM. Ví dụ: "2025-05"

Nội dung phản hồi

Thông báo phản hồi cho RPC organizations.reportPropertyUsage.

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "propertyUsages": [
    {
      object (PropertyUsage)
    }
  ],
  "billInfo": {
    object (BillInfo)
  }
}
Trường
propertyUsages[]

object (PropertyUsage)

Dữ liệu sử dụng cho tất cả tài sản trong tổ chức và tháng được chỉ định.
billInfo

object (BillInfo)

Số tiền trên hoá đơn của tổ chức và tháng được chỉ định.

Sẽ trống nếu người dùng chỉ có quyền truy cập vào dữ liệu sử dụng.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

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

PropertyUsage

Chứa số lượng sự kiện mà tài sản nhận được, cùng với siêu dữ liệu ảnh hưởng đến số lượng sự kiện billable.

Biểu diễn dưới dạng JSON 
{
  "property": string,
  "displayName": string,
  "accountId": string,
  "serviceLevel": enum (AnalyticsServiceLevel),
  "propertyType": enum (AnalyticsPropertyType),
  "totalEventCount": string,
  "billableEventCount": string
}
Trường
property

string

Tên của tài nguyên tài sản Google Analytics Admin API.

Định dạng: analyticsadmin.googleapis.com/properties/{property_id}
displayName

string

Tên hiển thị của cơ sở lưu trú.
accountId

string (int64 format)

Mã nhận dạng tài khoản mẹ của tài sản.
serviceLevel

enum (AnalyticsServiceLevel)

Cấp dịch vụ của tài sản.
propertyType

enum (AnalyticsPropertyType)

Loại phụ của tài sản Analytics. Điều này ảnh hưởng đến số sự kiện có thể lập hoá đơn.
totalEventCount

string (int64 format)

Tổng số sự kiện mà tài sản nhận được trong tháng được yêu cầu.
billableEventCount

string (int64 format)

Số lượng sự kiện mà tài sản bị tính phí trong tháng được yêu cầu.

AnalyticsPropertyType

Các loại tài sản Google Analytics.

Enum
ANALYTICS_PROPERTY_TYPE_UNSPECIFIED Loại cơ sở lưu trú không xác định hoặc chưa chỉ định
ANALYTICS_PROPERTY_TYPE_ORDINARY Tài sản Google Analytics thông thường
ANALYTICS_PROPERTY_TYPE_SUBPROPERTY Tài sản phụ Google Analytics
ANALYTICS_PROPERTY_TYPE_ROLLUP Tài sản tổng hợp Google Analytics

BillInfo

Chứa số tiền trên hoá đơn.

Biểu diễn dưới dạng JSON 
{
  "baseFee": {
    object (Money)
  },
  "eventFee": {
    object (Money)
  },
  "priceProtectionCredit": {
    object (Money)
  },
  "total": {
    object (Money)
  }
}
Trường
baseFee

object (Money)

Số tiền phí cơ bản hằng tháng.
eventFee

object (Money)

Số tiền phí sự kiện.
priceProtectionCredit

object (Money)

Số tiền tín dụng bảo vệ giá, chỉ dành cho khách hàng đủ điều kiện.
total

object (Money)

Tổng số tiền trên hoá đơn.

Tiền

Biểu thị một số tiền cùng với loại đơn vị tiền tệ.

Biểu diễn dưới dạng JSON 
{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}
Trường
currencyCode

string

Mã đơn vị tiền tệ gồm 3 chữ cái được xác định trong ISO 4217.
units

string (int64 format)

Đơn vị số nguyên của số tiền. Ví dụ: nếu currencyCode là "USD", thì 1 đơn vị là 1 đô la Mỹ.
nanos

integer

Số lượng đơn vị nano (10^-9) của số tiền. Giá trị phải nằm trong khoảng từ -999.999.999 đến +999.999.999 (bao gồm). Nếu units là số dương, thì nanos phải là số dương hoặc 0. Nếu units bằng 0, thì nanos có thể là số dương, số 0 hoặc số âm. Nếu units là số âm, thì nanos phải là số âm hoặc 0. Ví dụ: -1,75 USD được biểu thị là units=-1 và nanos=-750.000.000.