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”媒体资源。

createConnectedSiteTag

为 Universal Analytics 媒体资源创建已关联的网站代码。

delete

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

deleteConnectedSiteTag

删除 Universal Analytics 媒体资源的关联网站代码。

fetchAutomatedGa4ConfigurationOptOut

获取 UA 媒体资源自动 GA4 设置流程的选择停用状态。

get

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

getAttributionSettings

查找 AttributionSettings 单例。

getDataRetentionSettings

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

getGoogleSignalsSettings

查找媒体资源的 Google 信号设置。

list

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

listConnectedSiteTags

列出 Universal Analytics 媒体资源的关联网站代码。

patch

更新属性。

runAccessReport

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

setAutomatedGa4ConfigurationOptOut

为 UA 媒体资源的 GA4 自动设置流程设置选择停用状态。

updateAttributionSettings

更新媒体资源的归因设置。

updateDataRetentionSettings

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

updateGoogleSignalsSettings

更新媒体资源的 Google 信号设置。