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 עם המיקום והמאפיינים שצוינו.

createConnectedSiteTag

 יצירת תג אתר מחובר לנכס Universal Analytics.

createRollupProperty

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

delete

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

deleteConnectedSiteTag

 מחיקה של תג אתר מחובר לנכס Universal Analytics.

fetchAutomatedGa4ConfigurationOptOut

 אחזור של סטטוס ביטול ההסכמה לתהליך ההגדרה האוטומטי של GA4 בנכס UA.

fetchConnectedGa4Property

 נתון נכס UA מסוים, מחפש את נכס GA4 שמקושר אליו.

get

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

getAttributionSettings

 חיפוש של אובייקט יחיד (singleton) של AttributionSettings.

getDataRetentionSettings

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

getGoogleSignalsSettings

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

list

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

listConnectedSiteTags

 רשימה של תגי האתר המקושרים לנכס Universal Analytics.

patch

 עדכון נכס.

provisionSubproperty

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

runAccessReport

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

setAutomatedGa4ConfigurationOptOut

 הגדרת סטטוס ביטול ההסכמה לתהליך ההגדרה האוטומטי של GA4 לנכס UA.

updateAttributionSettings

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

updateDataRetentionSettings

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

updateGoogleSignalsSettings

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