- المورد: PolicySchema
- AdditionalTargetKeyName
- FileDescriptorProto
- DescriptorProto
- FieldDescriptorProto
- التصنيف
- النوع
- EnumDescriptorProto
- EnumValueDescriptorProto
- OneofDescriptorProto
- PolicySchemaFieldDescription
- PolicySchemaFieldKnownValueDescription
- PolicySchemaFieldDependencies
- PolicySchemaRequiredItems
- FieldConstraints
- NumericRangeConstraint
- UploadedFileConstraints
- ContentType
- PolicySchemaNoticeDescription
- TargetResource
- PolicyApiLifecycle
- PolicyApiLifecycleEnum
- التاريخ
- النظام الأساسي
- الطُرق
المرجع: PolicySchema
مورد يمثّل مخطط سياسة.
تمثيل JSON |
---|
{ "name": string, "policyDescription": string, "additionalTargetKeyNames": [ { object ( |
الحقول | |
---|---|
name |
التنسيق: name=customers/{customer}/policySchemas/{schema_namespace} |
policyDescription |
النتائج فقط. وصف حول مخطط السياسة لاستهلاك المستخدمين |
additionalTargetKeyNames[] |
النتائج فقط. أسماء رئيسية إضافية سيتم استخدامها لتحديد هدف قيمة السياسة عند تحديد |
definition |
تعريف المخطط باستخدام واصف النماذج الأوّلية |
fieldDescriptions[] |
النتائج فقط. وصف تفصيلي لكل حقل يشكّل جزءًا من المخطط. يمكن عرض الحقول حسب الترتيب في هذه القائمة، وليس حسب رقم الحقل. |
accessRestrictions[] |
النتائج فقط. قيود وصول محدّدة ذات صلة بهذه السياسة. |
notices[] |
النتائج فقط. رسائل إشعار خاصة ذات صلة بإعداد قيم معيّنة في حقول معيّنة في المخطط. |
supportUri |
النتائج فقط. معرّف موارد منتظم (URI) لمقالة الدعم ذات الصلة بهذا المخطط. |
schemaName |
النتائج فقط. الاسم المؤهّل بالكامل لمخطط السياسة. يتم استخدام هذه القيمة لملء الحقل |
validTargetResources[] |
النتائج فقط. معلومات حول الموارد المستهدفة السارية للسياسة. |
policyApiLifecycle |
النتائج فقط. معلومات مراحل النشاط الحالية |
categoryTitle |
عنوان الفئة التي ينتمي إليها الإعداد. |
supportedPlatforms[] |
النتائج فقط. تشير "القائمة" إلى أنّ السياسة لن تسري إلا على الأجهزة/المستخدمين على هذه المنصات. |
AdditionalTargetKeyName
أسماء رئيسية إضافية سيتم استخدامها لتحديد هدف قيمة السياسة
تمثيل JSON |
---|
{ "key": string, "keyDescription": string } |
الحقول | |
---|---|
key |
الاسم الرئيسي. |
keyDescription |
وصف المفتاح |
FileDescriptorProto
يصف ملف .proto كاملًا.
تمثيل JSON |
---|
{ "name": string, "package": string, "messageType": [ { object ( |
الحقول | |
---|---|
name |
اسم الملف، نسبةً إلى جذر شجرة المصدر |
package |
مثلاً: "foo" أو "foo.bar" وما إلى ذلك |
messageType[] |
جميع التعريفات ذات المستوى الأعلى في هذا الملف |
enumType[] |
|
syntax |
بناء جملة ملف Proto. القيم المسموح بها هي "proto2" و"proto3" و"editions". في حال توفّر السمة |
DescriptorProto
تصف نوع الرسالة.
تمثيل JSON |
---|
{ "name": string, "field": [ { object ( |
الحقول | |
---|---|
name |
|
field[] |
|
nestedType[] |
|
enumType[] |
|
oneofDecl[] |
|
FieldDescriptorProto
يصف حقلاً داخل رسالة.
تمثيل JSON |
---|
{ "name": string, "number": integer, "label": enum ( |
الحقول | |
---|---|
name |
|
number |
|
label |
|
type |
إذا تم ضبط typeName، لا يلزم ضبطها. إذا تم ضبط كل من هذا الحقل وtypeName، يجب أن يكون النوع TYPE_ENUM أو TYPE_MESSAGE أو TYPE_GROUP. |
typeName |
بالنسبة إلى أنواع الرسالة والتعداد، يكون هذا هو اسم النوع. وإذا كان الاسم يبدأ بـ "."، فهذا يعني أنّه مؤهَّل بالكامل. وبخلاف ذلك، يتم استخدام قواعد تحديد نطاق تشبه C++ للعثور على النوع (أي يتم البحث أولاً عن الأنواع المتداخلة داخل هذه الرسالة، ثم داخل الأصل، وصولاً إلى مساحة الاسم الجذر). |
defaultValue |
بالنسبة للأنواع الرقمية، يحتوي على تمثيل النص الأصلي للقيمة. بالنسبة إلى القيم المنطقية، يكون "true" أو "خطأ". بالنسبة إلى السلاسل، يحتوي على المحتوى النصي التلقائي (لا يتم تخطيه بأي شكل من الأشكال). بالنسبة إلى وحدات البايت، يحتوي على قيمة C التي تتضمن حروف إلغاء. يتم تخطي جميع وحدات البايت >= 128. |
oneofIndex |
في حال استخدام هذه السمة، يتم توفير فهرس a oneof في قائمة oneofDecl للنوع المحتوي. هذا الحقل عضو في ذلك الحقل. |
jsonName |
اسم JSON لهذا الحقل. يتم تعيين القيمة بواسطة برنامج التحويل البرمجي للبروتوكول. إذا قام المستخدم بتعيين "jsonName" في هذا الحقل، فسيتم استخدام قيمة هذا الخيار. وبخلاف ذلك، يتم استنتاجه من اسم الحقل بتحويله إلى CamlCase. |
proto3Optional |
إذا كانت القيمة true، تكون قيمة Proto3 "اختيارية". عندما يكون حقل proto3 اختياريًا، يتم تتبع التواجد بغض النظر عن نوع الحقل. عندما تكون قيمة proto3Optional صحيحة، يجب أن ينتمي هذا الحقل إلى أحد هذه القيم للإشارة إلى عملاء Proto3 القدامى الذي يتم تتبع وجوده لهذا الحقل. يُعرف هذا العنصر باسم "الاصطناعي" ويجب أن يكون هذا الحقل عضوًا وحيدًا فيه (يحصل كل حقل اختياري من حقول Proto3 على واحد اصطناعي خاص به). وتوجد عبارات البحث الاصطناعية في الواصف فقط، ولا تنشئ أي واجهة برمجة تطبيقات. يجب طلب منتج واحد اصطناعي بعد كل كلمة "حقيقية" واحد. بالنسبة إلى حقول الرسائل، لا ينشئ proto3Optional أي تغيير دلالي، لأنّ حقول الرسائل غير المكررة تتبع دائمًا الحضور. ومع ذلك، فإنها لا تزال تشير إلى التفاصيل الدلالية لما إذا كان المستخدم قد كتب كلمة "اختياري" أم لا. يمكن أن يكون ذلك مفيدًا لنقل البيانات ذهابًا وإيابًا ملف .proto. للحفاظ على الاتساق، نمنح حقول الرسائل حقلاً اصطناعيًا أيضًا، على الرغم من أنّه ليس من الضروري تتبُّع الحضور. وهذا مهم بشكل خاص لأن المحلل لا يمكنه معرفة ما إذا كان الحقل عبارة عن رسالة أو تعداد، لذا يجب دائمًا إنشاء واحد اصطناعي. لا تعمل حقول Proto2 الاختيارية على ضبط هذه العلامة، لأنّها تشير إلى أنّها اختيارية في |
التصنيف
عمليات التعداد | |
---|---|
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 ( |
الحقول | |
---|---|
name |
|
value[] |
|
EnumValueDescriptorProto
تصف قيمة داخل تعداد.
تمثيل JSON |
---|
{ "name": string, "number": integer } |
الحقول | |
---|---|
name |
|
number |
|
OneofDescriptorProto
يصف أحدها.
تمثيل JSON |
---|
{ "name": string } |
الحقول | |
---|---|
name |
|
PolicySchemaFieldDescription
توفّر هذه السياسة معلومات تفصيلية حول حقل معيّن يشكّل جزءًا من PolicySchema.
تمثيل JSON |
---|
{ "field": string, "description": string, "inputConstraint": string, "knownValueDescriptions": [ { object ( |
الحقول | |
---|---|
field |
النتائج فقط. تمثّل هذه السمة اسم الحقل المرتبط بهذا الوصف. |
description |
تمّ الإيقاف. استخدِم name وfieldDescription بدلاً من ذلك. وصف الحقل. |
inputConstraint |
النتائج فقط. أي قيود إدخال مرتبطة بالقيم الخاصة بالحقل. |
knownValueDescriptions[] |
النتائج فقط. إذا كان الحقل يحتوي على مجموعة من القيم المعروفة، سيقدّم هذا الحقل وصفًا لهذه القيم. |
nestedFieldDescriptions[] |
النتائج فقط. تقدِّم وصفًا للحقول المضمّنة في هذا الحقل، إذا كان الحقل من نوع رسالة يحدد حقولاً متعدّدة. يمكن عرض الحقول حسب الترتيب في هذه القائمة، وليس حسب رقم الحقل. |
fieldDependencies[] |
النتائج فقط. توفّر هذه السياسة قائمة بالحقول والقيم. يجب أن يتضمّن حقل واحد على الأقل القيمة المقابلة، لكي يتم السماح بضبط هذا الحقل. |
requiredItems[] |
النتائج فقط. يتم توفير قائمة بالحقول التي يجب ضبطها إذا كان هذا الحقل يحتوي على قيمة معيّنة. |
defaultValue |
النتائج فقط. الإعداد التلقائي للعميل في حال ترك السياسة بدون ضبط. |
name |
النتائج فقط. اسم الحقل. |
fieldDescription |
النتائج فقط. وصف الحقل. |
fieldConstraints |
النتائج فقط. معلومات حول أي قيود إدخال مرتبطة بالقيم الخاصة بالحقل. |
PolicySchemaFieldKnownValueDescription
تقدِّم هذه السياسة معلومات تفصيلية حول قيمة معروفة مسموح بها لحقل معيّن في PolicySchema.
تمثيل JSON |
---|
{
"value": string,
"description": string,
"fieldDependencies": [
{
object ( |
الحقول | |
---|---|
value |
النتائج فقط. إعادة تمثيل السلسلة للقيمة التي يمكن ضبطها للحقل. |
description |
النتائج فقط. وصف إضافي لهذه القيمة. |
fieldDependencies[] |
النتائج فقط. شروط الحقل المطلوبة لكي تكون هذه القيمة صالحة. |
PolicySchemaFieldDependencies
الحقل والقيمة التي يجب أن يحتوي عليها ليتم السماح بضبط حقل آخر.
تمثيل JSON |
---|
{ "sourceField": string, "sourceFieldValue": string } |
الحقول | |
---|---|
sourceField |
حقل المصدر الذي يعتمد عليه هذا الحقل. |
sourceFieldValue |
القيمة التي يجب أن يتضمّنها حقل المصدر للسماح بضبط هذا الحقل. |
PolicySchemaRequiredItems
الحقول التي ستصبح مطلوبة استنادًا إلى قيمة هذا الحقل.
تمثيل JSON |
---|
{ "fieldConditions": [ string ], "requiredFields": [ string ] } |
الحقول | |
---|---|
fieldConditions[] |
قيمة(قيم) الحقل التي أدت إلى فرض تنفيذ الحقل المطلوب. تشير شروط الحقل الفارغ إلى أنّ أيّ قيمة مخصّصة لهذا الحقل ستؤدي إلى فرض تنفيذ الحقل المطلوب. |
requiredFields[] |
الحقول المطلوبة نتيجة لشروط الحقل. |
FieldConstraints
معلومات حول أي قيود للنطاق.
تمثيل JSON |
---|
{ "numericRangeConstraint": { object ( |
الحقول | |
---|---|
numericRangeConstraint |
النطاق المسموح به للحقول الرقمية. |
uploadedFileConstraints |
القيود المفروضة على الملف الذي تم تحميله لسياسة ملف تتطلب هذه السياسة، في حال توفّرها، عنوان URL يمكن استرجاعه عن طريق تحميل ملف تنطبق عليه القيود المحدَّدة في هذا النموذج الأوّلي. |
NumericRangeConstraint
قيد على الحد الأعلى و/أو الأدنى، مع تعيين واحد على الأقل.
تمثيل JSON |
---|
{ "minimum": string, "maximum": string } |
الحقول | |
---|---|
minimum |
القيمة الصغرى. |
maximum |
القيمة القصوى. |
UploadedFileConstraints
القيود المفروضة على الملف الذي تم تحميله لسياسة ملف
تمثيل JSON |
---|
{
"supportedContentTypes": [
enum ( |
الحقول | |
---|---|
supportedContentTypes[] |
أنواع الملفات التي يمكن تحميلها لأحد الإعدادات. |
sizeLimitBytes |
الحد الأقصى لحجم الملفات المحمَّلة لأحد الإعدادات، بالبايت. |
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 |
النتائج فقط. اسم الحقل المرتبط بالإشعار. |
noticeValue |
النتائج فقط. قيمة الحقل الذي يحتوي على إشعار. وعند ضبط الحقل على هذه القيمة، قد يُطلَب من المستخدم الإقرار برسالة الإشعار حتى يتم ضبط القيمة. |
noticeMessage |
النتائج فقط. ترتبط رسالة الإشعار بقيمة الحقل. |
acknowledgementRequired |
النتائج فقط. ما إذا كان المستخدم بحاجة إلى الإقرار برسالة الإشعار قبل ضبط القيمة. |
TargetResource
أنواع الموارد المستهدفة
عمليات التعداد | |
---|---|
TARGET_RESOURCE_UNSPECIFIED |
مورد مستهدَف غير محدَّد |
ORG_UNIT |
المورد المستهدف للوحدة التنظيمية. |
GROUP |
المصدر المستهدف للمجموعة. |
PolicyApiLifecycle
معلومات مراحل النشاط
تمثيل JSON |
---|
{ "deprecatedInFavorOf": [ string ], "scheduledToDeprecatePolicies": [ string ], "policyApiLifecycleStage": enum ( |
الحقول | |
---|---|
deprecatedInFavorOf[] |
في حال إيقاف هذه السياسة لصالح سياسة أخرى، سيتم عرض مساحات الاسم المؤهلة بالكامل للسياسات الجديدة على النحو الذي ستظهر به في PolicyAPI. لا يمكن ضبطها إلا إذا كانت policyApiLifecycleStage API_DEPRECATED. |
scheduledToDeprecatePolicies[] |
وبما يتوافق مع سياسة متوقّفة نهائيًا InFavorOf، فإنّ مساحات الاسم المؤهّلة بالكامل للسياسات القديمة سيتم إيقافها نهائيًا بسبب تطبيق هذه السياسة. |
policyApiLifecycleStage |
يشير هذا الحقل إلى مرحلة دورة الحياة الحالية لواجهة برمجة تطبيقات السياسة. |
description |
وصف حول دورة الحياة الحالية. |
endSupport |
تاريخ انتهاء التوافق مع السياسة الحالية ستؤدي محاولة تعديل إحدى السياسات بعد تاريخ انتهاء صلاحيتها إلى ظهور "طلب غير صالح" (الخطأ 400). لا يمكن ضبطها إلا إذا كانت policyApiLifecycleStage API_DEPRECATED. |
PolicyApiLifecycleEnum
مرحلة نشاط واجهة برمجة تطبيقات السياسة
عمليات التعداد | |
---|---|
API_UNSPECIFIED |
لم يتم تحديد مراحل نشاط واجهة برمجة التطبيقات للسياسة. |
API_PREVIEW |
لم تعمل السياسة بعد، ولكنّنا سنطلع المطوّرين على التنسيق الجديد. يمكن نقل هذه المرحلة إلى API_DEPLACEMNT أو API_CURRENT. |
API_DEVELOPMENT |
يمكن أن تغيّر السياسة التنسيق بطريقة غير متوافقة مع الأنظمة القديمة (تغيير قد يؤدي إلى عطل). يمكن أن تنتقل هذه المرحلة إلى API_CURRENT أو API_DEPRECATED. ويمكن استخدام ذلك للسياسات التي تم إطلاقها فقط لخدمات "تحويل النص إلى كلام" أو تم إطلاقها لعملاء محدَّدين للاستخدام في حالات الطوارئ. |
API_CURRENT |
السياسة بالتنسيق الرسمي. يمكن أن تغيّر السياسة التنسيق بطريقة متوافقة مع الأنظمة القديمة (تغيير غير منتظم). على سبيل المثال: يمكن أن تقدّم هذه السياسة حقلاً جديدًا عندما يتم استخدام أقنعة الحقول بشكل صحيح، ويُعدّ هذا التغيير تغييرًا لا يؤثّر على المحتوى. يمكن أن تنتقل هذه المرحلة إلى API_DEPRECATED. |
API_DEPRECATED |
يُرجى التوقف عن استخدام هذه السياسة. تم إيقاف هذه السياسة نهائيًا، وقد تتم إزالتها في المستقبل. تمّ على الأرجح طرح سياسة جديدة لتحلّ محلّ هذه السياسة. |
التاريخ
يمثل تاريخ تقويم كاملاً أو جزئيًا، مثل عيد الميلاد. تم تحديد الوقت من اليوم والمنطقة الزمنية في مكان آخر أو غير مهمين. يرتبط التاريخ بالتقويم الميلادي. يمكن أن يمثل ذلك أيًا مما يلي:
- تاريخ كامل، بقيم غير صفرية للسنة والشهر واليوم.
- شهر ويوم، بسنة صفرية (على سبيل المثال، ذكرى سنوية).
- سنة بمفردها، بشهر صفري ويوم صفري.
- سنة وشهر بيوم صفري (على سبيل المثال، تاريخ انتهاء صلاحية بطاقة الائتمان).
الأنواع ذات الصلة:
google.type.TimeOfDay
google.type.DateTime
google.protobuf.Timestamp
تمثيل JSON |
---|
{ "year": integer, "month": integer, "day": integer } |
الحقول | |
---|---|
year |
السنة من التاريخ. يجب أن تتراوح القيمة من 1 إلى 9999، أو 0 لتحديد تاريخ بدون سنة. |
month |
شهر من السنة. يجب أن تتراوح القيمة من 1 إلى 12، أو 0 لتحديد سنة بدون شهر ويوم. |
day |
يوم من الشهر. يجب أن تتراوح القيمة من 1 إلى 31 وأن تكون صالحة للسنة والشهر، أو 0 لتحديد عام في حد ذاته أو تحديد سنة وشهر عندما لا يكون اليوم مهمًا. |
النظام الأساسي
هذا تعداد يتضمّن مجموعات الأنظمة الأساسية المختلفة التي يتيح استخدام Chrome عليها.
عمليات التعداد | |
---|---|
PLATFORM_UNSPECIFIED |
منصة غير محدّدة |
CHROME_OS |
نظام التشغيل ChromeOS. |
CHROME_BROWSER |
متصفِّح Chrome لنظام التشغيل OSX/Windows/Linux. |
CHROME_BROWSER_FOR_ANDROID |
متصفح Chrome لنظام التشغيل Android. |
CHROME_BROWSER_FOR_IOS |
متصفح Chrome لنظام التشغيل iOS. |
الطُرق |
|
---|---|
|
يمكنك الحصول على مخطط سياسة محدّد لعميل حسب اسم المورد الخاص به. |
|
تحصل على قائمة بمخططات السياسات التي تطابق قيمة فلتر محدّدة لعميل معيّن. |