דף זה תורגם על ידי Cloud Translation API.

Class Fields

מכיל קבוצה של Field למחבר קהילה. קבוצת השדות הזו מגדירה ניתן להשתמש במאפיינים ובמדדים ב-Data Studio.

var cc = DataStudioApp.createCommunityConnector();
var fields = cc.getFields();
var types = cc.FieldType;

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

שיטות

שיטה	סוג הערך המוחזר	תיאור קצר
`asArray()`	`Field[]`	מחזירה תצוגה של האובייקט כמערך.
`build()`	`Object[]`	מאמת את האובייקט הזה ומחזיר אותו בפורמט הנדרש ב-Data Studio.
`forIds(ids)`	`Fields`	הפונקציה מחזירה אובייקט `Fields` חדש שסונן לפי `Field` עם מזהה ב-`ids`.
`getDefaultDimension()`	`Field`	מחזירה את מאפיין ברירת המחדל שיש להשתמש בו עבור קבוצת השדות.
`getDefaultMetric()`	`Field`	מחזירה את מדד ברירת המחדל שישמש לקבוצת השדות.
`getFieldById(fieldId)`	`Field`	מחזירה שדה עם מזהה נתון, או `null` אם אין שדה עם המזהה הזה באובייקט `Fields` הזה.
`newDimension()`	`Field`	מחזירה מאפיין חדש `Field`.
`newMetric()`	`Field`	מחזירה מדד חדש `Field`.
`setDefaultDimension(fieldId)`	`void`	מגדיר את מאפיין ברירת המחדל שישמש לקבוצת השדות.
`setDefaultMetric(fieldId)`	`void`	הגדרת מדד ברירת המחדל שישמש לקבוצת השדות.

מסמכי תיעוד מפורטים

`asArray()`

מחזירה תצוגה של האובייקט כמערך.

var fields = //reference to fields object.
fields.newDimension().setId('field1_id');
fields.newDimension().setId('field2_id');
fields.newDimension().setId('field3_id');

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

חזרה

Field[] – מערך של Field אובייקטים.

`build()`

מאמת את האובייקט הזה ומחזיר אותו בפורמט הנדרש ב-Data Studio.

חזרה

Object[] – נתוני השדה המאומת, מיוצגים כרשימה של אובייקטים.

קליעות

Error – אם לא ניתן להרכיב אובייקט חוקי.

`forIds(ids)`

הפונקציה מחזירה אובייקט Fields חדש שסונן לפי Field עם מזהה ב-ids.

var fields = //reference to fields object.
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.
var subsetFields = fields.forIds(['field1_id', 'field3_id']);

פרמטרים

שם	סוג	תיאור
`ids`	`String[]`	המזהים של השדות שצריך לשמור.

חזרה

Fields – אובייקט Fields חדש.

`getDefaultDimension()`

מחזירה את מאפיין ברירת המחדל שיש להשתמש בו עבור קבוצת השדות. מאפיין ברירת המחדל הוא נבחר באופן אוטומטי כשנוצר תצוגה חזותית חדשה.

חזרה

Field – המאפיין שמוגדר כמאפיין ברירת המחדל, או null אם לא הוגדר כברירת מחדל הוגדר מאפיין.

`getDefaultMetric()`

מחזירה את מדד ברירת המחדל שישמש לקבוצת השדות. מדד ברירת המחדל נבחר באופן אוטומטי כשנוצר תרשים חדש.

חזרה

Field – המדד שמוגדר כמדד ברירת המחדל, או null אם לא הוגדר מדד ברירת מחדל הוגדרה.

`getFieldById(fieldId)`

מחזירה שדה עם מזהה נתון, או null אם אין שדה עם המזהה הזה באובייקט Fields הזה.

var fields = //reference to fields object.
var field1 = fields.newDimension().setId('field1_id');

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

// byId2 is null.
var 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`	מזהה השדה שישמש כמדד ברירת המחדל. המזהה הזה חייב להופיע ב קבוצת שדות.