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) בנכס הזה.