REST Resource: properties

资源:媒体资源

表示 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 资源的属性类型。创建媒体资源时,如果类型为“PROPERTY_TYPE_UNSPECIFIED”,则系统会隐含“ORDINARY_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

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

注意:Property-Moving 界面可用于更改父项。格式:accounts/{account}、媒体资源/{property} 示例:“accounts/100”“properties/101”

displayName

string

必需。此属性的直观易懂的显示名称。

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

industryCategory

enum (IndustryCategory)

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

timeZone

string

必需。报告时区,用作报告的日期边界,无论数据来自何处。如果时区符合夏令时,Google Analytics(分析)会自动针对相应变化做出调整。

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

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

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”

PropertyType

属性资源的类型。

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

IndustryCategory

为此媒体资源选择的类别,用于行业基准比较。

枚举
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 Shopping

ServiceLevel

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

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