REST Resource: properties

资源:Property

表示 Google Analytics(分析)GA4 媒体资源的资源消息。

JSON 表示法
{
  "name": string,
  "propertyType": enum (PropertyType),
  "createTime": string,
  "updateTime": string,
  "parent": string,
  "displayName": string,
  "industryCategory": enum (IndustryCategory),
  "timeZone": string,
  "currencyCode": string,
  "serviceLevel": enum (ServiceLevel),
  "deleteTime": string,
  "expireTime": string,
  "account": string
}
字段
name

string

仅供输出。此属性的资源名称。格式:properties/{property_id} 示例:“properties/1000”

propertyType

enum (PropertyType)

不可变。此资源资源的属性类型。创建属性时,如果类型为“PROPERTY_TYPE_UNSPECIFIED”,则系统会隐含“ORDINary_PROPERTY”。尚无法使用 Google Analytics(分析)Admin API 创建“SUBPROPERTY”和“ROLLUP_PROPERTY”类型。

createTime

string (Timestamp format)

仅供输出。最初创建实体的时间。

时间戳采用 RFC3339 世界协调时间 (UTC)(即“祖鲁时”)格式,分辨率为纳秒,最多包含九个小数位。示例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

updateTime

string (Timestamp format)

仅供输出。上次更新实体载荷字段的时间。

时间戳采用 RFC3339 世界协调时间 (UTC)(即“祖鲁时”)格式,分辨率为纳秒,最多包含九个小数位。示例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

parent

string

不可变。此属性的逻辑父级的资源名称。

注意:属性移动界面可用于更改父级。格式:accounts/{account}, properties/{property} 示例:“accounts/100”, “properties/101”

displayName

string

必需。人类可读的显示名称。

允许的显示名称的长度上限为 100 个 UTF-16 代码单元。

industryCategory

enum (IndustryCategory)

与此媒体资源相关联的行业:例如 AUTOMOTIVE、FOOD_AND_DRINK

timeZone

string

必需。报告时区,用作报告的每日起止时间,而无论数据来自何处。如果时区支持 DST,Google Analytics(分析)会根据相应的变化自动调整。

注意:更改时区只会影响今后的数据,不会影响以前的数据。

格式:https://www.iana.org/time-zones 示例:“America/Los_NYC”

currencyCode

string

涉及货币价值的报告中使用的币种类型。

格式:https://en.wikipedia.org/wiki/ISO_4217 示例:“USD”、“EUR”、“JPY”

serviceLevel

enum (ServiceLevel)

仅供输出。适用于此媒体资源的 Google Analytics(分析)服务等级。

deleteTime

string (Timestamp format)

仅供输出。如果设置,系统会删除此媒体资源的时间。如果未设置,则表示此媒体资源当前不在垃圾箱中。

时间戳采用 RFC3339 世界协调时间 (UTC)(即“祖鲁时”)格式,分辨率为纳秒,最多包含九个小数位。示例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

expireTime

string (Timestamp format)

仅供输出。如果设置此项,则此回收站的媒体资源将被永久删除的时间。如果未设置,则表示此媒体资源当前不在垃圾箱中,也不会计划删除。

时间戳采用 RFC3339 世界协调时间 (UTC)(即“祖鲁时”)格式,分辨率为纳秒,最多包含九个小数位。示例:"2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

account

string

不可变。父级帐号的资源名称 格式:accounts/{account_id} 示例:“accounts/123”

属性类型

媒体资源资源类型。

枚举
PROPERTY_TYPE_UNSPECIFIED 未知或未指定的属性类型
PROPERTY_TYPE_ORDINARY 普通 GA4 媒体资源
PROPERTY_TYPE_SUBPROPERTY GA4 子媒体资源
PROPERTY_TYPE_ROLLUP GA4 总览媒体资源

行业类别

为此媒体资源选择的类别,用于行业基准化分析。

枚举
INDUSTRY_CATEGORY_UNSPECIFIED 未指定行业类别
AUTOMOTIVE Automotive 设备
BUSINESS_AND_INDUSTRIAL_MARKETS 工商业市场
FINANCE 金融
HEALTHCARE 医疗保健
TECHNOLOGY 科技
TRAVEL 旅游
OTHER 其他
ARTS_AND_ENTERTAINMENT 艺术与娱乐
BEAUTY_AND_FITNESS 美容健身
BOOKS_AND_LITERATURE 图书与文学
FOOD_AND_DRINK 食品和饮料
GAMES 游戏
HOBBIES_AND_LEISURE 爱好与休闲
HOME_AND_GARDEN 家居园艺
INTERNET_AND_TELECOM 互联网与电信
LAW_AND_GOVERNMENT 法律与政府
NEWS 新闻
ONLINE_COMMUNITIES 在线社区
PEOPLE_AND_SOCIETY 人与社会
PETS_AND_ANIMALS 宠物与动物
REAL_ESTATE 房地产
REFERENCE 参考
SCIENCE 科学
SPORTS 体育
JOBS_AND_EDUCATION 招聘与培训
SHOPPING Google 购物

服务等级

Google Analytics(分析)的各种服务级别。

枚举
SERVICE_LEVEL_UNSPECIFIED 未指定服务等级或服务等级无效。
GOOGLE_ANALYTICS_STANDARD 标准版的 Google Analytics(分析)。
GOOGLE_ANALYTICS_360 付费版 Google Analytics(分析)。

方法

acknowledgeUserDataCollection

确认指定媒体资源的用户数据收集条款。

create

创建具有指定地理位置和属性的“GA4”媒体资源。

delete

将目标属性标记为软删除(即“回收站”),并返回它。

get

查找单个“GA4”媒体资源。

getDataRetentionSettings

返回此属性的单例数据保留设置。

list

返回指定的父级帐号下的子级媒体资源。

patch

更新属性。

runAccessReport

返回自定义的数据访问记录报告。

updateDataRetentionSettings

更新此媒体资源的单例数据保留设置。