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 清單中一人的索引。這個欄位是該項目的成員。
jsonName

string

這個欄位的 JSON 名稱。這個值是由通訊協定編譯器設定。如果使用者設定了「jsonName」選項，系統就會使用該選項的值否則，系統會將其轉換為駝峰式大小寫，從欄位名稱得出。
proto3Optional

boolean

如果為 true，則此為 proto3「選用」。proto3 欄位為選填欄位時，無論欄位類型為何，系統都會追蹤是否存在。

當 proto3Optional 為 true 時，這個欄位必須屬於其中一個項目，向這個欄位中的舊版 proto3 用戶端表明是否存在這個欄位。這是我們稱之為「合成」一，且這個欄位必須是唯一成員 (每個 proto3 選用欄位都有自己的合成資料)。合成單一項目僅存在於描述元中，不會產生任何 API。合成項目必須依照所有「真實」順序排序請多多包涵

針對訊息欄位，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 實作仍應能剖析群組線格式，並將群組欄位視為不明欄位。在 Edition 中，可透過 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

會叫用必要欄位的欄位值。如果 FieldCondition 為空白，表示凡是指派給這個欄位的值，都會觸發強制實行必要欄位。
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

對應至已淘汰 InFavorOf，該政策將因推出而已淘汰的舊政策完整命名空間。
policyApiLifecycleStage

enum (PolicyApiLifecycleEnum)

指出 Policy API 目前的生命週期階段。
description

string

目前生命週期的說明。
endSupport

object (Date)

目前政策的結束日期。如果您在支援服務期過後嘗試修改政策，會導致要求錯誤 (400 錯誤)。只有在 policyApiLifecycleStage 為 API_DEPRECATED 時才能設定。

PolicyApiLifecycleEnum

政策 API 的生命週期階段。

列舉
API_UNSPECIFIED 未指定 Policy Api 生命週期。
API_PREVIEW 政策尚未生效，但會通知開發人員政策格式。這個階段可轉移至 API_DEVELOPEMNT 或 API_CURRENT。
API_DEVELOPMENT 政策可能會以回溯不相容的方式變更格式 (破壞性變更)。這個階段可轉移至 API_CURRENT 或 API_DEPRECATED。這應該用於僅限 TTs 推出的政策，或是向特定客戶推出，以供緊急使用。
API_CURRENT 官方格式的政策。政策能以回溯相容性變更格式 (非破壞性變更)。範例：這項政策可能會引入一個新欄位，當欄位遮罩妥善使用時，系統會將其視為非破壞性變更。這個階段可轉移至 API_DEPRECATED。
API_DEPRECATED 請停止使用這項政策。這項政策已淘汰，日後可能會移除。該政策很有可能是因新政策而引入了新政策。

日期

代表完整或部分的日曆日期，例如生日。您可以指明時段和時區，或者在其他地方指定時間或時區。日期以公曆為基準。可能代表下列其中一項：

  • 完整日期，具有非零的年、月和日值。
  • 日期為 0 的月份和日期，例如週年紀念日。
  • 有 1 年，第 0 個月卻為 0 天。
  • 年和月，但數字為零 (例如信用卡到期日)。

相關類型：

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

 取得政策結構定義清單，其中符合指定客戶的指定篩選器值。