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 ספרות חלקיות. אפשר להשתמש גם בהיסטים אחרים חוץ מ-Z. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

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

הפונקציה משתמשת ב-RFC 3339, והפלט שנוצר תמיד יהיה מנורמל ל-Z וישתמש ב-0, 3, 6 או 9 ספרות חלקיות. אפשר להשתמש גם בהיסטים אחרים חוץ מ-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 ספרות חלקיות. אפשר להשתמש גם בהיסטים אחרים חוץ מ-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 ספרות חלקיות. אפשר להשתמש גם בהיסטים אחרים חוץ מ-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 עם המיקום והמאפיינים שצוינו.

createRollupProperty

 יצירת נכס-על וכל קישורי המקור של נכס-העל.

delete

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

get

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

getAttributionSettings

 חיפוש של סינגלטון AttributionSettings.

getDataRetentionSettings

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

getGoogleSignalsSettings

 חיפוש ההגדרות של Google Signals בנכס.

getReportingIdentitySettings

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

list

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

patch

 עדכון נכס.

provisionSubproperty

 ליצור נכס משנה ומסנן אירועים לנכס משנה שחל על נכס המשנה שנוצר.

runAccessReport

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

submitUserDeletion

 שליחת בקשה למחיקת משתמש בנכס.

updateAttributionSettings

 מעדכן את הגדרות השיוך (Attribution) בנכס.

updateDataRetentionSettings

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

updateGoogleSignalsSettings

 עדכון ההגדרות של Google Signals בנכס.