REST Resource: properties

משאב: נכס

הודעת משאב שמייצגת נכס Google Analytics.

ייצוג ב-JSON 
{
  "name": string,
  "propertyType": enum (PropertyType),
  "createTime": string,
  "updateTime": string,
  "parent": string,
  "displayName": string,
  "industryCategory": enum (IndustryCategory),
  "timeZone": string,
  "currencyCode": string,
  "serviceLevel": enum (ServiceLevel),
  "deleteTime": string,
  "expireTime": string,
  "account": string
}
שדות
name

string

פלט בלבד. שם המשאב של הנכס הזה. פורמט: properties/{property_id}. דוגמה: ‎"properties/1000"‎
propertyType

enum (PropertyType)

לא ניתן לשינוי. סוג הנכס של משאב הנכס הזה. כשיוצרים נכס, אם הסוג הוא 'PROPERTY_TYPE_UNSPECIFIED', המערכת תשתמש באפשרות 'ORDINARY_PROPERTY'.
createTime

string (Timestamp format)

פלט בלבד. המועד שבו הישות נוצרה במקור.

הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד 'Z'. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

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

הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד 'Z'. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
parent

string

לא ניתן לשינוי. שם המשאב של ההורה הלוגי של הנכס הזה.

הערה: אפשר להשתמש בממשק המשתמש להעברת נכסים כדי לשנות את הנכס ההורה. פורמט: accounts/{account}, ‏ properties/{property}. דוגמה: "accounts/100",‏ "properties/101"
displayName

string

חובה. השם המוצג של הנכס הזה, שקריא לבני אדם.

האורך המקסימלי המותר של השם המוצג הוא 100 יחידות קוד UTF-16.
industryCategory

enum (IndustryCategory)

התחום שמשויך לנכס הזה. דוגמה: AUTOMOTIVE, ‏ FOOD_AND_DRINK
timeZone

string

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

הערה: שינוי אזור הזמן משפיע רק על נתונים עתידיים, ולא מיושם רטרואקטיבית.

פורמט: https://www.iana.org/time-zones דוגמה: 'America/Los_Angeles'
currencyCode

string

סוג המטבע שמשמש בדוחות שכוללים ערכים כספיים.

פורמט: https://en.wikipedia.org/wiki/ISO_4217 דוגמאות: "USD",‏ "EUR",‏ "JPY"
serviceLevel

enum (ServiceLevel)

פלט בלבד. רמת השירות של Google Analytics שחלה על הנכס הזה.
deleteTime

string (Timestamp format)

פלט בלבד. אם השדה מוגדר, השעה שבה הנכס הועבר לאשפה. אם לא מגדירים את הערך, הנכס הזה לא נמצא כרגע בפח האשפה.

הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד 'Z'. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
expireTime

string (Timestamp format)

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

הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד 'Z'. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
account

string

לא ניתן לשינוי. שם המשאב של החשבון הראשי. הפורמט: accounts/{account_id}. דוגמה: accounts/123

PropertyType

סוגי המשאבים של Property.

טיפוסים בני מנייה (enum)
PROPERTY_TYPE_UNSPECIFIED סוג נכס לא ידוע או לא מוגדר
PROPERTY_TYPE_ORDINARY נכס רגיל ב-Google Analytics
PROPERTY_TYPE_SUBPROPERTY נכס משנה ב-Google Analytics
PROPERTY_TYPE_ROLLUP נכס-על ב-Google Analytics

IndustryCategory

הקטגוריה שנבחרה לנכס הזה, שמשמשת לצורך השוואה לנכסים אחרים באותו תחום.

טיפוסים בני מנייה (enum)
INDUSTRY_CATEGORY_UNSPECIFIED קטגוריית התחום לא צוינה
AUTOMOTIVE ענף הרכב
BUSINESS_AND_INDUSTRIAL_MARKETS שוקי העסקים והתעשייה
FINANCE פיננסים
HEALTHCARE שירותי בריאות
TECHNOLOGY טכנולוגיה
TRAVEL נסיעות
OTHER אחר
ARTS_AND_ENTERTAINMENT אומנות ובידור
BEAUTY_AND_FITNESS יופי וכושר
BOOKS_AND_LITERATURE ספרים וספרות
FOOD_AND_DRINK מזון ומשקאות
GAMES משחקים
HOBBIES_AND_LEISURE תחביבים ופנאי
HOME_AND_GARDEN בית וגן
INTERNET_AND_TELECOM אינטרנט ותקשורת
LAW_AND_GOVERNMENT חוק וממשל
NEWS חדשות
ONLINE_COMMUNITIES קהילות מקוונות
PEOPLE_AND_SOCIETY אנשים וחברה
PETS_AND_ANIMALS חיות מחמד ובעלי חיים
REAL_ESTATE נדל"ן
REFERENCE חומרי עזר
SCIENCE מדע
SPORTS ספורט
JOBS_AND_EDUCATION משרות והשכלה
SHOPPING קניות

ServiceLevel

רמות שירות שונות ב-Google Analytics.

טיפוסים בני מנייה (enum)
SERVICE_LEVEL_UNSPECIFIED רמת השירות לא צוינה או לא תקינה.
GOOGLE_ANALYTICS_STANDARD הגרסה הרגילה של Google Analytics.
GOOGLE_ANALYTICS_360 הגרסה בתשלום של Google Analytics.

Methods

acknowledgeUserDataCollection

 אישור לתנאים של איסוף נתוני המשתמשים בנכס שצוין.

create

 יצירת נכס Google Analytics עם המיקום והמאפיינים שצוינו.

delete

 הפונקציה מסמנת את נכס היעד כ'מחיקה רכה' (כלומר 'העברה לאשפה') ומחזירה אותו.

get

 חיפוש של נכס GA יחיד.

getDataRetentionSettings

 הפונקציה מחזירה את הגדרות שמירת הנתונים של הנכס הזה.

list

 הפונקציה מחזירה נכסי צאצא בחשבון ההורה שצוין.

patch

 עדכון נכס.

runAccessReport

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

updateDataRetentionSettings

 עדכון ההגדרות של שמירת הנתונים של אובייקט יחיד (singleton) בנכס הזה.