Class Fields

الحقول

تحتوي على مجموعة من Field لموصّل بيانات من إنشاء المنتدى. تحدّد مجموعة الحقول هذه السمات والمقاييس التي يمكن استخدامها في مركز البيانات.

const cc = DataStudioApp.createCommunityConnector();
const fields = cc.getFields();

const field1 = fields
                   .newDimension()
                   // Set other properties as needed.
                   .setId('field1_id');

الطُرق

الطريقة	نوع القيمة التي تم إرجاعها	وصف قصير
asArray()	Field[]	تعرض هذه الطريقة عرضًا لهذا العنصر كمصفوفة.
build()	Object[]	تتحقّق هذه الدالة من صحة العنصر وتعرضه بالتنسيق الذي يحتاج إليه "مركز البيانات".
forIds(ids)	Fields	تعرض هذه الطريقة عنصر Fields جديدًا تمّت فلترته إلى Fields باستخدام معرّف في ids.
getDefaultDimension()	Field	تعرِض هذه السمة السمة التلقائية التي سيتم استخدامها لمجموعة الحقول.
getDefaultMetric()	Field	تعرِض هذه الدالة المقياس التلقائي الذي سيتم استخدامه لمجموعة الحقول.
getFieldById(fieldId)	Field	تعرِض هذه الدالة حقلاً يحمل معرّفًا معيّنًا، أو null إذا لم يكن هناك حقل يحمل هذا المعرّف في عنصر Fields هذا.
newDimension()	Field	تعرِض هذه الدالة بُعدًا جديدًا Field.
newMetric()	Field	تعرِض هذه الدالة مقياسًا جديدًا Field.
setDefaultDimension(fieldId)	void	تحدّد هذه السمة السمة التلقائية التي سيتم استخدامها لمجموعة الحقول.
setDefaultMetric(fieldId)	void	تضبط هذه السمة المقياس التلقائي الذي سيتم استخدامه لمجموعة الحقول.

مستندات تفصيلية

asArray()

تعرض هذه الطريقة عرضًا لهذا العنصر كمصفوفة.

const fields = DataStudioApp.createCommunityConnector().getFields();
fields.newDimension().setId('field1_id');
fields.newDimension().setId('field2_id');
fields.newDimension().setId('field3_id');

// Logging the ID of each field:
fields.asArray().map((field) => {
  Logger.log(field.getId());
});

الإرجاع

Field[]: مصفوفة من عناصر Field

---

build()

تتحقّق هذه الدالة من صحة العنصر وتعرضه بالتنسيق الذي يحتاج إليه "مركز البيانات".

الإرجاع

Object[]: بيانات الحقل التي تم التحقّق من صحتها، ويتم تمثيلها كقائمة من العناصر

عمليات الطرح

‫Error: إذا تعذّر إنشاء عنصر صالح.

---

forIds(ids)

تعرض هذه الطريقة عنصر Fields جديدًا تمّت فلترته إلى Fields باستخدام معرّف في ids.

const fields = DataStudioApp.createCommunityConnector().getFields();
fields.newDimension().setId('field1_id');
fields.newDimension().setId('field2_id');
fields.newDimension().setId('field3_id');

// subsetFields is a Fields object that only contains field1 and field2.
const subsetFields = fields.forIds(['field1_id', 'field3_id']);

المعلمات

الاسم	النوع	الوصف
ids	String[]	أرقام تعريف الحقول التي يجب الاحتفاظ بها

الإرجاع

Fields: كائن Fields جديد

---

getDefaultDimension()

تعرِض هذه السمة السمة التلقائية التي سيتم استخدامها لمجموعة الحقول. يتم اختيار السمة التلقائية تلقائيًا عند إنشاء تمثيل مرئي جديد.

الإرجاع

Field: السمة التي تم ضبطها كسمة تلقائية، أو null إذا لم يتم ضبط أي سمة تلقائية.

---

getDefaultMetric()

تعرِض هذه الدالة المقياس التلقائي الذي سيتم استخدامه لمجموعة الحقول. يتم اختيار المقياس التلقائي تلقائيًا عند إنشاء تمثيل مرئي جديد.

الإرجاع

‫Field: المقياس الذي تم ضبطه كمقياس تلقائي، أو null إذا لم يتم ضبط أي مقياس تلقائي.

---

getFieldById(fieldId)

تعرِض هذه الدالة حقلاً يحمل معرّفًا معيّنًا، أو null إذا لم يكن هناك حقل يحمل هذا المعرّف في عنصر Fields هذا.

const fields = DataStudioApp.createCommunityConnector().getFields();
const field1 = fields.newDimension().setId('field1_id');

// byId is the same as field1.
const byId = fields.getFieldById('field1_id');

// byId2 is null.
const byId2 = fields.getFieldById('not present id');

المعلمات

الاسم	النوع	الوصف
fieldId	String	معرّف الحقل المطلوب جلبه

الإرجاع

‫Field — Field الذي يحمل رقم التعريف المحدّد، أو null إذا لم يتم تضمين أي حقل من هذا النوع في عنصر Fields هذا.

---

newDimension()

تعرِض هذه الدالة بُعدًا جديدًا Field.

الإرجاع

Field: بُعد جديد Field

---

newMetric()

تعرِض هذه الدالة مقياسًا جديدًا Field.

الإرجاع

Field: مقياس جديد Field

---

setDefaultDimension(fieldId)

تحدّد هذه السمة السمة التلقائية التي سيتم استخدامها لمجموعة الحقول. يتم اختيار السمة التلقائية تلقائيًا عند إنشاء تمثيل مرئي جديد.

المعلمات

الاسم	النوع	الوصف
fieldId	String	معرّف الحقل الذي سيتم استخدامه كسمة تلقائية. يجب أن يكون هذا المعرّف متوفّرًا في مجموعة الحقول.

---

setDefaultMetric(fieldId)

تضبط هذه السمة المقياس التلقائي الذي سيتم استخدامه لمجموعة الحقول. يتم اختيار المقياس التلقائي تلقائيًا عند إنشاء تمثيل مرئي جديد.

المعلمات

الاسم	النوع	الوصف
fieldId	String	معرّف الحقل الذي سيتم استخدامه كمقياس تلقائي. يجب أن يكون هذا المعرّف متوفّرًا في مجموعة الحقول.