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

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

getGoogleSignalsSettings

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

getReportingIdentitySettings

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

getUserProvidedDataSettings

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

list

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

patch

 עדכון נכס.

provisionSubproperty

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

runAccessReport

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

submitUserDeletion

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

updateAttributionSettings

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

updateDataRetentionSettings

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

updateGoogleSignalsSettings

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