REST Resource: properties

משאב: נכס

הודעת משאב שמייצגת נכס GA4 ב-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)

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

חותמת זמן בפורמט "זולו" RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

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

חותמת זמן בפורמט "זולו" RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".

parent

string

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

הערה: אפשר להשתמש בממשק המשתמש להעברת נכסים כדי לשנות את ההורה. פורמט: accounts/{account}, נכסים/{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)

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

חותמת זמן בפורמט "זולו" RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".

expireTime

string (Timestamp format)

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

חותמת זמן בפורמט "זולו" RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".

account

string

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

PropertyType

סוגים של משאבי נכסים.

טיפוסים בני מנייה (enums)
PROPERTY_TYPE_UNSPECIFIED סוג מאפיין לא ידוע או שלא צוין
PROPERTY_TYPE_ORDINARY נכס GA4 רגיל
PROPERTY_TYPE_SUBPROPERTY נכס משנה של GA4
PROPERTY_TYPE_ROLLUP נכס-על של GA4

IndustryCategory

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

טיפוסים בני מנייה (enums)
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.

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

שיטות

acknowledgeUserDataCollection

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

create

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

delete

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

get

מחפשים נכס GA4 יחיד.

getDataRetentionSettings

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

list

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

patch

מתבצע עדכון של נכס.

runAccessReport

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

updateDataRetentionSettings

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