REST Resource: customers.policySchemas

资源：PolicySchema

表示政策架构的资源。

JSON 表示法 
{
  "name": string,
  "policyDescription": string,
  "additionalTargetKeyNames": [
    {
      object (AdditionalTargetKeyName)
    }
  ],
  "definition": {
    object (FileDescriptorProto)
  },
  "fieldDescriptions": [
    {
      object (PolicySchemaFieldDescription)
    }
  ],
  "accessRestrictions": [
    string
  ],
  "notices": [
    {
      object (PolicySchemaNoticeDescription)
    }
  ],
  "supportUri": string,
  "schemaName": string,
  "validTargetResources": [
    enum (TargetResource)
  ],
  "policyApiLifecycle": {
    object (PolicyApiLifecycle)
  },
  "categoryTitle": string,
  "supportedPlatforms": [
    enum (Platform)
  ]
}
字段
name

string

格式：name=customers/{customer}/policySchemas/{schema_namespace}
policyDescription

string

仅限输出。关于用户消费的政策架构的说明。
additionalTargetKeyNames[]

object (AdditionalTargetKeyName)

仅限输出。将用于标识政策值目标的其他键名。指定 policyTargetKey 时，此处指定的每个额外键都必须包含在 additionalTargetKeys 映射中。
definition

object (FileDescriptorProto)

使用 proto 描述符进行架构定义。
fieldDescriptions[]

object (PolicySchemaFieldDescription)

仅限输出。架构中每个字段的详细说明。建议按照此列表中的顺序（而非字段编号）来显示字段。
accessRestrictions[]

string

仅限输出。与此政策相关的特定访问权限限制。
notices[]

object (PolicySchemaNoticeDescription)

仅限输出。与在架构的特定字段中设置特定值相关的特殊消息。
supportUri

string

仅限输出。指向此架构的相关支持文章的 URI。
schemaName

string

仅限输出。政策架构的完全限定名称。在调用 BatchInheritOrgUnitPolicies BatchModifyOrgUnitPolicies BatchModifyGroupPolicies 或 BatchDeleteGroupPolicies 时，此值用于填充 PolicyValue 中的 policySchema 字段。
validTargetResources[]

enum (TargetResource)

仅限输出。政策的适用目标资源的相关信息。
policyApiLifecycle

object (PolicyApiLifecycle)

仅限输出。当前生命周期信息。
categoryTitle

string

设置所属类别的标题。
supportedPlatforms[]

enum (Platform)

仅限输出。列表指出该政策将仅适用于这些平台上的设备/用户。

AdditionalTargetKeyName

将用于标识政策值目标的其他键名。

JSON 表示法 
{
  "key": string,
  "keyDescription": string
}
字段
key

string

键名称。
keyDescription

string

键说明。

FileDescriptorProto

描述完整的 .proto 文件。

JSON 表示法 
{
  "name": string,
  "package": string,
  "messageType": [
    {
      object (DescriptorProto)
    }
  ],
  "enumType": [
    {
      object (EnumDescriptorProto)
    }
  ],
  "syntax": string,
}
字段
name

string

文件名（相对于源代码树的根目录）
package

string

例如“foo”、“foo.bar”等
messageType[]

object (DescriptorProto)

此文件中的所有顶级定义。
enumType[]

object (EnumDescriptorProto)
syntax

string

proto 文件的语法。支持的值为“proto2”“proto3”和“editions”。

如果存在 edition，则此值必须为“版本”。

DescriptorProto

描述消息类型。

JSON 表示法 
{
  "name": string,
  "field": [
    {
      object (FieldDescriptorProto)
    }
  ],
  "nestedType": [
    {
      object (DescriptorProto)
    }
  ],
  "enumType": [
    {
      object (EnumDescriptorProto)
    }
  ],
  "oneofDecl": [
    {
      object (OneofDescriptorProto)
    }
  ]
}
字段
name

string
field[]

object (FieldDescriptorProto)
nestedType[]

object (DescriptorProto)
enumType[]

object (EnumDescriptorProto)
oneofDecl[]

object (OneofDescriptorProto)

FieldDescriptorProto

描述消息中的字段。

JSON 表示法 
{
  "name": string,
  "number": integer,
  "label": enum (Label),
  "type": enum (Type),
  "typeName": string,
  "defaultValue": string,
  "oneofIndex": integer,
  "jsonName": string,
  "proto3Optional": boolean
}
字段
name

string
number

integer
label

enum (Label)
type

enum (Type)

如果设置了 typeName，则无需设置。如果同时设置了此字段和 typeName，此字段必须为 TYPE_ENUM、TYPE_MESSAGE 或 TYPE_GROUP 中的一个。
typeName

string

对于消息和枚举类型，这是类型的名称。如果名称以“.”开头，则是完全限定的。否则，系统将使用类似 C++ 的范围限定规则来查找类型（即首先搜索此消息中的嵌套类型，然后在父级中搜索，直到根命名空间）。
defaultValue

string

对于数字类型，包含值的原始文本表示形式。如果是布尔值，则为“true”或“false”。对于字符串，它包含默认文本内容（不以任何方式转义）。对于字节，包含 C 转义值。所有不小于 128 的字节都会转义。
oneofIndex

integer

如果设置，则提供所含类型的 oneofDecl 列表中 a 的索引。此字段是其中之一。
jsonName

string

此字段的 JSON 名称。该值由协议编译器设置。如果用户设置了“jsonName”，选项，系统会使用该选项的值。否则，系统会通过将字段名称转换为驼峰命名法，从字段名称中推断出该名称。
proto3Optional

boolean

如果为 true，则这是一个“可选”的 proto3。如果 proto3 字段是可选的，它会跟踪在线状态，而不考虑字段类型。

当 proto3Optional 为 true 时，此字段必须属于 之一，以向旧的 proto3 客户端表明已针对此字段跟踪在线状态。这种宏称为“合成”oneof，并且此字段必须是其唯一成员（每个 proto3 可选字段都有自己的合成之一）。合成类仅存在于描述符中，不会生成任何 API。合成的 1 必须在所有“真实”之后排序其中之一。

对于消息字段，proto3Optional 不会创建任何语义更改，因为非重复消息字段始终跟踪其存在。不过，它仍然指明了有关用户写入“可选”的语义详细信息。这对于往返 .proto 文件很有用。为保持一致性，我们也为消息字段提供合成的其中一个字段（即使不需要跟踪在线状态）。这一点尤其重要，因为解析器无法分辨字段是消息还是枚举，因此必须始终创建一个合成字段。

Proto2 可选字段不会设置此标志，因为它们已通过 LABEL_OPTIONAL 指示可选。

标签

枚举
LABEL_OPTIONAL 0 保留用于错误
LABEL_REPEATED
LABEL_REQUIRED 所需标签只能在 proto2 中使用。在 proto3 和版本中，明确禁止这样做。在各版本中，可以使用 fieldPresence 功能实现此行为。

类型

枚举
TYPE_DOUBLE 0 保留用于错误。由于历史原因，顺序很奇怪。
TYPE_FLOAT
TYPE_INT64 未采用 ZigZag 编码。负数需要 10 个字节。如果可能存在负值，请使用 TYPE_SINT64。
TYPE_UINT64
TYPE_INT32 未采用 ZigZag 编码。负数需要 10 个字节。如果有可能为负值，请使用 TYPE_SINT32。
TYPE_FIXED64
TYPE_FIXED32
TYPE_BOOL
TYPE_STRING
TYPE_GROUP 以代码分隔的汇总报告。组类型已弃用，在 proto2 之后不受支持。不过，Proto3 实现应该仍然能够解析组线路格式并将组字段视为未知字段。在版本中，可通过 messageEncoding 功能启用群组电线格式。
TYPE_MESSAGE 以长度分隔的汇总。
TYPE_BYTES 版本 2 中的新功能。
TYPE_UINT32
TYPE_ENUM
TYPE_SFIXED32
TYPE_SFIXED64
TYPE_SINT32 使用 ZigZag 编码。
TYPE_SINT64 使用 ZigZag 编码。

EnumDescriptorProto

描述枚举类型。

JSON 表示法 
{
  "name": string,
  "value": [
    {
      object (EnumValueDescriptorProto)
    }
  ]
}
字段
name

string
value[]

object (EnumValueDescriptorProto)

EnumValueDescriptorProto

描述枚举中的值。

JSON 表示法 
{
  "name": string,
  "number": integer
}
字段
name

string
number

integer

OneofDescriptorProto

描述 之一。

JSON 表示法 
{
  "name": string
}
字段
name

string

PolicySchemaFieldDescription

提供 PolicySchema 中包含的特定字段的详细信息。

JSON 表示法 
{
  "field": string,
  "description": string,
  "inputConstraint": string,
  "knownValueDescriptions": [
    {
      object (PolicySchemaFieldKnownValueDescription)
    }
  ],
  "nestedFieldDescriptions": [
    {
      object (PolicySchemaFieldDescription)
    }
  ],
  "fieldDependencies": [
    {
      object (PolicySchemaFieldDependencies)
    }
  ],
  "requiredItems": [
    {
      object (PolicySchemaRequiredItems)
    }
  ],
  "defaultValue": value,
  "name": string,
  "fieldDescription": string,
  "fieldConstraints": {
    object (FieldConstraints)
  }
}
字段
field

string

仅限输出。与此说明相关联的字段的名称。
description
(deprecated)

string

已弃用。请改用 name 和 fieldDescription。字段的说明。
inputConstraint

string

仅限输出。与字段的值相关的任何输入限制条件。
knownValueDescriptions[]

object (PolicySchemaFieldKnownValueDescription)

仅限输出。如果该字段具有一组已知值，则此字段将提供对这些值的说明。
nestedFieldDescriptions[]

object (PolicySchemaFieldDescription)

仅限输出。如果此字段是定义了多个字段的消息类型，则提供此字段中嵌套字段的说明。建议按照此列表中的排序而非字段编号来显示字段。
fieldDependencies[]

object (PolicySchemaFieldDependencies)

仅限输出。提供字段和值的列表。必须至少有一个字段具有相应的值，系统才能设置此字段。
requiredItems[]

object (PolicySchemaRequiredItems)

仅限输出。提供此字段具有特定值时需要设置的字段列表。
defaultValue

value (Value format)

仅限输出。如果此政策未设置，则为客户端默认设置。
name

string

仅限输出。字段的名称。
fieldDescription

string

仅限输出。字段的说明。
fieldConstraints

object (FieldConstraints)

仅限输出。与字段的值相关的任何输入约束的信息。

PolicySchemaFieldKnownValueDescription

提供关于 PolicySchema 中特定字段允许的已知值的详细信息。

JSON 表示法 
{
  "value": string,
  "description": string,
  "fieldDependencies": [
    {
      object (PolicySchemaFieldDependencies)
    }
  ]
}
字段
value

string

仅限输出。可以为字段设置的值的字符串表示。
description

string

仅限输出。此值的其他说明。
fieldDependencies[]

object (PolicySchemaFieldDependencies)

仅限输出。此值需要满足的字段条件才有效。

PolicySchemaFieldDependencies

允许设置其他字段的字段及其必须具备的值。

JSON 表示法 
{
  "sourceField": string,
  "sourceFieldValue": string
}
字段
sourceField

string

此字段所依赖的来源字段。
sourceFieldValue

string

要允许设置此字段，来源字段必须具有的值。

PolicySchemaRequiredItems

根据此字段的值将变为必填字段。

JSON 表示法 
{
  "fieldConditions": [
    string
  ],
  "requiredFields": [
    string
  ]
}
字段
fieldConditions[]

string

引发必填字段强制执行的字段的值。空的 fieldConditions 意味着分配给此字段的任何值都会触发必填字段实施。
requiredFields[]

string

因字段条件而需要的字段。

FieldConstraints

有关任何范围限制的信息。

JSON 表示法 
{
  "numericRangeConstraint": {
    object (NumericRangeConstraint)
  },
  "uploadedFileConstraints": {
    object (UploadedFileConstraints)
  }
}
字段
numericRangeConstraint

object (NumericRangeConstraint)

数字字段允许的范围。
uploadedFileConstraints

object (UploadedFileConstraints)

针对已上传文件政策的限制。如果此政策存在，需要提供一个网址，该网址可通过上传具有此 proto 中指定的约束条件的文件来获取。

NumericRangeConstraint

限制上限和/或下限，至少设置一个限制条件。

JSON 表示法 
{
  "minimum": string,
  "maximum": string
}
字段
minimum

string (int64 format)

最小值。
maximum

string (int64 format)

最大值。

UploadedFileConstraints

针对已上传文件政策的限制。

JSON 表示法 
{
  "supportedContentTypes": [
    enum (ContentType)
  ],
  "sizeLimitBytes": string
}
字段
supportedContentTypes[]

enum (ContentType)

可针对某项设置上传的文件类型。
sizeLimitBytes

string (int64 format)

针对某项设置上传的文件的大小上限（以字节为单位）。

ContentType

可针对某项设置上传的文件类型。

枚举
CONTENT_TYPE_UNSPECIFIED 未指定的内容类型。
CONTENT_TYPE_PLAIN_TEXT 纯文本。
CONTENT_TYPE_HTML HTML。
CONTENT_TYPE_IMAGE_JPEG JPEG。
CONTENT_TYPE_IMAGE_GIF GIF。
CONTENT_TYPE_IMAGE_PNG .PNG。
CONTENT_TYPE_JSON JSON。
CONTENT_TYPE_ZIP ZIP。
CONTENT_TYPE_GZIP GZIP。
CONTENT_TYPE_CSV CSV 文件。
CONTENT_TYPE_YAML YAML。
CONTENT_TYPE_IMAGE_WEBP WEBP。

PolicySchemaNoticeDescription

提供与作为 PolicySchema 一部分的字段中特定值相关的特殊通知消息。

JSON 表示法 
{
  "field": string,
  "noticeValue": string,
  "noticeMessage": string,
  "acknowledgementRequired": boolean
}
字段
field

string

仅限输出。与通知关联的字段名称。
noticeValue

string

仅限输出。包含通知的字段的值。将此字段设为此值时，系统可能会要求用户确认通知消息，然后才能设置此值。
noticeMessage

string

仅限输出。通知消息与字段的值相关联。
acknowledgementRequired

boolean

仅限输出。用户是否需要先确认通知消息，然后才能设置该值。

TargetResource

目标资源类型

枚举
TARGET_RESOURCE_UNSPECIFIED 未指定的目标资源。
ORG_UNIT 组织部门目标资源。
GROUP 群组目标资源。

PolicyApiLifecycle

生命周期信息。

JSON 表示法 
{
  "deprecatedInFavorOf": [
    string
  ],
  "scheduledToDeprecatePolicies": [
    string
  ],
  "policyApiLifecycleStage": enum (PolicyApiLifecycleEnum),
  "description": string,
  "endSupport": {
    object (Date)
  }
}
字段
deprecatedInFavorOf[]

string

如果此政策已被弃用，取而代之的是新政策在 PolicyAPI 中显示的完全限定命名空间。仅当 policyApiLifecycleStage 为 API_DEPRECATED 时才能设置。
scheduledToDeprecatePolicies[]

string

因推出此政策而将被弃用的旧政策的完全限定命名空间，对应于 excludedInFavorOf。
policyApiLifecycleStage

enum (PolicyApiLifecycleEnum)

指示 Policy API 的当前生命周期阶段。
description

string

有关当前生命周期的说明。
endSupport

object (Date)

当前政策的支持日期。如果在政策支持终止日期之后尝试修改政策，将会导致请求错误（400 错误）。仅当 policyApiLifecycleStage 为 API_DEPRECATED 时才能设置。

PolicyApiLifecycleEnum

Policy API 的生命周期阶段。

枚举
API_UNSPECIFIED 未指定 Policy API 生命周期。
API_PREVIEW 政策尚未生效，但开发者提前了解格式。此阶段可以转移到 API_DEVELOPEMNT 或 API_CURRENT。
API_DEVELOPMENT 政策可能会以不向后兼容的方式更改格式（重大更改）。此阶段可以转移到 API_CURRENT 或 API_DEPRECATED。这可用于仅针对 TT 发布的政策或面向选定客户发布的政策，用于紧急用途。
API_CURRENT 官方格式的政策。政策能够以向后兼容的方式更改格式（非重大更改）。示例：如果正确使用字段掩码，此政策可能会引入一个新字段，这会被视为非破坏性更改。此阶段可以转移到 API_DEPRECATED。
API_DEPRECATED 请停止使用此政策。此政策已被弃用，日后可能会被移除。很可能是因为我们引入了一项新政策来取代该政策。

日期

表示整个或部分日历日期（例如生日）。一天中的时间和时区要么在别处指定，要么不重要。日期相对于公历。可以表示以下任一情况：

  • 包含非零年份、月份和天值的完整日期。
  • 月份和天，年份值为零（例如周年纪念日）。
  • 单独的年份，月份和天值为零。
  • 年份和月份，天值为零（例如，信用卡到期日期）。

相关类型：

JSON 表示法 
{
  "year": integer,
  "month": integer,
  "day": integer
}
字段
year

integer

日期中的年份。必须介于 1 到 9999 之间，或为 0（即指定不含年份的日期）。
month

integer

一年中的第几个月。必须介于 1 到 12 之间，或为 0（即只指定年份，不指定月份和天值）。
day

integer

一个月中的第几天。必须介于 1 到 31 之间并且对年份和月份有效，或为 0（即天不重要，指定单独的年份或者年份和月份）。

平台

这是支持 Chrome 的不同平台组的枚举。

枚举
PLATFORM_UNSPECIFIED 未指定的平台。
CHROME_OS ChromeOS。
CHROME_BROWSER OSX/Windows/Linux 版 Chrome 浏览器。
CHROME_BROWSER_FOR_ANDROID Android 版 Chrome 浏览器。
CHROME_BROWSER_FOR_IOS iOS 版 Chrome 浏览器。

方法

get

 按资源名称获取客户的特定政策架构。

list

 获取与指定客户的指定过滤条件值匹配的政策架构列表。